知行合一
Github
顺翔的技术驿站
顺翔的技术驿站
  • README
  • ABOUTME
  • Computer Science
    • 数据结构与算法
      • 位运算以及位图
      • 随机数
      • 递归
      • 经典排序算法
      • 经典查找算法
      • 数组和动态数组
      • 链表
      • 栈和队列
      • 树
      • 哈希表
    • 计算机网络
      • 物理层
      • 数据链路层
      • 网络层
        • TCP
      • 运输层
      • 应用层
      • HTTP
        • HTTPS的原理
        • DNS详解
        • file协议
        • 邮件协议
    • 设计模式
      • 单例模式
      • 建造者模式
      • 原型模式
      • 工厂模式
      • 享元模式
      • 代理模式
      • 装饰者模式
      • 桥接模式
      • 适配器模式
      • 外观模式
      • 组合模式
      • 事件驱动
      • 有限状态机
      • 备忘录模式
      • 模板方法模式
      • 策略模式
      • 迭代器模式
      • 命令模式
      • 解释器模式
    • 加密与解密
      • 数字证书原理
      • cfssl
  • Programming Language
    • 编程语言学习要素
    • Java
      • 集合
        • List
          • ArrayList
          • Vector
          • Stack
          • LinkedList
        • Iterator
        • Set
          • HashSet
          • TreeSet
        • Map
          • HashMap
          • HashTable
          • TreeMap
          • LinkedHashMap
      • 常用API
        • 日期时间处理
        • System
        • Random
        • Arrays
        • Scanner
        • 格式化输出
      • java特性
        • java5特性
        • java8特性
        • java9特性
        • java10特性
        • java11特性
      • 并发编程
        • 线程基础
        • 线程同步:synchronized及其原理
        • 线程同步: volatile
        • 锁机制
        • 锁的分类与对应的Java实现
        • JUC:同步辅助类
        • JUC: AtomicXXX
        • 线程池
        • ThreadLocal详解
      • 测试
        • 使用JMH进行基准测试
      • JVM
        • 强引用、软引用、弱引用、虚引用
        • jvm内存模型
        • jvm优化
        • GC算法与回收器
        • 静态绑定与动态绑定
      • ORM
        • Mybatis
          • IBatis常用操作
      • Web编程
        • Servlet详解(一)
        • Servlet详解(二):request和response对象
        • Servlet详解(三):会话技术与Cookie
        • JSP详解(一):页面构成、EL表达式
        • JSP详解(二):九大内置对象
        • JavaWeb的编码问题
        • Thymeleaf
      • Velocity
      • Java日志框架总结
      • Spring
        • SpringIOC
        • SpringMVC
        • SpringBoot源码
      • 其他
        • Apache Commons Lang使用总结
        • 使用FtpClient进行ftp操作
        • Java PDF操作总结
        • Java使用zip4j进行文件压缩
        • Java解析Excel总结
    • JVM Language
      • Groovy
      • Scala
    • Kotlin
      • 变量和常量
      • 数据类型
        • 基本数据类型
        • 容器类型
        • 函数类型
        • null和null安全
      • 流程控制
      • 包
      • 面向对象
    • Golang
      • 关键字与标识符
      • 变量和常量
      • 数据类型
      • 函数
      • 常用API
        • 时间日期处理
        • 字符串操作
        • 正则表达式
      • 控制语句
      • 包package
      • 面向对象
      • 错误处理
      • 命令行编程
        • Cobra
      • 文件操作
      • 测试
      • 并发编程
        • sync包详解
      • 数据格式与编码
        • 使用encoding包操作xml
        • 使用encoding包操作json
        • 使用magiconair操作properties
        • 使用go-ini操作ini
      • 反射
      • Build Tools
        • Go Module
        • Go Vendor
      • 日志框架
        • zap日志框架
      • Web编程
        • Gin
    • JavaScript
      • 数据类型
      • ECMAScript
        • ECMAScript6
      • NodeJS
    • TypeScript
      • 变量和常量
      • 数据类型
      • 函数
      • 面向对象
      • 泛型
      • Build Tools
        • tsc编译
        • 与webpack整合
    • Python
      • BuildTools
        • requirements.txt
        • Ananconda
    • Swift
      • 变量和常量
    • Script Language
      • Regex
      • BAT
      • Shell
    • Markup Language
      • Markdown
      • Yaml
  • Build Tools
    • CMake
    • Maven
      • 搭建Nexus私服
      • maven使用场景
    • Gradle
  • Version Control
    • Git
      • Git工作流
      • Git分支管理
      • Git Stash
      • Git Commit Message规范
      • .gitttributes文件
    • SVN
  • Distributed
    • 分布式基础理论
      • 互联网架构演变
      • 架构设计思想AKF拆分原则
      • CAP理论
      • BASE理论
    • 一致性
      • 一致性模型
      • 共识算法
        • Paxos
        • Raft
        • ZAB
      • 复制
        • 主从复制
        • Quorum机制
        • Nacos Distro协议
      • 缓存一致性
        • 双写一致性
        • 多级缓存一致性
    • 事务一致性
      • Seata
      • 本地消息表实现方案
      • 关于dpad的事务问题的分析
    • IO
    • RPC协议
    • 序列化
    • Session共享
    • 分布式协调
      • Zookeeper
        • zk集群4节点搭建
    • 服务治理
      • Dubbo分布式治理
    • 分布式ID
      • 分布式ID生成策略总结
    • 分布式锁
    • 应用服务器
      • Tomcat
    • Web服务器
      • Nginx
        • Nginx的基本配置
        • ab接口压力测试工具
        • nginx模块
        • 随机访问页面
        • 替换响应内容
        • 请求限制
        • 访问控制
        • 状态监测
        • nginx应用场景
        • 代理服务
        • 负载均衡
        • 缓存
        • 静态资源服务器和动静分离
        • 附录
      • Kong
    • 缓存中间件
      • Caffeine
      • memcached
      • Redis
        • Centos下安装Redis
        • RatHat下安装Redis
    • 数据库中间件
      • ShardingSphere
      • MyCat2
    • 消息中间件
      • Kafka
      • RocketMQ
  • Microservices
    • 服务发现
      • Nacos注册中心
      • Consul
    • 配置中心
      • Apollo
    • 消息总线
    • 客户端负载均衡
    • 熔断器
    • 服务网关
    • 链路追踪
      • Skywalking
  • Domain-Specific
    • Auth
      • 有关权限设计的思考
      • 认证方式
      • JWT
    • 任务调度
      • QuartzScheduler
      • Elastic-Job
      • XXL-Job
      • PowerJob
    • 工作流
      • BPM
      • Activiti
      • Flowable
    • 规则引擎
      • Drools
  • Architect
    • DDD领域驱动设计
      • 三层架构设计
      • 四层架构设计
    • Cola
    • 代码设计与代码重构
      • 重构改变既有代码设计
      • 枚举规范化
      • 接口幂等
      • 限流
      • 历史与版本
      • 逻辑删除和唯一索引
      • 业务对象设计
    • 单元测试
      • SpringBoot单元测试实践
    • 项目管理
    • APM
      • SkyWalking
      • Arthas
    • 性能优化
      • 接口性能优化
    • 系统设计
      • 流程中台
      • 短信中台
      • 权限中台
        • 智电运维平台组织架构改造二期
  • Database
    • Oracle
      • Docker下安装oracle11g
    • IBM DB2
    • Mysql
      • 安装Mysql
      • 用户与权限管理
      • MySQL的逻辑架构
      • 存储引擎
      • 索引详解
      • MySql的列类型
      • MySql中表和列的设计
      • MySql的SQL详解
      • 锁机制
      • 事务
      • Mysql函数总结
      • MySql存储过程详解
      • MySql触发器详解
      • Mysql视图详解
      • Mysql中Sql语句的执行顺序
      • 配置MySql主从和读写分离
      • MySql的备份策略
      • MySql分库分表解决方案
      • MySql优化总结
      • MySQL实战调优
        • schema与数据类型优化
    • Mongo
  • File System
    • README
    • HDFS
    • FastDFS
    • MinIO
  • Linux
    • 常用的Linux命令
    • vim
    • Linux磁盘管理
    • Linux系统编程
    • RedHat
      • rpm包管理器具体用法
    • Ubuntu
      • Ubuntu下录制屏幕并做成gif图片
      • Ubuntu20.05LiveServe版安装
  • DevOps
    • VM
      • 新建一个新的Linux虚拟机需要配置的东西
      • VMware桥接模式配置centos
      • VMwareFusion配置Nat静态IP
    • Ansible
    • Container
      • Docker
        • Dockerfile详解
        • DockerCompose详解
      • Containerd
    • Kubernetes
      • 安装k8s
        • 使用Minikube安装k8s
        • centos7.x下使用kubeadm安装k8s1.21
        • ubuntu20下使用kubeadm安装k8s1.21
        • centos7.x下使用二进制方式安装k8s1.20
        • 使用DockerDesktop安装K8s(适用M1芯片)
      • 切换容器引擎
      • 使用k8s部署项目的流程
      • 集群维护-备份升级排错
    • Gitlab
      • GitlabCI/CD
    • CI/CD
      • ArgoCD
  • Big-Data
    • Hadoop
    • MapReduce
    • HDFS
  • Front-End
    • Android
      • Log的使用、自定义Log工具类
      • Android倒计时功能实现
      • 解决ViewDrawableLeft左侧图片大小不可控的问题
      • AndroidSQLite基本用法
      • View的生命周期
      • 工具类
      • WebView详解
      • ViewTreeObserver类监听ViewTree
      • 在onCreate中获取控件的宽高等信息的几种方法
      • View的foreground属性
        • MaterialDesign
          • BottomNavigationBar
          • CardView
          • Elevation高度、shadows阴影、clipping裁剪、tint着色
          • TouchFeedbackRipple波纹动画
      • Volley完全解析——使用、源码
      • Android围住神经猫的实现
      • LookLook剖析,架构概述——MVP、Retrofit+RxJava
      • Android性能优化之渲染
    • Browser
      • 浏览器的工作原理
    • HTML
      • DOCTYPE标签、XHTML与HTML的区别
    • CSS
      • CSS的继承性、层叠性、权重
      • CSS浮动float详解(一):标准文档流
      • CSS浮动float详解(二):使用float
      • CSS浮动float详解(三):清除浮动方案
    • Tools Lib
      • JavaScript 文件下载解决方案-download.js
      • js-url 用于url的js开源库
      • jsuri 用于操作url的js开源库
      • window offset
    • React
      • 模块化和组件
      • 组件的三大核心属性
      • 事件处理
      • 表单数据收集
      • 生命周期
      • DOM的diff算法
      • 工程化
        • 脚手架create-react-app
        • 工程结构和模块化
      • 路由
  • Design
    • 产品设计
      • 交互设计
