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文档。此JSON文档可以使用swagger-ui作为最终用户文档显示为交互式网页。
• 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服务应该如此简单，开发人员不必重新定义和重新编写基础知识。