Mockito是一個(gè)Java單元測(cè)試框架，它允許開發(fā)者創(chuàng)建和配置模擬對(duì)象（mock objects），以便在隔離的環(huán)境中測(cè)試代碼，尤其是當(dāng)實(shí)際對(duì)象難以構(gòu)造或其行為不確定時(shí)。下面是一些核心的Mockito API及其使用場(chǎng)景和代碼示例。

基礎(chǔ)API

1. 創(chuàng)建Mock對(duì)象

   • @Mock 注解或 Mockito.mock(Class<T> classToMock) 方法用于創(chuàng)建mock對(duì)象。

   場(chǎng)景: 當(dāng)你需要模擬一個(gè)類的行為，以便測(cè)試依賴于它的類或方法時(shí)。

   示例:

   @Mock
   List<String> mockedList;// 或者
   List<String> mockedList = Mockito.mock(List.class);
   

2. 定義Mock行為

   • Mockito.when(mockedMethodCall).thenReturn(value) 定義當(dāng)特定方法被調(diào)用時(shí)應(yīng)返回的值。

   場(chǎng)景: 你想要控制模擬對(duì)象在特定調(diào)用下的響應(yīng)。

   示例:

   Mockito.when(mockedList.get(0)).thenReturn("first");
   

3. 驗(yàn)證交互

   • Mockito.verify(mockedObject).methodCall(arguments) 驗(yàn)證某個(gè)方法是否按照預(yù)期被調(diào)用了。

   場(chǎng)景: 驗(yàn)證測(cè)試過程中mock對(duì)象的某個(gè)方法確實(shí)被正確調(diào)用。

   示例:

   mockedList.add("one");
   Mockito.verify(mockedList).add("one");
   

4. 捕獲參數(shù)

   • 使用 ArgumentCaptor 捕獲傳遞給mock方法的參數(shù)，以便進(jìn)一步檢查。

   場(chǎng)景: 需要檢查方法調(diào)用的具體參數(shù)時(shí)。

   示例:

   ArgumentCaptor<String> argument = ArgumentCaptor.forClass(String.class);
   Mockito.verify(mockedList).add(argument.capture());
   assertEquals("captured", argument.getValue());
   

5. 設(shè)置異常

   • Mockito.when(mockedMethodCall).thenThrow(exception) 用于模擬方法拋出異常。

   場(chǎng)景: 測(cè)試代碼對(duì)異常的處理邏輯。

   示例:

   Mockito.when(mockedList.get(999)).thenThrow(new IndexOutOfBoundsException());
   

具體使用場(chǎng)景示例

假設(shè)你有一個(gè)UserService類，它依賴于UserRepository來獲取用戶信息。你想測(cè)試UserService的getUserById方法，但不希望真實(shí)地查詢數(shù)據(jù)庫。

public class UserService {private UserRepository userRepository;public UserService(UserRepository userRepository) {this.userRepository = userRepository;}public User getUserById(int id) {return userRepository.findById(id);}
}public interface UserRepository {User findById(int id);
}

測(cè)試類使用Mockito模擬UserRepository：

