02-通用语言与协作-DDD领域驱动设计


title: "02 通用语言与协作"


学习目标

  • 理解通用语言(Ubiquitous Language)的作用:消除"人脑翻译"
  • 能建立最小可用的词汇表,并把它映射到代码命名
  • 知道如何在模型演化时同步更新语言与代码

核心概念

通用语言(Ubiquitous Language)

通用语言是围绕模型建立的共同语言,要求团队在:

  • 讨论、文档、图
  • 代码中的类名、方法名、事件名、命令名

都尽量使用同一套词汇与定义。

课堂讲授:语言不是"写出来",而是"用起来"

学生最容易犯的错误是把通用语言当"术语表文档"。正确做法是:

  • 词汇表是"约定",但真正的落点是命名交流
  • 发现歧义(同名不同义)时,要么拆词,要么划边界(有界上下文)

最小可用词汇表模板

你需要的不多,但必须完整:

text 复制代码
术语:
定义:
边界(属于/不属于):
同义词(允许):
禁用词(避免混用):
反例(常见误解):
代码命名建议(类/方法/字段/事件/命令):
示例句(业务/代码各一句):

示例:把"创建订单"命名为"下单"

很多系统把接口叫 createOrder,但业务更常说"下单/提交订单"。这不是"语言洁癖",而是减少认知负担:

  • 命令:PlaceOrder
  • 事件:OrderPlaced
  • 聚合:Order
  • 用例(应用服务方法):placeOrder(...)

常见误区

  • 一个概念多种叫法:create/submit/place 混用,最终所有人都不确定差异
  • 用技术词代替业务词:把"订单取消"说成"updateStatus(3)"
  • 词汇表不维护:模型变了,语言没变,造成"旧词新义"

课堂练习(可评分)

给定一段业务描述,输出一个 8~12 条的词汇表,并满足:

  • 至少 3 个术语包含"禁用词/同义词"
  • 至少 3 个术语给出"代码命名建议"
  • 至少 2 个术语给出"反例(常见误解)"

自测题

  1. 为什么说通用语言是"模型驱动"的?
  2. "订单取消"和"订单作废"如果在业务上含义不同,你会怎么做?
  3. 词汇表更新后,哪些地方必须同步更新?

延伸阅读

参考资料索引:references.md

相关推荐
知兀2 分钟前
【MybatisPlus】后端用枚举类,数据库用tinyint,存在枚举类型转换
java
StockTV4 分钟前
印度股票实时数据 NSE和BSE的实时行情、K 线及指数数据
java·开发语言·spring boot·python
chaofan9804 分钟前
GPT-5.5 领衔 Image 2.0:像素级控制时代,AI 绘图告别开盲盒
开发语言·人工智能·python·gpt·自动化·api
User_芊芊君子6 分钟前
【OpenAI 把 AI 玩明白了】:自主推理 + 动态知识图谱,这 4 个技术突破要颠覆行业
java·人工智能·知识图谱
爱码小白25 分钟前
Python 异常处理 完整学习笔记
开发语言·python
c++之路39 分钟前
C++20概述
java·开发语言·c++20
Championship.23.2444 分钟前
Linux Top 命令族深度解析与实战指南
java·linux·服务器·top·linux调试
芝士就是力量啊 ೄ೨1 小时前
Python如何编写一个简单的类
开发语言·python
橘子海全栈攻城狮1 小时前
【最新源码】养老院系统管理A013
java·spring boot·后端·web安全·微信小程序
逻辑驱动的ken1 小时前
Java高频面试考点18
java·开发语言·数据库·算法·面试·职场和发展·哈希算法