JUnit - 基本用法

我們來看一個基本示例，展示使用 JUnit 的分步流程。

建立類

建立要測試的 Java 類，例如 MessageUtil.java 在 C:\>JUNIT_WORKSPACE

/*
* This class prints the given message on console.
*/

public class MessageUtil {

   private String message;

   //Constructor
   //@param message to be printed
	
   public MessageUtil(String message){
      this.message = message;
   }
      
   // prints the message
   public String printMessage(){
      System.out.println(message);
      return message;
   }   
}  

建立測試用例類

• 建立一個 Java 測試類，例如 TestJunit.java。
• 向測試類中新增一個測試方法 testPrintMessage()。
• 向方法 testPrintMessage() 新增一個註釋 @Test。
• 實現測試條件並使用 JUnit 的 assertEquals API 檢查條件。

在 C:\>JUNIT_WORKSPACE 中建立 Java 類檔案 TestJunit.java。

import org.junit.Test;
import static org.junit.Assert.assertEquals;

public class TestJunit {
	
   String message = "Hello World";	
   MessageUtil messageUtil = new MessageUtil(message);

   @Test
   public void testPrintMessage() {
      assertEquals(message,messageUtil.printMessage());
   }
}

建立測試執行器類

• 建立一個 TestRunner Java 類。
• 使用 TestRunner.java 的 JUnitCore 類的 runClasses 方法執行上述建立的測試類的測試用例。
• 獲取 Result 物件中執行的測試用例的結果。
• 使用 Result 物件的 getFailures() 方法獲取失敗案例。
• 使用 Result 物件的 wasSuccessful() 方法獲取成功結果。

在 C:\>JUNIT_WORKSPACE 中建立一個名為 TestRunner.java 的 Java 類檔案以執行測試用例。

import org.junit.runner.JUnitCore;
import org.junit.runner.Result;
import org.junit.runner.notification.Failure;

public class TestRunner {
   public static void main(String[] args) {
      Result result = JUnitCore.runClasses(TestJunit.class);
		
      for (Failure failure : result.getFailures()) {
         System.out.println(failure.toString());
      }
		
      System.out.println(result.wasSuccessful());
   }
}  	

使用 javac 編譯 MessageUtil、測試用例和測試執行器類。

C:\JUNIT_WORKSPACE>javac MessageUtil.java TestJunit.java TestRunner.java

現在執行測試執行器，它將執行在提供的測試用例類中定義的測試用例。

C:\JUNIT_WORKSPACE>java TestRunner

驗證輸出。

Hello World
true

現在更新 C:\>JUNIT_WORKSPACE 中的 TestJunit，使其測試失敗。更改訊息字串。

import org.junit.Test;
import static org.junit.Assert.assertEquals;

public class TestJunit {
	
   String message = "Hello World";	
   MessageUtil messageUtil = new MessageUtil(message);

   @Test
   public void testPrintMessage() {
      message = "New Word";
      assertEquals(message,messageUtil.printMessage());
   }
}

讓我們保持其他類不變，並嘗試執行相同的測試執行器。

import org.junit.runner.JUnitCore;
import org.junit.runner.Result;
import org.junit.runner.notification.Failure;

public class TestRunner {

   public static void main(String[] args) {
      Result result = JUnitCore.runClasses(TestJunit.class);
		
      for (Failure failure : result.getFailures()) {
         System.out.println(failure.toString());
      }
		
      System.out.println(result.wasSuccessful());
   }
}

現在執行測試執行器，它將執行在提供的測試用例類中定義的測試用例。

C:\JUNIT_WORKSPACE>java TestRunner

驗證輸出。

Hello World
testPrintMessage(TestJunit): expected:<[New Wor]d> but was:<[Hello Worl]d>
false