Java 测试 JUnit 4 学习

转自：http://blog.csdn.net/piaoliuking/article/details/8485940

参考：《JUnit测试框架使用介绍（以Junit3.x为例）》http://zhangjunhd.blog.51cto.com/113473/132553/

本文主要介绍基于 Junit4.x 的 JUnit 单元测试

Junit简介：

    Junit最初是由Erich Gamma 和 Kent Beck 编写的一个回归测试框架(regression testing framework)，为单元测试（Unit Test）的支持框架。用来编写和执行重覆性的测试。即所谓白盒测试。

它包括了以下的特性：

  1 对预期结果作断言
  2 提供测试装备的生成与销毁
  3 易于组织执行测试
  4 图形与文字界面的测试器

Junit的环境配置
环境：Eclipse 中配置junit，选择项目Junit4(在Package Explorer中) -> 右击鼠标 -> 选择properties -> 选择Java Build Path (在左边的菜单中) -> 在右边选择标签 Libraries  -> 单击按钮“Add Library”  -> 选择JUnit , 单击按钮 “Next>”  -> 选择JUnit library version 为： JUnit4 -> 单击按钮“Finish” –> 单击按钮 “OK”

 Junit4是Junit框架有史以来的最大改进，其主要目标是利用java5的Annotation特性来简化测试用例的编写。Junit4的官方网址是http://www.junit.org/。

总结一下3-4的不同,及4的改进

下面我们以一个简单的例子来介绍如何使用 Junit4同Junit3编写测试用例：

[java] view plaincopyprint?

1. public Class XXXX{  
2.   
3.      public String hello(){  
4.   
5.      return “hello”;  
6.   
7.       }  
8.   
9. }  

对于这个类的用junit3编写测试用例：

[java] view plaincopyprint?

1. import junit.framework.TestCase;  
2.   
3.    public Class XXXXTest extends TestCase{  
4.   
5.    public void testHello(){  
6.   
7.    asssertEqual(new XXXX().Hello(),”hello”);  
8.   
9.   }  
10.   
11. }  

用junit4编写测试用例：

[java] view plaincopyprint?

1. import static org.junit.framework.assertEqual;  
2.   
3. import org.junit.Test;  
4.   
5. //这两个是junit4中必须导入的s  
6.   
7. public Class XXXXTest{  
8.   
9. @Test  
10.   
11. public void helloTest(){  
12.   
13.     asssertEqual(new XXXX().Hello(),”hello”);  
14.   
15. }  
16.   
17. }  

从上面例子我们对Junit3和Junit4有了一个初步的印象，下面我们重点介绍Junit4与Junit3的主要区别。

JUnit3  JUnit4 
必须引入类TestCase
import junit.framework.TestCase; 必须引入
import org.junit.Test;
import static org.junit.Assert.*; 
必须继承类TestCase
class BaseClassTest extends TestCase 不需要 
测试方法必须以test开头
public void testMethod () 不需要，
但是类开始的时候要标记 @Test 
通过assert*方法来判断结果
assertTrue(baseClass.method ().equals(“test.junit.BaseClass”));

3.1 Junit4引入了java 5.0的注释技术：

这两个版本最大的区别在JUnit3.x中测试必须继承 TestCase，并且每个方法名必须以test开头。比如:testMethod1()而在JUnit4.x中不必继承TestCase，采用了注解的方式。只要在测试的方法上加上注解@Test即可，从而不必再遵循以前的一些显式约定和反射定位测试;在JUnit4.x中如果继承了TestCase，注解就不起作用了。并且有很重要的一点就是在JUnit4.x中继承了TestCase后，在OutLine视图中测试单个方法时，结果整个类都run 了。还有一点就是，在3.x中需要实现setUp和tearDown方法，而在4.x中无需这样，可以自定义需要在测试前和测试后的方法，在方法前加上 @before，@after就可以了。所以在JUnit4.x不必继承TestCase用注解即可对单个方法进行测试。

3.2 JUnit4引入了一个JUnit3中没有的新特性——类范围的 setUp() 和tearDown() 方法。任何用 @BeforeClass 注释的方法都将在该类中的测试方法运行之前刚好运行一次，而任何用 @AfterClass 注释的方法都将在该类中的所有测试都运行之后刚好运行一次。

