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

Question

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

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

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

谢谢你的帮助 ！

Answer 1

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