Řazení záznamů¶
Na všechny zdroje vracející kolekce (AtomFeed) lze aplikovat řazení pomocí parametru orderBy. Řadit lze obvykle podle libovolného elementu v první úrovni pod atom:content
, a to i podle více elementů, přičemž pro každý lze určit směr řazení (vzestupně/sestupně).
Gramatika a sémantika¶
Zápis výrazu pro řazení odpovídá jednoduché gramatice:
expression = ordering,
[ ",", ordering ];
ordering = identifier,
[ "@", direction ];
identifier = ? ["a"-"z","A"-"Z","_","0"-"9","-"]+ ?
direction = "asc" | "desc";
kde identifier
je název elementu, podle kterého chceme řadit, a direction
je směr řazení – asc
vzestupný (výchozí), desc
sestupný.
Příklady¶
/teachers?orderBy=firstName
– seřadí vyučující podle křestního jména vzestupně od A do Z/teachers?orderBy=firstName@desc
– seřadí vyučující podle křestního jména sestupně od Z do A/teachers?orderBy=firstName,lastName
– seřadí vyučující podle křestního jména a příjmení vzestupně od A do Z/teachers?orderBy=firstName@desc,lastName@desc
– seřadí vyučující podle křestního jména a příjmení sestupně od Z do A/teachers?orderBy=firstName@desc,lastName@asc
– seřadí vyučující podle křestního jména sestupně a podle příjemní vzestupně