《SOA与REST：用REST构建企业级SOA解决方案》—第1章1.4节约定

本节书摘来自异步社区《soa与rest：用rest构建企业级soa解决方案》一书中的第1章1.4节约定，作者【美】thomas erl , benjamin carlyle , cesare pautasso , raj balasubramanian，更多章节内容可以访问云栖社区“异步社区”公众号查看。

1.4　约定

1.4.1　灰色的使用

本书中，文字和代码片段偶尔使用灰色标识。灰色的文字谨慎用于普通章节内容中，帮助突出关键语句。在代码样例中，当它与之前的样例章节中的描述相关时，代码片段一般使用灰色标识。

1.4.2　设计约束、原则和模式：页码参考

本书中讨论的每一个设计约束、原则和模式都有对应的概要表。概要就是总结了关键设计环节和注意事项的简明定义。本书主要重复的主题就是探讨约束、原则和模式如何相互关联和影响。因此，鼓励读者任何时候在上下文中遇到一个不清楚的约束、原则或模式时，反复地参考相关概要表。

为了帮助快速参考概要表，本书采用了一个特殊的约定。每个原则、模式和约束的名字后面跟着指向概要页面的页码数字。这项约定由设计模式社区设定并在本书中进一步用于本书中的设计原则和设计约束。

附录中包含所有概要表的内容。约束的概要表在附录c中，原则和模式的概要表分别在附录d和附录e中。

为了保持本书中的约束、原则和模式之间能够迅速区分，它们名字后面的页码分别使用了不同的分隔符。每个约束对应的页码采用花括号，每个原则对应的页码使用圆括号，每个模式对应的页码使用方括号，如下：

约束名｛页码｝

原则名（页码）

模式名［页码］

例如，下列陈述首先引用的是一个面向服务的设计原则，然后是一个soa设计模式，最后是一个rest约束：

“……通过运用解耦的契约［302］模式和无状态｛279｝约束来支持服务松耦合（413）原则……”

在这段陈述中，每个引用都明确限定为原则、模式或是约束。为简洁起见，本书中的大部分引用（尤其是后面的章节中）忽略这些限定。

例如，对前面陈述的更为常见的措辞如下：

“……通过运用解耦的契约［302］和无状态｛279｝来支持服务松耦合（413）……”

这种措辞约定仍旧来源于设计模式社区。如前所述，如果读者碰到一个没有特定限定词的引用，则使用其页码分隔符（圆括号、方括号、花括号）来识别它的类型（原则、模式或是约束）。

1.4.3　设计目标

rest架构设计目标和面向服务计算的战略目标同设计约束、原则和模式不同，设计目标没有概要。第5章介绍了rest架构设计目标，第4章介绍了面向服务计算的设计目标。

1.4.4　符号图例

本书包含一系列的图表，称之为图。所有图中使用的主要符号在本书插页的符号图例中有分别的描述。