REST webservice的'WSDL'的首选方法是什么？

Question

我已经构建了大量的SOAP Web服务，但是正在为特定项目构建REST Web服务，并且我想知道人们用于REST服务的“WSDL”，或者甚至需要它。

Answer 1

您可以尝试Swagger（现在的OpenAPI），它允许使用JSON开放标准来描述REST服务。

Answer 2

如果您在REST服务中使用XML，则可以提供XSD。

或者只是XML的例子，应该足以为简单的数据结构解决问题。

Answer 3

REST实际上只在资源上使用HTTP动词（GET，PUT，POST，DELETE）。资源上的所有操作都应该以这种方式表示。当您无法以适合其他三种方式表达您的业务逻辑时，POST被用作所有功能。这就是为什么REST服务没有真正的WSDL，因为在资源上只有4种方法。请注意，Zend Framework REST库不是真正的RESTful，更多的是普通的旧式XML（POX）服务。

Answer 4

虽然Sam认为RESTful Web应用程序不需要直接模拟WSDL，但有一个XML词汇表对描述RESTful Web应用程序很有用：WADL或Web Application Description Language。在我的公司，我们主要使用WADL为我们想要构建的给定服务定义一个规范 - 我们通常不会以编程方式使用它。也就是说，the WADL home page包含一些用于代码生成的Java工具，而（Java REST框架）包含一个WADL扩展，用于动态连接基于WADL的应用程序，并基于有线应用程序动态生成WADL。我是WADL的粉丝，并建议您检查一下。

Answer 5

其实它可以使用WSDL，但它应该是2.0版 - 请参阅“Describe REST Web services with WSDL 2.0”文章。