java - 在 Java 中更改 SOAP 接口(interface)和弃用 Web 方法

Question

我的团队正在使用 soap 在 java 中开发一个服务层，在 dot-net 中开发一个 GUI。 GUI 开发人员一直很烦恼，因为服务层偶尔会更改 Web 服务接口(interface)。

为了让 GUI 小伙伴开心，而不是破坏原始的网络方法，我们现在正在编写与现有方法并存的新方法。由于我们的 soap 界面设计仍在完善中，因此变得越来越困惑，肯定有更好的方法!有什么建议吗？

此外，有时我们想要弃用 Web 服务方法 - 是否有用于执行此操作的 Java 注释(会出现在 WSDL 中的注释)？

谢谢你的建议

Answer 1

据我所知，没有这样的弃用注释。这是我通常使用的一般模式:

• 实现一个 SOAP api，将版本号 (v1) 放在 WSDL 名称或路径中
• 编写新的(或改进的)应有更新的 SOAP api 的应用程序代码
• 在 v1 代码旁边使用新版本号 (v2) 实现全新版本的 SOAP api，但由相同的域类支持
• 更改 v1 网络服务的实现以执行迁移并(只要可能)调用 v2 服务的适当方法
• 通知客户他们应该开始使用 v2 而不是 v1
• 等等
• 如果您在大型企业环境中，请等待更长时间；-)
• 一旦没有人再使用 v1(通过日志和与用户的对话验证这一点)，删除 v1 接口(interface)

只有在网络服务代码和实际应用程序代码之间有很好的分离时，这种方法才真正有效。将 Web 服务代码视为表示层会有所帮助。