复杂度应对之道 - 阿里的COLA应用架构

最近阿里开源了一个COLA架构,COLA是Clean Object-Oriented and Layered Architecture的缩写,代表“整洁面向对象分层架构”,也叫“可乐”架构。

前言

从业这么多年,接触过银行的应用,Apple的应用,eBay的应用和现在阿里的应用,虽然分属于不同的公司,使用了不同的架构,但有一个共同点就是都很复杂。导致复杂性的原因有很多,如果从架构的层面看,主要有两点,一个是架构设计过于复杂,层次太多能把人绕晕。另一个是根本就没架构,ServiceImpl作为上帝类包揽一切,一杆捅到DAO(就简单场景而言,这种Transaction Script也还凑合,至少实现上手都快。

这种人为的复杂性导致系统越来越臃肿,越来越难维护,酱缸的老代码发出一阵阵恶臭,新来的同学,往往要捂着鼻子抠几天甚至几个月,才能理清系统和业务脉络,然后又一头扎进各种bug fix,业务修补的恶性循环中,暗无天日!
image.png

CRM作为阿里最老的应用系统,自然也逃不过这样的宿命。不甘如此的我们开始反思到底是什么造成了系统复杂性? 我们到底能不能通过架构来治理这种复杂性?基于这个出发点,我们团队开始了一段非常有意义的架构重构之旅(Redefine the Arch),期间我们参考了SalesForce,TMF2.0,汇金和盒马的架构,从他们那里汲取了很多有价值的输入,再结合我们自己的思考最终形成了我们自己现在的基于扩展点+元数据+CQRS+DDD的应用架构。该架构的特点是可扩展性好,很好的贯彻了OO思想,有一套完整的规范标准,并采用了CQRS和领域建模技术,在很大程度上可以降低应用的复杂度。本文主要阐述了我们的思考过程和架构实现,希望能对在路上的你有所帮助。

复杂性来自哪里

经过我们分析、讨论,发现造成现在系统异常复杂的罪魁祸首主要来自以下四个方面:

可扩展性差

对于只有一个业务的简单场景,并不需要扩展,问题也不突出,这也是为什么这个点经常被忽略的原因,因为我们大部分的系统都是从单一业务开始的。但是随着支持的业务越来越多,代码里面开始出现大量的if-else逻辑,这个时候代码开始有坏味道,没闻到的同学就这么继续往上堆,闻到的同学会重构一下,但因为系统没有统一的可扩展架构,重构的技法也各不相同,这种代码的不一致性也是一种理解上的复杂度。

久而久之,系统就变得复杂难维护。像我们CRM应用,有N个业务方,每个业务方又有N个租户,如果都要用if-else判断业务差异,那简直就是惨绝人寰。其实这种扩展点(Extension Point),或者叫插件(Plug-in)的设计在架构设计中是非常普遍的。比较成功的案例有eclipse的plug-in机制,集团的TMF2.0架构。还有一个扩展性需求就是字段扩展,这一点对SaaS应用尤为重要,因为有很多客户定制化需求,但是我们很多系统也没有统一的字段扩展方案。

面向过程

是的,不管你承认与否,很多时候,我们都是操着面向对象的语言干着面向过程的勾当。面向对象不仅是一个语言,更是一种思维方式。在我们追逐云计算、深度学习、区块链这些技术热点的时候,静下心来问问自己我们是不是真的掌握了OOD;在我们强调工程师要具备业务Sense,产品Sense,数据Sense,算法Sense,XXSense的时候,是不是忽略了对工程能力的要求。

据我观察大部分工程师(包括我自己)的OO能力还远没有达到精通的程度,这种OO思想的缺乏主要体现在两个方面,一个是很多同学不了解SOLID原则,不懂设计模式,不会画UML图,或者只是知道,但从来不会运用到实践中;另一个是不会进行领域建模,关于领域建模争论已经很多了,我的观点是DDD很好,但不是银弹,用和不用取决于场景。

但不管怎样,请你抛开偏见,好好的研读一下Eric Evans的《领域驱动设计》,如果有认知升级的感悟,恭喜你,你进阶了。我个人认为DDD最大的好处是将业务语义显现化,把原先晦涩难懂的业务算法逻辑,通过领域对象(Domain Object),统一语言(Ubiquitous Language)将领域概念清晰的显性化表达出来。相信我,这种表达带来的代码可读性的提升,会让接手你代码的人对你心怀感恩的。借用Abelson的一句话是

Programs must be written for people to read, and only incidentally for machines to execute

所以强烈谴责那些不顾他人感受的编码行为。

分层不合理

俗话说的好,All problems in computer science can be solved by another level of indirection(计算机科学领域的任何问题都可以通过增加一个间接的中间层来解决),怎样? 是不是感受到间接层的强大了。分层最大的好处就是分离关注点,让每一层只解决该层关注的问题,从而将复杂的问题简化,起到分而治之的作用。

我们平时看到的MVC,pipeline,以及各种valve的模式,都是这个道理。好吧,那是不是层次越多越好,越灵活呢。当然不是,就像我开篇说的,过多的层次不仅不能带来好处,反而会增加系统的复杂性和降低系统性能。就拿ISO的网络七层协议来说,你这个七层分的很清楚,很好,但也很繁琐,四层就够了嘛。再比如我前面提到的过度设计的例子,如果没记错的话应该是Apple的Directory Service应用,整个系统有7层之多,把什么validator,assembler都当成一个层次来对待,能不复杂么。所以分层太多和没有分层都会导致系统复杂度的上升,因此我们的原则是不可以没有分层,但是只分有必要的层

随心所欲

随心所欲是因为缺少规范和约束。这个规范非常非常非常的重要(重要事情说三遍),但也是最容易被无视的点,其结果就是架构的consistency被严重破坏,代码的可维护性将急剧下降,国将不国,架构将形同虚设。

有同学会说不就是个naming的问题么,不就是个分包的问题么,不就是2个module还是3个module的问题么,只要功能能跑起来,这些问题都是小问题。是的,对于这些同学,我再丢给你一句名言“Just because you can, doesn’t mean you should”

就拿package来说,它不仅仅是一个放一堆类的地方,更是一种表达机制,当你将一些类放到Package中时,相当于告诉下一位看到你设计的开发人员要把这些类放在一起考虑。理想很丰满,现实很骨感,规范的执行是个大问题,最好能在架构层面进行约束,例如在我们架构中,扩展点必须以ExtPt结尾,扩展实现必须以Ext结尾,你不这么写就会给你抛异常。

但是架构的约束毕竟有限,更多的还是要靠Code Review,暂时没想到什么更好的办法。这种对架构约束的近似严苛follow,确保了系统的consistency,最终形成了一个规整的收纳箱(如下图所示),就像我和团队说的,我们在评估代码改动点时,应该可以像Hash查找一样,直接定位到对应的module,对应的package里面对应的class。而不是到“一锅粥”里去慢慢抠。
image.png
本章节最后,上一张我们老系统中比较典型的代码,也许你可以从中看到你自己应用的影子。
sample.png

复杂性应对之道

知道了问题所在,接下来看下我们是如何一个个解决这些问题的。回头站在山顶再看这些解决方案时,每个都不足为奇,但当你还“身在此山中”的时候,这个拨开层层迷雾,看到山的全貌的过程,并不是想象的那么容易。庆幸的是我团队在艰难跋涉之后,终有所收获。

扩展点设计

扩展点的设计思想主要得益于TMF2.0的启发,其实这种设计思想也一直在用,但都是在局部的代码重构和优化,比如基于Strategy Pattern的扩展,但是一直没有找到一个很好的固化到框架中的方法。直到毗卢到团队分享,给了我们两个关键的提示,一个是业务身份识别,用他的话说,如果当时TMF1.0如果有身份识别的话,就没有TMF2.0什么事了;另一个是抽象的扩展点机制。

身份识别

业务身份识别在我们的应用中非常重要,因为我们的CRM系统要服务不同的业务方,而且每个业务方又有多个租户。比如中供销售,中供拍档,中供商家都是不同的业务方,而拍档下的每个公司,中供商家下的每个供应商又是不同的租户。所以传统的基于多租户(TenantId)的业务身份识别还不能满足我们的要求,于是在此基础上我们又引入了业务码(BizCode)来标识业务。所以我们的业务身份实际上是(BizCode,TenantId)二元组。在每一个业务身份下面,又可以有多个扩展点(ExtensionPoint),所以一个扩展点实现(Extension)实际上是一个三维空间中的向量。借鉴Maven Coordinate的概念我给它起了个名字叫扩展坐标(Extension Coordinate),这个坐标可以用(ExtensionPoint,BizCode,TenantId)来唯一标识
image.png
有了业务身份这个关键抽象之后,通过身份来获取扩展实现的过程就变得水到渠成了,具体流程如下
image.png

扩展点

扩展点的设计是这样的,所有的扩展点(ExtensionPoint)必须通过接口申明,扩展实现(Extension)是通过Annotation的方式标注的,Extension里面使用BizCode和TenantId两个属性用来标识身份,框架的Bootstrap类会在Spring启动的时候做类扫描,进行Extension注册,在Runtime的时候,通过TenantContext来选择要使用的Extension。TenantContext是通过Interceptor在调用业务逻辑之前进行初始化的。整个过程如下图所示:
image.png

实例展示

比如在一个CRM系统里,客户要添加联系人Contact是一个,但是在添加联系人之前,我们要判断这个Contact是不是已经存在了,如果存在那么就不能添加了。不过在一个支持多业务的系统里面,可能每个业务的冲突检查都不一样,这是一个典型的可以扩展的场景。那么在SOFA框架中,我们可以这样去做。

1、定义扩展点

1
2
3
4
5
6
7
8
9
10
public interface ContactConflictRuleExtPt extends RuleI, ExtensionPointI {
/**
* 查询联系人冲突
*
* @param contact 冲突条件,不同业务会有不同的判断规则
* @return 冲突结果
*/
public boolean queryContactConflict(ContactE contact);

}

2、实现业务的扩展实现

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
@Extension(bizCode = BizCode.ICBU)
public class IcbuContactConflictRuleExt implements ContactConflictRuleExtPt {

@Autowired
private RepeatCheckServiceI repeatCheckService;
@Autowired
private MemberMappingQueryTunnel memberMappingQueryTunnel;
private Logger logger = LoggerFactory.getLogger(getClass());

/**
* 查询联系人冲突
*
* @param contact 冲突条件,不同业务会有不同的判断规则
* @return 冲突结果
*/
@Override
public boolean queryContactConflict(ContactE contact) {

Set<String> emails = contact.getEmail();

//具体的业务逻辑

return false;
}

3、在领域实体中调用扩展实现

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
@ToString
@Getter
@Setter
public class CustomerE extends Entity {
/**
* 公司ID
*/
private String companyId;
/**
* 公司(客户)名字
*/
private String companyName;
/**
* 公司(客户)英文名字
*/
private String companyNameEn;
/**
* 给客户添加联系人
* @param contact
*/

public void addContact(ContactE contact,boolean checkConflict){
// 业务检查
if (checkConflict) {
ruleExecutor.execute(ContactConflictRuleExtPt.class, p -> p.queryContactConflict(contact));
}
contact.setCustomerId(this.getId());
contactRepository.create(contact);
}
}

在上面的代码中,框架在runtime的时候之所以可以找到对应的扩展实现,主要是靠@Extension(bizCode = BizCode.ICBU)这个Annotation, 因为在系统启动时,Bootstrap会扫描所有的扩展实现并注册并缓存到HashMap里面。

面向对象

面向对象不仅是一种编程语言,更是一种思维模式。所以看到很多简历里面写“精通Java”,没写“精通OO”,也算是中肯,因为会Java语言并不代表你就掌握了面向对象思维(当然,精通Java也不是件易事),要想做到精通,必须要对OO设计原则,模式,方法论有很深入的理解,同时要具备非常好的业务理解力和抽象能力,才能说是精通,这种思维的训练是一个长期不断累积的过程,我也在路上,下面是我对面向对象设计的两点体会:

SOLID

SOLID是单一职责原则(SRP),开闭原则(OCP),里氏替换原则(LSP),接口隔离原则(ISP)和依赖倒置原则(DIP)的缩写,原则是要比模式(Design Pattern)更基础更重要的指导准则,是面向对象设计的Bible。深入理解后,会极大的提升我们的OOD能力和代码质量。

单一职责

比如我在开篇提到的ServiceImpl上帝类的例子,很明显就是违背了单一职责,你一个类把所有事情都做了,把不是你的功能也往自己身上揽,所以你的内聚性就会很差,内聚性差将导致代码很难被复用,不能复用,只能复制(Repeat Yourself),其结果就是一团乱麻。
image.png

依赖倒置

再比如在java应用中使用logger框架有很多选择,什么log4j,logback,common logging等,每个logger的API和用法都稍有不同,有的需要用isLoggable()来进行预判断以便提高性能,有的则不需要。对于要切换不同的logger框架的情形,就更是头疼了,有可能要改动很多地方。产生这些不便的原因是我们直接依赖了logger框架,应用和框架的耦合性很高。

怎么破? 遵循下依赖倒置原则就能很容易解决,依赖倒置就是你不要直接依赖我,你和我都同时依赖一个接口(所以有时候也叫面向接口的编程),这样我们之间就解耦了,依赖和被依赖方都可以自由改动了。
image.png
在我们的框架设计中,这种对SOLID的遵循也是随处可见,Service Facade设计思想来自于单一职责SRP;扩展点设计符合关闭原则OCP;日志设计,以及Repository和Tunnel的交互就用到了依赖倒置DIP原则,这样的点还有很多,就不一一枚举了。当然了,SOLID不是OO的全部。抽象能力,设计模式,架构模式,UML,以及阅读优秀框架源码(我们的Command设计就是参考了Activiti的Command)也都很重要。只是SOLID更基础,更重要,所以我在这里重点拿出来讲一下,希望能得到大家的重视。

领域建模

准确的说DDD不是一个架构,而是思想和方法论,关于如何领域建模的详细请参看我另一篇文章领域建模。所以在架构层面我们并没有强制约束要使用DDD,但对于像我们这样的复杂业务场景,我们强烈建议使用DDD代替事务脚本(TS: Transaction Script)。因为TS的贫血模式,里面只有数据结构,完全没有对象(数据+行为)的概念,这也是为什么我们叫它是面向过程的原因。

然而DDD是面向对象的,是一种知识丰富的设计(Knowledge Rich Design),怎么理解?,就是通过领域对象(Domain Object),领域语言(Ubiquitous Language)将核心的领域概念通过代码的形式表达出来,从而增加代码的可理解性。这里的领域核心不仅仅是业务里的“名词”,所有的业务活动和规则如同实体一样,都需要明确的表达出来

业务语义显性化

例如前面典型代码图中所展示的,分配策略(DistributionPolicy)你把它隐藏在一堆业务逻辑中,没有人知道它是干什么的,也不会把它当成一个重要的领域概念去重视。但是你把它抽出来,凸显出来,给它一个合理的命名叫DistributionPolicy,后面的人一看就明白了,哦,这是一个分配策略,这样理解和使用起来就容易的多了,添加新的策略也更方便,不需要改原来的代码了。所以说好的代码不仅要让程序员能读懂,还要能让领域专家也能读懂

通用语言

再比如在CRM领域中,公海和私海是非常重要领域概念,是用来做领地划分的,每个销售人员只能销售私海(自己领地)内的客户,不能越界。但是在我们的代码中却没有这两个实体(Entity),也没有相应的语言和其对应,这就导致了领域专家描述的,和我们日常沟通的,以及我们模型和代码呈现的都是相互割裂的,没有关联性。这就给后面系统维护的同学造成了极大的困扰,因为所有关于公海私海的操作,都是散落着各处的repeat itself的逻辑代码,导致看不懂也没办法维护。

采用领域建模以后,我们在系统中定义了清晰的机会(Opportunity),公海(PublicSea)和私海(PrivateSea)的Entity,相应的行为和业务逻辑也被封装到对应的领域实体身上,让代码充分展现业务语义,让曾经散落在各处找到了业务代码找到了属于它们自己的家,它们应该在的地方。相信我,这种代码可读性的提升,会让后来接手系统的同学对你心怀感恩。下面就是我们重构后Opportunity实体的代码,即使你对CRM领域不了解,是不是也很容易看懂:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
public class OpportunityE extends Entity{
private String customerId;
private String ownerId;
private OpportunityType opportunityType;

//是否可以捡入
public boolean isCanPick(){
return "y".equals(canPick) && opportunityStatus == OpportunityStatus.NEW || opportunityStatus == OpportunityStatus.ACTIVE;
}

//是否可以开放
public boolean isCanOpen(){
return (opportunityStatus == OpportunityStatus.NEW || opportunityStatus == OpportunityStatus.ACTIVE)
&& CommonUtils.isNotEmpty(ownerId);
}

//捡入机会到私海
public void pickupTo(PrivateSeaE privateSea){
privateSea.addOpportunity(this);
}

//开放到公海
public void openTo(PublicSea publicSea){
publicSea.addOpportunity(this);
}

//机会转移
public void transfer(PrivateSeaE from, PrivateSeaE to){
from.removeOpportunity(this);//从一个私海移出
to.addOpportunity(this);//添加到另一个私海中
}

如果整个系统都采用DDD,不仅代码的可读性和系统的可维护性会大大提升,系统之间的边界和交互也会更加的清晰。下图是CRM域的简要领域模型,基本上可以完整的表达CRM领域的核心概念
image.png

关于CQRS简要说一下,我们只使用了Command,Query分离的概念,我们提倡使用Domain Event,但是认为Event Sourcing是可选项。关于Command的实现我们使用了命令模式,因此以前的ServiceImpl的职责就只是一个Facade,所有的处理逻辑都在CommandExecutor里面。

分层设计

这一块的设计比较直观,整个应用层划分为三个大的层次,分别是App层,Domain层和Infrastructure层。

  • App层主要负责获取输入,组装context,做输入校验,发送消息给领域层做业务处理,监听确认消息,如果需要的话使用MetaQ进行消息通知;
  • Domain层主要是通过领域服务(Domain Service),领域对象(Domain Object)的交互,对上层提供业务逻辑的处理,然后调用下层Repository做持久化处理;
  • Infrastructure层主要包含Repository,Config,Common和message,Repository负责数据的CRUD操作,这里我们借用了盒马的数据通道(Tunnel)的概念,通过Tunnel的抽象概念来屏蔽具体的数据来源,来源可以是MySQL,NoSql,Search,甚至是HSF等;Config负责应用的配置;Common是一写工具类;负责message通信的也应该放在这一层。
    image.png
    这里需要注意的是从其他系统获取的数据是有界上下文(Bounded Context)下的数据,为了弥合Bounded Context下的语义Gap,通常有两种方式,一个是用大领域(Big Domain)把两边的差异都合起来,另一个是增加防腐层(Anticorruption Layer)做转换。什么是Bounded Context? 简单阐述一下,就是我们的领域概念是有作用范围的(Context)的,例如摇头这个动作,在中国的Context下表示NO,但是在印度的Context下却是YES。

规范设计

整洁的代码就像开篇提到的收纳整洁的玩具柜,和玩具收纳一样,需要做到以下两点:

放对位置

东西不要乱放,我们的每一个组件(Module),每一个包(Package)都有明确的职责定义和范围,不可以放错,例如extension包就只是用来放扩展实现的,不允许放其他东西,而Interceptor包就只是放拦截器的,validator包就只是放校验器的。我们的主要组件如下图:
image.png
组件里面的Package如下图:
image.png

贴好标签

东西放在合适位置后还要贴上合适的标签,也就是要按照规范合理命名,例如我们架构里面和数据有关的Object,主要有Client Object,Domain Object和Data Object,Client Object是放在二方库中和外部交互使用的DTO,其命名必须以CO结尾,相应的Data Object主要是持久层使用的,命名必须以DO结尾。

这个类名应该是自明的(self-evident),也就是看到类名就知道里面是干了什么事,这也就反向要求我们的类也必须是单一职责的(Single Responsibility)的,如果你做的事情不单纯,自然也就很难自明了。如果我们Class Name是自明的,Package Name是自明的,Module Name也是自明的,那么我们整个应用系统就会很容易被理解,看起来就会很舒服,维护效率会提高很多。除了组件和包的命名规范以外,我们对类、方法名和错误码等都做了相关规定。

类名约定

image.png

方法名约定

从某种意义上来说,任何的业务操作,落到数据的层面,都是对数据的CRUD(增删改查),因此在写业务代码的时候,会经常碰到关于CRUD的命名,就拿查询来说,fetch, retrieve, get, find, query等等都能表示查询的意思,为了命名的一致性和统一性,为了保证每个概念对应一个词,我们有必要对CRUD的命名做一个约定。

比如,在SOFA框架中,我们就对CRUD的命名做了如下约定:

CRUD操作 方法名约定
新增 create
添加 add
删除 remove(App和Domain层),delete(Infrastructure层)
修改 update
查询(返回单个结果) get
查询(返回多个结果) list
分页查询 page
统计 count

业务命名最好不用直接用CRUD,除非其行为有非常强的CRUD语义,比如用addContact表示添加联系人,removeContact表示删除联系人是可以接受的。但是如果你用createOrder和deleteOrder来表示下单和取消订单是不合适的,在业务层,更贴切的命名应该是placeOrder和cancelOrder。

当然在Infrastructure层,比如OrderDAO,你还是应该采用CRUD的命名方式,用createOrder和deleteOrder来表示对订单数据的创建和删除。

Tips:在业务层,尽量避免CRUD,努力找到更好的业务词汇来表达业务语义,如果非用不可,请使用约定好的CRUD命名。

错误码约定

异常主要分为系统异常和业务异常,系统异常是指不可预期的系统错误,如网络连接,服务调用超时等,是可以retry的;而业务异常是指有明确业务语义的错误,再细分的话,又可以分为参数异常和业务逻辑异常,参数异常是指用户过来的请求不准确,逻辑异常是指不满足系统约束,比如客户已存在。业务异常是不需要retry的。

我们的错误码主要有3部分组成:类型+场景+自定义标识

错误类型 错误码约定 举例
参数异常 P_XX_XX P_CAMPAIGN_NameNotNull: 运营活动名不能为空
业务异常 B_XX_XX B_CAMPAIGN_NameAlreadyExist: 运营活动名已存在
系统异常 S_XX_ERROR S_DATABASE_ERROR: 数据库错误

Domain Event约定

Domain Event(领域事件),是领域实体发生状态变化后,向外界publish出来的事件。
该事件既可以在当前的Bounded Context下面被消费,也可以被其它Bounded Context消费。

其命名规则是:领域名称+动词的一般过去式+Event

这里的动词的一般过去式,非常关键,因为在语义上表达的是发生过的事情,因为Event总是在动作发生后再发出的。下面是几个举例:

  1. CustomerCreatedEvent,表示客户创建后发出的领域事件。
  2. OpportunityTransferedEvent,表示机会转移后发出的领域事件。
  3. LeadsCreatedEvent,表示线索创建后发出的领域事件。

测试约定

从开发的视角来看,主要是两方面的测试,一个是单元测试,一个是基于command的集成测试。

单元测试,主要是针对Domain层的业务逻辑测试,有下面3个约定:

  1. 测试粒度要小,通常是业务方法,其scope不要超过一个类。
  2. 要稳定,要快,使用mock,不要对外部环境有依赖。
  3. 放在Domain的test里面,命名方式为Entity + Test,例如CustomerTest, ContactTest, OpportunityTest

案例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
@RunWith(MockitoJUnitRunner.class)
public class CustomerTest {
@InjectMocks
private IcbuCustomerE customerE = new IcbuCustomerE();

@Mock
private CustomerSearchTunnel customerSearchTunnel;

@Test
public void testIsCustomerAailableForPrivateSea(){
//没有业务员
PvgContext.set("","","","");
Assert.assertFalse(customerE.isAvailableForPrivateSea());

//是"删除客户"落入公海
PvgContext.set("121212","","","");
customerE.setCustomerGroup(CustomerGroup.AliCrmCustomerGroup.CANCEL_GROUP);
Assert.assertFalse(customerE.isAvailableForPrivateSea());

//可以捡入私海
PvgContext.set("121212","","","");
customerE.setCustomerGroup(CustomerGroup.AliCrmCustomerGroup.ENQUIRY_GROUP);
Assert.assertTrue(customerE.isAvailableForPrivateSea());
}

集成测试,主要是针对Command的业务流程测试,有下面两个约定:

  1. 每个Command,以及分支场景必须要有集成测试覆盖。
  2. 不需要mock,依赖日常环境。
  3. 放在start的test里面,命名方式为XXXCmd + Test,例如IcbuLeadsAddCmdTest,CustomerPickupCmdTest

案例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
public class IcbuLeadsAddCmdTest {
@Autowired
protected LeadsRepository leadsRepository;

@Autowired
private CommandBusI commandBus;

@Test
public void testLeadsExistWithNoCustomer(){
//1. Prepare
IcbuLeadsAddCmd cmd = getIcbuIMLeadsAddCmd();
String tenantId = "cn_center_10002404";
LeadsE leadsE = leadsRepository.getLeads(tenantId, cmd.getContactId());
if(leadsE != null) {
leadsE.setCustomerId(null);
leadsRepository.updateCustomerId(leadsE);
}

//2. Execute
commandBus.send(cmd);

//3. Check
leadsE = leadsRepository.getLeads(tenantId, cmd.getContactId());
Assert.assertEquals(leadsE.getCustomerId(), "179001");
}

COLA应用架构

经过上面的长篇大论,我希望我把我们的架构理念阐述清楚了,最后再从整体上看下我们的架构吧。我讲这个架构命名为COLA,全称是Clean Object-oriented and Layered Architecture,是一个整洁的,面向对象的,分层的,可扩展的应用架构,可以帮助降低复杂应用场景的系统熵值,提升系统开发和运维效率。
image.png
目前COLA框架已经开源,要阅读源码或直接在项目中使用COLA,请移步:https://github.com/alibaba/COLA

整体架构

我们的架构原则很简单,即在高内聚,低耦合,可扩展,易理解大的指导思想下,尽可能的贯彻OO的设计思想和原则。我们最终形成的架构是集成了扩展点+元数据+CQRS+DDD的思想,关于元数据前面没怎么提到,这里稍微说一下,对于字段扩展,简单一点的解决方案就是预留扩展字段,复杂一点的就是使用元数据引擎。使用元数据的好处是不仅能支持字段扩展,还提供了丰富的字段描述,等于是为以后的SaaS化配置提供了可能性,所以我们选择了使用元数据引擎。和DDD一样,元数据也是可选的,如果对没有字段扩展的需求,就不要用。最后的整体架构图如下:
image.png

提效工具

Archetype

因为框架包含了5个Module,20+的Package,如果手动创建的话很费时,而且很容易出错,所以创建了这个Archetype,可以一键构建框架的所有Artifacts,使用时,只需要将下面的命令中的demo替换成自己应用的名字即可:

1
mvn archetype:generate  -DgroupId=com.alibaba.sample -DartifactId=demo -Dversion=1.0.0-SNAPSHOT -Dpackage=com.alibaba.sample -DarchetypeArtifactId=cola-framework-archetype -DarchetypeGroupId=com.alibaba.cola -DarchetypeVersion=1.0.0-SNAPSHOT

测试容器

不管你是不是TDD吧,写几行代码,然后本地跑下测试验证一下总是个不错的习惯。因为代码还是热的,出错也容易定位。

但是本地启动PandoraBoot可不是个省心的事,我这台2.3G双核平均也要4分钟,严重的影响了效率。所以开发了这个工具,就是等PandoraBoot启动后,将线程Hold住,然后通过Console控制台输入要测试的方法或者类。使用这个工具很简单:

  1. 依赖COLA框架
  2. 使用TestApplication启动应用
1
2
3
4
5
6
7
public class TestApplication {
public static void main(String[] args) {
PandoraBootstrap.run(args);
SpringApplication.run(Application.class, args);
TestsContainer.start();//启动测试容器,避免重复启动PandoraBoot
}
}

本文转自COLA架构的设计思想和原理