由 GitBook 提供支持
在本页
  • 业务对象的状态
  • 使用Manager层对业务对象进行控制
  • ContractManager API
  • XXXXContractService

这有帮助吗?

在GitHub上编辑
  1. Architect
  2. 代码设计与代码重构

业务对象设计

业务对象设计的流程,我总结为了以下几个步骤:

  1. 理解业务流程,绘制简单的业务流程图

  2. 从简单的业务流程图中,大概提取出业务角色

  3. 分析各个业务角色之间的关系(一对一、一对多、多对多)

  4. 分析业务角色的

    • 属性

    • 操作

    • 状态

业务对象的状态

实际开发中,特别是复杂的业务系统,会包含复杂的状态变化。但是针对业务状态,很多开发人员甚至在需求开发阶段,业务的状态以及它的生命周期都理解的不清楚、不到位。无论是复杂的业务流程还是简单的业务流程,他一定拥有自己的状态变化,理清这些状态与状态变化,并对状态进行统一管理,会让业务对象更安全,代码健壮性也更高。

拿到一个业务对象时,首先需要分析他的业务状态有哪些,罗列出他的所有状态,并分析他的初始状态、终结状态,以及状态通过何种事件进行转换的,并将状态机图绘制出来。状态机图是后续代码开发的所有依据,没有清楚地状态机图,后续的代码就会变的异常混乱。

