JUnit简单使用教程

时间:2021-08-22 16:18:20
JUnit简介

JUnit是由 Erich Gamma和Kent Beck编写的一个回归测试框架(regression testing framework)。JUnit测试是程序员测试,即所谓白盒测试,因为程序员知道被测试的软件如何(How)完成功能和完成什么样(What)的功能。



简单编写单元测试实例

public class JunitAnnotation {

// execute before class
@BeforeClass
public static void beforeClass() {
System.out.println("in before class");
}

// execute after class
@AfterClass
public static void afterClass() {
System.out.println("in after class");
}

// execute before test
@Before
public void before() {
System.out.println("in before");
}

// execute after test
@After
public void after() {
System.out.println("in after");
}

// test case
@Test
public void test() {
System.out.println("in test");
}

// test case ignore and will not execute
@Ignore(“unimplemented”)
public void ignoreTest() {
System.out.println("in ignore test");
}
}



JUnit常用注解介绍

@Test:JUnit 3.x是通过对测试方法的命名(test+方法名)来确定是否是测试,且所有的测试类必须继承TestCase。JUnit 4.x只需要在方法前加上@Test 就可以定义一个测试方法。

注意:测试方法必须是public void,即公共、无返回值的;可以抛出异常。

@Ignore该注解标记的测试方法在测试中会被忽略。当测试的方法还没有实现,或者测试的方法已经过时,或者在某种条件下才能测试该方法(比如需要一个数据库连接,而在本地测试的时候,数据库并没有连接),那么使用该注解来标记这个方法。同时可以为该注解传递一个String的参数,表明为什么会忽略这个测试方法。比如:@lgnore(“该方法还没有实现”),在执行的时候,仅会报告该方法没有实现,而不会运行测试方法。

@BeforeClass:当我们运行几个有关联的用例时,可能会在数据准备或其它前期准备中执行一些相同的命令,这个时候为了让代码更清晰,更少冗余,可以将公用的部分提取出来, 放在一个方法里,并为这个方法注解@BeforeClass。意思是在测试类里所有用例运行之前,运行一次这个方法。例如创建数据库连接、读取文件等。

注意:方法名可以任意,但必须是public static void,即公开的、静态的、无返回值的。这个方法只会运行一次。

@AfterClass:跟@BeforeClass对应,在测试类里所有用例运行之后,运行一次。用于处理一些测试后续工作,例如清理数据,恢复现场。

注意:同样必须是public static void,即公开的、静态的、无返回值的。这个方法只会运行一次。

@Before使用了该注解的方法在每个测试方法执行之前都要执行一次。主要用于一些独立于用例之间的准备工作。比如两个用例都需要读取数据库里的用户A信息,但第一个用例会删除这个用户A,而第二个用例需要修改用户A。那么可以用@BeforeClass创建数据库连接。用@Before来插入一条用户A信息。

注意:必须是public void,不能为static。

@After 使用了该注解的方法在每个测试方法执行之后要执行一次。

@Runwith
:即测试运行器,放在测试类名之前,用来确定测试类怎么运行的,当不指定这个注解时,使用默认Runner来运行测试代码,即@RunWith(JUnit4.class)。


常见的运行器有:

(1)@RunWith(Parameterized.class):参数化运行器,配合@Parameters使用JUnit的参数化功能。

(2)@RunWith(Suite.class)

@SuiteClasses({ATest.class,BTest.class,CTest.class})

测试集运行器配合使用测试集功能。

(3)@RunWith(JUnit4.class):JUnit 4的默认运行器

(4)@RunWith(JUnit38ClassRunner.class):用于兼容junit3.8的运行器

(5)一些其它运行器具备更多功能。例如@RunWith(SpringJUnit4ClassRunner.class)集成了Spring的一些功能。



@Parameters:用于JUnit的参数化功能,用来标记准备数据的方法。

注意:该方法需要满足一定的要求:

  1. 该方法必须为public static的
  2. 该方法返回值必须为java.util.Collection类型 
  3. 该方法的名字不做要求 
  4. 该方法没有参数 


