RESTful开发 - 如何与客户分享？

Question

我使用Jersey / Tomcat6来开发一些Web服务。与我为SOAP服务所做的相比，我不知道在开发服务后我应该与客户分享什么...只是Web服务的URL？对于SOAP，WSDL文件就足够了，因为客户端会自行生成存根。

我的服务以JSON格式返回User对象列表（包含2个字符串）。如果我只与他们共享服务URL，我的客户将如何反序列化JSON？我是否需要在服务器端共享实体bean（User类和列表类）？

我一直在阅读有关REST的一些WADL文件......它们在这里有用吗？

感谢您的帮助！

Answer 1

听起来您可能希望将一个示例客户端放在一起，让您的客户向他们展示如何使用REST服务。当然，理想情况下，您的REST服务将完全支持HATEOAS（超媒体作为应用程序状态引擎），因此可以发现遍历资源以获得所需结果的方法;我发现真正的HATEOAS实现很少见。对于RESTful-ish服务（不完全支持HATEOAS的服务），示例客户端很有用。您通常可以使用一些Javascript在HTML中实现示例客户端;这使得大多数REST客户端用户都可以轻松访问所有内容。