然后,将状态机图输出为代码时,需要对业务对象进行统一的管理,这有很多方式,但是其主要核心是控制状态机,让其所有的操作都合法:

  1. 控制业务对象在指定的状态下,只能进行指定的操作(状态幂等)

  2. 一个业务对象在某个状态下执行某个操作,一定要有确定的结果

当你讲业务的所有操作都控制住了,只要外层都调用这些API,那这个业务对象就永远不会出现令人疑惑的异常情况。

使用Manager层对业务对象进行控制

控制业务对象的一种我常使用的方式就是在Service层与Mapper层之间增加一个新的Manager层:

注意:

  1. Manager层是针对某个独立的业务对象进行生命周期管理的

  2. Manager层中的方法分为三种:

    1. 对状态没有影响的普通操作方法

    2. 对状态由影响的事件方法,他会让业务对象的状态转换到下一个状态

    3. 单纯的查询方法

  3. 为了状态的安全,Service层不可以直接调用Mapper操作更新数据库,这有可能导致数据、甚至是状态的不正确,从而导致以后发生一些奇怪状态的数据

  4. Manager中指涉及当前业务信息的变更,如果有关联的其他业务信息变更,需要由Service控制,交给另一个Manager处理。也就是说,Manager是独立的耦合性很低的,Service像是一个组装层。

  5. Manager层使用Model结尾的类作为参数返回值,也可以直接使用Entity,这里使用Model是因为多个业务对象可能映射到一张表中,或者数据库表中的字段因历史原因会有较多的垃圾字段,影响代码开发,故增加这个类型的对象,让业务对象更纯粹。

