知识卡片
服务序列图识别契约
先为业务服务编写业务服务规约(编号、描述、触发事件、基本/替代流程、验收标准),据执行步骤绘制服务序列图。序列图以限界上下文(及伴生系统)为参与对象,角色发起的请求为起点,发出的消息即待识别的服务契约,消息传递代表上下文间协作,用消息流产生向前的设计驱动力。
图11-5让作品上下文自己验证作品,向合规请求检查,再发布LiteraturePublished交给通知方处理;表11-2据此记录以下契约。订阅者到事件总线的虚线是订阅关系,不表示它主动发布LiteraturePublished。
| 服务/事件 | 生产者 → 消费者 | 操作 | 映射 |
|---|---|---|---|
| LiteratureController.publish(PublishingRequest): void | 作品 → UI | 命令 | 无 |
| CensorshipResource.censor(String): CensoredResponse | 合规 → 作品 | 查询 | 客户方/供应方 |
| LiteraturePublished | 作品 → 通知 | 事件 | 发布者/订阅者 |
服务契约表还记录功能、功能描述、业务服务及完整方法签名;可再补命名空间和消息定义。格式可调整,关键是把职责、参与者和模式写清,并与映射图或BRC卡一起保存。
结构图: 类图仅表达表11-2的公开契约,不推断实现字段;序列图表达图11-5的业务协作,两者分别回答接口形状与参与顺序。
classDiagram
class LiteratureController {
+publish(PublishingRequest request) void
}
class PublishingRequest
class CensorshipResource {
+censor(String content) CensoredResponse
}
class CensoredResponse
class LiteratureSubscriber
class LiteraturePublished
LiteratureController ..> PublishingRequest
CensorshipResource ..> CensoredResponse
LiteratureSubscriber ..> LiteraturePublished : 订阅事件
sequenceDiagram
actor A as 作者
participant W as 作品上下文
participant C as 合规上下文
participant B as 事件总线
participant N as 通知上下文
A->>W: publish(PublishingRequest)
W->>C: censor(String)
C-->>W: CensoredResponse
W-->>B: LiteraturePublished
B-->>N: 按订阅传递事件
序列图以消息传递帮助理解订阅关系,不宣称原图给出了总线的推送/拉取实现。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 第11章 服务契约设计 · 查看原书依据
发出的消息实则就是我们要识别的服务契约,而消息之间的传递,也代表了限界上下文之间的协作。如果执行步骤还需要与目标系统之外的伴生系统产生协作,则伴生系统也将作为序列图的参与对象。我将这样由伴生系统与限界上下文参与的序列图称为服务序列图。引入服务序列图的目的就是弄清楚限界上下文之间、
参考来源
- 位置:《解构领域驱动设计》第11章11.3.2(源文件:extracted/解构领域驱动设计/_epub-src/OEBPS/022.xhtml)
- 结论依据:文学平台"发布作品"业务服务规约L0006与服务序列图绘制方法。
- 原始内容:限界上下文作为序列图的参与对象,发出的消息实则就是我们要识别的服务契约