此卡片不在当前主题的阅读序列中,可返回主题继续阅读。
知识卡片
普通读书笔记卡 · 1969
服务契约是协作接口
业务服务满足角色的服务请求,在解空间体现为服务与客户的协作关系,形成的协作接口即契约。业务服务通过架构映射阶段的一个或多个协作契约落实,具体接口可以体现为菱形对称架构北向网关的开放主机服务;它向客户端传递的消息数据称为消息契约,是服务契约的组成部分。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- 主要讲解 · 第11章 服务契约设计
原书出处 · 1 处
- 第11章 服务契约设计 · 查看原书依据
消息契约是组成服务契约的一部分。
参考来源
- 位置:《解构领域驱动设计》第11章章首(源文件:extracted/解构领域驱动设计/_epub-src/OEBPS/022.xhtml)
- 结论依据:业务服务→服务契约→消息契约的层层对应,映射到菱形对称架构北向网关。
- 原始内容:一个业务服务对应于架构映射阶段需要定义的服务契约,体现为菱形对称架构北向网关的开放主机服务。
关联卡片
- 上下文映射定协作:Related(章11服务契约设计承接章10上下文映射)
- 服务由接口与约束定义:Related(两卡都以对外协作契约说明服务边界;本卡抽象到参数、协议及格式,前卡说明领域服务在协作中的契约。)
- 服务契约固定协作:Related(服务契约明确跨边界协作,本卡保留EAS真实方法与参数并区分事件,展开契约表的实现落点。)
- 消息契约三类操作:Related(“服务契约是协作接口”与“消息契约三类操作”在服务及消息契约中互补;本卡具体说明:消息契约对应发布语言模式,按操作类型分三类:命令是改变系统状态的动作,查询是无副作用的状态查看,事件既是事实又是触发器。它们决定不同协作模式——查询用请求/响应,命令视是否需结果选请求/响应或即发即忘,事件用发布/订阅。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 请求消息与响应消息:Related(“服务契约是协作接口”与“请求消息与响应消息”在服务及消息契约中互补;本卡具体说明:请求/响应模式的消息契约分请求消息(查询请求、命令请求)与响应消息;响应又分命令结果、面向前端UI的视图模型、面向下游上下文的数据契约。即发即忘只有命令请求,发布/订阅模式的契约就是事件本身。操作类型与协作模式共同决定契约模型。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 消息契约命名遵循统一后缀规范:Related(“服务契约是协作接口”与“消息契约命名遵循统一后缀规范”在服务及消息契约中互补;本卡具体说明:请求消息建议以"动名词+Request"命名(QueryingProductRequest),也可用Query/Command后缀区分操作;响应消息视图模型以Presentation/View为后缀,数据契约以Response为后缀,命令结果以Result为后。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 引入消息契约模型保护领域模型:Related(“服务契约是协作接口”与“引入消息契约模型保护领域模型”在服务及消息契约中互补;本卡具体说明:消息契约以专用的数据结构表达跨边界交互,避免远程调用直接依赖领域对象的内部形态。这样可把序列化要求、外部视图需求和内部模型演进分开;代价是相似字段的重复及转换成本。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 契约转换基于信息专家模式分配:Related(“服务契约是协作接口”与“契约转换基于信息专家模式分配”在服务及消息契约中互补;本卡具体说明:简单的消息与领域对象转换,可按信息专家原则放在了解消息结构的对象中;内部领域模型不应反向依赖外部消息类型。原例NominationRequest.toCandidate()从已有请求构造Candidate,TrainingResponse.from(Train。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 装配器负责组装跨聚合的消息契约:Related(“服务契约是协作接口”与“装配器负责组装跨聚合的消息契约”在服务及消息契约中互补;本卡具体说明:当OrderItem只持有productId,而响应需要产品信息时,装配器可以先批量取得产品,再组装各订单项响应。OrderResponseAssembler通过ProductClient获得映射,再把Order与产品结果组合为OrderResponse,避免。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 应用服务是不含领域逻辑的外观:Related(“服务契约是协作接口”与“应用服务是不含领域逻辑的外观”在服务及消息契约中互补;本卡具体说明:应用服务是外观模式的体现:对外为完整业务服务提供自给自足的统一简单接口,对内仅协调领域模型对象、不含任何领域逻辑,是调用领域层的入口点。第一条设计准则——不包含领域逻辑的业务服务应被定义为应用服务,以此降低客户程序对领域层的依赖。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 横切关注点应交由应用服务协作:Related(“服务契约是协作接口”与“横切关注点应交由应用服务协作”在服务及消息契约中互补;本卡具体说明:消息验证、错误处理、监控、事务、认证授权等属基础架构问题,是散布于各对象层次却与其核心功能无关的横切关注点,逻辑上应与核心关注点(领域逻辑)分离。为保证领域模型纯粹性,应用服务成为与横切关注点协作的最佳位置——第二条设计准则。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 编制属应用逻辑:Related(“服务契约是协作接口”与“编制属应用逻辑”在服务及消息契约中互补;本卡具体说明:判断协调逻辑的归属,可问这些步骤是否因领域规则而必须共同发生。如果组合本身表达稳定的业务策略,应把该知识留在领域模型;若只是为应用用例安排可替换的任务、格式转换或技术协作,可由应用服务组织。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 按关注点分应用领域:Related(“服务契约是协作接口”与“按关注点分应用领域”在服务及消息契约中互补;本卡具体说明:判断服务归属的另一标准:看服务代码蕴含的知识是否与所处限界上下文要解决的问题关注点直接有关。领域逻辑对应子领域的业务知识与规则(如资金转账),应用逻辑为完成业务服务的其他逻辑(如文件格式转换、导出),后者不在子领域问题空间内。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 远程服务三类契约:Related(“服务契约是协作接口”与“远程服务三类契约”在服务及消息契约中互补;本卡具体说明:建立服务模型的思想不同,远程服务契约也不同:面向资源思想驱动服务资源契约(按调用者分资源服务与控制器服务),面向行为思想采用SOA概念模型驱动服务行为契约(提供者服务),面向事件思想驱动服务事件契约(其消费者反成开放主机服务,即订阅者服务)。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 资源契约遵循REST:Related(“服务契约是协作接口”与“资源契约遵循REST”在服务及消息契约中互补;本卡具体说明:资源契约从调用者要操作的对象建模:查询订单面向Orders,统计分析也可识别AnalysisResults,而不只暴露一个含混的AnalysisService。完整资源契约还要交代动作、请求/响应表述和状态信息。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 行为契约规定权义:Related(“服务契约是协作接口”与“行为契约规定权义”在服务及消息契约中互补;本卡具体说明:行为契约规定请求方必须满足的条件,以及服务方在满足条件后承诺的结果。前置条件是消费者义务与提供者权利,后置条件则相反;它们是对输入、状态和结果的约束,不能直接等同于参数列表或返回类型。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 意图导向设计契约:Related(“服务契约是协作接口”与“意图导向设计契约”在服务及消息契约中互补;本卡具体说明:意图导向设计先站在消费者的业务场景想象理想服务:需要什么有效条件、最少提供哪些信息、应获得什么保证、什么名字清楚表达价值,再决定接口与实现。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 事件契约实现松耦合:Related(“服务契约是协作接口”与“事件契约实现松耦合”在服务及消息契约中互补;本卡具体说明:服务事件契约以已经发生的业务事件连接发布者与订阅者。双方不必直接引用对方的实现,事件总线负责传递;异步协作可以减少同步等待和直接位置耦合。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 事件的两种定义风格:Related(“服务契约是协作接口”与“事件的两种定义风格”在服务及消息契约中互补;本卡具体说明:事件通知风格仅携带领域对象ID,订阅者需回调发布者远程服务补全信息,反而引入复杂协作破坏松耦合。事件携带状态迁移风格将事件定义为自给自足对象,"自给自足"是双方协商结果、只满足当前协作场景,不必传整个领域模型(付款已收到事件无须带全部水单)。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 应用事件才是契约:Related(“服务契约是协作接口”与“应用事件才是契约”在服务及消息契约中互补;本卡具体说明:本书按作用范围区分事件:领域层的领域事件用于表达领域事实和内部协作,应用层对外发布的应用事件作为跨上下文契约。若领域事件需要对外传播,可转换成稳定的应用事件,隔离内部模型重构。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 良好应用事件的特征:Related(“服务契约是协作接口”与“良好应用事件的特征”在服务及消息契约中互补;本卡具体说明:应用事件应避免依赖内部领域类,保留协作所需的最小属性、发布聚合ID、事件唯一ID、版本与创建时间,并尽量保持不可变。版本为契约演进提供线索,唯一ID为辨认同一事件提供身份。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 用事件类型表达分支:Related(“服务契约是协作接口”与“用事件类型表达分支”在服务及消息契约中互补;本卡具体说明:支付结果可用一种事件加结果值表达,例如PaymentCompleted携带OperationResult;订阅者据值分支。也可用PaymentSucceeded、PaymentFailed两种事件类型直接表达结果,再分别处理。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 围绕业务服务定契约:Related(“服务契约是协作接口”与“围绕业务服务定契约”在服务及消息契约中互补;本卡具体说明:一个业务服务可能需多个限界上下文协作,设计服务契约应围绕业务服务展开,并区分公开给UI/外部调用者的契约与公开给下游上下文的契约。细化时抹去领域细节,只考虑控制器服务、资源服务、供应者服务、面向下游的应用服务、应用事件与作为发布语言的消息契约六类。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 服务序列图识别契约:Related(“服务契约是协作接口”与“服务序列图识别契约”在服务及消息契约中互补;本卡具体说明:先为业务服务编写业务服务规约(编号、描述、触发事件、基本/替代流程、验收标准),据执行步骤绘制服务序列图。序列图以限界上下文(及伴生系统)为参与对象,角色发起的请求为起点,发出的消息即待识别的服务契约,消息传递代表上下文间协作,用消息流产生向前的设计驱动力。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- DTO因分布式粗粒度服务而生:Related(“服务契约是协作接口”与“DTO因分布式粗粒度服务而生”在当前具体职责与方法中互补;本卡具体说明:DTO用于按调用者需要组合数据,历史动机包括减少跨进程细碎调用。它可把多个领域对象的信息组成一个消息,避免把内部对象图直接暴露给客户端。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 消息契约即DTO:Related(“服务契约是协作接口”与“消息契约即DTO”在当前具体职责与方法中互补;本卡具体说明:本书把北向接口的输入与结果定义为消息契约模型,作为DTO保护内部领域结构;南向也可定义本地消息类型,配合防腐转换隔离上游语义。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 辅助类统一远程服务:Related(“服务契约是协作接口”与“辅助类统一远程服务”在当前具体职责与方法中互补;本卡具体说明:Resources辅助类把应用调用、异常类别、日志与HTTP状态映射集中起来,提供execute(Supplier<T>)和execute(Runnable)两种入口,减少各资源控制器重复代码。。二者并非凭原章节顺序形成论证支撑,使用Related;保留历史卡ID和编号。)
- 领域驱动架构的核心:Related(章12领域驱动架构承接章11服务契约设计)