共计 30170 个字符,预计需要花费 76 分钟才能阅读完成。
0. 前言
面对业务,一个永恒的真谛:永远不变的就是变动。如何发现变动、封装变动、隔离变动,是每个 程序员 的永恒话题。
本篇文章,将率领大家把“模板办法”设计模式利用于畛域设计的“应用服务”中,以达到如下目标:
- 对主流程进行封装,放弃主流程的稳定性,不变性;
- 对细节步骤进行扩大,放弃业务的灵活性,扩展性;
在正式开始之前,先理解下 什么是应用服务,以及他所面对的问题。
1. 什么是应用服务?
应用服务是 DDD 的重要概念之一,它是位于用户接口和畛域模型之间薄薄的一层,面向用户用例,次要负责编排,包含流程编排和事件编排。
以下是比拟风行的 六边形架构,让咱们简略理解下应用服务的角色和作用。
image
从图中可知,应用服务有几个特点:
- 面向用户用例,次要负责对业务流程进行编排;
- 畛域模型的间接使用者,在各组件间进行协调,共同完成业务流程。
- 资源管理者,将畛域模型和基础设施粘合在一起。
- 另外,负责事务、平安等技术爱护;
可见,应用服务职能还是很多,在泛滥职能中,“流程编排”算是最重要的一个,也是咱们这次钻研的重点。
首先,咱们看一个简略案例,钻研下应用服务在写入流程中的规范写法:
1.1 UserApplication 应用服务
应用服务接口,次要是为了对多个实现进行束缚,在理论开发中,并不是必须的。
UserApplication 对业务操作进行定义,具体如下:
public interface UserApplication {void createAndEnableUser(CreateAndEnableUserContext context);
void modifyUserName(ModifyUserNameContext context);
}
接口中次要定义两个业务操作:
- createAndEnableUser 创立并激活用户。该业务是个组合业务,由“创立”和“激活”两个原子操作组成,创立并激活用户后,对外发送畛域事件;
- modifyUserName 批改用户姓名。单纯的更新操作,在实现用户姓名批改后,对外发送畛域事件;
针对这个接口,咱们先看第一个简略实现:
1.2 UserV1Application 实现
UserV1Application 是第一个实现类,其余的实现都是在其根底之上进行推演。
UserV1Application 为应用服务的规范实现,具体代码如下:
@Service
public class UserV1Application implements UserApplication {private static final Logger LOGGER = LoggerFactory.getLogger(UserV1Application.class);
@Autowired
private UserRepository userRepository;
@Autowired
private ApplicationEventPublisher eventPublisher;
@Override
@Transactional(readOnly = false)
public void createAndEnableUser(CreateAndEnableUserContext context){
try {
// 1. 生成 聚合根
User user = User.create(context.getName(), context.getAge());
// 2. 执行业务拜访
user.enable();
// 3. 保留聚合根
this.userRepository.save(user);
// 4. 公布畛域事件
user.foreachEvent(this.eventPublisher::publishEvent);
// 5. 清理畛域事件
user.clearEvents();
LOGGER.info("success to handle createAndEnableUser and sync {} to DB", user);
}catch (Exception e){LOGGER.error("failed to handle createAndEnableUser", e);
if (e instanceof RuntimeException){throw (RuntimeException) e;
}
throw new RuntimeException(e);
}
}
@Override
@Transactional(readOnly = false)
public void modifyUserName(ModifyUserNameContext context){
try {
// 1. 加载聚合根
User user = this.userRepository.getById(context.getUserId());
// 2. 验证聚合根
if (user == null){throw new UserNotFoundException(context.getUserId());
}
// 3. 调用聚合根办法
user.modifyUserName(context.getNewName());
// 4. 保留对象
this.userRepository.save(user);
// 5. 公布畛域事件
user.foreachEvent(this.eventPublisher::publishEvent);
// 6. 清理畛域事件
user.clearEvents();
LOGGER.info("success to handle modifyUserName and sync {} to DB", user);
}catch (Exception e){LOGGER.error("failed to handle modifyUserName", e);
if (e instanceof RuntimeException){throw (RuntimeException) e;
}
throw new RuntimeException(e);
}
}
}
仔细观察 UserV1Application 实现,会发现流程存在肯定的相似性(重复性):
- 对立的异样解决机制。应用间接抛出异样的形式进行流程中断;
- 高度类似的胜利日志。在操作实现后,打印胜利日志;
- 高度一致的业务流程。
- 创立流程。
- 更新流程。
- 加载聚合根。通过 Repository 从数据库中获取聚合根对象;
- 验证聚合根。对 聚合根 有效性进行验证(是否找到);
- 执行业务操作。调用聚合根上的办法,实现业务操作;
- 保留聚合根。通过 Repository 将变更保留到数据库;
- 公布 & 清理畛域事件。应用 ApplicationEventPublisher 对外公布畛域事件;
- 实例化聚合根对象。应用上下文信息,生成聚合根对象;
- 执行业务操作(可选)。调用聚合根上的办法,执行业务操作;
- 长久化聚合根。应用 Repository 对聚合根进行长久化,将变更保留到数据库;
- 公布 & 清理畛域事件。应用 ApplicationEventPublisher 将业务操作所产生的畛域事件进行公布
这是 User 聚合的操作,咱们来看另一个聚合 Email。
@Service
public class EmailApplication {private static final Logger LOGGER = LoggerFactory.getLogger(EmailApplication.class);
@Autowired
private EmailRepository emailRepository;
@Autowired
private ApplicationEventPublisher eventPublisher;
@Transactional(readOnly = false)
public void createEmail(CreateEmailContext context){
try {
// 1. 生成 聚合根
Email email = Email.create(context.getUserId(), context.getEmail());
// 2. 执行业务拜访
email.init();
// 3. 保留聚合根
this.emailRepository.save(email);
// 4. 公布畛域事件
email.foreachEvent(this.eventPublisher::publishEvent);
// 5. 清理畛域事件
email.clearEvents();
LOGGER.info("success to handle createEmail and sync {} to DB", email);
}catch (Exception e){LOGGER.error("failed to handle createEmail", e);
if (e instanceof RuntimeException){throw (RuntimeException) e;
}
throw new RuntimeException(e);
}
}
@Transactional(readOnly = false)
public void modifyEmail(ModifyEmailContext context){
try {
// 1. 加载聚合根
Email email = this.emailRepository.getByUserId(context.getUserId());
// 2. 验证聚合根
if (email == null){throw new UserNotFoundException(context.getUserId());
}
// 3. 调用聚合根办法
email.modifyEmail(context.getEmail());
// 4. 保留对象
this.emailRepository.save(email);
// 5. 公布畛域事件
email.foreachEvent(this.eventPublisher::publishEvent);
// 6. 清理畛域事件
email.clearEvents();
LOGGER.info("success to handle modifyEmail and sync {} to DB", email);
}catch (Exception e){LOGGER.error("failed to handle modifyEmail", e);
if (e instanceof RuntimeException){throw (RuntimeException) e;
}
throw new RuntimeException(e);
}
}
}
有没有发现,聚合的写操作根本都是类似的逻辑(套路)?
面对“套路”,有没有一种办法可能对其进行对立治理呢?
这正是“模板办法”设计模式善于的中央,接下来,让咱们先停一下,简略复习下规范的模板办法。
2. 模板办法
模板办法:在一个办法中定义一个算法的骨架,而将一些步骤提早到子类中。使子类在不扭转算法构造的状况下,从新定义算法中的某些步骤。
首先,咱们看下模板办法的整体构造。
image
相熟完整体构造,咱们先对现有流程进行梳理,找到算法骨架(不变局部)和操作步骤(变动局部),以更好的套用 模板办法 模式。
针对以上剖析,能够得出:
- 创立和更新流程中,打印胜利日志、异样治理、长久化治理、事件治理 是通用逻辑,属于“算法骨架”;
- 创立流程中,聚合实例化、聚合业务操作,能够作为“算法骨架”;
- 更新流程中,聚合加载、聚合验证、聚合业务操作,能够作为“算法骨架”;
面对三个须要对立的“算法骨架”,咱们通过多级继承的形式进行构建,整体的类图如下:
该类图次要有三个模板类:
- AbstractDomainService。顶层模板类,是 AbstractCreateService 和 AbstractUpdateService 的父类,次要对“创立”和“更新”两个流程中的通用局部进行封装;
- AbstractCreateService。创立流程模板类,对 创立 流程进行封装;
- AbstractUpdateService。更新流程模板类,对 更新流程进行 封装;
具体的代码如下:
AbstractDomainService 源码如下:
abstract class AbstractDomainService<AGG extends Agg, CONTEXT extends DomainServiceContext> {private static final Logger LOGGER = LoggerFactory.getLogger(AbstractDomainService.class);
private final ApplicationEventPublisher eventPublisher;
private final CrudRepository<AGG, ?> repository;
public AbstractDomainService(CrudRepository<AGG, ?> repository,
ApplicationEventPublisher eventPublisher) {
this.eventPublisher = eventPublisher;
this.repository = repository;
}
@Transactional(readOnly = false)
public void handle(CONTEXT context){
try {
// 回调子类接口,用于扩大
AGG agg = doHandle(context);
// 将变更长久化到 DB
save2DB(agg);
// 公布畛域事件,实现后对事件进行清理
publishAndCleanEvent(agg);
// 胜利回调,默认打印日志
onSuccess(agg, context);
}catch (Exception e){
// 异样解决,间接中断流程
onException(e, context);
}
}
/**
* 回调接口,用于子类进行扩大
* @param context
* @return
*/
protected abstract AGG doHandle(CONTEXT context);
/**
* 异样默认解决策略,子类通过从新能够进行自定义
* @param e
* @param context
*/
protected void onException(Exception e, CONTEXT context){LOGGER.error("failed to handle {}", context, e);
if (e instanceof RuntimeException){throw (RuntimeException) e;
}
throw new RuntimeException(e);
}
/**
* 默认胜利回调,子类通过重写能够进行自定义
* @param agg
* @param context
*/
protected void onSuccess(AGG agg, CONTEXT context){LOGGER.info("success to handle {} and sync {} to DB", context, agg);
}
/**
* 公布并清理畛域事件
* @param agg
*/
private void publishAndCleanEvent(AGG agg){
// 1. 公布畛域事件
agg.foreachEvent(this.eventPublisher::publishEvent);
// 2. 清理畛域事件
agg.clearEvents();}
/**
* 将变更长久化到 DB 中
* @param agg
*/
private void save2DB(AGG agg){this.repository.save(agg);
}
}
AbstractDomainService 作为顶层抽象类,次要对流程进行对立,封装 异样解决、事件处理、胜利日志、数据长久化等操作,并通过 doHandle 形象办法对子类进行扩大。接下来咱们看下两个子类源码:
AbstractCreateService 源码如下:
public abstract class AbstractCreateService<AGG extends Agg, CONTEXT extends DomainServiceContext>
extends AbstractDomainService<AGG, CONTEXT>{public AbstractCreateService(CrudRepository<AGG, ?> repository, ApplicationEventPublisher eventPublisher) {super(repository, eventPublisher);
}
/**
* 重写父类办法,进行扩大
* @param context
* @return
*/
@Override
protected AGG doHandle(CONTEXT context) {
// 1. 生成 聚合根
AGG agg = instance(context);
// 2. 执行业务拜访
update(agg, context);
return agg;
}
/**
* 子类扩大点,能够对 聚合 进行业务调用
* @param agg
* @param context
*/
protected void update(AGG agg, CONTEXT context){ }
/**
* 子类扩大点,对 聚合 进行实例化
* @param context
* @return
*/
protected abstract AGG instance(CONTEXT context);
}
AbstractCreateService 裸露 instance 办法由子类实现扩大,对聚合进行实例化,同时提供 update 扩大点,在实例化实现后进行业务解决。
咱们看另外一个扩大子类,AbstractUpdateService 源码如下:
public abstract class AbstractUpdateService<AGG extends Agg, CONTEXT extends DomainServiceContext>
extends AbstractDomainService<AGG, CONTEXT>{
public AbstractUpdateService(CrudRepository<AGG, ?> repository,
ApplicationEventPublisher eventPublisher) {super(repository, eventPublisher);
}
/**
* 重写父类办法,进行扩大
* @param context
* @return
*/
@Override
protected AGG doHandle(CONTEXT context) {
// 1. 加载聚合根
AGG agg = loadAgg(context);
// 2. 验证聚合根
if (agg == null){notFound(context);
}
// 3. 调用聚合根办法
update(agg, context);
return agg;
}
/**
* 子类扩大点,加载要操作的聚合
* @param context
* @return
*/
protected abstract AGG loadAgg(CONTEXT context);
/**
* 子类扩大点,当聚合失落时进行回调
* @param context
*/
protected abstract void notFound(CONTEXT context);
/**
* 子类扩大点,调用 聚合上的业务办法
* @param agg
* @param context
*/
protected abstract void update(AGG agg, CONTEXT context);
}
AbstractUpdateService 为子类提供了 聚合记录、聚合操作、聚合失落等三个扩大点。
在这个体系下,业务实现将变的整洁,并且高度一致,具体如下:
CreateAndEnableUserService 源码如下:
@Service
public class CreateAndEnableUserService
extends AbstractCreateService<User, CreateAndEnableUserContext> {
@Autowired
public CreateAndEnableUserService(ApplicationEventPublisher eventPublisher, CrudRepository<User, ?> repository) {super(repository, eventPublisher);
}
@Override
protected User instance(CreateAndEnableUserContext context) {
// 实例化 User 聚合对象
return User.create(context.getName(), context.getAge());
}
@Override
protected void update(User agg, CreateAndEnableUserContext context) {
// 调用聚合上的 业务办法
agg.enable();}
}
ModifyUserNameService 源码如下:
@Service
public class ModifyUserNameService extends AbstractUpdateService<User, ModifyUserNameContext> {
private final JpaRepository<User, Long> repository;
public ModifyUserNameService(JpaRepository<User, Long> repository, ApplicationEventPublisher eventPublisher) {super(repository, eventPublisher);
this.repository = repository;
}
@Override
protected User loadAgg(ModifyUserNameContext context) {
// 加载要操作的 聚合对象
return this.repository.getById(context.getUserId());
}
@Override
protected void notFound(ModifyUserNameContext context) {
// 聚合失落,间接抛出异样
throw new UserNotFoundException(context.getUserId());
}
@Override
protected void update(User agg, ModifyUserNameContext context) {
// 调用聚合上的 业务办法
agg.modifyUserName(context.getNewName());
}
}
在模板办法束缚下,业务代码变的高度一致,残缺类图如下:
image
最初,咱们须要批改应用服务,把业务逻辑分发给对于的畛域服务:
@Service
public class UserV2Application implements UserApplication {
@Autowired
private CreateAndEnableUserService createAndEnableUserService;
@Autowired
private ModifyUserNameService modifyUserNameService;
@Override
public void createAndEnableUser(CreateAndEnableUserContext context) {
// 将逻辑分发给畛域服务
this.createAndEnableUserService.handle(context);
}
@Override
public void modifyUserName(ModifyUserNameContext context) {
// 将逻辑分发给畛域服务
this.modifyUserNameService.handle(context);
}
}
当然,如果感觉每个操作都须要创立一个新的服务类,还能够应用外部匿名类实现,具体如下:
@Service
public class UserV2Application2
implements UserApplication {
@Autowired
private JpaRepository<User, Long> repository;
@Autowired
private ApplicationEventPublisher applicationEventPublisher;
@Override
public void createAndEnableUser(CreateAndEnableUserContext context) {
// 应用匿名外部类实现逻辑
new AbstractCreateService<User, CreateAndEnableUserContext>(this.repository, applicationEventPublisher){
@Override
protected User instance(CreateAndEnableUserContext context) {return User.create(context.getName(), context.getAge());
}
@Override
protected void update(User agg, CreateAndEnableUserContext context) {agg.enable();
}
}.handle(context);
}
@Override
public void modifyUserName(ModifyUserNameContext context) {
// 应用匿名外部类实现逻辑
new AbstractUpdateService<User, ModifyUserNameContext>(this.repository, this.applicationEventPublisher){
@Override
protected void update(User agg, ModifyUserNameContext context) {agg.modifyUserName(context.getNewName());
}
@Override
protected void notFound(ModifyUserNameContext context) {throw new UserNotFoundException(context.getUserId());
}
@Override
protected User loadAgg(ModifyUserNameContext context) {return repository.getById(context.getUserId());
}
}.handle(context);
}
}
匿名外部类使代码变的紧凑,但也丢失了肯定的可读性。你感觉简略,还是简单了?是不是感觉流程被割裂开?不急,那让咱们持续。
4. Spring 模板办法
Spring 的一个设计特点就是,提供了大量的 Template 类 以实现对资源的治理。如 JdbcTemplate、RedisTemplate 等。
首先,让咱们从新感受一下 Spring 的 JdbcTemplate:
public User getByName(String name) {
String sql = "select" +
"id, create_time, update_time, status, name, password" +
"from tb_user" +
"where" +
"name = ?";
List<User> result = jdbcTemplate.query(sql, new Object[]{name}, new RowMapper<User>() {
@Override
public User mapRow(ResultSet resultSet, int i) throws SQLException {Long idForSelect = resultSet.getLong(1);
java.sql.Date createDate = resultSet.getDate(2);
java.sql.Date updateDate = resultSet.getDate(3);
Integer statusCode = resultSet.getInt(4);
String name = resultSet.getString(5);
String password = resultSet.getString(6);
User user = new User();
user.setId(idForSelect);
user.setCreateTime(createDate);
user.setUpdateTime(updateDate);
user.setStatus(UserStatus.valueOfCode(statusCode));
user.setName(name);
user.setPassword(password);
return user;
}
});
return result.isEmpty() ? null : result.get(0);
}
JdbcTemplate 实现了对资源的治理,对 jdbc 的规范用法进行封装,通过 入参 + 回调形式,将扩大点裸露给应用方。
Spring 模板办法与规范模板办法有哪些差别呢?
- 不变局部的封装基本相同。都是应用办法对算法骨架进行封装;
- 变动局部的定义和束缚形式不同。规范模板办法应用 形象办法 标准操作步骤,而 Spring 模板办法应用 接口 束缚操作步骤。
- 变动局部的扩大形式不同。模板办法应用继承的办法重写进行扩大,Spring 模板办法应用 入参形式进行扩大;
- 逻辑组织形式不同。模板办法通过父类回调子类办法的模式以实现流程编排,Spring 模板办法通过入参回调实现流程组织;
实现实践比照后,咱在代码中找下不同的感觉。首先,定义咱们本人的模板类:
public final class ApplicationServiceTemplate<AGG extends Agg> {private static final Logger LOGGER = LoggerFactory.getLogger(ApplicationServiceTemplate.class);
private final ApplicationEventPublisher eventPublisher;
private final CrudRepository<AGG, ?> repository;
public ApplicationServiceTemplate(ApplicationEventPublisher eventPublisher,
CrudRepository<AGG, ?> repository) {
this.eventPublisher = eventPublisher;
this.repository = repository;
}
public <CONTEXT extends DomainServiceContext> void executeCreate(CONTEXT context,
Function<CONTEXT, AGG> instanceFun,
BiConsumer<CONTEXT, AGG> updateFun){
try {
// 1. 生成 聚合根
AGG agg = instanceFun.apply(context);
// 2. 执行业务拜访
updateFun.accept(context, agg);
// 3. 保留聚合根
save2DB(agg);
publishAndCleanEvent(agg);
onSuccess(agg, context);
}catch (Exception e){onException(e, context);
}
}
public <CONTEXT extends DomainServiceContext> void executeUpdate(CONTEXT context,
Function<CONTEXT, AGG> loadFun,
Consumer<CONTEXT> notFoundFun,
BiConsumer<CONTEXT, AGG> updateFun){
try {
// 1. 加载聚合根
AGG agg = loadFun.apply(context);
// 2. 验证聚合根
if (agg == null){notFoundFun.accept(context);
}
// 3. 调用聚合根办法
updateFun.accept(context, agg);
publishAndCleanEvent(agg);
onSuccess(agg, context);
}catch (Exception e){onException(e, context);
}
}
private <CONTEXT extends DomainServiceContext> void onException(Exception e, CONTEXT context){LOGGER.error("failed to handle {}", context, e);
if (e instanceof RuntimeException){throw (RuntimeException) e;
}
throw new RuntimeException(e);
}
private <CONTEXT extends DomainServiceContext> void onSuccess(AGG agg, CONTEXT context){LOGGER.info("success to handle {} and sync {} to DB", context, agg);
}
private void publishAndCleanEvent(AGG agg){
// 1. 公布畛域事件
agg.foreachEvent(this.eventPublisher::publishEvent);
// 2. 清理畛域事件
agg.clearEvents();}
private void save2DB(AGG agg){this.repository.save(agg);
}
}
该模板类与之前的代码逻辑基本一致,只是代码组织模式产生了变动。
有了模板办法,那咱们看下如何应用:
@Service
public class UserV3Application
implements UserApplication {
private final JpaRepository<User, Long> repository;
private final ApplicationServiceTemplate<User> applicationServiceTemplate;
@Autowired
public UserV3Application(ApplicationEventPublisher eventPublisher, JpaRepository<User, Long> repository) {
this.repository = repository;
this.applicationServiceTemplate = new ApplicationServiceTemplate<>(eventPublisher, this.repository);
}
@Override
public void createAndEnableUser(CreateAndEnableUserContext cxt) {
this.applicationServiceTemplate.executeCreate(cxt,
context -> User.create(context.getName(), context.getAge()),
(createAndEnableUserContext, user) -> user.enable());
}
@Override
public void modifyUserName(ModifyUserNameContext cxt) {
this.applicationServiceTemplate.executeUpdate(cxt,
context -> repository.getById(context.getUserId()),
context -> {throw new UserNotFoundException(context.getUserId());},
(modifyUserNameContext, user) -> user.modifyUserName(modifyUserNameContext.getNewName())
);
}
}
有没有感觉比 规范模板办法简略不少呢?但同样带来几个问题:
- 参数过少,性能扩大能力有余;
- 参数过多,面对几十个参数,会存在混同,减少应用难度;
- 如果只有几个是必选,其余设置为 null,将会显得十分凌乱;
那办法重载能解决这个问题吗?只能缓解无奈根治,那有没有更好的办法?让咱们持续往下看。
5. 模板办法 + Builder 模式
模板办法善于对流程进行标准,Builder 模式善于对对象进行组装。模板办法 和 Builder 模式的组合应用,将带来十分清晰,且容易扩大的 API 体验。
相比 Spring 模板办法,新的模式只是在 逻辑组织形式上有些不同。Spring 模板办法通过入参回调实现流程组织,该模式应用 Builder 进行逻辑组装。说起来很形象,让咱们看下代码。
public abstract class BaseV4Application {private static final Logger LOGGER = LoggerFactory.getLogger(BaseV4Application.class);
@Autowired
private ApplicationEventPublisher eventPublisher;
/**
* 创立 Creator,已实现对创立流程的组装
* @param repository
* @param <A>
* @param <CONTEXT>
* @return
*/
protected <A extends Agg, CONTEXT extends DomainServiceContext> Creator<A, CONTEXT> creatorFor(CrudRepository<A, ?> repository){return new Creator<A, CONTEXT>(repository);
}
/**
* 创立 Updater,已实现对更新流程的组装
* @param aggregateRepository
* @param <A>
* @param <CONTEXT>
* @return
*/
protected <A extends Agg, CONTEXT extends DomainServiceContext> Updater<A, CONTEXT> updaterFor(CrudRepository<A, ?> aggregateRepository){return new Updater<A, CONTEXT>(aggregateRepository);
}
/**
* 创立流程的 Builder,次要:* 1. 组装流程
* 2. 执行流程
* @param <A>
* @param <CONTEXT>
*/
protected class Creator<A extends Agg, CONTEXT extends DomainServiceContext>{
// 规范仓库
private final CrudRepository<A, ?> aggregateRepository;
// 实例化器,用于实现对 聚合 的实例化
private Function<CONTEXT, A> instanceFun;
// 默认的操作胜利处理器,在操作胜利后进行回调
private BiConsumer<A, CONTEXT> successFun = (agg, context)->{LOGGER.info("success to handle {} and sync {} to DB", context, agg);
};
// 默认的异样处理器,在操作失败抛出异样时进行回调
private BiConsumer<Exception, CONTEXT> errorFun = (exception, context) -> {LOGGER.error("failed to handle {}", context, exception);
if (exception instanceof RuntimeException){throw (RuntimeException) exception;
}
throw new RuntimeException(exception);
};
// 聚合业务操作方法回调,最次要的扩大点,用于执行 聚合上的业务办法
private BiConsumer<A, CONTEXT> updateFun = (a, context) -> {};
Creator(CrudRepository<A, ?> aggregateRepository) {Preconditions.checkArgument(aggregateRepository != null);
this.aggregateRepository = aggregateRepository;
}
/**
* 设置 聚合的实例化器
* @param instanceFun
* @return
*/
public Creator<A, CONTEXT> instance(Function<CONTEXT, A> instanceFun){Preconditions.checkArgument(instanceFun != null);
this.instanceFun = instanceFun;
return this;
}
/**
* 减少 聚合上的业务操作,链式模式,能够绑定多的 业务操作
* @param updater
* @return
*/
public Creator<A, CONTEXT> update(BiConsumer<A, CONTEXT> updater){Preconditions.checkArgument(updater != null);
this.updateFun = this.updateFun.andThen(updater);
return this;
}
/**
* 减少 胜利处理器,链式模式,能够绑定多个处理器
* @param onSuccessFun
* @return
*/
public Creator<A, CONTEXT> onSuccess(BiConsumer<A, CONTEXT> onSuccessFun){Preconditions.checkArgument(onSuccessFun != null);
this.successFun = onSuccessFun.andThen(this.successFun);
return this;
}
/**
* 减少 异样处理器,链式模式,能够绑定多个处理器
* @param errorFun
* @return
*/
public Creator<A, CONTEXT> onError(BiConsumer<Exception, CONTEXT> errorFun){Preconditions.checkArgument(errorFun != null);
this.errorFun = errorFun.andThen(this.errorFun);
return this;
}
/**
* 执行 创立流程
* @param context
* @return
*/
public A call(CONTEXT context){Preconditions.checkArgument(this.instanceFun != null, "instance fun can not be null");
Preconditions.checkArgument(this.aggregateRepository != null, "aggregateRepository can not be null");
A a = null;
try{
// 实例化 聚合根
a = this.instanceFun.apply(context);
// 在聚合根上执行业务操作
this.updateFun.accept(a, context);
// 长久化聚合根到 DB
this.aggregateRepository.save(a);
// 公布畛域事件,并进行清理
if (eventPublisher != null){
// 1. 公布畛域事件
a.foreachEvent(eventPublisher::publishEvent);
// 2. 清理畛域事件
a.clearEvents();}
// 调用 胜利回调器
this.successFun.accept(a, context);
}catch (Exception e){
// 调用 异样回调器
this.errorFun.accept(e, context);
}
return a;
}
}
/**
* 更新流程的 Builder,次要:* 1. 组装流程
* 2. 执行流程
* @param <A>
* @param <CONTEXT>
*/
protected class Updater<A extends Agg, CONTEXT extends DomainServiceContext> {
// 规范仓库
private final CrudRepository<A, ?> aggregateRepository;
// 聚合加载器,用于从 DB 中加载 聚合对象
private Function<CONTEXT, A> loadFun;
// 聚合失落处理器,聚合失落时进行回调
private Consumer<CONTEXT> onNotExistFun = context -> {};
// 胜利回调器,链式模式,在操作胜利时调用
private BiConsumer<A, CONTEXT> successFun = (agg, context)->{LOGGER.info("success to handle {} and sync {} to DB", context, agg);
};
// 异样回调器,链式模式,在操作失败抛出异样时调用
private BiConsumer<Exception, CONTEXT> errorFun = (exception, context) -> {LOGGER.error("failed to handle {}", context, exception);
if (exception instanceof RuntimeException){throw (RuntimeException) exception;
}
throw new RuntimeException(exception);
};
// 业务更新器,对聚合进行业务操作
private BiConsumer<A, CONTEXT> updateFun = (a, context) -> {};
Updater(CrudRepository<A, ?> aggregateRepository) {this.aggregateRepository = aggregateRepository;}
/**
* 设置 聚合对象加载器,用于从 DB 中加载 聚合
* @param loader
* @return
*/
public Updater<A, CONTEXT> loader(Function<CONTEXT, A> loader){Preconditions.checkArgument(loader != null);
this.loadFun = loader;
return this;
}
/**
* 减少 业务执行器,链式模式,能够绑定多个执行器
* @param updateFun
* @return
*/
public Updater<A, CONTEXT> update(BiConsumer<A, CONTEXT> updateFun){Preconditions.checkArgument(updateFun != null);
this.updateFun = updateFun.andThen(this.updateFun);
return this;
}
/**
* 减少 胜利回调器,链式模式,能够绑定多个回调器
* @param onSuccessFun
* @return
*/
public Updater<A, CONTEXT> onSuccess(BiConsumer<A, CONTEXT> onSuccessFun){Preconditions.checkArgument(onSuccessFun != null);
this.successFun = onSuccessFun.andThen(this.successFun);
return this;
}
/**
* 减少 异样回调器,链式模式,能够绑定多个回调器
* @param errorFun
* @return
*/
public Updater<A, CONTEXT> onError(BiConsumer<Exception, CONTEXT> errorFun){Preconditions.checkArgument(errorFun != null);
this.errorFun = errorFun.andThen(this.errorFun);
return this;
}
/**
* 减少 聚合失落处理器,链式模式,能够绑定多个回调器
* @param onNotExistFun
* @return
*/
public Updater<A, CONTEXT> onNotFound(Consumer<CONTEXT> onNotExistFun){Preconditions.checkArgument(onNotExistFun != null);
this.onNotExistFun = onNotExistFun.andThen(this.onNotExistFun);
return this;
}
/**
* 执行更新流程
* @param context
* @return
*/
public A call(CONTEXT context){Preconditions.checkArgument(this.aggregateRepository != null, "aggregateRepository can not be null");
Preconditions.checkArgument(this.loadFun != null, "loader can not both be null");
A a = null;
try {
// 从 DB 中加载 聚合根
a = this.loadFun.apply(context);
if (a == null){
// 聚合根不存在,回调 聚合失落处理器
this.onNotExistFun.accept(context);
}
// 在聚合之上,执行业务操作
updateFun.accept(a, context);
// 对聚合进行长久化解决
this.aggregateRepository.save(a);
// 公布并清理事件
if (eventPublisher != null){
// 1. 公布畛域事件
a.foreachEvent(eventPublisher::publishEvent);
// 2. 清理畛域事件
a.clearEvents();}
// 操作胜利回调
this.successFun.accept(a, context);
}catch (Exception e){
// 异样回调
this.errorFun.accept(e, context);
}
return a;
}
}
}
外围在 Creator 和 Updater 两个外部类上,这两个外部类次要由以下职责:
- 流程组装。通过 Builder 模式,对流程中所应用的操作步骤进行组装。在封装过程中,大量应用链式模式,在同一扩大点绑定多个操作;
- 流程执行。也就是模板办法设计模式中,不变的“算法主体”;
费了老大劲,一起来看下具体成果:
@Service
public class UserV4Application
extends BaseV4Application
implements UserApplication {
@Autowired
private JpaRepository<User, Long> repository;
@Override
public void createAndEnableUser(CreateAndEnableUserContext context) {this.<User, CreateAndEnableUserContext>creatorFor(this.repository)
// 绑定聚合实例化逻辑
.instance(createAndEnableUserContext -> User.create(createAndEnableUserContext.getName(), createAndEnableUserContext.getAge()))
// 减少聚合业务操作
.update((user, createAndEnableUserContext) -> user.enable())
// 执行创立流程
.call(context);
}
@Override
public void modifyUserName(ModifyUserNameContext context) {this.<User, ModifyUserNameContext>updaterFor(repository)
// 绑定聚合加载器
.loader(domainServiceContext -> this.repository.getById(domainServiceContext.getUserId()))
// 减少 聚合失落处理器
.onNotFound(modifyUserNameContext -> {throw new UserNotFoundException(modifyUserNameContext.getUserId());})
// 减少 聚合业务操作
.update((user, modifyUserNameContext) -> user.modifyUserName(modifyUserNameContext.getNewName()))
// 执行更新流程
.call(context);
}
}
和之前的玩法相比,是不是清晰很多?
小结
本篇文章聚焦于 DDD 应用服务的标准化解决,在规范化主流程的前提下,最大限度的减少业务的灵活性,从而赋予其弱小的流程编排能力。
从规范的 模板办法 登程,推演至 Spring 模板办法,最终定格在 模板办法 + Builder 模式,各种模式各有优缺点,须要依据场景进行定制,以施展其弱小的能力。
各模式特点简略汇总如下:
模式 | 不变局部封装策略 | 变动局部束缚策略 | 变动局部扩大形式 | 组装 |
---|---|---|---|---|
模板办法 | 算法封装在办法 | 形象办法 | 通过继承重写办法 | 办法重写 |
动态模板办法 | 算法封装在办法 | 接口 | 传入不同的接口实现 | 入参 + 回调 |
模板办法 +Builder | 算法封装在办法 | 接口 | 传入不同的接口实现 | builder + 入参 + 回调 |
最初,附上 源码地址 源码