ГОСТ Р ИСО/МЭК 19831—2017
4.1.6.6 Сортировка Наборов
При запросе представления Набора Потребителям допускается включать параметр запроса Sor
derby для сортировки возвращаемых записей Набора на основании различных атрибутов и в различном
порядке (убывания). Поставщики должны интерпретировать и обрабатывать параметр запроса Sorder-by
в соответствии с требованиями настоящего раздела.
Параметр Sorderby должен иметь форму
?Sorderby=HanMeHOBaHHeATpn6yTa/.ascj.descy. ...
Выражение Sorderby может включать в себя несколько наименований атрибутов, разделенных
запятой. Кроме того, каждое наименование атрибута может сразу сопровождаться двоеточием и клю
чевыми словами «asc» для обозначения порядка по возрастанию (значение по умолчанию) или «desc»
для обозначения порядка по убыванию для данного атрибута. Если ни asc. ни desc не заданы, то по
рядок должен быть возрастающим.
Атрибуты, включенные в Sorderby, должны иметь следующие типы в соответствии с 5.5: boolean.
dateFormat. duration, integer или string.
Сортировка зависит от типа атрибута.
Следующие правила относятся к сортировке по возрастанию:
- boolean — значение «false» должно быть расположено перед значением ’true";
- dateTime — более ранние значения дата/время должны быть расположены перед более поздни
ми значениями дата/время;
- duration — более короткая продолжительность должна быть расположена перед более длитель
ной продолжительностью;
- integer — меньшее целое число должно быть расположено перед большими целыми числами.
Отрицательные целые числа должны быть расположены перед положительными целыми числами.
- string — порядок основан на порядке сортировки Unicode/UTF-8.
Порядок сортировки desc (по убыванию) должен быть противоположным указанному выше.
Примеры
Д ля сортировки набора результатов Ресурса MachinesCollection по атрибуту "created
"
в
порядке
убывания, используют следующее выражение:
GET
/
Machines?$orderby=created:desc
Д ля сорт ировки набора результатов Ресурса MachinesCollection по атрибуту "ери" в порядке
убывания, а затем по атрибуту "m em ory"
в
порядке возрастания, используют следующее выражение:
GET /Machines ?$orderby=cpu:desc,memory:asc
4.1.6.7 Заголовки ответа
В соответствии с [7] для передачи метаданных сообщения в ответных сообщениях в настоящем
стандарте использованы заголовки общего назначения, заголовки ответа и заголовки объекта (entity),
чтобы предоставить метаданные о сообщении. В приложениях, в которых использованы сообщения,
определенные в настоящем стандарте, следует использовать заголовки, совместимые с Реестром за
головков HTTP (5).
4.1.6.8 Заголовок Job
Если сервер поддерживает Ресурс Job, то ответные сообщения должны включать в себя заголо
вок, определенный в настоящем стандарте, чтобы указать на URI задания, созданного для обработки
связанного с ним сообщения запроса:
CIMI-Job-URI = "CIMI-Job-URI"string
В тех случаях, когда во время обработки запроса происходит ошибка. Поставщик должен вклю
чить представление Ресурса Job. описывающего состояние иеудавшейся операции. Представление
Job должно быть включенодаже в тех случаях, если Поставщик обычно не поддерживает Ресурсы Job,
чтобы гарантировать, что Потребителям предоставлена достаточная информация согласованным спо
собом относительно причины неудачи, независимо от того, поддерживает ли Поставщик Ресурсы Job.
Если Ресурсы Job в целом не поддерживаются, то любая из ссылок в представлении Job (например,
«id» или «href» для nestedJobs) должна быть представлена пустыми путями (т. е.«»), и массив nestedJob
должен быть развернут (см. 4.1.6.4), чтобы встроить представление псевдоподчиненных заданий Job.
4.1.6.9 Поддержка завершающего тега (ЕТад)
Заголовок ЕТад может быть предоставлен Поставщиком с каждым Ресурсом в соответствии с [7].
Если Поставщик действительно предоставляет заголовок ЕТад, то он должен также поддержать обра
ботку заголовка If-Match от имени Потребителя.
10