Web 服务契约的版本控制

今天，我们介绍这本由 Thomas Erl、Anish Karmarkar、Priscilla Walmsley、Hugo Haas、L. Umit Yalcinalp、Canyang Kevin Liu、David Orchard、Andre Tost 和 James Pasley 编著的“《针对 SOA 的 Web 服务契约设计和版本控制》”。更确切的说，是这本书的第 20、21 和 22 章，它们说明了跟服务契约版本控制相关的问题。

下载地址：《针对 SOA 的 Web 服务契约设计和版本控制》——第 20、21 和 22 章——服务契约的版本控制（PDF）。

在基于 SOA 的解决方案中，Web 服务需要详细的技术契约，它们清楚地指出了每个服务的功能和使用方式。由于服务会随着时间而变化，契约的设计者需要确保服务消费者使用合适的契约变种，该问题可以通过版本控制来解决。

第 20 章：版本控制的基础

在本章中，作者叙述了版本控制中使用的基本概念和术语，要解决的兼容性问题，如何使用版本标识符，以及几个可供选择的版本控制策略。

由于 Web 服务契约可以由多个文档（WSDL 定义、XML 模式定义、WS-Policy 定义）构成，版本控制应该适用于在契约改变时改变的所有文件。通常情况下，WSDL 的版本控制会被考虑，但是变更也可能出现在 XML 模式定义中，因而它们同样需要版本控制。

有四种需要考虑的基本变更类型：向后兼容、向前兼容、兼容和不兼容。这部分通过实例对每种变更类型进行了解释。

接下来的章节介绍了最常用的版本控制标识符和版本控制策略。这三个策略是：

• 严格：任何兼容或不兼容的变更都会产生一个新的服务契约版本。这种方式不支持向后兼容和向前兼容。
• 灵活：任何不兼容的变更会产生一个新的服务契约版本，契约被设计成支持向后兼容，但不支持向前兼容。
• 宽松：任何不兼容的变更会产生一个新的服务契约版本，契约被设计成同时支持向后兼容和向前兼容。

第 21 章：对 WSDL 定义进行版本控制

在这一章中，作者使用“变更的意义”和documentation元素来解决 WSDL 定义文件的版本控制。除了对整个文档进行版本控制，这本书中还包含了对操作定义、端口类型定义和具体描述（concrete descriptions）进行版本控制的实例。

第 22 章：对消息模式进行版本控制

服务契约包含的 XML 模式定义描述了在服务使用时交换的基本输入、输出和错误消息。因此，作者认为，XML 模式定义最有可能经常变更，需要版本控制。

本章解释了，什么是 XML 模式组件，它们的内容集，增加 / 删除 / 重命名 / 修改组件的影响，以及它们跟版本控制的关系。作者还解释了变更 XML 模式的目标命名空间会如何影响 WSDL 的目标命名空间，以及在这种情况下，如何应用严格、灵活、宽松的版本控制策略。

关于此书的详细信息，请浏览： informit.com/soa 或 soabooks.com

给 InfoQ 中文站投稿或者参与内容翻译工作，请邮件至 editors@cn.infoq.com 。也欢迎大家加入到 InfoQ 中文站用户讨论组中与我们的编辑和其他读者朋友交流。