领域模型设计为复杂问题的解决提供了一套方法,但其理论往往非常抽象,本系列文单旨在提供一些最佳实践。您需要首先认识到,软件的设计过程主观性很强,我希望能够提供一个设计思想让您在入门中有一个感性的认识,莫要陷入到“教条主义”中。
程序研发过程中,往往涉及到验证。不论是采用哪种实现方式(面向过程的方式或者对象驱动),原则上,公有方法中的第一件事情是验证参数。何时,何地,如何做验证是一个开发者要面临的挑战。做一个合格的软件设计师(在这里,我喜欢用设计师而非码农或程序员,那是对于自己的不尊重),当您想要写一份干净、整洁及可读性很强的代码时,细节上的转变会让您的作品看起来更加赏心悦目、更有自信、代码可维护性更强。
1、基于视图模型的验证
在展开书写之前,我们需要假设一个非常简单的业务场景:用户的每一个操作,都需要为其增加一个操作日志。在此处,我们遵循如下设计原则:1)涉及新建、更新、复杂查询业务时,Service层公有方法都接收视图模型作为参数,而非拆成一个个独立的参数;2)所有公有方法的要做的第一件事是验证。视图模型代码如下。
public class OperationLogInfo { private String module; private String operatorId; private String operatorName; private String action; public String getModule() { return module; } public void setModule(String module) { this.module = module; } public String getOperatorId() { return operatorId; } public void setOperatorId(String operatorId) { this.operatorId = operatorId; } public String getOperatorName() { return operatorName; } public void setOperatorName(String operatorName) { this.operatorName = operatorName; } public String getAction() { return action; } public void setAction(String action) { this.action = action; } }
接下来为Service层代码。
@Service public class OperationLogService { private static Logger logger = LoggerFactory.getLogger(OperationLogService.class); /** * 保存操作日志 * @param operationLogInfo 操作日志信息 */ public void save(OperationLogInfo operationLogInfo) { try { if (operationLogInfo == null) { throw new IllegalArgumentException(OperationMessages.NO_OPERATION_LOG); } if (StringUtils.isEmpty(operationLogInfo.getModule())) { throw new IllegalArgumentException(OperationMessages.NO_MODULE_INFO); } if (StringUtils.isEmpty(operationLogInfo.getOperatorId())) { throw new IllegalArgumentException(OperationMessages.NO_OPERATOR_ID_TYPE); } if (StringUtils.isEmpty(operationLogInfo.getOperatorName())) { throw new IllegalArgumentException(OperationMessages.NO_OPERATOR_NAME_TYPE); } if (StringUtils.isEmpty(operationLogInfo.getAction())) { throw new IllegalArgumentException(OperationMessages.NO_ACTION_TYPE); } OperationLogDataEntity entity = OperationLogDataEntity.of(operationLogInfo); this.operationLogDao.save(entity); } catch (IllegalArgumentException e) { logger.error(e.getMessage(), e); } catch (Exception e) { logger.error(OperationMessages.SAVE_LOG_FAILED, e); } } }
为了保持代码的干净,我引入了一个新的类”OperationMessages“,将所有的”报错信息“或者”操作提示“以静态常量的形式保存在一个统一的地方供后续代码引用。如果您的服务中有多个包,建议为每一个包中都加入这样一个包含常量的类,用于区分不同业务的操作提示。下面为这个常量的代码片段。
/** * 操作提示 */ final public class OperationMessages { public static final String NO_OPERATION_LOG = "无操作日志信息"; }
返回到我的应用服务代码,嗯……整体来看比较整洁,不过代码读起来不舒服,70%全是验证,我的业务代码已经淹没在验证的海洋里。还好只有4个字段的信息,否则……让我们来优化一下,把验证类代码全部移到一个方法中。
@Service public class OperationLogService { private static Logger logger = LoggerFactory.getLogger(OperationLogService.class); /** * 保存操作日志 * @param operationLogInfo 操作日志信息 */ public void save(OperationLogInfo operationLogInfo) { try { this.validate(operationLogInfo); OperationLogDataEntity entity = OperationLogDataEntity.of(operationLogInfo); this.operationLogDao.save(entity); } catch (IllegalArgumentException e) { logger.error(e.getMessage(), e); } catch (Exception e) { logger.error(OperationMessages.SAVE_LOG_FAILED, e); } } private void validate(OperationLogInfo operationLogInfo) { if (operationLogInfo == null) { throw new IllegalArgumentException(OperationMessages.NO_OPERATION_LOG); } if (StringUtils.isEmpty(operationLogInfo.getModule())) { throw new IllegalArgumentException(OperationMessages.NO_MODULE_INFO); } if (StringUtils.isEmpty(operationLogInfo.getOperatorId())) { throw new IllegalArgumentException(OperationMessages.NO_OPERATOR_ID_TYPE); } if (StringUtils.isEmpty(operationLogInfo.getOperatorName())) { throw new IllegalArgumentException(OperationMessages.NO_OPERATOR_NAME_TYPE); } if (StringUtils.isEmpty(operationLogInfo.getAction())) { throw new IllegalArgumentException(OperationMessages.NO_ACTION_TYPE); } } }
假如我需要在类”OperationLogInfo“中再加入一个新的字段,对应的”validate“方法也需要变更。希望你的记性好一点不要忘了这处的变更,要不然可能要开始”事故报告“之旅,谁知道您的DB中是否设置了字段必填或有某个长度的限制。而外,从信息内聚的角度来看,把验证代码写到服务层貌似差了一点,毕竟类”OperationLogInfo“中有什么字段,只有它自己最知道,所以我们希望它可以承担“信息专家”的角色。因此,我们把验证的方法上升到DTO模型“OperationLogInfo”中。 此外,考虑到参数验证大多数时是必需的,所以我们做一个视图模型的父类。
新引入的父类叫“VOBase”,类“OperationLogInfo”继承于它。原因很简单,“OperationLogInfo”的来源可能是另外的包,也可能是通过REST传进的参数,是一种信息的缩影,设计为视图模型还是比较自然的。
public interface Validatable { /** * 验证 * @return 验证结果 */ ParameterValidationResult validate(); } public abstract class VOBase implements Validatable { @Override public ParameterValidationResult validate() { return ParameterValidationResult.success(); } public String toJson() { return JsonUtils.toJson(this); } }
变更后的“OperationLogInfo”和“OperationLogService”代码如下。
public class OperationLogInfo extends VOBase { private String module; private String operatorId; private String operatorName; private String action; @Override public ParameterValidationResult validate() { if (StringUtils.isEmpty(operationLogInfo.getModule())) { return ParameterValidationResult.failed(OperationMessages.NO_MODULE_INFO); } if (StringUtils.isEmpty(operationLogInfo.getOperatorId())) { return ParameterValidationResult.failed(OperationMessages.NO_OPERATOR_ID_TYPE); } if (StringUtils.isEmpty(operationLogInfo.getOperatorName())) { return ParameterValidationResult.failed(OperationMessages.NO_OPERATOR_NAME_TYPE); } if (StringUtils.isEmpty(operationLogInfo.getAction())) { return ParameterValidationResult.failed(OperationMessages.NO_ACTION_TYPE); } return ParameterValidationResult.success(); } //省略其它get、set方法 }
@Service public class OperationLogService { private static Logger logger = LoggerFactory.getLogger(OperationLogService.class); /** * 保存操作日志 * @param operationLogInfo 操作日志信息 */ public void save(OperationLogInfo operationLogInfo) { try { if (operationLogInfo == null) { throw new IllegalArgumentException(OperationMessages.NO_OPERATION_LOG); } ParameterValidationResult validation = operationLogInfo.validate(); if (!validation.isSuccess()) { throw new IllegalArgumentException(validation.getMessage()); } OperationLogDataEntity entity = OperationLogDataEntity.of(operationLogInfo); this.operationLogDao.save(entity); } catch (IllegalArgumentException e) { logger.error(e.getMessage(), e); } catch (Exception e) { logger.error(OperationMessages.SAVE_LOG_FAILED, e); } } //其它代码省略 }
如果您有“代码强迫证”,可以将此处的验证放到下面另起一个方法。不过此处的分离与前面设计的分离意义不同,我们引入了“信息专家”(OperationLogInfo)的概念,把验证的责任进行了约束。
2、基于业务模型的验证
基于领域模型的验证,通过使用一些很小的设计技巧可以实现非常优雅的验证。很多工程师喜欢使用如“AXON”这类框架,觉得使用起来非常的酷。实际上,应用模型驱动时我个人不是特别建议使用那类开源框架,一是依赖性太强;二是框架为了支撑各类模式,设计的非常复杂,造成您的代码性能不是很高。此外,无论是EDA还是CARS模式,都属于局部模式,不要在系统中全面应用。一些逻辑简单的场景使用面向过程设计效果很好;复杂的业务则要根据其业务形态使用不同的设计模式。
引入模型驱动,说明您的业务比较复杂,那设计出的对象也不会很简单。如何保证一个对象的合法性是您需要首先考虑的内容。对象的生成,一个是通过外部参数新创建,另外则通过查询数据库进行加载。无论是哪种方式,数据都是不可信的。所以,验证规则一定是非常非常的多,那么是否有一种方式能让我们专注于业务开发,而非为验证头痛呢?这里面引入了两个问题:1)如何验证;2)何时验证。
2.1、业务模型内验的实现
业务模型的内验,可以通过引入一些小的设计技巧完成。如果把代码的所有实现细节全部都展现出来,对于阅读者来说也是一件比较痛苦的事情,所以在此进行一些简化,仅贴一些核心代码供参考。此处的业务场景为“服务部署审批”流程,简单来说就是每一次的服务上线需要通过一轮轮的审核,只有都通过后方能进行实施。
//业务模型:部署审批单
public class DeploymentApprovalForm extends ApprovalFormBase { private LocalDateTime deploymentDate; private ProcessStatus status = ProcessStatus.DRAFTING; private PhaseType currentPhase = PhaseType.DRAFTING; DeploymentApprovalForm(Long id, String name, ApplierInfo applierInfo, LocalDateTime createdDate, LocalDateTime updatedDate, List<ApprovalNodeBase> nodes, LocalDateTime deploymentDate, ProcessStatus status, PhaseType currentPhase) { //代码省略 } @Override protected void addRule(RuleManager ruleManager) { super.addRule(ruleManager); ruleManager.addRule(new ObjectNotNullRule("status", this.status, OperationMessages.INVALID_STATUS)); ruleManager.addRule(new NotEqualsRule("status", this.status, ProcessStatus.UNKNOWN, OperationMessages.INVALID_STATUS)); ruleManager.addRule(new ObjectNotNullRule("currentPhase", this.currentPhase, OperationMessages.INVALID_PHASE)); ruleManager.addRule(new NotEqualsRule("currentPhase", this.currentPhase, PhaseType.UNKNOWN, OperationMessages.INVALID_PHASE)); ruleManager.addRule(new ObjectNotNullRule("deploymentDate", this.deploymentDate, OperationMessages.INVALID_DEPLOYMENT_DATE)); } //代码省略 }
上面的“部署审批单”领域模型中,方法“addRule”为内验的具体实现,定义在父类中。
public abstract class ApprovalFormBase extends EntityModel<Long> { private String name; private ApplierInfo applierInfo; //代码省略 } public abstract class EntityModel<TID extends Comparable> extends DomainModel implements Versionable, Deletable { //ID private TID id; //代码省略 } public abstract class DomainModel extends ValidatableBase { /** * 初始化当前状态 */ public void initializeToNewCreation() { } //代码省略 } public abstract class ValidatableBase implements Validatable { /** * 验证当前领域模型 * @return 验证r的结果 */ final public ParameterValidationResult validate() { RuleManager ruleManager = new RuleManager(this); this.addRule(ruleManager); return ruleManager.validate(); } /** * 增加验证规则 * @param ruleManager 验证规则管理器 */ protected void addRule(RuleManager ruleManager){ } }
“ObjectNotNullRule”为验证规则,定义在框架中,代码如下所示。通过定义不同类型的验证规则如“NotEqualsRule”、“RegexRule”等,可以让验证的实现变得非常灵活。如果您愿意,甚至可以定义如“and”,"or"这类的逻辑表达式。这里的验证逻辑使用了设计模式中的“规约模式”,建议找相关文章进行了解。
final public class ObjectNotNullRule extends RuleBase<Object> { /** * 规则基类 * * @param nameOfTarget 验证目标的名称 * @param target 验证的目标 * @param errorMessage 当规验证失败时的错误提示信息 */ public ObjectNotNullRule(String nameOfTarget, Object target, String errorMessage) { super(nameOfTarget, target, errorMessage); } /** * 执行验证 * @return 验证是否成功 */ @Override public ParameterValidationResult validate() { if(this.getTarget() == null){ return ParameterValidationResult.failed(null); } return ParameterValidationResult.success(); } }
通过引入一些简单的设计模式,可以将一些通用的功能进行封装,这样您的代码就会变得更加纯粹。开发过程中,我很喜欢用一个词来描述自己的代码,包括“整洁”,“纯粹”,“高可读性”,希望您也有类似的规则,让编程工作视为一项艺术。
2.1、业务模型内验的实现
此处有了验证,您也许会问:“那我什么时候调用呢,每一次保存的时候?每一次操作对象的时候?”,如果真的这样,您会发现代码中有许多重复的东西。在开发过程中如果发现了重复代码通常有两类处理方式:1)封装为类中单独的方法;2)将方法提升至父类中。而验证方法的调用时机,用这两类方式都不太适合。领域模型的验证通常是在应用服务中,不太好为所有的应用服务都设计出通用的可继承的验证方法。而如果我们仔细分析一下,到底何时真的需要进行验证,您会发现调用时机其实是可枚举的:1)从数据库中加载已有模型;2)模型新创建后;3)经过一系列的模型操作后,模型被最终持久化时。您也许会问,我在业务模型的方法中可能要判断一些类字段是否为空或者是否有合适的值等,是不是每次都要调用验证方法?答案是否定的,因为在上面的三个环节中您已经保证了整体对象的合法性,这是任何业务操作的前提,在后续的业务执行过程中就不必做额外的验证。当然,如果是参数的验证则需要您在代码中实现,因为参数不是对象本身的属性,不属于内验范围。
我们继续分析上面三个验证时机。在此,我们为项目加入限制:业务模型的创建必须通过工厂。这样的话,1)和2)两个场景中都可以将验证方法放至对象工厂中,保证我们创建对象的过程或者返回一个合法的对象或者直接抛创建异常。下面代码展示了实现细节。
final public class DeploymentApprovalFormFactory { public final static DeploymentApprovalFormFactory INSTANCE = new DeploymentApprovalFormFactory(); private DeploymentApprovalFormFactory() { } public DeploymentApprovalForm create(DeploymentApprovalFormInfo deploymentApprovalFormInfo) throws DeploymentApprovalFormCreationException { if (deploymentApprovalFormInfo == null) { throw new DeploymentApprovalFormCreationException(OperationMessages.INVALID_APPROVAL_FROM_INFO); } //代码省略 PhaseType currentPhase = PhaseType.getPhaseType(deploymentApprovalFormInfo.getCurrentPhase()); if (currentPhase == PhaseType.UNKNOWN) { currentPhase = PhaseType.DRAFTING; } //代码省略 DeploymentApprovalForm deploymentApprovalForm = new DeploymentApprovalForm(deploymentApprovalFormInfo.getId(), deploymentApprovalFormInfo.getName(), applier, createdDate, updatedDate, nodes, deploymentDate, status, currentPhase); ParameterValidationResult validationResult = deploymentApprovalForm.validate(); if (!validationResult.isSuccess()) { throw new DeploymentApprovalFormCreationException(validationResult.getMessage()); } return deploymentApprovalForm; } }
“DeploymentApprovalFormInfo”这个对象是一个视图模型,其值可以来自前端,也可以在“Repository”中通过调用“DAO”从数据库中查询信息后构建。
针对场景3),如果我们每次持久化时都显示的调用一次验证,会出现大量的重复的代码。所以,我们引入了一个新的模式“工作单元”,工作单元是在使用面向对象设计时非常实用的一种模式,下面代码给出片段,建议在网上找一些文章进行详细学习。
public abstract class UnitOfWorkBase implements UnitOfWork { private static final Logger logger = LoggerFactory.getLogger(UnitOfWorkBase.class); /** * 提交所有改变的对象至事务 * */ @Override public CommitHandlingResult commit() { CommitHandlingResult result = new CommitHandlingResult(); try { this.validate(); this.persist(); } catch(ValidationException e) { logger.error(e.getMessage(), e); result = new CommitHandlingResult(false, e.getMessage()); } catch(Exception e) { logger.error(e.getMessage(), e); result = new CommitHandlingResult(false, OperationMessages.COMMIT_FAILED); } finally { this.clear(); } return result; } //验证对象 protected void validate() throws ValidationException { CompositeParameterValidateResult result = new CompositeParameterValidateResult(); for (EntityModel entityModel : this.entityModels) { ParameterValidationResult validationResult = entityModel.validate(); if (!validationResult.isSuccess()){ result.addValidationResult(validationResult); result.fail(); } } if (!result.isSuccess()) { throw new ValidationException(result.getMessage(), result); } } //代码省略 }
本文介绍了验证模式中的“内验证”,后续会针对“外验证”进行说明。