下面是一个有关合同对象的管理层,仅供参考:

ContractManager API

public interface ContractManager {

    boolean canSave(ContractModel model);

    /**
     * 保存
     *
     * @param model model
     * @return 保存后的合同model
     */
    ContractModel save(ContractModel model);

    boolean canSubmit(ContractModel model);

    /**
     * 提交(手动提交)
     *
     * @param model model
     * @return 提交后的model
     */
    ContractModel submit(ContractModel model);

    /**
     * 提交(自动提交,直接变为已回签的状态)
     * @param model model
     * @return 提交后的model
     */
    ContractModel submitAuto(ContractModel model);

    /**
     * 生成成功校验
     *
     * @param model model
     * @return true 校验成功
     */
    boolean canGenerateSuccessful(ContractModel model);

    /**
     * 生成成功(非自动生成,设置审批状态为审批通过)
     *
     * @param model model
     * @return model
     */
    ContractModel generateSuccessful(ContractModel model);

    /**
     * 生成失败
     *
     * @param model         model
     * @param approveStatus 审批状态
     * @return model
     */
    ContractModel generateFailed(ContractModel model, CommonEnum.ApproveStatusEnum approveStatus);

    // --------------- 

    /**
     * 变更保存校验
     *
     * @param model model
     * @return model
     */
    boolean canChangeSave(ContractModel model);

    /**
     * 变更保存
     *
     * @param model model
     * @return model
     */
    ContractModel changeSave(ContractModel model);

    /**
     * 变更提交校验
     *
     * @param model model
     * @return model
     */
    boolean canChangeSubmit(ContractModel model);

    /**
     * 变更提交
     *
     * @param model model
     * @return model
     */
    ContractModel changeSubmit(ContractModel model);

    /**
     * 变更取消
     *
     * @param model model
     * @return model
     */
    ContractModel changeCancel(ContractModel model, ContractChangeStatusEnum changeStatus);

