【DDD】学习笔记-薪资管理系统的测试驱动开发

回顾薪资管理系统的设计建模

在 3-15 课，我们通过场景驱动设计完成了薪资管理系统的领域设计建模。既然场景驱动设计可以很好地与测试驱动开发融合在一起，因此根据场景驱动设计的成果来开展测试驱动开发，就是一个水到渠成的过程。让我们先来看看针对薪资管理系统“支付薪资”领域场景分解的任务：

  • 确定是否支付日期
    • 确定是否为周五
    • 确定是否为月末工作日
      • 获取当月的假期信息
      • 确定当月的最后一个工作日
    • 确定是否为间隔一周周五
      • 获取上一次销售人员的支付日期
      • 确定是否间隔了一周
  • 计算雇员薪资
    • 计算钟点工薪资
      • 获取钟点工雇员与工作时间卡
      • 根据雇员日薪计算薪资
    • 计算月薪雇员薪资
      • 获取月薪雇员与考勤记录
      • 对月薪雇员计算月薪
    • 计算销售人员薪资
      • 获取销售雇员与销售凭条
      • 根据酬金规则计算薪资
  • 支付
    • 向满足条件的雇员账户发起转账
    • 生成支付凭条

根据任务分解驱动出来的时序图完整脚本则如下所示：

PaymentAppService.pay() {PaymentService.pay() {PayDayService.isPayday(today) {Calendar.isFriday(today);WorkdayService.isLastWorkday(today) {HolidayRepository.ofMonth(month);Calendar.isLastWorkday(holidays);}        WorkdayService.isIntervalFriday(today) {PaymentRepository.lastPayday(today);Calendar.isFriday(today);}}PayrollCalculator.calculate(employees) {HourlyEmployeePayrollCalculator.calculate() {HourlyEmployeeRepository.all();while (employee -> List<HourlyEmployee>) {employee.payroll(PayPeriod);}}SalariedEmployeePayrollCalculator.calculate() {SalariedEmployeeRepository.all();while (employee -> List<SalariedEmployee>) {employee.payroll();}}CommissionedEmployeePayrollCalculator.calculate() {CommissionedEmployeeRepository.all();while (employee -> List<CommissionedEmployee>) {employee.payroll(payPeriod);}}}PayingPayrollService.execute(employees) {TransferClient.transfer(account);PaymentRepository.add(payment);}}
}

测试驱动的方向

有了分解的任务，也有了履行职责的各个角色构造型，现在是万事俱备只欠东风。让我们严格按照测试驱动开发的红绿黄节奏以及三定律开展领域实现建模。首先，我们要选择需要添加测试的新功能。场景驱动设计在分解任务时，是从外部代表业务价值的领域场景逐步向内推进和拆分的，这是一个从外向内的驱动设计方向；测试驱动开发则不同，为了尽可能避免编写需要模拟的单元测试，应该从内部代表业务实现的原子任务开始，先完成细粒度的自给自足的领域行为逻辑单元，然后逐步往外推进，直到完成满足完整领域场景的所有任务，这是一个从内向外的驱动开发方向：

71557437.png

这就意味着在开始测试驱动开发之前，我们需要选择合适的任务。需要考虑的因素包括：

  • 任务的依赖性
  • 任务的重要性

从依赖的角度看，并不一定需要优先选择前序任务，因为我们可以使用模拟的方式驱动出当前任务需要依赖的接口，而无需考虑实现。不过，基于场景驱动开发分解的任务层次，为其编写测试用例时，也应优先挑选无需访问外部资源的原子任务，即为聚合编写单元测试，因为它无需任何模拟行为。至于任务的重要性，主要是判断任务是否整个系统或模块的核心功能。在确定了领域场景的前提下，一个判断标准是确定任务是主要流程还是异常流程。通常而言，应优先考虑任务的主流程。

