Přejít na obsah
Flexideo
Skip to main content

Požadavek get-temp

Účel a dopady​

Vrátí obsah dříve uložený stejným uživatelem požadavkem set-temp do krátkodobého úložiště v paměti serveru. Požadavek samotný nic neukládá ani nemaže; jen čte.

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

  • Dostupné každému přihlášenému uživateli, výhradně pro jeho vlastní uložená data; cizí přístup není možný.
  • Přístup je chráněn čtecím zámkem (tempLock), takže souběžné get-temp/set-temp téhož uživatele se nekříží.

XML požadavek (syntax + popis)​

  <request>
   <get-temp/>
  </request>

Parametry a pravidla (atributy, potomci)​

Požadavek get-temp nemá žádné atributy ani potomky – server je u tohoto uzlu vůbec nečte.

Příklady požadavku​

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

Zpracování a vedlejší účinky​

  • Server vrací přesně to, co bylo uloženo posledním voláním set-temp téhož uživatele: set-temp při uložení přejmenuje celý přijatý uzel <set-temp> (včetně všech jeho atributů a potomků/textu) na <get-temp> a takto sestavený řetězec uloží beze změny do paměti. get-temp jej pak jen doslovně vloží do odpovědi.
  • Úspěšná odpověď proto nemá žádný pevný tvar ani stavový atribut definovaný protokolem – jde o cokoli, co klient sám dříve uložil (libovolné atributy/potomky/text pod kořenem <get-temp>). Jediný protokolem daný tvar je chybová odpověď níže.
  • Data se neukládají do databáze a nepřežívají restart serveru; po odstranění uživatelského objektu ze serveru se ztrácí.

XML odpověď (syntax + popis)​

Při úspěchu (dříve uložená data existují) – tvar zcela určuje obsah uložený předchozím set-temp, viz výše:

  <response>
   <get-temp ...libovolné atributy/potomci dle set-temp... >
    ...
   </get-temp>
  </response>

Při chybě (dosud nic neuloženo):

  <response>
   <get-temp
    type="error"
    detail="Neexistuje"
    />
  </response>

Příklady odpovědi​

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

Chyby a reakce​

  • <get-temp type="error" detail="Neexistuje"/> – uživatel dosud (v rámci běhu tohoto serverového procesu) nepoužil set-temp, nebo byla data mezitím smazána.
  • Na rozdíl od staré dokumentace je chybový atribut vždy type, ne status (stará stránka byla v syntaxi a v textu vzájemně nekonzistentní), a odpověď nikdy neobsahuje vnořený uzel error.
  • Výraz pro identifikaci chyb v odpovědi serveru: get-temp[@type='error'].

Související požadavky​

  • set-temp – uložení dat, která get-temp vrací.