JUnit - API

---

---

JUnit 中最重要的包是junit.framework，它包含所有核心類。一些重要的類如下：

Assert 類

以下是org.junit.Assert 類的宣告：

public class Assert extends java.lang.Object

此類提供了一組用於編寫測試的斷言方法。只有失敗的斷言才會被記錄。Assert 類的一些重要方法如下：

讓我們在一個例子中使用上面提到的某些方法。在C:\>JUNIT_WORKSPACE中建立一個名為TestJunit1.java 的java類檔案。

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

public class TestJunit1 {
   @Test
   public void testAdd() {
      //test data
      int num = 5;
      String temp = null;
      String str = "Junit is working fine";

      //check for equality
      assertEquals("Junit is working fine", str);
      
      //check for false condition
      assertFalse(num > 6);

      //check for not null value
      assertNotNull(temp);
   }
}

接下來，在C:\>JUNIT_WORKSPACE中建立一個名為TestRunner1.java的java類檔案來執行測試用例。

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

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

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

C:\JUNIT_WORKSPACE>javac TestJunit1.java TestRunner1.java

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

C:\JUNIT_WORKSPACE>java TestRunner1

驗證輸出。

true

TestCase 類

以下是org.junit.TestCase 類的宣告：

public abstract class TestCase extends Assert implements Test

測試用例定義了執行多個測試的fixture。TestCase類的一些重要方法如下：

讓我們在一個例子中使用上面提到的某些方法。在C:\>JUNIT_WORKSPACE中建立一個名為TestJunit2.java的java類檔案。

import junit.framework.TestCase;
import org.junit.Before;
import org.junit.Test;

public class TestJunit2 extends TestCase  {
   protected double fValue1;
   protected double fValue2;
   
   @Before 
   public void setUp() {
      fValue1 = 2.0;
      fValue2 = 3.0;
   }
	
   @Test
   public void testAdd() {
      //count the number of test cases
      System.out.println("No of Test Case = "+ this.countTestCases());
		
      //test getName 
      String name = this.getName();
      System.out.println("Test Case Name = "+ name);

      //test setName
      this.setName("testNewAdd");
      String newName = this.getName();
      System.out.println("Updated Test Case Name = "+ newName);
   }
	
   //tearDown used to close the connection or clean up activities
   public void tearDown(  ) {
   }
}

接下來，在C:\>JUNIT_WORKSPACE中建立一個名為TestRunner2.java的java類檔案來執行測試用例。

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

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

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

C:\JUNIT_WORKSPACE>javac TestJunit2.java TestRunner2.java

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

C:\JUNIT_WORKSPACE>java TestRunner2

驗證輸出。

No of Test Case = 1
Test Case Name = testAdd
Updated Test Case Name = testNewAdd
true

TestResult 類

以下是org.junit.TestResult類的宣告：

public class TestResult extends Object

TestResult 收集執行測試用例的結果。它是收集引數模式的一個例項。測試框架區分失敗和錯誤。失敗是預期的，並透過斷言進行檢查。錯誤是意外的問題，例如ArrayIndexOutOfBoundsException。TestResult類的一些重要方法如下：

在C:\>JUNIT_WORKSPACE中建立一個名為TestJunit3.java的java類檔案。

import org.junit.Test;
import junit.framework.AssertionFailedError;
import junit.framework.TestResult;

public class TestJunit3 extends TestResult {
   // add the error
   public synchronized void addError(Test test, Throwable t) {
      super.addError((junit.framework.Test) test, t);
   }

   // add the failure
   public synchronized void addFailure(Test test, AssertionFailedError t) {
      super.addFailure((junit.framework.Test) test, t);
   }
	
   @Test
   public void testAdd() {
      // add any test
   }
   
   // Marks that the test run should stop.
   public synchronized void stop() {
      //stop the test here
   }
}

接下來，在C:\>JUNIT_WORKSPACE中建立一個名為TestRunner3.java的java類檔案來執行測試用例。

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

public class TestRunner3 {
   public static void main(String[] args) {
      Result result = JUnitCore.runClasses(TestJunit3.class);

      for (Failure failure : result.getFailures()) {
         System.out.println(failure.toString());
      }
		
      System.out.println(result.wasSuccessful());
   }
}  	

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

C:\JUNIT_WORKSPACE>javac TestJunit3.java TestRunner3.java

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

C:\JUNIT_WORKSPACE>java TestRunner3

驗證輸出。

true

TestSuite 類

以下是org.junit.TestSuite類的宣告

public class TestSuite extends Object implements Test

TestSuite 是測試的組合。它執行一系列測試用例。TestSuite類的一些重要方法如下：

在C:\>JUNIT_WORKSPACE中建立一個名為JunitTestSuite.java的java類檔案來建立測試套件。

import junit.framework.*;

public class JunitTestSuite {
   public static void main(String[] a) {
      // add the test's in the suite
      TestSuite suite = new TestSuite(TestJunit1.class, TestJunit2.class, TestJunit3.class );
      TestResult result = new TestResult();
      suite.run(result);
      System.out.println("Number of test cases = " + result.runCount());
   }
}

使用javac編譯測試套件類。

C:\JUNIT_WORKSPACE>javac JunitTestSuite.java 

現在執行測試套件。

C:\JUNIT_WORKSPACE>java JunitTestSuite

驗證輸出。

No of Test Case = 1
Test Case Name = testAdd
Updated Test Case Name = testNewAdd
Number of test cases = 3