课程表

JUnit课程

工具箱
速查手册

JUnit - API

当前位置:免费教程 » Java相关 » JUnit

JUnit 中的重要的 API

JUnit 中的最重要的程序包是 junit.framework 它包含了所有的核心类。一些重要的类列示如下:

序号 类的名称 类的功能
1 Assert assert 方法的集合
2 TestCase 一个定义了运行多重测试的固定装置
3 TestResult TestResult 集合了执行测试样例的所有结果
4 TestSuite TestSuite 是测试的集合

Assert 类

下面介绍的是 org.junit.Assert 类:

  1. 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()
在没有报告的情况下使测试不通过

下面让我们在例子中来测试一下上面提到的一些方法。在 C:\ > JUNIT_WORKSPACE 目录下创建一个名为 TestJunit1.java 的类。

  1. import org.junit.Test;
  2. import static org.junit.Assert.*;
  3. public class TestJunit1 {
  4. @Test
  5. public void testAdd() {
  6. //test data
  7. int num= 5;
  8. String temp= null;
  9. String str= "Junit is working fine";
  10. //check for equality
  11. assertEquals("Junit is working fine", str);
  12. //check for false condition
  13. assertFalse(num > 6);
  14. //check for not null value
  15. assertNotNull(str);
  16. }
  17. }

接下来,我们在 C:\ > JUNIT_WORKSPACE 目录下创建一个文件名为 TestRunner1.java 的类来执行测试案例。

  1. import org.junit.runner.JUnitCore;
  2. import org.junit.runner.Result;
  3. import org.junit.runner.notification.Failure;
  4. public class TestRunner1 {
  5. public static void main(String[] args) {
  6. Result result = JUnitCore.runClasses(TestJunit1.class);
  7. for (Failure failure : result.getFailures()) {
  8. System.out.println(failure.toString());
  9. }
  10. System.out.println(result.wasSuccessful());
  11. }
  12. }

用 javac 编译 Test case 和 Test Runner 类

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

现在运行 Test Runner 它将运行在 Test Case 类中定义并提供的测试样例。

  1. C:\JUNIT_WORKSPACE>java TestRunner1

检查输出结果。

  1. true

TestCase 类

下面介绍的是 org.junit.TestCaset 类:

  1. public abstract class TestCase extends Assert implements Test

测试样例定义了运行多重测试的固定格式。TestCase 类的一些重要方法列式如下:

序号 方法和描述
1 int countTestCases()
为被run(TestResult result) 执行的测试案例计数
2 TestResult createResult()
创建一个默认的 TestResult 对象
3 String getName()
获取 TestCase 的名称
4 TestResult run()
一个运行这个测试的方便的方法,收集由TestResult 对象产生的结果
5 void run(TestResult result)
在 TestResult 中运行测试案例并收集结果
6 void setName(String name)
设置 TestCase 的名称
7 void setUp()
创建固定装置,例如,打开一个网络连接
8 void tearDown()
拆除固定装置,例如,关闭一个网络连接
9 String toString()
返回测试案例的一个字符串表示

我们在例子中尝试一下上文提到的方法。在 C:\ > JUNIT_WORKSPACE 路径下创建一个名为TestJunit2.java 的类。

  1. import junit.framework.TestCase;
  2. import org.junit.Before;
  3. import org.junit.Test;
  4. public class TestJunit2 extends TestCase {
  5. protected double fValue1;
  6. protected double fValue2;
  7. @Before
  8. public void setUp() {
  9. fValue1= 2.0;
  10. fValue2= 3.0;
  11. }
  12. @Test
  13. public void testAdd() {
  14. //count the number of test cases
  15. System.out.println("No of Test Case = "+ this.countTestCases());
  16. //test getName
  17. String name= this.getName();
  18. System.out.println("Test Case Name = "+ name);
  19. //test setName
  20. this.setName("testNewAdd");
  21. String newName= this.getName();
  22. System.out.println("Updated Test Case Name = "+ newName);
  23. }
  24. //tearDown used to close the connection or clean up activities
  25. public void tearDown( ) {
  26. }
  27. }

