4.服务契约设计
服务序列图驱动我们获得了消息定义,由此可以驱动出服务契约。如果目标系统规模大,限界上下文数量多,可以为每个限界上下文定义一个服务契约表。服务契约表除了体现了整个项目的服务契约定义,同时也为领域特性团队提供了设计约束。
表20-5列出了EAS系统的部分服务契约。
除了UI作为下游发起服务请求,表20-5列出的服务契约都标记了上下文映射模式。表20-5的“服务方法”列给出了类和方法的明确定义,也指出了方法参数的形参名和类型。若有返回值,也需要给出返回值类型。
在确定EAS的限界上下文时,我并没有明确指出限界上下文的通信边界。边界取决于质量属性的要求,自然也需要权衡库和服务的优缺点。在无法给出必须跨进程通信的证据之前,应优先考虑进程内通信。EAS系统作为一个企业内部系统,对并发访问与低延迟的要求并不高。可用性固然是一个系统该有的特质,但EAS系统毕竟不是“生死攸关”的一线生产系统,即使短时间出现故障,也不会给企业带来致命的打击或难以估量的损失。既然如此,我们应优先考虑将限界上下文定义为进程内的通信边界。唯一的例外是OA集成上下文被定义为进程间通信,因为它需要跨进程调用OA系统。这种方式一方面解除了OA系统上下文与大多数限界上下文之间的耦合,另一方面也能够较好地保证EAS系统的响应速度,减轻主应用服务器的压力。
因此,对于采用客户方/供应方模式的限界上下文,作为供应方的上游只需通过应用服务对外公开服务契约,如员工上下文的EmployeeAppService应用服务公开了追加项目经验的服务契约,这一设计满足菱形对称架构北向网关的要求。对采用发布者/订阅者模式的限界上下文而言,作为发布者的限界上下文也通过应用服务发布事件,如项目上下文通过TeamAppService应用服务发布了TeamMemberAdded事件,该事件属于应用事件,需要支持分布式通信。
所有服务契约的方法参数和返回值都是消息契约的一部分,也需要按照消息契约模型的要求进行定义,尤其需要满足菱形对称架构的要求,不能直接将领域模型暴露在外。
5.映射系统分层架构
在系统上下文的约束下,确定限界上下文属于哪种类型的子领域,即可将它们分别映射到系统分层架构的业务价值层与基础层。显然,资源上下文、文件共享上下文和OA集成上下文都属于支撑子领域,组织上下文和认证上下文属于通用子领域,其余限界上下文属于核心子领域。
EAS系统需要为集团决策者提供移动端应用程序,满足他(她)们提出的决策分析要求,也有利于他(她)们实时了解市场动态、人员动态和项目进度。针对市场部、人力资源部、项目管理部以及子公司等职能部门,主要提供Web前端,方便用户在办公环境的使用。因此,有必要为EAS系统引入一个边缘层来应对不同UI前端的需求。
根据系统级映射的方法,可以为EAS设计出图20-48所示的系统分层架构。
我们为限界上下文建立了菱形对称架构。可将它们看作一个个封闭的架构单元,它们之间的关系由上下文映射确定,在系统分层架构中,只需要考虑它们所处的层次即可。分层架构作用于整个系统上下文,业务价值层和基础层的内部架构由各个限界上下文控制,边缘层则汇聚了每个限界上下文提供的业务能力,统一对外向前端或其他客户端公开服务。
虽然EAS的每个限界上下文都引入了菱形对称架构,不过在其内部,网关层与领域层的设计仍有细微的差异。如决策分析上下文的领域逻辑主要为统计分析,受技术决策的影响,通常可以直接针对数据进行操作,无须建立领域模型,形成弱化的菱形对称架构,内部只包含北向网关与南向网关。其中,南向网关是一个薄薄的数据访问层,从数据库获得的统计分析数据会直接转换为消息契约模型。
OA集成上下文是一个由防腐层发展起来的限界上下文。它与其他限界上下文的协作采用了发布者/订阅者模式,内部又需要调用OA系统的服务接口,因而它的领域层只包含了组装消息内容的领域模型。在网关层,定义了应用事件作为消息契约模型,事件订阅者为北向网关的远程服务,事件处理器为北向网关的应用服务,事件发布者则属于南向网关,分为端口与适配器。
文件共享上下文的定义打破了惯有的设计方式。它负责的工作是文件上传和下载,通常会考虑将其作为基础设施层的一个公共组件。正如我们在第9章对模块、组件、库、服务等概念的澄清,一个限界上下文可以实现为库或者服务,但本质上仍然表达了对业务能力的纵向切分。由于不需要跨进程通信,可以将文件共享上下文实现为基础层(注意不是基础设施层)的库。它提供的业务能力为具备支撑功能的文件共享能力,封装的领域逻辑除了上传文件与下载文件的领域行为,还规定了属于不同类别的文件存放在文件服务器的不同位置。文件传输的实现由于操作了外部资源,因而属于南向网关适配器的内容。以归档合同为例,合同上下文调用文件共享上下文的FileAppService,其内部的协作序列如图20-49所示。
系统分层架构属于架构的逻辑视图,并没有确定限界上下文的通信边界。例如,OA集成上下文与其他限界上下文并不在一个进程中,但系统分层架构并不需要体现这一点。