显然，支付薪资领域场景的核心功能是支付与薪资计算。由于支付由外部服务完成，剩下要实现的核心功能就是薪资计算。如果从原子任务开始挑选，应首先从内部的原子任务开始挑选，例如选择“根据雇员日薪计算薪资”原子任务：

  • 计算雇员薪资
    • 计算钟点工薪资
      • 获取钟点工雇员与工作时间卡
      • 根据雇员日薪计算薪资
    • 计算月薪雇员薪资
      • 获取月薪雇员与考勤记录
      • 对月薪雇员计算月薪
    • 计算销售人员薪资
      • 获取销售雇员与销售凭条
      • 根据酬金规则计算薪资

测试驱动开发的过程

编写失败的测试

现在需要为该子任务编写测试用例。根据钟点工薪资的计算规则，可以分为两个不同的测试用例：正常工作时长和加班工作时长。由于场景驱动设计已经确定了履行该原子任务职责的是 HourlyEmployee，遵循测试驱动开发的定律一“一次只写一个刚好失败的测试，作为新加功能的描述”，编写一个刚好失败的测试：

public class HourlyEmployeeTest {@Testpublic void should_calculate_payroll_by_work_hours_in_a_week() {}
}

按照 Given-When-Then 模式来编写该测试方法。首先考虑 HourlyEmployee 聚合的创建。由于钟点工每天都要提交工作时间卡，薪资按周结算，因此在创建 HourlyEmployee 聚合根的实例时，需要传入工作时间卡的列表。计算薪资的方法为 payroll()，返回结果为薪资模型对象 Payroll。验证时，需确保薪资的结算周期与薪资总额是正确的。故而编写的测试方法为：

    @Testpublic void should_calculate_payroll_by_work_hours_in_a_week() {//givenTimeCard timeCard1 = new TimeCard(LocalDate.of(2019, 9, 2), 8);TimeCard timeCard2 = new TimeCard(LocalDate.of(2019, 9, 3), 8);TimeCard timeCard3 = new TimeCard(LocalDate.of(2019, 9, 4), 8);TimeCard timeCard4 = new TimeCard(LocalDate.of(2019, 9, 5), 8);TimeCard timeCard5 = new TimeCard(LocalDate.of(2019, 9, 6), 8);List<TimeCard> timeCards = new ArrayList<>();timeCards.add(timeCard1);timeCards.add(timeCard2);timeCards.add(timeCard3);timeCards.add(timeCard4);timeCards.add(timeCard5);HourlyEmployee hourlyEmployee = new HourlyEmployee(timeCards, Money.of(10000, Currency.RMB));//whenPayroll payroll = hourlyEmployee.payroll();//thenassertThat(payroll).isNotNull();assertThat(payroll.beginDate()).isEqualTo(LocalDate.of(2019, 9, 2));assertThat(payroll.endDate()).isEqualTo(LocalDate.of(2019, 9, 6));assertThat(payroll.amount()).isEqualTo(Money.of(400000, Currency.RMB));}

运行测试，失败：

56636479.png

让失败的测试刚好通过

在实现测试时，遵循测试驱动开发定律二“不写任何产品代码，除非它刚好能让失败的测试通过”，在实现 payroll() 方法时，仅提供满足当前测试用例预期的实现。什么是“刚好能让失败的测试通过”？以当前测试方法为例。要计算钟点工的薪资，除了它提供的工作时间卡之外，还需要钟点工的时薪，至于 HourlyEmployee 的其他属性，暂时可不用考虑；当前测试方法没有要求验证工作时间卡的有效性，在实现时，亦不必验证传入的工作时间卡是否符合要求，只需确保为测试方法准备的数据是正确的即可；当前测试方法是针对正常工作时长计算薪资，实现时就无需考虑加班的情况。实现代码为：

public class HourlyEmployee {private List<TimeCard> timeCards;private Money salaryOfHour;public HourlyEmployee(List<TimeCard> timeCards, Money salaryOfHour) {this.timeCards = timeCards;this.salaryOfHour = salaryOfHour;}public Payroll payroll() {int totalHours = timeCards.stream().map(tc -> tc.workHours()).reduce(0, (hours, total) -> hours + total);Collections.sort(timeCards);return new Payroll(timeCards.get(0).workDay(), timeCards.get(timeCards.size() - 1).workDay(), salaryOfHour.multiply(totalHours));}
}

在编写让失败测试通过的代码时，要把握好分寸，既不要过度地实现测试没有覆盖的内容，也无需死板地拘泥于编写所谓“简单”的实现代码。简单并非简陋，既然你的编码技能与设计水平已经足以一次编写出优良的代码，就不必一定要拖到最后，多此一举地等待重构来改进。例如，在上述实现代码中，需要将工作总小时数乘以 Money 类型的时薪，你当然可以实现为如下代码：

new Money(salaryOfHour.value() * totalHours, salaryOfHour.currency())

然而，如果你已经熟悉迪米特法则，且认识到以数据提供者形式进行对象协作的弊病，就会自然地想到应该在 Money 中定义 multiply() 方法，而非通过公开 value 和 currency 的 get 访问器让调用者完成乘法计算。这时就可直接实现如下代码，而不必等着以后再来进行重构：

public class Money {private final long value;private final Currency currency;public static Money of(long value, Currency currency) {return new Money(value, currency);}private Money(long value, Currency currency) {this.value = value;this.currency = currency;}public Money multiply(int factor) {return new Money(value * factor, currency);}@Overridepublic boolean equals(Object o) {if (this == o) return true;if (o == null || getClass() != o.getClass()) return false;Money money = (Money) o;return value == money.value &&currency == money.currency;}@Overridepublic int hashCode() {return Objects.hash(value, currency);}
}

简单说来，在不会导致过度设计的前提下，若能直接编写出整洁的代码，又何乐而不为呢？只需要做到实现的代码仅仅能让测试刚好通过，不去过度设计即可。为了让测试方法通过，我们定义并实现了 HourlyEmployee、TimeCard 与 Payroll 等领域模型对象。它们的定义都非常简单，即使你知道 HourlyEmployee 一定还有 Id 和 name 等基本的核心字段，也不必在现在就给出这些字段的定义。利用测试驱动开发来实现领域模型，重要的一点就是要用测试来驱动出这些模型对象的定义。只要不会遗漏领域场景，就一定会有测试去覆盖这些领域逻辑。一次只做好一件事情即可。

现在测试变绿了：

82470824.png

在测试通过的情况下，先不要考虑是重构还是编写新的测试，而应提交代码。持续集成强调七步提交法，其基础就是进行频繁的原子提交。这样就能保证尽快将你的最新变更反馈到团队共享的代码库上，降低代码冲突的风险，同时也能为重构设定一个安全的回滚版本。

重构产品代码和测试代码

提交代码后，根据简单设计原则，我们需要检查已有实现与测试代码是否存在重复，是否清晰地表达了设计者意图。

先看产品代码，目前的实现并没有重复代码，但是 payroll() 方法中的代码 Collections.sort(timeCards); 会让人产生困惑：为什么需要对工作时间卡排序？显然，这里缺乏对业务含义的封装，直接将实现暴露出来了。排序仅仅是手段，我们的目标是获得结算薪资的开始日期和结束日期。由于返回的是两个值，且这两个值代表了一个内聚的概念，故而可以定义一个内部概念 Peroid。重构的过程是首先提取 beginDate 和 endDate 变量，然后定义 Period 内部类：

    public Payroll payroll() {int totalHours = timeCards.stream().map(tc -> tc.workHours()).reduce(0, (hours, total) -> hours + total);Collections.sort(timeCards);LocalDate beginDate = timeCards.get(0).workDay();LocalDate endDate = timeCards.get(timeCards.size() - 1).workDay();Period settlementPeriod = new Period(beginDate, endDate);return new Payroll(settlementPeriod.beginDate, settlementPeriod.endDate, salaryOfHour.multiply(totalHours));}private class Period {private LocalDate beginDate;private LocalDate endDate;Period(LocalDate beginDate, LocalDate endDate) {this.beginDate = beginDate;this.endDate = endDate;}}

然后，再提取方法 settlementPeriod()。该方法名直接体现其业务目标，并将包括排序在内的实现细节封装起来：

    public Payroll payroll() {int totalHours = timeCards.stream().map(tc -> tc.workHours()).reduce(0, (hours, total) -> hours + total);return new Payroll(settlementPeriod().beginDate,settlementPeriod().endDate,salaryOfHour.multiply(totalHours));}private Period settlementPeriod() {Collections.sort(timeCards);LocalDate beginDate = timeCards.get(0).workDay();LocalDate endDate = timeCards.get(timeCards.size() - 1).workDay();return new Period(beginDate, endDate);}

接下来，不要忘了对测试代码的重构。毫无疑问，创建 List 的逻辑可以封装为一个方法，不至于让测试的 Given 部分充斥太多不必要的细节：

 public class HourlyEmployeeTest {@Testpublic void should_calculate_payroll_by_work_hours_in_a_week() {//givenList<TimeCard> timeCards = createTimeCards();Money salaryOfHour = Money.of(10000, Currency.RMB);HourlyEmployee hourlyEmployee = new HourlyEmployee(timeCards, salaryOfHour);//whenPayroll payroll = hourlyEmployee.payroll();//thenassertThat(payroll).isNotNull();assertThat(payroll.beginDate()).isEqualTo(LocalDate.of(2019, 9, 2));assertThat(payroll.endDate()).isEqualTo(LocalDate.of(2019, 9, 6));assertThat(payroll.amount()).isEqualTo(Money.of(400000, Currency.RMB));}private List<TimeCard> createTimeCards() {TimeCard timeCard1 = new TimeCard(LocalDate.of(2019, 9, 2), 8);TimeCard timeCard2 = new TimeCard(LocalDate.of(2019, 9, 3), 8);TimeCard timeCard3 = new TimeCard(LocalDate.of(2019, 9, 4), 8);TimeCard timeCard4 = new TimeCard(LocalDate.of(2019, 9, 5), 8);TimeCard timeCard5 = new TimeCard(LocalDate.of(2019, 9, 6), 8);List<TimeCard> timeCards = new ArrayList<>();timeCards.add(timeCard1);timeCards.add(timeCard2);timeCards.add(timeCard3);timeCards.add(timeCard4);timeCards.add(timeCard5);return timeCards;}
}

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.hqwc.cn/news/487402.html

如若内容造成侵权/违法违规/事实不符，请联系编程知识网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

【LeetCode每日一题】 单调栈的案例 42. 接雨水

【LeetCode每日一题】 单调栈的案例 42. 接雨水

这道题是困难&#xff0c;但是可以使用单调栈&#xff0c;非常简洁通俗。 关于单调栈可以参考单调栈总结以及Leetcode案例解读与复盘 42. 接雨水 给定 n 个非负整数表示每个宽度为 1 的柱子的高度图&#xff0c;计算按此排列的柱子&#xff0c;下雨之后能接多少雨水。 示例 …
阅读更多...
数据结构day4

数据结构day4

实现创建单向循环链表、创建结点、判空、输出、头插、按位置插入、尾删、按位置删除 loop_list.c #include "loop_list.h" loop_p create_head() {loop_p L(loop_p)malloc(sizeof(loop_list));if(LNULL){printf("空间申请失败\n");return NULL;}L->le…
阅读更多...
【区块链】联盟链

【区块链】联盟链

区块链中的联盟链 写在最前面**FAQs** 联盟链&#xff1a;区块链技术的新兴力量**联盟链的定义****联盟链的技术架构**共识机制智能合约加密技术身份认证 **联盟链的特点**高效性安全性可控性隐私保护 **联盟链的应用场景****金融服务****供应链管理****身份验证****跨境支付**…
阅读更多...
【前端素材】推荐优质后台管理系统Sneat平台模板（附源码）

【前端素材】推荐优质后台管理系统Sneat平台模板（附源码）

一、需求分析 后台管理系统是一种用于管理网站、应用程序或系统的工具&#xff0c;它通常作为一个独立的后台界面存在&#xff0c;供管理员或特定用户使用。下面详细分析后台管理系统的定义和功能&#xff1a; 1. 定义 后台管理系统是一个用于管理和控制网站、应用程序或系统…
阅读更多...
计算机毕业设计 基于SpringBoot的宠物商城网站系统的设计与实现 Java实战项目 附源码+文档+视频讲解

计算机毕业设计 基于SpringBoot的宠物商城网站系统的设计与实现 Java实战项目 附源码+文档+视频讲解

博主介绍&#xff1a;✌从事软件开发10年之余&#xff0c;专注于Java技术领域、Python人工智能及数据挖掘、小程序项目开发和Android项目开发等。CSDN、掘金、华为云、InfoQ、阿里云等平台优质作者✌ &#x1f345;文末获取源码联系&#x1f345; &#x1f447;&#x1f3fb; 精…
阅读更多...
图像压缩感知的MATLAB实现（OMP）

图像压缩感知的MATLAB实现（OMP）

前面实现了 压缩感知的图像仿真&#xff08;MATLAB源代码&#xff09; 效果还不错&#xff0c;缺点是速度慢如牛。 下面我们采用OMP对其进行优化&#xff0c;提升速度。具体代码如下&#xff1a; 仿真 构建了一个MATLAB文件&#xff0c;所有代码都在一个源文件里面&#xf…
阅读更多...
第九节HarmonyOS 常用基础组件24-Navigation

第九节HarmonyOS 常用基础组件24-Navigation

1、描述 Navigation组件一般作为Page页面的根容器&#xff0c;通过属性设置来展示的标题栏、工具栏、导航栏等。 2、子组件 可以包含子组件&#xff0c;推荐与NavRouter组件搭配使用。 3、接口 Navigation() 4、属性 名称 参数类型 描述 title string|NavigationComm…
阅读更多...
政安晨：【示例演绎机器学习】（四）—— 神经网络的标量回归问题示例 (价格预测)

政安晨：【示例演绎机器学习】（四）—— 神经网络的标量回归问题示例 (价格预测)

政安晨的个人主页&#xff1a;政安晨 欢迎 &#x1f44d;点赞✍评论⭐收藏 收录专栏: 政安晨的机器学习笔记 希望政安晨的博客能够对您有所裨益&#xff0c;如有不足之处&#xff0c;欢迎在评论区提出指正&#xff0c;让小伙伴们一起学习、交流进步&#xff0c;不论是学业还是工…
阅读更多...
X-Rhodamine maleimide ，ROX 马来酰亚胺，实验室常用的荧光染料

X-Rhodamine maleimide ，ROX 马来酰亚胺，实验室常用的荧光染料

您好&#xff0c;欢迎来到新研之家 文章关键词&#xff1a;X-Rhodamine maleimide &#xff0c;X-Rhodamine mal&#xff0c;ROX-maleimide&#xff0c;ROX 马来酰亚胺 一、基本信息 【产品简介】&#xff1a;ROX, also known as Rhodamine 101, is a product whose active …
阅读更多...
个人博客系统测试

个人博客系统测试

文章目录 一、项目介绍二、测试1. 功能测试2. 自动化测试&#xff08;1&#xff09;添加相关依赖&#xff08;2&#xff09;新建包并在报下创建测试类&#xff08;3&#xff09;亮点及难点 一、项目介绍 个人博客系统采用前后端分离的方法来实现&#xff0c;同时使用了数据库来…
阅读更多...
数据结构二叉树顺序结构——堆的实现

数据结构二叉树顺序结构——堆的实现

二叉树顺序结构——堆的实现 结构体的创建以及接口函数结构体的创建堆的初始化交换函数堆的插入向上调整删除向下调整返回堆的个数返回堆顶数据判断堆是否为空 该文章以大堆作为研究对象 结构体的创建以及接口函数 typedef int HPDateType;//定义动态数组的数据类型 typedef s…
阅读更多...
关于uniapp H5应用无法在触摸屏正常显示的处理办法

关于uniapp H5应用无法在触摸屏正常显示的处理办法

关于uniapp H5应用无法在触摸屏正常显示的处理办法 1、问题2、处理3、建议 1、问题 前几天&#xff0c; 客户反馈在安卓触摸大屏上无法正确打开web系统&#xff08;uni-app vue3开发的h5 应用&#xff09;&#xff0c;有些页面显示不出内容。该应用在 pc 端和手机端都可以正常…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023