RESTful開發 - 如何與客戶分享？

Question

我使用Jersey/Tomcat6來開發一些Web服務。與我爲SOAP服務所做的相比，我沒有想到應該在開發服務時向我的客戶分享什麼內容......只是Web服務的URL？對於SOAP來說，WSDL文件就足夠了，因爲客戶端自己生成了存根。

我的服務返回JSON格式的用戶對象列表（帶有2個字符串）。如果我只與他們共享服務URL，我的客戶如何反序列化JSON？我是否需要在服務器端共享實體bean（用戶類和列表類）？

我一直在閱讀關於REST的一些WADL文件......他們在這裏有幫助嗎？

感謝您的幫助！

Answer 1

聽起來好像你可能想組合一個示例客戶端來給你的呃客戶端，告訴他們如何使用REST服務。理想情況下，您的REST服務將完全支持HATEOAS（超媒體作爲應用程序狀態引擎），因此遍歷資源以獲得預期結果的方法將被發現;但是，我發現真正的HATEOAS實現很少見。對於RESTful-ish服務（不完全支持HATEOAS的服務），示例客戶端很有用。您通常可以使用一些Javascript在HTML中實現您的示例客戶端;這使大多數REST客戶端用戶都可以輕鬆訪問所有內容。