Java REST Web 服务中的服务详细信息



我是Java中Web服务的新手。

在 SOAP Web 服务中,我们有 wsdl 告诉我们有关操作等服务的信息,但在 REST 中,我们没有得到 wsdl

所以,我的问题是,如果有人想知道服务细节,那么在 REST Web 服务的情况下如何找到它。

SOAP 引入了 WSDL 来描述服务,这些服务可以自动发现并与 UDDI 等机制集成。实际上,SOAP 就像硬编码的 RPC 一样使用。如果使用 REST,则许多细节(如异常处理、操作类型、幂等性)都是使用众所周知的 HTTP 机制处理的。您唯一需要知道的是有效负载编码。如果你使用XML,你可以使用XSD来描述服务,如果你使用JSON,你需要自己处理(它要简单得多)。URL 的结构应设计为足够直观,以便在单页自述文件中进行描述。短说一说:Web服务是如此复杂,你需要大量的样板,REST服务应该非常简单,以至于开发人员不必重新定义和重新记录基础知识。

对于 REST,目前还没有单一的既定方法来实现这一点,但是出现了几个选项:

  • Swagger http://swagger.wordnik.com/- 检查源代码中的注释(支持 Web 框架 JAX-RS 注释、Spring 注释、Play2),并生成描述 API 的 JSON 文档。此 JSON 文档可以使用 swagger-ui 显示为交互式网页作为最终用户文档。
  • Json 主页 https://datatracker.ietf.org/doc/html/draft-nottingham-json-home-02 - 描述 RESTful API 的 JSON 文档规范
  • WADL http://en.wikipedia.org/wiki/Web_Application_Description_Language

最新更新