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服务应该如此简单，开发人员不必重新定义和重新编写基础知识。