一  為什么要寫單元測試？

二  為什么推薦鏈路思想？

1. 應該如何設計測試用例？
2. 應該如何編寫測試用例？
3. 測試用例的質(zhì)量該如何判定？

但無論測試用例如何設計或是如何編寫，我始終認為，在不考慮測試代碼的風格和規(guī)范的前提下，衡量測試用例質(zhì)量的核心指標是分支覆蓋率。這也是我推薦鏈路思想的一大原因——從入口出發(fā)，遍歷鏈路上各個環(huán)節(jié)的各個分支，遇到阻礙就Mock；相比于分別單測各個獨立方法，單測鏈路所需要的入?yún)⒑统鰠⒏忧逦?，更是大大?jié)省了編寫測試代碼所需的時間成本！計算分支覆蓋率的工具有很多，例如本地的JaCoCo或是各類云化測試工具。試想，每當看到單測完美地覆蓋了自己所提交的特性代碼時，心里是不是放心了許多？

.

當然，基于鏈路思想的開發(fā)還遠遠不夠，在補充單測用例時，我們同樣也能用鏈路思想來構造測試用例。測試用例的要求很簡單，需要覆蓋controller、service等自主編寫的代碼(多分支場景也需要完全覆蓋)，對于周邊關聯(lián)的系統(tǒng)可以采用Mock進行屏蔽，對于Dao層的SQL可以視需求決定是否Mock。秉承這個思路，我們可以對“用戶買豬”圖進行改造，將允許Mock的環(huán)節(jié)涂灰，從而變成我們在編寫單元測試用例時所需要的“虛擬用戶買豬”圖。

	
	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	



/** * 豬肉庫存的數(shù)據(jù)庫實體類 */@Data@NoArgsConstructor@AllArgsConstructor@Builder@TableName(value = "pork_storage", autoResultMap = true)public class PorkStorage { @TableId(value = "id", type = IdType.AUTO) private Long id;  private Long cnt;}

	
	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	



/** * 豬肉實例，由倉庫打包后生成 **/@Data@NoArgsConstructor@AllArgsConstructor@Builderpublic class PorkInst { /** * 重量 */ private Long weight;  /** * 附件參數(shù)，例如包裝類型，寄送地址等信息 */ private Map<String, Object> paramsMap;}

	
	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	



@RestController@Slf4j@RequestMapping("/pork")public class PorkController { @Autowired private PorkService porkService;  @PostMapping("/buy") public ResponseEntity<PorkInst> buyPork(@RequestParam("weight") Long weight, @RequestBody Map<String,Object> params) { if (weight == null) { throw new BaseBusinessException("invalid input: weight", ExceptionTypeEnum.INVALID_REQUEST_PARAM_ERROR); } return ResponseEntity.ok(porkService.getPork(weight, params)); }}


PorkService.java

	
	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	



public interface PorkService { /** * 獲取豬肉打包實例 * * @param weight 重量 * @param params 額外信息 * @return {@link PorkInst} - 指定數(shù)量的豬肉實例 * @throws BaseBusinessException 如果豬肉庫存不足，返回異常，同時后臺告知工廠 */ PorkInst getPork(Long weight, Map<String, Object> params);}

	
	

		
	

	

		
	

	

		
	

	

		
	



@Mapperpublic interface PorkStorageDao extends BaseMapper<PorkStorage> { PorkStorage queryStore();}

	
	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	



<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mapper namespace="com.alibaba.ut.demo.dao.PorkStorageDao"> <sql id="columns">id, cnt</sql> <sql id="table_name">pork_storage</sql> <select id="queryStore" resultType="com.alibaba.ut.demo.entity.PorkStorage"> select <include refid="columns"/> from <include refid="table_name"/> where id = 1 </select></mapper>

	
	

		
	

	

		
	

	

		
	



public interface FactoryApi { void supplyPork(Long weight);}

	
	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	



@Service@Slf4jpublic class FactoryApiImpl implements FactoryApi { @Override public void supplyPork(Long weight) { log.info("call real factory to supply pork, weight: {}", weight); }}

	
	

		
	

	

		
	

	

		
	



public interface WareHouseApi { PorkInst packagePork(Long weight, Map<String, Object> params);}

	
	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	



@Service@Slf4jpublic class WareHouseApiImpl implements WareHouseApi { @Override public PorkInst packagePork(Long weight, Map<String, Object> params) { log.info("call real warehouse to package, weight: {}", weight); return PorkInst.builder().weight(weight).paramsMap(params).build(); }}

	
	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	



 <!--    test    --> <dependency> <groupId>com.taobao.pandora</groupId> <artifactId>pandora-boot-test</artifactId> <scope>test</scope> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-test</artifactId> <scope>test</scope> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-test</artifactId> <scope>test</scope> </dependency> <dependency> <groupId>org.mockito</groupId> <artifactId>mockito-all</artifactId> <version>1.10.19</version> <scope>test</scope> </dependency>

單測代碼

	
	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	

	

		
	



package com.alibaba.ut.demo.controller; import com.alibaba.ut.demo.PorkController;import com.alibaba.ut.demo.api.FactoryApi;import com.alibaba.ut.demo.api.WareHouseApi;import com.alibaba.ut.demo.dao.PorkStorageDao;import com.alibaba.ut.demo.entity.PorkInst;import com.alibaba.ut.demo.entity.PorkStorage;import com.alibaba.ut.demo.exception.BaseBusinessException;import com.alibaba.ut.demo.service.impl.PorkServiceImpl;import lombok.extern.slf4j.Slf4j;import org.junit.After;import org.junit.Assert;import org.junit.Before;import org.junit.Test;import org.mockito.InjectMocks;import org.mockito.Mock;import org.mockito.MockitoAnnotations;import org.mockito.Spy;import org.mockito.stubbing.Answer;import org.springframework.http.HttpEntity;import org.springframework.http.HttpStatus;import org.springframework.http.ResponseEntity; import java.util.HashMap;import java.util.Map;import java.util.Optional; import static org.mockito.Matchers.any;import static org.mockito.Mockito.doAnswer;import static org.mockito.Mockito.when; /** * @Author Taofu.lj * @Version 1.0.0 * @Date 2021年12月02日 14:15 */@Slf4jpublic class PorkControllerTest { /** * controller入口，由于是鏈路入口，無需用@Spy監(jiān)聽 */ @InjectMocks private PorkController porkController;  /** * 接口類型的鏈路環(huán)節(jié)用實現(xiàn)類初始化代替, @Spy需要手動初始化避免initMocks時失敗 * 注：鏈路上每一環(huán)都必須聲明，即使測試用例中并沒有被顯性調(diào)用 */ @InjectMocks @Spy private PorkServiceImpl porkService = new PorkServiceImpl();  /** * 待Mock的鏈路環(huán)節(jié)，下同 */ @Mock private PorkStorageDao porkStorageDao;  @Mock private FactoryApi factoryApi;  @Mock private WareHouseApi wareHouseApi;  /** * 預置數(shù)據(jù)可直接作為類變量聲明 */ private final Map<String, Object> mockParams = new HashMap<String, Object>() {{ put("user", "system_user"); }};  @Before public void setup() { // 必要: 初始化該類中所聲明的Mock和InjectMock對象 MockitoAnnotations.initMocks(this);  // Mock預置數(shù)據(jù)并綁定相關方法(適用于有返回值的方法) PorkStorage mockStorage = PorkStorage.builder().id(1L).cnt(10L).build();  // 常見Mock寫法一：僅試圖Mock返回值 when(porkStorageDao.queryStore()).thenReturn(mockStorage);  // 常見Mock寫法二：不僅試圖Mock返回值，還想額外打些日志方便定位 when(wareHouseApi.packagePork(any(), any())) .thenAnswer(ans -> { log.info("mock log can be written here"); return PorkInst.builder() .weight(ans.getArgumentAt(0, Long.class)) .paramsMap(ans.getArgumentAt(1, Map.class)) .build(); });  // Mock動作并綁定相關方法(適用于無返回值方法) doAnswer((Answer<Void>) invocationOnMock -> { log.info("mock factory api success!"); return null; }).when(factoryApi).supplyPork(any()); }  @After public void teardown() { // TODO: 可以加入Mock數(shù)據(jù)清理或資源釋放 }  /** * 當傳入?yún)?shù)為null時，拋出業(yè)務異常 * * @throws BaseBusinessException */ @Test(expected = BaseBusinessException.class) public void testBuyPorkIfWeightIsNull() { porkController.buyPork(null, mockParams); }  /** * 當后臺庫存不滿足需求時，拋出業(yè)務異常 * * @throws BaseBusinessException */ @Test(expected = BaseBusinessException.class) public void testBuyPorkIfStorageIsShortage() { porkController.buyPork(20L, mockParams); }  /** * 正常購買時返回業(yè)務結(jié)果 */ @Test public void testBuyPorkIfResultIsOk() { Long expectWeight = 5L;  ResponseEntity<PorkInst> res = porkController.buyPork(expectWeight, mockParams); // 此處第一次校驗接口返回狀態(tài)是否符合預期 Assert.assertEquals(HttpStatus.OK, res.getStatusCode());  Long actualWeight = Optional.of(res).map(HttpEntity::getBody).map(PorkInst::getWeight).orElse(-99L); // 此處第二次校驗接口返回值是否符合預期 Assert.assertEquals(expectWeight, actualWeight); }}


推薦閱讀：

單元測試的意義是什么？：https://www.zhihu.com/question/49530527

Better code, faster: 8 reasons why you should use unit testing ：https://fortegrp.com/the-importance-of-unit-testing/




阿里云云原生攜10+技術專家?guī)怼对圃c云未來的新可能》

	



2021年12月，阿里云攜10+技術專家亮相年度頂級云原生開源技術峰會 KubeCon + CloudNa tiveCon + Open Source Summit China 2021，并帶來阿里云云原生專場，不僅匯聚行業(yè)發(fā)展方向的精彩主題演講，在云基礎設施、可觀察性、存儲、定制和擴展 Kubernetes、性能、服務網(wǎng)格、無服務器、容器運行時、CI/CD、網(wǎng)絡等云原生與開源技術等各大專題中，從阿里云真實業(yè)務場景中走出來的云原生技術最佳實踐也向全球開發(fā)者一一呈現(xiàn)。

如果說云原生代表了云計算的今天，那么云計算的未來會是什么樣?我們將本次阿里云云原生專場的技術專家們分享內(nèi)容實錄匯集本書，希望與更多的開發(fā)者共同探索“云未來，新可能”。