import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.mockito.Mockito;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.mockito.Mockito.when;class UserServiceTest {@MockUserRepository userRepository;private UserService userService;@BeforeEachvoid setUp() {userService = new UserService(userRepository);}@Testvoid getUserById_ReturnsUser() {// 創(chuàng)建模擬行為User mockUser = new User(1, "John Doe");when(userRepository.findById(1)).thenReturn(mockUser);// 調(diào)用待測(cè)試方法User result = userService.getUserById(1);// 驗(yàn)證結(jié)果assertEquals(mockUser, result);// 驗(yàn)證交互Mockito.verify(userRepository).findById(1);}
}

在這個(gè)例子中，UserRepository被模擬，其findById方法被設(shè)定為返回一個(gè)預(yù)設(shè)的User對(duì)象，從而允許我們專注于測(cè)試UserService的邏輯，而不必關(guān)心數(shù)據(jù)庫操作的細(xì)節(jié)。

當(dāng)然，除了基本的Mock對(duì)象之外，Mockito還提供了Spy功能，以及其他一些高級(jí)特性，以滿足更復(fù)雜的測(cè)試需求。下面我將繼續(xù)介紹這些內(nèi)容。

Spy

Spy與Mock相似，但它會(huì)委托真實(shí)對(duì)象執(zhí)行未被模擬的方法調(diào)用，只有被明確指定的方法才會(huì)被模擬。這在你需要大部分保留原有對(duì)象行為，僅修改或監(jiān)控部分行為時(shí)非常有用。

API:

• Mockito.spy(Object object) 創(chuàng)建一個(gè)Spy對(duì)象。

場(chǎng)景: 當(dāng)你希望大部分情況下使用真實(shí)對(duì)象的行為，只在某些特定方法上進(jìn)行模擬或驗(yàn)證時(shí)。

示例:

public class Calculator {public int add(int a, int b) {return a + b;}public int subtract(int a, int b) {return a - b;}
}@Test
void testSpy() {Calculator realCalculator = new Calculator();Calculator spyCalculator = Mockito.spy(realCalculator);// 模擬add方法的行為when(spyCalculator.add(1, 1)).thenReturn(3);// 調(diào)用真實(shí)subtract方法int result = spyCalculator.subtract(5, 2);// 驗(yàn)證add方法的模擬行為assertEquals(3, spyCalculator.add(1, 1));// 驗(yàn)證subtract方法的調(diào)用及結(jié)果assertEquals(3, result);verify(spyCalculator).subtract(5, 2);
}

其他高級(jí)API

1. DoAnswer: 提供更靈活的方式來定義模擬方法的行為，可以基于回調(diào)函數(shù)執(zhí)行自定義邏輯。

   示例:

   doAnswer(invocation -> {Object[] args = invocation.getArguments();return args[0] + args[1];
   }).when(someMock).someMethod(anyInt(), anyInt());
   

2. BDD風(fēng)格: Mockito提供了一套行為驅(qū)動(dòng)開發(fā)(Behavior-Driven Development)風(fēng)格的API，使得測(cè)試代碼更加可讀。

   示例:

   given(mockedList.get(0)).willReturn("first");
   then(mockedList).should().add("one");
   

3. MockitoJUnitRunner: 使用這個(gè)Runner可以自動(dòng)初始化使用@Mock或@Spy注解的字段，無需在每個(gè)測(cè)試方法中手動(dòng)初始化。

   示例:

   @RunWith(MockitoJUnitRunner.class)
   public class MyTestClass {@MockList<String> mockedList;// 測(cè)試方法...
   }
   

4. MockitoAnnotations.openMocks(this): 如果不使用MockitoJUnitRunner，可以在測(cè)試類的setUp方法中手動(dòng)打開Mockito注解。

   示例:

   @BeforeEach
   public void setUp() {MockitoAnnotations.openMocks(this);
   }
   

通過結(jié)合使用這些API，Mockito能夠幫助開發(fā)者編寫更加高效、精確的單元測(cè)試，確保代碼質(zhì)量。

使用說明

具體使用說明和示例，你可以參考以下資源：

• 官方文檔: 訪問Mockito官方網(wǎng)站，查看最新的官方文檔，包括API參考和用戶指南。
• 在線教程: 網(wǎng)站如Stack Overflow上有大量關(guān)于Mockito使用的問答，涵蓋了從基礎(chǔ)到高級(jí)的各個(gè)方面。
• 技術(shù)博客: CSDN、博客園等技術(shù)社區(qū)有大量Mockito的教程和實(shí)踐分享，比如通過搜索“Mockito進(jìn)階使用”、“Mockito詳盡教程”等關(guān)鍵詞。