Каков предпочтительный метод для WSDL для веб-службы REST?

Question

Я создал множество веб-сервисов SOAP, но я создаю веб-сервис REST для конкретного проекта, и мне было интересно, что люди используют для WSDL для сервисов REST или вообще нужно ли это.

Answer 1

REST действительно использует только HTTP-глаголы (GET, PUT, POST, DELETE) для ресурса. Все операции с ресурсом должны быть представлены таким образом. POST используется как ловушка для всех случаев, когда вы не можете выразить свою бизнес-логику так, чтобы она подходила к остальным трем. Вот почему на самом деле не существует WSDL для службы REST, поскольку у вас есть только 4 метода для ресурса. Обратите внимание, что библиотека Zend Framework REST на самом деле не является RESTful и представляет собой скорее простой старый сервис XML (POX).

Answer 2

Хотя Сэм прав, что веб-приложениям RESTful не нужен прямой аналог WSDL, существует словарь XML, который полезен для описания веб-приложений RESTful: WADL или Язык описания веб-приложений . В моей компании мы в основном используем WADL, чтобы определить спецификацию для конкретного сервиса, который мы хотим построить - мы обычно не используем его программно. Тем не менее, домашняя страница WADL включает в себя некоторые инструменты Java для генерации кода, а Restlet , инфраструктура Java REST, включает расширение WADL для динамически подключаемых приложений на основе WADL и динамического генерирования WADL. на основе проводного приложения. Я фанат WADL и рекомендую проверить это.

Answer 3

Вы можете попробовать Swagger (теперь OpenAPI), который позволяет описывать службы REST с использованием открытого стандарта JSON.

Answer 4

На самом деле для этого можно использовать WSDL, но он должен быть v 2.0 - см. Статью " Описание веб-служб REST с WSDL 2.0 ".

Answer 5

Вы можете предоставить XSD, если вы используете XML в службе REST.

Или просто примеров XML, должно быть достаточно, чтобы все-таки разобраться с простой структурой данных.