3.3 异常测试：

异常测试是Junit4中的最大改进。Junit3的异常测试是在抛出异常的代码中放入try块，然后在try块的末尾加入一个fail()语句。

例如该方法测试一个被零除抛出一个ArithmeticException:

该方法不仅难看，而且试图挑战代码覆盖工具，因为不管测试是否通过还是失败，总有一些代码不被执行。

在JUni4中，可以编写抛出异常的代码，并使用注释来声明该异常是预期的：如果没有异常抛出或者抛出一个不同的异常，那么测试就将失败。

3.4 JUnit4添加了两个比较数组的assert() 方法：

[java] view plaincopyprint?

1. public static void assertEquals(Object[] expected, Object[] actual)  
2.   
3. public static void assertEquals(String message, Object[] expected, Object[] actual)  

这两个方法以最直接的方式比较数组：如果数组长度相同，且每个对应的元素相同，则两个数组相等，否则不相等。数组为空的情况也作了考虑。

assertEquals()方法用来断定您希望的预期结果与单元方法实际的传回结果是否相同，如果不同则发出断言

JUnit 4 常用的几个annotation 介绍

★ @Before：初始化方法，在任何一个测试执行之前必须执行的代码;

★ @After：释放资源，在任何测试执行之后需要进行的收尾工作。在每个测试方法执行之后执行一次，该annotation只能修饰public void 方法;

★ @Test：测试方法，表明这是一个测试方法。在Junit中将会自动被执行。该annotation只你呢个修饰public void 方法。对于方法的声明也有如下要求：名字可以随便取，没有任何限制，但是返回值必须为void，而且不能有任何参数。如果违反这些规定，会在运行时抛出一个异常。至于方法内该写些什么，那就要看你需要测试些什么了;在这里可以测试期望异常和超时时间，如 @Test(timeout = 100)：我们给测试函数设定一个执行时间，超过了这个时间(100毫秒)，它们就会被系统强行终止，并且系统还会向你汇报该函数结束的原因是因为超时，这样你就可以发现这些Bug了。

★ @Ignore：忽略的测试方法，标注的含义就是“某些方法尚未完成，暂不参与此次测试”;这样的话测试结果就会提示你有几个测试被忽略，而不是失败。一旦你完成了相应函数，只需要把@Ignore标注删去，就可以进行正常的测试。

★ @BeforeClass：针对所有测试，只执行一次，且必须为public static void;

★ @AfterClass：针对所有测试，将会在所有测试方法执行结束后执行一次，且必须为public static void;

所以一个Junit 4 的单元测试用例执行顺序为：@BeforeClass –> @Before –> @Test –> @After –> @AfterClass;每一个测试方法的调用顺序为：@Before –> @Test –> @After。

如下面例子：

[java] view plaincopyprint?

1. import static org.junit.Assert.*;   
2. import org.junit.After;  
3. import org.junit.AfterClass;  
4. import org.junit.Before;  
5. import org.junit.BeforeClass;  
6. import org.junit.Ignore;  
7. import org.junit.Test;   
8.   
9. public class JUnit4Test {  
10.   
11. @Before  
12.   
13. public void before() {  
14.   
15. System.out.println(“@Before”);  
16.   
17. }  
18.   
19. @Test  
20.   
21. public void test() {  
22.   
23. System.out.println(“@Test”);  
24.   
25. assertEquals(5 + 5, 10);  
26.   
27. }  
28.   
29. @Ignore  
30.   
31. @Test  
32.   
33. public void testIgnore() {  
34.   
35. System.out.println(“@Ignore”);  
36.   
37. }  
38.   
39. @Test(timeout = 50)  
40.   
41. public void testTimeout() {  
42.   
43. System.out.println(“@Test(timeout = 50)”);  
44.   
45. assertEquals(5 + 5, 10);  
46.   
47. }  
48.   
49. @Test(expected = ArithmeticException.class)  
50.   
51. public void testExpected() {  
52.   
53. System.out.println(“@Test(expected = Exception.class)”);  
54.   
55. throw new ArithmeticException();  
56.   
57. }  
58.   
59. @After  
60.   
61. public void after() {  
62.   
63. System.out.println(“@After”);  
64.   
65. }  
66.   
67. @BeforeClass  
68.   
69. public static void beforeClass() {  
70.   
71. System.out.println(“@BeforeClass”);  
72.   
73. };  
74.   
75. @AfterClass  
76.   
77. public static void afterClass() {  
78.   
79. System.out.println(“@AfterClass”);  
80.   
81. };  
82.   
83. };  

