JUnit - 基本用法

现在我们将应用简单的例子来一步一步教你如何使用 Junit。

JUnit的一些注意事项：

• 测试方法必须使用 @Test 修饰
• 测试方法必须使用 public void 进行修饰，不能带参数
• 一般使用单元测试会新建一个 test 目录存放测试代码，在生产部署的时候只需要将 test 目录下代码删除即可
• 测试代码的包应该和被测试代码包结构保持一致
• 测试单元中的每个方法必须可以独立测试，方法间不能有任何依赖
• 测试类一般使用 Test 作为类名的后缀
• 测试方法使一般用 test 作为方法名的前缀

测试失败说明：

• Failure：一般是由于测试结果和预期结果不一致引发的，表示测试的这个点发现了问题
• error：是由代码异常引起的，它可以产生于测试代码本身的错误，也可以是被测试代码中隐藏的 bug

一些常用注解：

• @Test:将一个普通方法修饰成一个测试方法 @Test(excepted=xx.class): xx.class 表示异常类，表示测试的方法抛出此异常时，认为是正常的测试通过的 @Test(timeout = 毫秒数) :测试方法执行时间是否符合预期
• @BeforeClass： 会在所有的方法执行前被执行，static 方法 （全局只会执行一次，而且是第一个运行）
• @AfterClass：会在所有的方法执行之后进行执行，static 方法 （全局只会执行一次，而且是最后一个运行）
• @Before：会在每一个测试方法被运行前执行一次
• @After：会在每一个测试方法运行后被执行一次
• @Ignore：所修饰的测试方法会被测试运行器忽略
• @RunWith：可以更改测试运行器 org.junit.runner.Runner
• Parameters：参数化注解

创建一个类

• 在C:\ > JUNIT_WORKSPACE 路径下创建一个名为 MessageUtil.java 的类用来测试。

/*
* This class prints the given message on console.
*/
public class MessageUtil {

   private String message;

   //Constructor
   //@param message to be printed
   public MessageUtil(String message){
      this.message = message;
   }

   // prints the message
   public String printMessage(){
      System.out.println(message);
      return message;
   }   
}  

创建 Test Case 类

• 创建一个名为 TestJunit.java 的测试类。
• 向测试类中添加名为 testPrintMessage() 的方法。
• 向方法中添加 Annotaion @Test。
• 执行测试条件并且应用 Junit 的 assertEquals API 来检查。

在C:\ > JUNIT_WORKSPACE路径下创建一个文件名为 TestJunit.java 的类

import org.junit.Test;
import static org.junit.Assert.assertEquals;
public class TestJunit {

   String message = "Hello World";  
   MessageUtil messageUtil = new MessageUtil(message);

   @Test
   public void testPrintMessage() {
      assertEquals(message,messageUtil.printMessage());
   }
}

创建 Test Runner 类

• 创建一个 TestRunner 类
• 运用 JUnit 的 JUnitCore 类的 runClasses 方法来运行上述测试类的测试案例
• 获取在 Result Object 中运行的测试案例的结果
• 获取 Result Object 的 getFailures() 方法中的失败结果
• 获取 Result object 的 wasSuccessful() 方法中的成功结果

在 C:\ > JUNIT_WORKSPACE 路径下创建一个文件名为 TestRunner.java 的类来执行测试案例

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

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

用 javac 编译 MessageUtil、Test case 和 Test Runner 类。

C:\JUNIT_WORKSPACE>javac MessageUtil.java TestJunit.java TestRunner.java

现在运行 Test Runner,它可以运行在所提供的 Test Case 类中定义的测试案例。

C:\JUNIT_WORKSPACE>java TestRunner

检查运行结果

Hello World
true

现在更新 C:\ > JUNIT_WORKSPACE 路径下的 TestJunit，并且检测失败。改变消息字符串。

import org.junit.Test;
import static org.junit.Assert.assertEquals;
public class TestJunit {

   String message = "Hello World";  
   MessageUtil messageUtil = new MessageUtil(message);

   @Test
   public void testPrintMessage() {
      message = "New Word";
      assertEquals(message,messageUtil.printMessage());
   }
}

让我们保持其他类不变，再次尝试运行相同的 Test Runner

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

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

现在运行在 Test Case 类中提供的即将运行测试案例的 Test Runner

C:\JUNIT_WORKSPACE>java TestRunner

检查运行结果

Hello World
testPrintMessage(TestJunit): expected:<[New Wor]d> but was:<[Hello Worl]d>
false