Java REST Web服務的服務詳細信息

Question

我是Java新手。

在SOAP Web服務中，我們有wsdl告訴我們有關服務的操作等，但在REST中，我們沒有得到wsdl 。

所以，我的問題是，如果有人想知道服務細節，那么在REST Web服務的情況下如何找到它。

Answer 1

使用REST還沒有一種既定的方法可以實現這一點，但是有很多選擇出現：

• Swagger http://swagger.wordnik.com/ - 檢查源代碼中的注釋（支持Web框架JAX-RS注釋，Spring annotatins，Play2）並生成描述API的JSON文檔。 可以使用swagger-ui將此JSON文檔顯示為交互式Web頁面作為最終用戶文檔。
• Json Home http://tools.ietf.org/html/draft-nottingham-json-home-02 - 描述RESTful API的JSON文檔規范
• WADL http://en.wikipedia.org/wiki/Web_Application_Description_Language

Answer 2

SOAP引入了WSDL來描述服務，這些服務可以自動發現並與UDDI等機制集成。 實際上，SOAP被用作硬編碼的RPC。 如果使用REST，則使用眾所周知的HTTP機制處理許多細節，例如異常處理，操作類型，冪等性。 您唯一需要知道的是有效負載編碼。 如果您使用XML，您可以使用XSD來描述服務，如果您使用JSON，則需要自己處理（更簡單）。 您的網址結構應設計得足夠直觀，可在單頁自述文件中進行描述。 簡而言之：Web服務非常復雜，您需要大量的電子設備，REST服務應該如此簡單，開發人員不必重新定義和重新編寫基礎知識。