    /**
     * 变更撤回校验
     *
     * @param model model
     * @return model
     */
    boolean canChangeRevoke(ContractModel model);

    /**
     * 变更拒绝校验
     *
     * @param model model
     * @return model
     */
    boolean canChangeRefuse(ContractModel model);
}

XXXXContractService

自动新增

if (hasContractFiles) {
    contractManager.submitAuto(contractModel);
} else {
    contractManager.save(contractModel);
}

changeModel.getMetadata()
            .setBusines、sOperateStage(BusinessOperateStageEnum.GENERATE)
            .setGenerateSource(BusinessGenerateSource.AUTO)
            .setContractChangeStatus(ContractChangeStatusEnum.EMPTY);
changeManager.commit(changeModel);
changeManager.publish(changeModel);

保存、提交

if (submitStatus == process) {
    AssertUtils.isTrue(contactManger.canSubmit(contractModel), "业务的状态不能进行提交操作");
    contractManager.submit(contractModel);
    changeModel.getMetadata()
                .setWorkflowCode("xxxx")
                .setBusinessOperateStage(BusinessOperateStageEnum.GENERATE)
                .setContractChangeStatus(ContractChangeStatusEnum.EMPTY);
    changeManager.commit(changeModel);
    processManager.start(procesModel);
} else {
    AssertUtils.isTrue(contactManger.canSubmit(contractModel), "业务的状态不能进行保存操作");
    contractManager.save(contractModel);
    changeModel.getMetadata()
        .setBusinessOperateStage(BusinessOperateStageEnum.GENERATE);
    changeManger.stash(changeModel);
}
// 第一个版本,也就是生成阶段,业务信息直接入库

保存、提交审批通过回调

contractManager.generateSuccessful(contractModel);
changeModel.getMetadata()
            .setChangeSuccessTime(new Date())
            .setContractChangeStatus(ContractChangeStatusEnum.EMPTY);
    changeManager.publish(changeModel);

保存、提交审批拒绝

changeModel.getMetadata()
            .setVoidSource(BusinessVoidSourceEnum.REFUSED)
            .setContractChangeStatus(ContractChangeStatusEnum.EMPTY);
contractManager.generateFailed(contractModel, CommonEnum.ApproveStatusEnum.APPROVE_STATUS_REFUSE);
changeManager.voids(changeModel);

保存、提交审批撤回

contractManager.generateFailed(contractModel, CommonEnum.ApproveStatusEnum.APPROVE_STATUS_UNDO);
changeModel.getMetadata()
        .setVoidSource(BusinessVoidSourceEnum.UNDO)
        .setContractChangeStatus(ContractChangeStatusEnum.EMPTY);
changeManager.voids(changeModel);

发起、编辑变更保存、提交

保存:

if (!contractManager.canChangeSave(contractModel)) {
    throw new ServiceException("变更失败,合同当前状态不能进行变更保存操作");
}
contractManager.changeSave(contractModel);
changeModel.getMetadata()
        .setChangeLevel(level)
        .setBusinessOperateStage(BusinessOperateStageEnum.CHANGE);
changeManager.stash(changeModel);

提交:

if (level == 3) {
    changeModel.getMetadata()
            .setContractChangeStatus(ContractChangeStatusEnum.CHANGED);
    changeModel = changeManager.commit(changeModel);
    changeManager.publish(changeModel);
} else {
    contractManager.changeSubmit(contractModel);
    changeModel.getMetadata().setWorkflowCode(CommonEnum.WorkFlowCode.LAND_LEASE_BUSINESS_CHANGE_APPROVAL.getCode());
    changeModel = changeManager.commit(changeModel);
    processManager.start(processModel);
}

发起、编辑变更提交审批通过

if (!contractManager.canChangeSuccessful(contractModel)) {
    throw new ServiceException("变更中的业务才能执行变更成功操作");
}
contractManager.changeSuccessful(contractModel);
// 业务数据入库
上一页逻辑删除和唯一索引下一页单元测试

最后更新于1年前

这有帮助吗?

图 0