接下来,在 C:\ > JUNIT_WORKSPACE 路径下创建一个名为 TestRunner2.java 的类来执行测试案例。

  1. import org.junit.runner.JUnitCore;
  2. import org.junit.runner.Result;
  3. import org.junit.runner.notification.Failure;
  4. public class TestRunner2 {
  5. public static void main(String[] args) {
  6. Result result = JUnitCore.runClasses(TestJunit2.class);
  7. for (Failure failure : result.getFailures()) {
  8. System.out.println(failure.toString());
  9. }
  10. System.out.println(result.wasSuccessful());
  11. }
  12. }

用 javac 编译 Test case 和 Test Runner 类

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

现在运行 Test Runner 它将运行在 Test Case 类中定义并提供的测试样例。

  1. C:\JUNIT_WORKSPACE>java TestRunner2

检查输出结果。

  1. No of Test Case = 1
  2. Test Case Name = testAdd
  3. Updated Test Case Name = testNewAdd
  4. true

TestResult 类

下面定义的是 org.junit.TestResult 类:

  1. 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 errors()
返回错误的详细信息
6 int failureCount()
获取被检测出的失败的数量
7 void run(TestCase test) 运行 TestCase
8 int int runCount()
获得运行测试的数量
9 void startTest(Test test)
声明一个测试即将开始
10 void stop()
标明测试必须停止

C:\ > JUNIT_WORKSPACE 路径下创建一个名为 TestJunit3.java 的类。

  1. import org.junit.Test;
  2. import junit.framework.AssertionFailedError;
  3. import junit.framework.TestResult;
  4. public class TestJunit3 extends TestResult {
  5. // add the error
  6. public synchronized void addError(Test test, Throwable t) {
  7. super.addError((junit.framework.Test) test, t);
  8. }
  9. // add the failure
  10. public synchronized void addFailure(Test test, AssertionFailedError t) {
  11. super.addFailure((junit.framework.Test) test, t);
  12. }
  13. @Test
  14. public void testAdd() {
  15. // add any test
  16. }
  17. // Marks that the test run should stop.
  18. public synchronized void stop() {
  19. //stop the test here
  20. }
  21. }

接下来,在 C:\ > JUNIT_WORKSPACE 路径下创建一个名为 TestRunner3.java 的类来执行测试案例。

  1. import org.junit.runner.JUnitCore;
  2. import org.junit.runner.Result;
  3. import org.junit.runner.notification.Failure;
  4. public class TestRunner3 {
  5. public static void main(String[] args) {
  6. Result result = JUnitCore.runClasses(TestJunit3.class);
  7. for (Failure failure : result.getFailures()) {
  8. System.out.println(failure.toString());
  9. }
  10. System.out.println(result.wasSuccessful());
  11. }
  12. }

用 javac 编译 Test case 和 Test Runner 类

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

现在运行 Test Runner 它将运行在 Test Case 类中定义并提供的测试样例。

  1. C:\JUNIT_WORKSPACE>java TestRunner3

检查输出结果。

  1. true

TestSuite 类

下面定义的是 org.junit.TestSuite 类:

  1. 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)
返回会失败的测试并且记录警告信息。

C:\ > JUNIT_WORKSPACE 路径下创建一个名为 JunitTestSuite.java 的类。

  1. import junit.framework.*;
  2. public class JunitTestSuite {
  3. public static void main(String[] a) {
  4. // add the test's in the suite
  5. TestSuite suite = new TestSuite(TestJunit1.class, TestJunit2.class, TestJunit3.class );
  6. TestResult result = new TestResult();
  7. suite.run(result);
  8. System.out.println("Number of test cases = " + result.runCount());
  9. }
  10. }

用 javac 编译 Test suit

  1. C:\JUNIT_WORKSPACE>javac JunitTestSuite.java

现在运行 Test Suit

  1. C:\JUNIT_WORKSPACE>java JunitTestSuite

检查输出结果。

  1. No of Test Case = 1
  2. Test Case Name = testAdd
  3. Updated Test Case Name = testNewAdd
  4. Number of test cases = 3
转载本站内容时,请务必注明来自W3xue,违者必究。
 友情链接:直通硅谷  点职佳  北美留学生论坛

本站QQ群:前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

W3xue 的所有内容仅供测试,对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接(目前9元/月)请联系QQ:27243702 沸活量
皖ICP备17017327号-2 皖公网安备34020702000426号