API поиска – Restful Design – передача списка в запросе ⇐ JAVA

[Anonymous]

Мне нужно изменить существующий API поиска. API поиска принимает SearchCriteria в качестве тела запроса для фильтрации записей. Мне нужно добавить еще один фильтр к этому SearchCriteria. Фильтр возьмет список идентификаторов и вернет ресурсы, которым присвоены указанные идентификаторы.
Таблица: Сотрудник

Код: Выделить всё

| ID   | departmentId |
|------|--------------|
| 1001 | 1            |
| 1001 | 2            |
| 1001 | 3            |
| 1001 | NULL         |

Предположим, запрос будет выглядеть так:

Код: Выделить всё

{
"searchCriteria": {
"departmentId": ["1","2","3"]
}
}

Результат должен вернуть все ресурсы, соответствующие идентификатору отдела. Это просто.
Но как получить сотрудников, у которых идентификатор отдела имеет значение NULL, как показано в таблице?
Проблемы:

• Потребитель API может пропустить само поле в запросе. В этом случае должны быть возвращены все сотрудники.
• В запросе это поле может иметь значение null. В этом случае также в ответе должны быть отправлены все сотрудники.
• Запрос имеет пустой список. Это также следует рассматривать, как указано выше.
• Запрос имеет список со значением «null». Тогда в ответе должны быть указаны сотрудники, у которых значение DepartmentId равно нулю. Обратите внимание, что стек потребительских технологий будет другим: в случае Python это будет «Нет», а в случае JavaScript — «неопределено».

Как с этим справиться? Какова наилучшая практика?


Подробнее здесь: https://stackoverflow.com/questions/793 ... he-request