Požadavek set-temp

Účel a dopady

Uloží libovolný XML obsah do jednoho krátkodobého uložiště vázaného na přihlášeného uživatele, odkud jej lze později vyzvednout párovým požadavkem get-temp. Data se neukládají do databáze, jen v paměti serveru, a zůstávají k dispozici do konce běhu serveru nebo do přepsání novým obsahem.

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

• Dostupné každému přihlášenému uživateli, bez zvláštního oprávnění; uložiště je oddělené pro každého uživatele.
• Zpracování set-temp (na rozdíl od požadavků jako sql-query/action) není podmíněno stavem obálkové transakce – v dispatcheru pro něj taková podmínka chybí, požadavek se provede vždy.

XML požadavek (syntax + popis)

  <request>
   <set-temp>
    <{element} ... > ... </{element}> *
   </set-temp>
  </request>

Parametry a pravidla (atributy, potomci)

• Uzel set-temp nemá žádné vlastní atributy.
• Potomek: libovolný počet libovolných XML elementů (0 a vícekrát) i prostý text – server neomezuje ani nevaliduje strukturu obsahu, celý uzel set-temp (včetně všech potomků) jen znovu serializuje jako text.

Příklady požadavku

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

Zpracování a vedlejší účinky

• Server nejprve zruší dosud uložený obsah (pokud nějaký byl) a uvolní jeho paměť.
• Poté přejmenuje přijatý uzel set-temp na get-temp a celý takto přejmenovaný uzel se všemi původními atributy a potomky převede na text, který uloží jako nový obsah uživatelova dočasného uložiště.
• Uložený text je tedy kompletní XML fragment <get-temp>...</get-temp> – přesně to, co požadavek get-temp při dalším volání vrátí doslovně jako obsah své odpovědi.
• Zpracování nemá žádnou chybovou větev – neprobíhá žádná validace obsahu, žádná kontrola velikosti ani formátu.

XML odpověď (syntax + popis)

  <response>
   <set-temp
    type="ok"
    />
  </response>

Příklady odpovědi

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

Chyby a reakce

Požadavek nemá žádnou chybovou větev a vždy vrací <set-temp type="ok"/> – sebeuzavírající, bez vnořeného uzlu error.

Oprava oproti starší dokumentaci: starší dokumentace uváděla odpověď s atributem status (ok/error) a možným vnořeným uzlem error. Kód tomu neodpovídá – atribut se jmenuje type, ne status, jeho jedinou možnou hodnotou je "ok" a odpověď nikdy neobsahuje vnořený uzel error.

Související požadavky

• get-temp – vyzvednutí obsahu uloženého tímto požadavkem.