淘系用户平台技术团队单元测试建设

纵观优秀的开源工程，完备的单元测试总是必须的条件。通过这些单元测试，我们可以充分了解代码中相关类和方法的作用和核心逻辑，熟悉各种场景的运行情况。同时也因为有了单元测试，开源作者在接受各种feature的代码提交时才有稳定安全的保障。其实单元测试的重要性所有开发同学应该都了然于胸，同样TDD(测试驱动开发)也不是一个新的概念，但是真当我们落地实践时，又总会找出各种各样的理由来劝服自己下次一定好好写单元测试，这一次先放过自己。这些理由无外乎，开发周期太紧了; 测试同学能保证功能正确性;写单元测试代码量比业务代码还大; 又不是不能跑。所以虽然我们总是在追逐工程师文化，却又时不时放纵在放弃工程师底蕴的路上。

摘自阿里巴巴开发规约

• 单元测试必须遵守AIR原则，单元测试必须具备Automatic(自动化)，Independent(独立性)，Repeatable(可重复)性；

• 单元测试应该是全自动执行的，并且非交互式的。测试用例通常是被定期执行的，执行过程必须完全自动化才有意义。输出结果需要人工检查的测试不是一个好的单元测试；

• 单元测试要保证测试粒度足够小。单元测试测试粒度足够小，有助于精确定位问题。单测粒度至多是类级别，一般是方法级别；

• 单元测试要遵守BCDE原则，Border，边界值测试，包括循环边界、特殊取值、特殊时间点、数据顺序等；Correct，正确的输入，并得到预期的结果；Design，与设计文档相结合，来编写单元测试；Error，强制错误信息输入（如：非法数据、异常流程、非业务允许输入等），并得到预期的结果；

• 核心业务、核心应用、核心模块的增量代码要确保单元测试通过；

1. Mock :
   通过when().thenReturn/thenAnswer/thenThrow 或者doReturn().when()等mock方式将依赖类方法进行模拟，模拟服务依赖或者中间结果

   
   

2. DO :  
   调用被测试类方法，执行测试链路

   
   

3. Verify :  
   校验执行结果正确性，通过Assert校验数据结果准确，通过Verify校验链路执行准确，通过expected=Exception.class校验异常链路

public class Test {    // 0. 依赖类    @Mock    DependencyClass dependencyClass;    // 0. 待测试类    @InjectMocks    TestClass testClass;
    @Before    public void setUp() {        MockitoAnnotations.initMocks(this);    }
    @Test    public void testMethod() {        // 1. Mock, 依赖方法，构造中间层数据        when(dependencyClass.someMehod(any())).thenReturn(mockData());        // 2. Do, 调用被测试类        Result result = testClass.testMehod();        // 3. Verify, 校验结果数据        Assert.assertEquals("some expected result string", result.getModel());    }}

@Componentpublic class DefaultMemberManager implements MemberManager {    @Autowired    private MemberDAO memberDAO;    @Autowired    private CacheManager cacheManager;
    @Override    public Date queryActivationTime(long userId) {        Date activationTime = cacheManager.getActivationTime(userId);        if (activationTime == null) {            MemberDO memberDO = memberDAO.queryByUserId(userId);            if (memberDO != null) {                cacheManager.saveActivationTime(userId, memberDO.getActiveTime());                activationTime = memberDO.getActiveTime();            }        }        return activationTime;    }}

public class DefaultMemberManagerTest {    @Mock    MemberDAO memberDAO;    @Mock    CacheManager cacheManager;    @InjectMocks    DefaultMemberManager defaultMemberManager;
    @Before    public void setUp() {        MockitoAnnotations.initMocks(this);    }
    @Test    public void testQueryActivationTime() throws Exception {        when(memberDAO.queryByUserId(anyLong())).thenReturn(null);        when(cacheManager.getActivationTime(anyLong())).thenReturn(            new GregorianCalendar(2022, Calendar.MARCH, 5, 23, 2).getTime());        Date result = defaultMemberManager.queryActivationTime(0L);        Assert.assertEquals(new GregorianCalendar(2022, Calendar.MARCH, 5, 23, 2).getTime(), result);    }}

1. 代码提交时，保证单元测试执行及时性
2. 代码审核时，保证代码审核通过的代码分支符合单元测试标准
3. 发布流程中，保证最终集成发布的所有分支代码符合单元测试标准

• 单元测试用例通过率为100%
• 单元测试增量代码行覆盖率为85%
• 代码规范扫描增量问题总数为0个