右击测试类，选择Junit运行……

输出结果如下：

[plain] view plaincopyprint?

1. @BeforeClass  
2.   
3. @Before  
4.   
5. @Test(timeout = 50)  
6.   
7. @After  
8.   
9. @Before  
10.   
11. @Test(expected = Exception.class)  
12.   
13. @After  
14.   
15. @Before  
16.   
17. @Test  
18.   
19. @After  
20.   
21. @AfterClass  

在eclipse中junit运行结果视图中可以看到testIgnore是被忽略的，没有执行;还有其中有一个方法运行报错。

4 常用的断言介绍

 4.1 、assertEquals([String message],Object target,Object result)

target与result不相等，中断测试方法，输出message

assertNull   断言对象为null，若不满足，方法抛出带有相应信息的AssertionFailedError异常。

assertEquals(a, b) 测试a是否等于b（a和b是原始类型数值(primitive value)或者必须为实现比较而具有equal方法）

assertEquals

断言两个对象相等，若不满足，方法抛出带有相应信息的AssertionFailedError异常。

例如计算器加法功能的测试可以使用一下验证：

Assert.assertEquals(0,result)；

4.2  assertTrue/False([String message],Boolean result)

Result为 false/true，中断测试方法，输出message

assertTrue

断言条件为真，若不满足，方法抛出带有相应信息的AssertionFailedError异常。

assertFalse(a) 测试a是否为false（假），a是一个Boolean数值。

assertFalse

断言条件为假，若不满足，方法抛出带有相应信息的AssertionFailedError异常。

4.3  assertNotNull/Null（[String message],Obejct result

Retult= = null/result!=null,中断测试方法，输出message

assertNotNull(a) 测试a是否非空，a是一个对象或者null。

assertNotNull 断言对象不为null，若不满足，方法抛出带有相应信息的AssertionFailedError异常。

4.4  assertSame/NotSame（Object target,Object result）

Traget与result 不指向/指向 同一内存地址（实例），中断测试方法，输出message

assertNotSame(a, b) 测试a和b是否没有都引用同一个对象。

assertNotSame

断言两个引用指向不同对象，若不满足，方法抛出带有相应信息的AssertionFailedError异常。

assertSame 断言两个引用指向同一个对象，若不满足，方法抛出带有相应信息AssertionFailedError异常。

4.5  fail([String message])

中断测试方法，输出message

Fail  让测试失败，并给出指定信息。

[java] view plaincopyprint?

1. @Test  
2.      public void add(){  
3.  assertEquals("不相等","1","1");  
4.       }  

 Junit4中测试类不需要继承自TestCase。不继承TestCase就无法调用assertXXX方法了，正因为如此，所有的assertXXX方法全部以静态方法被放入了Assert类，使用Assert.assertXXX()调用。使用方法是

[java] view plaincopyprint?

1. import static org.junit.Assert.*;   
2. import static org.junit.Assert.*;  

 setUp()和tearDown()方法也依赖@Before和@After标记，这样做的最大的好处是在继承体系内不必担心忘记了在setUp()方法中调用父类的super.setUp()方法，JUnit框架会自动处理父类的@Before和@After标记的方法。

并且，JUnit框架对@Before和@After的调用顺序类似于类的构造方法和析构方法，即@Before按照父类到子类的顺序调用，@After则相反，这样保证了资源的正确获取和释放。

当然，不再强迫必须使用setUp和tearDown作为方法名，可以使用更有意义的方法名，例如：initDatabase()和closeDatabase()，只要它们被标注了@Before和@After即可。

[java] view plaincopyprint?

