上一节:
下一节:

  JUnit - API

  • 简述

    JUnit 中最重要的包是 junit.framework，其中包含所有核心类。一些重要的类如下 -
    序号 类名称 功能
    1 断言 一组断言方法。
    2 测试用例 一个测试用例定义了运行多个测试的夹具。
    3 测试结果 TestResult 收集执行测试用例的结果。
    4 测试套件 TestSuite 是测试的组合。

  • 断言类

    以下是声明 org.junit.Assert 类 - 
    
public class Assert extends java.lang.Object
    此类提供了一组对编写测试有用的断言方法。只记录失败的断言。Assert 类的一些重要方法如下 -
    序号 方法和说明
    1
    void assertEquals(boolean expected, boolean actual)
    检查两个基元/对象是否相等。
    2
    void assertFalse(boolean condition)
    检查条件是否为假。
    3
    void assertNotNull(Object object)
    检查对象是否为空。
    4
    void assertNull(Object object)
    检查对象是否为空。
    5
    void assertTrue(boolean condition)
    检查条件是否为真。
    6
    void fail()
    没有消息的测试失败。
    让我们在一个例子中使用上面提到的一些方法。在里面创建一个名为TestJunit1.java的java类文件C:\>JUNIT_WORKSPACE. 
    
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);
   }
}
    接下来，创建一个名为的java类文件 TestRunner1.java 在 C:\>JUNIT_WORKSPACE 中执行测试用例。 
    
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 编译测试用例和 Test Runner 类。 
    
C:\JUNIT_WORKSPACE>javac TestJunit1.java TestRunner1.java
    现在运行 Test Runner，它将运行在提供的测试用例类中定义的测试用例。 
    
C:\JUNIT_WORKSPACE>java TestRunner1
    验证输出。 
    
true

  • 测试用例类

    以下是声明 org.junit.TestCase 类 - 
    
public abstract class TestCase extends Assert implements Test
    一个测试用例定义了运行多个测试的夹具。一些重要的方法TestCase 类如下 -
    序号 方法和说明
    1
    int countTestCases()
    统计 run(TestResult result) 执行的测试用例的数量。
    2
    TestResult createResult()
    创建一个默认的 TestResult 对象。
    3
    String getName()
    获取测试用例的名称。
    4
    TestResult run()
    运行此测试的便捷方法，使用默认的 TestResult 对象收集结果。
    5
    void run(TestResult result)
    运行测试用例并在 TestResult 中收集结果。
    6
    void setName(String name)
    设置测试用例的名称。
    7
    void setUp()
    设置灯具，例如，打开网络连接。
    8
    void tearDown()
    例如，拆下固定装置，关闭网络连接。
    9
    String toString()
    返回测试用例的字符串表示形式。
    让我们在一个例子中使用上面提到的一些方法。创建一个名为的java类文件TestJunit2.java 在 C:\>JUNIT_WORKSPACE 中。 
    
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(  ) {
   }
}
    接下来，创建一个名为的java类文件 TestRunner2.java 在 C:\>JUNIT_WORKSPACE 中执行测试用例。 
    
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 编译测试用例和 Test Runner 类。 
    
C:\JUNIT_WORKSPACE>javac TestJunit2.java TestRunner2.java
    现在运行 Test Runner，它将运行在提供的测试用例类中定义的测试用例。 
    
C:\JUNIT_WORKSPACE>java TestRunner2
    验证输出。 
    
No of Test Case = 1
Test Case Name = testAdd
Updated Test Case Name = testNewAdd
true

  • 测试结果类

    以下是声明 org.junit.TestResult 类 - 
    
public class TestResult extends Object
    TestResult 收集执行测试用例的结果。它是收集参数模式的一个实例。测试框架区分失败和错误。预期失败并使用断言检查失败。错误是意料之外的问题，例如 ArrayIndexOutOfBoundsException。一些重要的方法TestResult 类如下 -
    序号 方法和说明
    1
    void addError(Test test, Throwable t)
    将错误添加到错误列表中。
    2
    void addFailure(Test test, AssertionFailedError t)
    将故障添加到故障列表中。
    3
    void endTest(Test test)
    通知结果测试已完成。
    4
    int errorCount()
    获取检测到的错误数。
    5
    Enumeration<TestFailure> errors()
    返回错误的枚举。
    6
    int failureCount()
    获取检测到的故障数。
    7
    void run(TestCase test)
    运行一个测试用例。
    8
    int runCount()
    获取运行测试的数量。
    9
    void startTest(Test test)
    通知结果将开始测试。
    10
    void stop()
    标记测试运行应该停止。
    创建一个名为的java类文件 TestJunit3.java 在 C:\>JUNIT_WORKSPACE 中。 
    
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
   }
}
    接下来，创建一个名为的java类文件 TestRunner3.java 在 C:\>JUNIT_WORKSPACE 中执行测试用例。 
    
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 编译测试用例和 Test Runner 类。 
    
C:\JUNIT_WORKSPACE>javac TestJunit3.java TestRunner3.java
    现在运行 Test Runner，它将运行在提供的测试用例类中定义的测试用例。 
    
C:\JUNIT_WORKSPACE>java TestRunner3
    验证输出。 
    
true

  • 测试套件类

    以下是声明 org.junit.TestSuite 类： 
    
public class TestSuite extends Object implements Test
    TestSuite 是测试的组合。它运行一组测试用例。一些重要的方法TestSuite 类如下 -
    序号 方法和说明
    1
    void addTest(Test test)
    向套件添加测试。
    2
    void addTestSuite(Class<? extends TestCase> testClass)
    将给定类的测试添加到套件中。
    3
    int countTestCases()
    计算此测试将运行的测试用例的数量。
    4
    String getName()
    返回套件的名称。
    5
    void run(TestResult result)
    运行测试并将其结果收集在 TestResult 中。
    6
    void setName(String name)
    设置套件的名称。
    7
    Test testAt(int index)
    返回给定索引处的测试。
    8
    int testCount()
    返回此套件中的测试数量。
    9
    static Test warning(String message)
    返回将失败并记录警告消息的测试。
    创建一个名为的java类文件 JunitTestSuite.java 在 C:\>JUNIT_WORKSPACE 中创建测试套件。 
    
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
上一节:
下一节: