Giters

shell22 / enode

DDD应用框架

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

enode

enode是一个基于【DDD】【CQRS】【ES】【EDA】【In-Memory】架构风格的应用框架

框架特色

  • 一个DDD开发框架，完美支持基于六边形架构**开发
  • 实现CQRS架构**，解决CQRS架构的C端的高并发写的问题，以及CQ两端数据同步的顺序性保证和幂等性问题；
  • 聚合根常驻内存（In-Memory Domain Model），可以完全以OO的方式来设计实现聚合根，不必为ORM的阻抗失衡而烦恼；
  • 聚合根的处理基于Command Mailbox, Event Mailbox的**，类似Actor Model, Actor Mailbox
  • Group Commit Domain event
  • 基于聚合根ID+事件版本号的唯一索引，实现聚合根的乐观并发控制
  • 通过聚合根ID对命令或事件进行路由，做到最小的并发冲突、最大的并行处理
  • 架构层面严格规范了开发人员该如何写代码，和DDD开发紧密结合，严格遵守聚合内强一致性、聚合之间最终一致性的原则
  • 实现CQRS架构，支持Command结果的返回；支持C端完成后立即返回Command的结果，也支持CQ两端都完成后才返回Command的结果，同时框架保证了Command的幂等处理
  • 先进的Saga机制，以事件驱动的流程管理器（Process Manager）的方式支持一个用户操作跨多个聚合根的业务场景，如订单处理，从而避免分布式事务的使用
  • 基于ES（Event Sourcing）的**持久化C端的聚合根的状态，让C端的数据持久化变得通用化，具有一切ES的优点
  • 将并发写降低到最低，从而做到最大程度的并行、最大的吞吐量；
  • 通过基于分布式消息队列横向扩展的方式实现系统的可伸缩性（基于队列的动态扩容/缩容）
  • enode实现了CQRS架构面临的大部分技术问题，让开发者可以专注于业务逻辑和业务流程的开发，而无需关心纯技术问题

系统设计

enode执行过程

注意点

ICommandService sendAsync 和 executeAsync的区别

sendAsync只关注发送消息的结果 executeAsync发送消息的同时，关注命令的返回结果，返回的时机如下：

  • CommandReturnType.CommandExecuted：Command执行完成，Event发布成功后返回结果
  • CommandReturnType.EventHandled：Event处理完成后才返回结果

event使用哪个订阅者发送处理结果

event的订阅者可能有很多个，所以enode只要求有一个订阅者处理完事件后发送结果给发送命令的人即可，通过AbstractDomainEventListener中sendEventHandledMessage参数来设置是否发送，最终来决定由哪个订阅者来发送命令处理结果

ICommandHandler和ICommandAsyncHandler区别

ICommandHandler是为了操作内存中的聚合根的，所以不会有异步操作，但后来ICommandHandler的Handle方法也设计为了HandleAsync了，目的是为了异步到底，否则异步链路中断的话，异步就没效果了 而ICommandAsyncHandler是为了让开发者调用外部系统的接口的，也就是访问外部IO，所以用了Async ICommandHandler，ICommandAsyncHandler这两个接口是用于不同的业务场景，ICommandHandler.handleAsync方法执行完成后，框架要从context中获取当前修改的聚合根的领域事件，然后去提交。而ICommandAsyncHandler.handleAsync方法执行完成后，不会有这个逻辑，而是看一下handleAsync方法执行的异步消息结果是什么，也就是IApplicationMessage。

目前已经删除了 ICommandAsyncHandler，统一使用ICommandHandler来处理，异步结果 放在context中

使用说明

聚合根

聚合根需要定义一个无参构造函数，因为聚合根初始化时使用了

aggregateRootType.getDeclaredConstructor().newInstance();

编程方式

新增了三个注解，系统限定了只扫描@Command和@Event标识的类，执行的方法上需要添加@Subscribe注解

  • @Command
  • @Event
  • @Subscribe

消息

发送命令代码

        CompletableFuture<CommandResult> future = commandService.executeAsync(createNoteCommand, CommandReturnType.EventHandled);

消费命令消息

@Command
public class CreateNoteCommandHandler {
    /**
     * Handle the given aggregate command.
     */
    @Subscribe
    public void handleAsync(ICommandContext context, CreateNoteCommand command) {
        Note note = new Note(command.getAggregateRootId(), command.getTitle());
        context.add(note);
    }
}

领域事件消费