1. @Before  
2. public void test1(){  
3.  System.out.println("开始初始化----");  
4. }  
5.   
6.  @After  
7.  public void test2(){  
8.   System.out.println("销毁资源----");  
9.  }  
10.    

Unit 4另一个较大的变化是引入了@BeforeClass和@AfterClass，它们在一个Test类的所有测试方法执行前后各执行一次。这是为了能在@BeforeClass中初始化一些昂贵的资源，例如数据库连接，然后执行所有的测试方法，最后在@AfterClass中释放资源。正如你能想到的，由于@BeforeClass和@AfterClass仅执行一次，因此它们只能标记静态方法，在所有测试方法中 共享的资源也必须是静态引用：

[java] view plaincopyprint?

1.   @BeforeClass   
2.     public static void  test11(){    
3.         System.out.println("所有方法调用前要做的事情");    
4.     }    
5.    
6. @AfterClass   
7.     public static  void test22(){    
8.         System.out.println("所有方法测试完后要调用的");    
9.     }    

Junit4可以使用expected=Exception.class来期待一个预期的异常，而不必编写

[java] view plaincopyprint?

1. try{  
2.   
3.     fail("No exception")  
4.   
5. }catch(Exception e){  
6.   
7.    //Ok  
8.   
9. }  

例如：测试数组长度越界的异常。

[java] view plaincopyprint?

1. @Test(expected= IndexOutOfBoundsException.class)     
2.     public void empty() {    
3.         System.out.println("IndexOutOfBoundsException");    
4.         new ArrayList<Object>().get(0);     
5.     }    

对于非常耗时的测试，@Test还有一个timeout来标识该方法最长执行时间，超过此时间即表示该测试方法失败：

[java] view plaincopyprint?

1. @Test(timeout=1)  
2.  public void infinity() {  
3.        while(true);  
4.   }  

以上方法若执行时间超过1ms则测试失败，由于依赖CPU的执行速度，在不同的机器上测试结果也不同。

运行多个测试用例：

Java代码 
JUnitCore.runClasses(MyTest.class);
 

runClasses方法的参数可以写多个测试类的class

 

 下面是一个简单的测试用例。

[java] view plaincopyprint?

1. import static org.junit.Assert.*;    
2.    
3. import java.util.ArrayList;    
4.    
5. import org.junit.After;    
6. import org.junit.AfterClass;    
7. import org.junit.Before;    
8. import org.junit.BeforeClass;    
9. import org.junit.Test;    
10.    
11.    
12. public class MyTest {    
13.     @Before   
14.     public void test1(){    
15.         System.out.println("开始初始化----");    
16.     }    
17.     @BeforeClass   
18.     public static void  test11(){    
19.         System.out.println("所有方法调用前要做的事情");    
20.     }    
21.         
22.     @Test   
23.     public void add(){    
24.         assertEquals("不相等","1","1");    
25.             
26.     }    
27.     @Test   
28.     public void add2(){    
29.         System.out.println("测试用例2");    
30.         assertEquals("不相等","1","1");    
31.             
32.     }    
33.     @Test(expected= IndexOutOfBoundsException.class)     
34.     public void empty() {    
35.         System.out.println("IndexOutOfBoundsException");    
36.         new ArrayList<Object>().get(0);     
37.     }    
38.      @Test(timeout=1)     
39.      public void infinity() {    
40.            while(true);    
41.       }    
42.    
43.    
44.     @After   
45.     public void test2(){    
46.         System.out.println("销毁资源----");    
47.     }    
48.         
49.     @AfterClass   
50.     public static  void test22(){    
51.         System.out.println("所有方法测试完后要调用的");    
52.     }    
53.    
54. }    

运行测试用例：

[java] view plaincopyprint?

1. import junit.framework.JUnit4TestAdapter;    
2.    
3. import org.junit.runner.JUnitCore;    
4.    
5. public class MyTest3 {    
6.     public static void main(String[] args) {    
7.         JUnitCore.runClasses(MyTest.class);    
8.         System.out.println();    
9.         //MyTest3.suite();    
10.     }    
11.    
12.     public static junit.framework.Test suite() {     
13.         return new JUnit4TestAdapter(MyTest.class);     
14.     }    
15.    
16. }