我是 Java 中的 Web 服务的新手。
在 SOAP Web 服务中，我们有wsdl来告诉我们操作等服务，但在 REST 中，我们没有wsdl。
所以，我的问题是如果有人想知道服务细节，那么在 REST Web 服务的情况下如何找到它。
问问题
198 次
2 回答
2
对于 REST，目前还没有单一的既定方法可以实现这一目标，但是出现了几个选项：
- Swagger http://swagger.wordnik.com/ - 检查源代码中的注释（支持 Web 框架 JAX-RS 注释、Spring 注释、Play2）并生成描述 API 的 JSON 文档。可以使用swagger-ui将此 JSON 文档显示为作为最终用户文档的交互式网页。
- Json Home https://datatracker.ietf.org/doc/html/draft-nottingham-json-home-02 - 描述您的 RESTful API 的 JSON 文档规范
- WADL http://en.wikipedia.org/wiki/Web_Application_Description_Language
于 2012-12-10T08:27:16.850 回答
2
SOAP 引入了 WSDL 来描述服务，可以自动发现服务并与 UDDI 等机制集成。实际上，SOAP 就像硬编码的 RPC 一样使用。如果使用 REST，异常处理、操作类型、幂等性等许多细节都是使用众所周知的 HTTP 机制处理的。您唯一需要知道的是有效负载编码。如果您使用 XML，您可以使用 XSD 来描述服务，如果您使用 JSON，则需要自己处理（它更简单）。您的 URL 结构应设计得足够直观，以便在一页自述文件中进行描述。简而言之：WebServices 是如此复杂，您需要大量的样板，REST 服务应该如此简单，以至于开发人员不必重新定义和重新记录基础知识。
于 2012-12-10T08:27:49.113 回答