您是否需要RESTful webservice的接口？

Question

我打算爲我的論文構建一個簡單的RESTful Web服務，也許這是一個圓頂佇立，但我只想知道，你真的需要一個接口（WADL或WSDL）來創建客戶端嗎？可能通過SOAP webservice！謝謝

Answer 1

SOAP Web服務通常不是RESTful。如果您要提供SOAP API：yes，您需要提供一個WSDL文件。這使Web服務的消費者能夠從WSDL生成消費者代碼。

無論是否真的需要一個RESTful服務WADL不太明確：

• What is the reason for using wadl?
• WADL/WSDL 2.0 for RESTful services in Ruby on Rails
• Why the slow WADL uptake?

你需要記錄在服務一些方式，如果任何人都能夠使用它。就個人而言，我認爲有更好的方式來記錄一個RESTful API比WADL。

Answer 2

不，你不知道。即使使用SOAP，您也不需要需要接口 - 您可以發佈一個知道如何與您的服務交談的「客戶端SDK」，但是有一些標準（WSDL和MEX）用於在SOAP中聲明接口。

對於REST服務，由於WADL沒有被廣泛採用，所以最常見的情況是您將向您的服務用戶展示如何使用您的服務的易讀集示例。

Answer 3

SOAP：是的。 REST：不可以。你總是可以使用類似RestSharp的東西來消耗它們。

要使用SOAP，您的客戶端需要了解SOAP以及它通過SOAP接收的對象，因此需要WSDL。

Answer 4

在REST模型中，「接口」將是超媒體（請參閱http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven）。

例如，在網站上，界面將是網頁（HTML）本身。

WADL試圖爲機器消耗提供類似的東西。還可能有其他形式的接口：XForms，RDF（和RDF forms）。在某些情況下，SOAP也可能是合適的（例如與WSRF結合）。