java - What is required to call java webservice by other clients?

Question

I have developed two java web services; one is SOAP based and the second one REST. Now I have to ask some clients (they can be either java/non java clients) to use my web services. Now what information do I need to pass to the clients to use my web service?

• If SOAP, what should I share to clients to use my web service?
• If REST, what should I share to clients to use my web service?

Answer 1

使用 SOAP，您应该共享描述服务的WSDL 文档。这应该足够了，但通常不是；最常见的缺失是需要什么类型的安全性以及应该使用什么交互模式（即如何将方法串在一起）。理论上，WSDL 可以描述这些东西。实际上，您永远不会在野外看到它们。事实上，您最好通过将交互模式正确地记录在人类可读的文档中来进行交互模式。

使用 REST，理想状态通常被认为只是共享服务根页面的 URL，因为服务应该是自我描述的，客户可以通过点击链接找出要做什么。这是 HATEOAS 原则的核心。在实践中，它比这复杂得多。许多 JAX-RS 实现可以通过WADL 文档发布服务描述，这会有所帮助。使用 REST 的典型安全模型比使用 SOAP 更容易被发现，但即便如此仍然相当不透明，并且交互模式仍然存在问题（在服务中随机插入一些东西以希望它能够正常工作，无论您使用的是 SOAP 还是 REST管他呢）。