Вам нужен интерфейс веб-службы RESTful?

Question

Я стараюсь создать простой веб-сервис RESTful для моей диссертации, может быть, это купольная очередь, но я просто хочу знать, действительно ли вам нужен интерфейс (WADL или WSDL) для создания клиентов? Вероятно, SOAP веб-сервис! Спасибо

Answer 1

Нет, нет.Даже с SOAP на самом деле не требуется интерфейс - вы можете просто отправить "клиентский SDK", который знает, как общаться с вашим сервисом, но есть несколько стандартов (WSDL и MEX) для объявленияинтерфейс в SOAP.

С сервисами REST, поскольку WADL не получил широкого распространения, наиболее распространенным сценарием является предоставление пользователям вашего сервиса удобочитаемого набора примеров * 1006.* о том, как пользоваться вашим сервисом.

Answer 2

Веб-сервис SOAP обычно не является RESTful. Если вы предоставляете SOAP API: yes, , вам необходимо предоставить файл WSDL. Это позволяет потребителям веб-службы генерировать потребительский код из WSDL.

Вопрос о том, действительно ли WADL нужен для службы RESTful, менее ясен:

• В чем причина использования wadl?
• WADL / WSDL 2.0 для служб RESTful в Ruby on Rails
• Почему медленное поглощение WADL?

Вам необходимо документально оформить услугу некоторым способом, если кто-нибудь сможет ее использовать. Лично я думаю, что есть лучшие способы документировать RESTful API, чем WADL.

Answer 3

В модели REST «интерфейс» будет гипермедиа (см. http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven).

Например, на веб-сайте интерфейсом будет сама веб-страница (HTML).

WADL - это попытка предложить что-то похожее для машинного потребления. Также могут быть другие формы интерфейсов: XForms, RDF (и RDF формы ) В некоторых случаях SOAP также может быть подходящим (например, в сочетании с WSRF ).

Answer 4

МЫЛО: Да. ОТДЫХ: Нет. Вы всегда можете использовать что-то вроде RestSharp , чтобы потреблять их.

Чтобы использовать SOAP, ваш клиент должен понимать SOAP и какие объекты он получает через SOAP, поэтому требуется WSDL.