Požadavek unload-pseudo

Účel a dopady

Uvolní z operační paměti serveru všechny dosud načtené transformační šablony pro čtení a zápis pseudo dokumentů. Požadavek není běžně vůbec zapotřebí – server si aktuálnost načtených šablon hlídá sám; slouží jako ruční vynucení jejich příštího znovunačtení.

Dostupnost, kontext, oprávnění apod.

Smí použít jen uživatel s r_admin nebo r_manage; jinak je požadavek zamítnut.

XML požadavek (syntax + popis)

  <request>
   <unload-pseudo/>
  </request>

Požadavek nemá žádné atributy ani potomky – uvolní vždy všechny načtené šablony pro všechny typy dokumentů a role najednou, bez možnosti výběru jen některých.

Parametry a pravidla (atributy, potomci)

Požadavek unload-pseudo nemá žádné atributy ani potomky.

Příklady požadavku

(Zatím bez ověřeného příkladu.)

Zpracování a vedlejší účinky

Server uvolní z paměti všechny načtené pseudošablony a vyprázdní jejich mezipaměť. Samotné uvolnění nemá chybovou větev; jediná možná chyba je nedostatečné oprávnění.

XML odpověď (syntax + popis)

  <response>
   <unload-pseudo
    type="ok"
    />
  </response>

Parametry a pravidla (atributy, potomci) – odpověď

• type - Výsledek - Hodnota ok při úspěchu. (typ: enum; povolené hodnoty: ok)

Příklady odpovědi

(Zatím bez ověřeného příkladu.)

Chyby a reakce

• <unload-pseudo status="error" detail="Nemate patricna opravneni"/> – volající nemá r_admin ani r_manage. Pozor: chybová odpověď používá atribut status, zatímco úspěšná odpověď používá type.
• Jiná chybová větev pro tento požadavek neexistuje. Výraz pro identifikaci chyb v odpovědi serveru: unload-pseudo[@status='error'].

Související požadavky

• unload-soap – obdobné ruční uvolnění paměti, ale pro načtené SOAP služby/akce.