REST与DDD

之前在为什么要使用MVC+REST+CQRS架构我曾经提出DDD是核心，REST是壳的观点，我想在这里详细谈谈我的思路。

今天正好看看到老外一篇博文Why REST is so important：按这里，他认为，REST的核心概念应该是Representional State Transfer，中文意思是将状态转移显现出来，该文举例：

Marcus是一个农民。他有一个牧场，有4头猪，12只鸡和3头牛。

那么模拟客户端与之交谈，那么我肯定首先询问牧场的状态：“状态？”
Marcus 回答：“有4头猪，12只鸡和3头牛”。

这是最简单的将状态显现的案例，Marcus用语句“有4头猪，12只鸡和3头牛”将他的牧场状态转给了我。

那么如何以REST方式让Marcus加两头牛到它的牧场呢？
我们经常会范的错误是，你会说：“Marcus, 请加两头牛到你的牧场”。
请注意，我们在这里转换了状态吗？没有，我们这里表达的是动词，有面向函数风格，但是这种表述方式其实是RPC( remote procedure call 远程过程调用)，这个过程就是：加两头牛到牧场。

Marcus会悲伤地回答: "400错误, Bad Request. 你是什么意思?"

那么让我们以REST方式请求，原来状态是：4头猪，12只鸡和3头牛，增加了两头牛的状态是：4头猪，12只鸡和3头牛。
那我就会说：“Marcus, 4头猪，12只鸡和5头牛, Please ”
Marcus: "正确!".
我: "Marcus, ...那么你现在状态是什么?". 
Marcus: " 4头猪，12只鸡和5头牛".
我: "Ahh, 很好"

这才是真正REST。

原文还提到，如果你希望以RPC调用，那么SOAP是一种RPC方式，但是很重量，性能差。

这里，我想补充的是，这个案例让我们明白REST是如何显现状态的，那么在通用需求中，我们如何表达显现状态呢？

也就是说，REST是将什么状态转移显现出来？首先，我们想到的是应该是将业务逻辑的状态显现出来，而DDD领域驱动设计就是分析设计业务逻辑的，那么，推理结果是，REST应该是将领域层聚合根实体的状态显现出来。

首先，我们看看DDD是如何对需求分析设计的，大致步骤如下：
1.找出需求中的上下文边界。
2.根据上下文切分成模块。
3.从每个上下文中划出聚合边界
4.确定每个聚合边界内的聚合根

其中聚合根的状态是业务逻辑状态的核心所在，REST作为一个接口壳，应该透明地将聚合根实体的状态显现给客户端，客户端通过接受用户发出的命令，透过REST来修改聚合根的实体状态，从而达到实现业务功能的结果。如下图：

下面以转账案例来说明REST+DDD的结合：

客户端向REST发出转账请求的REST应该怎么写？
1.先发帐号A的扣除命令
2.再发帐号B的增加命令
这种方式其实不是状态表达，而是函数方法调用，是动词，是一种RPC，而REST方式应该是针对状态进行发出命令。

那么关键问题是，在这里寻找什么状态？有一种方式：
1.查询帐号A余额状态是10元
2.发出请求帐号A余额状态是5元(扣除5元，剩余5元)
3.查询帐号B余额状态是20元
4.发出请求帐号B余额状态是25元(增加5元)

这样很符合上面的牧场的REST对话方式。但是问题来了：
如果客户端扣除了A帐号钱后，不申请B帐号，从第三步以后没有了，那么我们后端服务器业务逻辑就不一致了。

所以，根据DDD的聚合根用来维护聚合边界内一致性这个原则，显然，A帐号借出和B帐号贷入应该是借贷平衡的，这是基本财务规则约束，也就是一致性要求，是逻辑要求 。

如果我们这时进行DDD建模，会发现这里有一个聚合根实体：转账Transaction。

下面是REST+DDD：
1. 客户端先GET获得当前帐号余额状态

2.客户端发出转账的POST命令:
POST /transactions
注意，需要加入参数 from=1&to=2&amount=500.00
见：http://www.jdon.com/41716

3.第二步的POST命令直接递交到转账服务，transactionService.

在转账服务中，有二种实现方式：
1. DCI+面向函数风格，直接在转账服务的方法中实现，将源账户和目标帐号看成两个角色TransferMoneySourceAccount和TransferMoneyDestinationAccount，需要通过事务机制。见：http://www.jdon.com/37976

2.DDD聚合体+EventSourcing方式, 转账服务委托聚合根实现，TransactionAggregate作为聚合根实体，转账是这个实体的一个行为方法，转账命令到激活这个方法，在这个方法内部将产生一个转账事件。见：
http://simon-says-architecture.com/2013/03/07/modelling-accounting-ledger-event-driven/

http://simon-says-architecture.com/2013/03/22/modelling-accounting-ledger-event-driven-2/

一个REST的转账命令POST一般对应一个上游事件，一旦上游事件进入聚合根内部，变成很多事件流分支，这些事件流分支是改变了状态后发出的，因此必须被记录下来，出错回放才能重现状态转变历史。

var tx = new Transaction();
tx.Post(amount, fromAccount, toAccount);
transactionRepository.Store(tx);

这是调用Transaction这个聚合根的post方法。方法内部代码：

public void Post(decimal amount, string fromAccount, string toAccount)
{
   this.Apply(new AccountDebited(amount, fromAccount));
   this.Apply(new AccountCredited(amount, toAccount));
}

将转账命令(转账上游事件)分为两个事件，AccountDebited和AccountCredited，账户借款和账户贷款，这样保证借贷平衡。然后根据借贷状态切换，还有更多子状态，EventStore应该是这些和状态直接有关的事件，间接有关事件没有必要记录，这样在事件回放时才能重现状态真实改变历史。

总结，上面总体架构涉及到是：REST+CQRS+DDD Aggregate + Domain Events + EventSourcing

https://www.jdon.com/45622