RESTful development -Как поделиться с клиентами?

Question

Я использую Jersey / Tomcat6 для разработки некоторых веб-сервисов.По сравнению с тем, что я сделал для сервисов SOAP, я не понимаю, что я должен делиться со своими клиентами после разработки сервисов ... только URL веб-сервиса ??Для SOAP было достаточно WSDL-файла, поскольку клиенты самостоятельно генерировали заглушки.

Мой сервис возвращает список объектов User (с 2 строками) в формате JSON.Как мои клиенты будут десериализовать JSON, если я предоставлю им только URL службы?Нужно ли мне совместно использовать компонент управления данными (класс User и класс списка) на стороне моего сервера?

Я читал о некоторых WADL-файлах для REST ... они полезны здесь?

Спасибо за любую помощь!

Answer 1

Похоже, вы, вероятно, захотите собрать пример клиента, который вы дадите своим клиентам, чтобы показать им, как использовать службу REST.В идеале, конечно, ваша служба REST будет полностью поддерживать HATEOAS (Hypermedia As The Engine Of Application State), и поэтому средства обхода ресурсов для получения желаемых результатов будут обнаружимы;Я обнаружил, что реальная реализация HATEOAS встречается редко.Для службы RESTful-ish (которая не полностью поддерживает HATEOAS) полезны примеры клиентов.Обычно вы можете реализовать свой пример клиента в HTML с помощью некоторого Javascript;это делает все очень доступным для большинства пользователей REST-клиентов.