更改 SOAP 接口并弃用 Java 中的 Web 方法

Question

我的团队正在使用soap 开发java 中的服务层和dot-net 中的GUI。 GUI 开发人员总是感到不安，因为服务层偶尔会更改 Web 服务接口。

为了让 GUI 用户满意，我们现在正在编写与现有方法并存的新方法，而不是废弃原来的 Web 方法。由于我们的肥皂界面设计仍在完善中，这变得越来越混乱，肯定有更好的方法！有什么建议吗？

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

感谢您的任何建议

Answer 1

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

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

仅此方法当您的 Web 服务代码和实际应用程序代码之间有很好的分离时，效果非常好。将 Web 服务代码视为表示层会有所帮助。