参数化测试

为了保证单元测试的严谨性,我们模拟了不同的测试数据来测试方法的处理能力,为此我们编写了大量的单元测试方法。而这些测试方法大同小异:代码结构都是相同的,不同的仅仅是测试数据和期望值。为了降低代码的冗余,JUnit 4提供了参数化测试,即只写一个测试方法,把这若干种情况作为参数传递进去,一次性的完成测试。

JUnit 4参数化测试的五个步骤

  1. 为准备使用参数化测试的测试类指定特殊的运行器org.junit.runners.Parameterized。
  2. 为测试类声明几个变量,分别用于存放期望值和测试所用数据。
  3. 为测试类声明一个带有参数的公共构造函数,并在其中为第二个环节中声明的几个变量赋值。
  4. 为测试类声明一个使用注解 org.junit.runners.Parameterized.Parameters饰的,返回值为java.util.Collection的公共静态方法,并在此方法中初始化所有需要测试的参数对。
  5. 编写测试方法,使用定义的变量作为参数进行测试。
Demo如下:

@RunWith(Parameterized.class)
public class SquareTest {

private static Calculator calculator = new Calculator();

private int param;//参数

private int result;//期望值

// 准备数据
@Parameters
public static Collection data() {
return Arrays.asList(new Object[][]{{2, 4},{0, 0},{-3, 9}});
}

//构造函数,对变量进行初始化
public SquareTest(int param, int result) {
this.param = param;
this.result = result;
}

@Test
public void square() {
calculator.square(param);
assertEquals(result, calculator.getResult());
}
}



打包测试
在一个项目中,只写一个测试类是不可能的,我们会写出很多很多个测试类。可是这些测试类必须一个一个的执行,也是比较麻烦的事情。鉴于此,JUnit为我们提供了打包测试的功能,将所有需要运行的测试类集中起来,一次性的运行完毕,大大的方便了我们的测试工作。具体代码如下:

@RunWith(Suite.class)
@Suite.SuiteClasses({ CalculatorTest.class,SquareTest.class})
public class AllCalculatorTests{
}
大家可以看到,这个功能也需要使用一个特殊的Runner,因此我们需要向@RunWith注解传递一个参数Suite.class。同时,我们还需要另外一个注解@Suite.SuiteClasses,来表明这个类是一个打包测试类。我们把需要打包的类作为参数传递给该注解就可以了。有了这两个注解之后,就已经完整的表达了所有的含义,因此下面的类已经无关紧要,随便起一个类名,内容全部为空既可。



异常测试
在JUnit 4之前,对错误的测试,我们只能通过fail来产生一个错误,并在try块里面assertTrue(true)来测试。现在,可以通过@Test 注解中的expected属性来测试异常。expected属性的值是一个异常的类型。

Demo如下:

@Test(expected=ArithmeticException.class)
public void testDivide() {
new Calculator().divide(6, 0);
}



限时测试

对于那些逻辑很复杂,循环嵌套比较深的程序,很有可能出现死循环,因此一定要采取一些预防措施。限时测试是一个很好的解决方案。我们给这些测试方法设定一个执行时间,超过了这个时间,他们就会被系统强行终止,并且系统还会向你汇报该方法结束的原因是因为超时,这样你就可以发现这些Bug了。要实现这一功能,只需要给@Test注解加一个timeout属性,该注解传入了一个时间(毫秒)给测试方法,如果测试方法在指定的时间之内没有运行完,则测试失败。

Demo如下:

@Test(timeout=1000)
public void testDeathLoop() {
new Calculator().deathLoop();
}


单元测试运行结果:

    java.lang.Exception: test timed out after 1000 milliseconds

at test.Calculator.deathLoop(Calculator.java:25)

at test.CaculatorTest.testDeathLoop(CaculatorTest.java:26)

at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)

at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)

…………………………


原文链接:https://my.oschina.net/jackieyeah/blog/183277