您需要 RESTful Web 服务的接口吗？答案

【问题标题】：Do you need an Interface by RESTful webservice?您需要 RESTful Web 服务的接口吗？
【发布时间】：2011-05-16 22:06:36
【问题描述】：

我正在忙着为我的论文构建一个简单的 RESTful web 服务，也许这是一个圆顶问题，但我只是想知道，你真的需要一个接口（WADL 或 WSDL）来创建客户端吗？很可能是 SOAP 网络服务！谢谢

【问题讨论】：

【解决方案1】：

SOAP Web 服务通常不是 RESTful。如果您提供 SOAP API：是的，您需要提供 WSDL 文件。这使 Web 服务的消费者能够从 WSDL 生成消费者代码。

RESTful 服务是否真的需要 WADL 不太明确：

如果有人能够使用它，您确实需要以某种方式记录该服务。就个人而言，我认为记录 RESTful API 的方法比 WADL 更好。

【讨论】：

【解决方案2】：

不，你没有。即使使用 SOAP，您也并不真正需要一个接口 - 您可以只发布一个知道如何与您的服务对话的“客户端 SDK”，但是有一些标准（WSDL 和 MEX）用于声明SOAP 中的一个接口。

对于 REST 服务，由于 WADL 没有被广泛采用，最常见的情况是您向您的服务的用户展示一组人类可读的示例，说明如何使用您的服务。

【讨论】：

【解决方案3】：

肥皂：是的。 REST：不。您可以随时使用RestSharp 之类的东西来使用它们。

要使用 SOAP，您的客户端需要了解 SOAP 以及它通过 SOAP 接收的对象，因此需要 WSDL。

【讨论】：

【解决方案4】：

例如，在网站上，界面将是网页 (HTML) 本身。

WADL 试图为机器消耗提供类似的东西。还可能有其他形式的接口：XForms、RDF（和RDF forms）。在某些情况下，SOAP 也可以说是合适的（例如与WSRF 结合使用）。

【讨论】：