Příklad XML nastavení
Příklad uložení kmenových XML nastavení uživatele 5 může vypadat takto:
<save-settings type="user-root" user="5">
<user-settings>
...
</user-settings>
</save-settings>
a uložení dílčího uživatelského nastavení téhož uživatele může vypadat např. takto:
<save-settings type="user-table" user="5" tb-id="1234">
<table-file>
...
</table-file>
</save-settings>
Všimněte si, že jako kmenové uzly platného XML obsahu jsou uzly s názvy user-settings a table-file. Zatímco struktura user-root vč. kmenového tagu obsahu user-settings je pevně dána, obsah dílčích nastavení vč. názvu kmenového tagu závisí na účelu jeho využití. I v případě dílčích nastavení table je ale využívána konvence sjednoceného kmenového tagu table-file, který teprve dále obsahuje potřebný obsah. Je dobré tuto konvenci dodržovat.
Požadavek na získání uživatelských nastavení v předchozím příkladu bude mít tedy následující formu:
<get-settings type="user-root" user="5"/>
a získání dílčích nastavení pak zase tuto:
<get-settings type="user-table" user="5" tb-id="1234"/>
Identifikace chyb
Ve všech používaných oblastech může dojít k požadavku na entitu, která nebyla vložena. Můžeme tak například poslat request s obsahem:
<get-settings type="user-table" user="5" tb-id="99999"/>
Budeme-li předpokládat, že entita s id 99999 nebyla vložena, bude mít odpověď response následující obsah:
<get-settings type="error" setting-type="user-table" tb-id="99999" descr="Neexistuje"/>