@Event
public class NoteEventHandler {
    @Subscribe
    public AsyncTaskResult handleAsync(NoteTitleChanged evnt) {
        System.out.println(String.format("Note denormalizered, title：%s, Version: %d", evnt.getTitle(), evnt.version()));
        return AsyncTaskResult.Success;
    }
    @Subscribe
    public AsyncTaskResult handleAsync(NoteTitleChanged2 evnt) {
        System.out.println(String.format("Note denormalizered, title：%s, Version: %d", evnt.getTitle(), evnt.version()));
        return AsyncTaskResult.Success;
    }
}

启动配置

enode启动配置

    @Bean(initMethod = "start", destroyMethod = "shutdown")
    public CommandResultProcessor commandResultProcessor() {
        CommandResultProcessor processor = new CommandResultProcessor(6000);
        return processor;
    }
    @Bean(initMethod = "init")
    public ENodeBootstrap eNodeBootstrap() {
        ENodeBootstrap bootstrap = new ENodeBootstrap();
        bootstrap.setPackages(Lists.newArrayList("org.enodeframework.samples"));
        return bootstrap;
    }

数据源选择

MySQL

需要下面两张表来存储事件

CREATE TABLE `EventStream`
(
    `Sequence`              BIGINT AUTO_INCREMENT NOT NULL,
    `AggregateRootTypeName` VARCHAR(256)          NOT NULL,
    `AggregateRootId`       VARCHAR(36)           NOT NULL,
    `Version`               INT                   NOT NULL,
    `CommandId`             VARCHAR(36)           NOT NULL,
    `CreatedOn`             DATETIME              NOT NULL,
    `Events`                MEDIUMTEXT            NOT NULL,
    PRIMARY KEY (`Sequence`),
    UNIQUE KEY `IX_EventStream_AggId_Version` (`AggregateRootId`, `Version`),
    UNIQUE KEY `IX_EventStream_AggId_CommandId` (`AggregateRootId`, `CommandId`)
) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4;
CREATE TABLE `PublishedVersion`
(
    `Sequence`              BIGINT AUTO_INCREMENT NOT NULL,
    `ProcessorName`         VARCHAR(128)          NOT NULL,
    `AggregateRootTypeName` VARCHAR(256)          NOT NULL,
    `AggregateRootId`       VARCHAR(36)           NOT NULL,
    `Version`               INT                   NOT NULL,
    `CreatedOn`             DATETIME              NOT NULL,
    PRIMARY KEY (`Sequence`),
    UNIQUE KEY `IX_PublishedVersion_AggId_Version` (`ProcessorName`, `AggregateRootId`, `Version`)
) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4;

MQ配置启动

多选一

Kafka

https://kafka.apache.org/quickstart

bin/zookeeper-server-start.sh config/zookeeper.properties
bin/kafka-server-start.sh config/server.properties

RocketMQ

https://rocketmq.apache.org/docs/quick-start/ 启动RocketMQ服务

nohup sh bin/mqnamesrv &
nohup sh bin/mqbroker -n 127.0.0.1:9876 &

command-web启动

  • CQRS架构中的Command端应用

主要用来接收Command，将Command发送到消息队列

command-consumer启动

  • 消费Command队列中的消息的服务

将领域事件消息持久化才算是Command执行成功，Command执行的结果可以通过发送命令时注册的监听器获取

event-consumer启动

  • 领域事件处理服务

事件可能会多次投递，所以需要消费端逻辑保证幂等处理，这里框架无法完成支持，需要开发者自己实现

测试

创建聚合

压测数据

机器配置：MacBook Pro (Retina, 15-inch, Mid 2015) CPU：2.2 GHz Intel Core i7 内存：16 GB 1600 MHz DDR3 硬盘：SSD

MySQL

模式 数据量 处理耗时 QPS
SendOneWay 10000 737 **
SendOneWay 50000 4856 **
SendOneWay 100000 8162 **
EventHandle 5000 7218 **
EventHandle 10000 11066 **
EventHandle 50000 71014 **
CommandHandle 5000 4001 **
CommandHandle 10000 7957 **
CommandHandle 50000 44531 **

InMemory

模式 数据量 处理耗时 QPS
SendOneWay 10000 1425 **
SendOneWay 50000 8383 **
SendOneWay 100000 12914 **
EventHandle 5000 1172 **
EventHandle 10000 2403 **
EventHandle 50000 12124 **
CommandHandle 5000 985 **
CommandHandle 10000 1939 **
CommandHandle 50000 11265 **

参考项目

About

DDD应用框架

License:MIT License

Languages

Language:Java 100.0%