您是否需要RESTful webservice的接口？

Question

我打算为我的论文构建一个简单的RESTful Web服务，也许这是一个圆顶伫立，但我只想知道，你真的需要一个接口（WADL或WSDL）来创建客户端吗？可能通过SOAP webservice！谢谢

Answer 1

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

无论是否真的需要一个RESTful服务WADL不太明确：

• What is the reason for using wadl?
• WADL/WSDL 2.0 for RESTful services in Ruby on Rails
• Why the slow WADL uptake?

你需要记录在服务一些方式，如果任何人都能够使用它。就个人而言，我认为有更好的方式来记录一个RESTful API比WADL。

Answer 2

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

对于REST服务，由于WADL没有被广泛采用，所以最常见的情况是您将向您的服务用户展示如何使用您的服务的易读集示例。

Answer 3

SOAP：是的。 REST：不可以。你总是可以使用类似RestSharp的东西来消耗它们。

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

Answer 4

在REST模型中，“接口”将是超媒体（请参阅http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hypertext-driven）。

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

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