使用函数式语言来建立领域模型
领域模型=代码=文档
如果说敏捷软件开发主张面对面沟通,通过快速迭代的手段,让有价值的软件尽早面向市场,从而适应快速变化的需求。
那么DDD则为敏捷开发过程中的沟通形式作出了进一步的补充,DDD让领域模型和代码以及文档之间画上了等号,主张让代码成为团队之间沟通和交流的途径。纵观DDD的所有环节,无一不是在打通领域专家和开发人员之间的沟通和交流,而代码无疑是最有效,最实时的共享模型。
DDD的精髓在于通过让开发人员理解领域,进而让开发人员使用编程语言建立一个跟领域专家脑海中一致的领域模型,使得该领域模型成为大家共享知识的途径,这将有效的减少不同利益相关者的沟通及交流,确保所有人都在解决同一个问题。
领域建模
领域建模是整个DDD环节中最最考验开发人员功底的一环,不同于传统的数据库建模技术,开发人员需要有很好的抽象能力,通过恰如其分的编程技术,将领域知识映射到一个代码模型中。
长期以来OO语言被认为是领域建模的首选,一些OO的技巧可以很好的用来抽象领域模型。而函数式语言则被普遍认为只能用来做数据处理,科学计算等。本文将为大家展示如何通过函数式编程语言进行领域建模,本文选用TypeScript编写实例,TypeScript类型系统完全满足函数式编程需求,当然本文也适用于其他拥有静态类型系统的函数式编程语言。
TypeScript的类型系统
实际上你只需要知道少量的知识就可以开始领域建模了,从这个角度来讲,实际上函数式类型系统更适合领域建模,从而让领域模型成为文档。
类型
各类编程语言在设计的时候就已经提供了类似string, bool, number
等简单类型(primitive),然而在真实世界里面,你还需要将这些类型组合成更大的类型,从而来映射现实世界。
在TypeScript中,type
关键字用来组合更大的类型:
type Name = {
firstName: string
middleName: string
lastName: string
}
上面类型的用途是显而易见的,除此之外type
还有起别名的用途,不要小瞧这个特性,他可以帮助你把领域知识记载在你的领域模型中,考虑下面的代码:
const timeToFly = 10
你能一眼看出这句代码代表的领域知识吗?也许不能,fly多久?查文档?No,你应该时刻告诉自己,代码等于文档。改进后的代码如下:
type Second = number
const timeToFly: Second = 10
Or类型
OO语言无法创建这种类型,在TypeScript,这种类型被称为联合
(Union Types),通过符号|
来创建,考虑下面的类型:
type Pet = Fish | Bird
Pet
是Fish
或者是Bird
类型。一般来说函数式语言都会有强大的模式匹配能力,来处理这种或
类型,然而受制于TypesScript没有模式匹配或者说能力很弱,通常情况下,会在类型里面添加一个字符串字面量, 从而来区分不同的类型, 在次不再细说。
And类型
在Typescript中,这种类型被称为交叉类型
(Intersection Types),通过符号&
来创建,考虑下面的类型:
type ABC = A & B & C
表示ABC类型包含所有A、B、C三个类型里面的属性。
定义函数类型
在TypeScript中,函数与其他类型没什么区别,也可以通过type
关键字来定义,例如:
type Add = (a: number) => (b: number) => number
Add
是一个函数,接收两个类型为number的类型a和b
,返回number。
通过代码来共享领域知识
type CreditCard = {
cardNo: string
firstName: string
middleName: string
lastName: string
contactEmail: Email
contactPhone: Phone
}
通过前面介绍的知识,我们很容易就可以写出上面的代码,用来描述CreditCard
这种支付方式。注意我们没有使用class
。
但这是一个靠谱的领域模型吗?如果不靠谱,它的问题在哪里?
这段代码最大的问题是他没有把本该拥有的领域知识记录在其中,我来试着问你几个问题:
问:middle name
可以为空吗?
答1:不清楚,也许需要查文档。
答2:也许可以吧?middle name
可以为null
。
为可空类型建模
在函数式编程语言中,可空类型被定义为Option
type Option<T> = T | null
一个简单的Option
type CreditCard = {
cardNo: string
firstName: string
middleName: Option<string>
lastName: string
contactEmail: Email
contactPhone: Phone
}
避免基本类型偏执(Primitive Obsession)
问:cardNo
可以用string来表示吗?如果是,它可以是任意字符串吗?firstName
可以是任意长度的字符串吗?很显然,你无法回答上面的问题,源于这个模型并没有包含有此类领域知识。
也许在编程语言里面,cardNo
可以用string表达,但是cardNo
在领域模型中,string
无法表达出cardNo
的领域知识。cardNo
是一个200
打头的19位字符串,name
是一个不超过50位的字符串,这样的领域信息可以通过type alias
来实现:
type CardNo = string
type Name50 = string
...
有了上面两个类型,你就有机会通过定义函数的方式,将cardNo
业务规则包含在领域模型中。
type GetCardNo = (cardNo: string) => CardNo
如果用户输入了一个20位的字符串,函数GetCardNo
返回什么?null?抛出异常?实际上函数式编程语言有比异常更加优雅的Error handling方式, 例如Either Monad或者Railway oriented programming。本文虽然不包含这类话题,但至少目前我们可以用Option来表示这个函数签名:
type GetCardNo = (cardNo: string) => Option<CardNo>
这个函数类型清晰的表达了整个验证过程,用户输入一个字符串, 返回一个CardNo类型,或者空。修改后的领域模型变成了这样:
type CreditCard = {
cardNo: Option<CardNo>
firstName: Name50
middleName: Option<string>
lastName: Name50
contactEmail: Email
contactPhone: Phone
}
于是,现在的代码拥有跟多的领域知识,丰富的类型还充当了单元测试的角色,例如,你永远都不会把一个email赋值给contactPhone,它们不是string, 它们代表不同的领域知识。
领域模型的原子性和聚合性
这个领域模型中的三个name可以分别修改吗?例如只修改middle name
?如果不可以,如何将这种原子性的修改知识包含在领域模型中?
实际上我们很容易就能把Name
和Contact
两个类型分离出来并加以组合:
type Name = {
firstName: Name50
middleName: Option<string>
lastName: Name50
}
type Contact = {
contactEmail: Email
contactPhone: Phone
}
type CreditCard3 = {
cardNo: Option<CardNo>
name: Name
contact: Contact
}
Make illegal states unrepresentable
在领域建模过程中,这是一条非常重要的原则,用通俗的话可以理解为:你建立的领域模型应该有尽可能多的静态检查和约束,让错误发生在编译时,而不是运行时,从而杜绝犯错误的机会。其实整个领域建模都是在遵循这个原则,例如上面的Email类型和Phone类型,为什么不用string来表示呢?因为string给与的领域知识不够,从而允许开发人员有了犯错误的机会。
让我们最后看一个例子,用来说明这条原则如何被应用在领域建模中。 上面领域模型中有一个contact类型,包含一个Email和Phone属性。支付成功后,系统可以通过这两个属性给用户发通知,由此延伸出来这样一条规则:用户必须至少填写一个Email或者一个Phone来接受支付消息。
首先,上面的领域模型是不匹配这条业务规则的,因为Email和Phone类型都是非空类型,意味着这两个属性都应该是必填项。
我们能不能把它俩都改为Option类型呢?
type Contact = {
contactEmail: Option<Email>
contactPhone: Option<Phone>
}
显然也不行,实际上就是违反了Make illegal states unrepresentable, 给与了代码犯错的机会,你的领域模型表达出了一种非法的状态,即Email和Phone都可以为空,你也许会说我的xxService做了验证呢,它俩绝对不会同时为空。对不起,我们希望我们的领域模型能够包含这种领域知识,至于xxService,跟领域模型无关。到底能否将这一规则表达在领域模型中吗?答案是肯定的,规则中有一个或
字,即我们可以通过Or类型(union)
来表达这种关系:
type OnlyContactEmail = Email
type OnlyContactPhone = Phone
type BothContactEmailAndPhone = Email & Phone
type Contact =
| OnlyContactEmail
| OnlyContactPhone
| BothContactEmailAndPhone
结束语
本文旨在通过函数式编程语言来指导领域建模,整个代码示例中没有出现类或者子类
,更不会出现abstract, bean等关键字
,衡量一个领域模型的好坏取决于
1)领域模型是否包含了尽可能多的领域知识,能否反映领域专家脑海中的业务模型
2)领域模型能否成为文档,进而成为所有人沟通和共享知识的途径
同时,一些语言,框架的”行话“应该越少越好,例如你在领域模型中创建了一个叫做AbstractContactBase
的类,除了增加复杂度,对共享领域模型这一目的帮助甚少。
实际上函数式编程语言的类型系统,不但能够帮助开发者建立一个丰富的领域模型,同时简单可组合的类型系统,也为代码即文档提供了基础。不可否认真实世界远比本文所描述的例子复杂,但是大部分复杂的部分,并不会出现在领域模型中,例如函数式编程中的各种”行话“,他们往往出现在数据请求的validation, 请求第三方,数据转化,持久化等实现阶段。在未来的文章中将会描述整个http请求到领域模型再到输出过程中如何通过函数式编程语言来实现。