提要 本文將向你介紹如何實(shí)現(xiàn)從JUnit 3.8向JUnit 4的遷移。同時(shí)，還討論JUnit 4中的一些新特征，特別包括對(duì)注解的使用；最后，簡(jiǎn)要介紹這個(gè)新版本的IDE集成現(xiàn)狀。
一、 引言
在本文開(kāi)始，我將假定，你已經(jīng)了解由Kent Beck和Erich Gamma發(fā)明的這個(gè)Java單元測(cè)試框架并因此而略過(guò)必要的簡(jiǎn)介。所以，我將集中分析從JUnit 3.8到最新版本-JUnit 4的遷移過(guò)程以及其在IDE和Ant中的集成。
JUnit 4是一種與其之前的版本完全不同的API，它根據(jù)Java 5.0中的新特征(注解，靜態(tài)導(dǎo)入等)構(gòu)建而成。如你所見(jiàn)，JUnit 4更簡(jiǎn)單、更豐富和更易于使用，而且它引入了更為靈活的初始化和清理工作，還有限時(shí)的和參數(shù)化測(cè)試用例。
代碼實(shí)例最能說(shuō)明問(wèn)題。因此，在本文中，我將使用一個(gè)例子來(lái)展示不同的測(cè)試用例：一個(gè)計(jì)算器。該示例計(jì)算器很簡(jiǎn)單，效率并不高，甚至還有一些錯(cuò)誤；它僅 僅操作整數(shù)，并且把結(jié)果存儲(chǔ)在一個(gè)靜態(tài)變量中。Substract方法并不返回一個(gè)有效的結(jié)果，而且也沒(méi)有實(shí)現(xiàn)乘法運(yùn)算，而且看上去在 squareRoot方法中還存在一個(gè)錯(cuò)誤：無(wú)限循環(huán)。這些錯(cuò)誤將幫助說(shuō)明使用JUnit 4進(jìn)行測(cè)試的有效性。你可以打開(kāi)和關(guān)閉這個(gè)計(jì)算器，而且你可以清除這些結(jié)果。下面是其實(shí)現(xiàn)代碼：
package calc;
public class Calculator {
private static int result; //存儲(chǔ)結(jié)果的靜態(tài)變量
public void add(int n) {
result = result + n;
}
public void substract(int n) {
result = result - 1; //錯(cuò)誤：應(yīng)該是"result = result - n"
}
public void multiply(int n) {} //還沒(méi)實(shí)現(xiàn)
public void divide(int n) {
result = result / n;
}
public void square(int n) {
result = n * n;
}
public void squareRoot(int n) {
for (; ;) ; //錯(cuò)誤：無(wú)限循環(huán)
}
public void clear() { //清除結(jié)果
result = 0;
}
public void switchOn() { //打開(kāi)屏幕，顯示"hello"，并報(bào)警
result = 0; //實(shí)現(xiàn)其它的計(jì)算器功能
}
public void switchOff() { } //顯示"bye bye"，報(bào)警，并關(guān)閉屏幕
public int getResult() {
return result;
}
} |
二、 遷移一個(gè)測(cè)試類
現(xiàn)在，我將把一個(gè)已經(jīng)使用JUnit 3.8編寫(xiě)成的簡(jiǎn)單的測(cè)試類遷移到JUnit 4。這個(gè)類有一些缺陷：它沒(méi)有測(cè)試所有的業(yè)務(wù)方法，而且看上去在testDivide方法中還存在一個(gè)錯(cuò)誤(8/2不等于5)。因?yàn)檫€沒(méi)有實(shí)現(xiàn)乘法運(yùn)算功能，所以對(duì)其測(cè)試將被忽略。
下面，我們把兩個(gè)版本的框架之間的差別以粗體顯示出現(xiàn)于表格1中。
表格1.分別以JUnit 3.8和JUnit 4實(shí)現(xiàn)的CaculatorTest。
JUnit 3.8
package junit3;
import calc.Calculator;
import junit.framework.TestCase;
public class CalculatorTest extends TestCase {
private static Calculator calculator = new Calculator();
@Override protected void setUp() { calculator.clear(); }
public void testAdd() {
calculator.add(1);
calculator.add(1);
assertEquals(calculator.getResult()， 2);
}
public void testSubtract() {
calculator.add(10);
calculator.subtract(2);
assertEquals(calculator.getResult()， 8);
}
public void testDivide() {
calculator.add(8);
calculator.divide(2);
assert calculator.getResult() == 5;
}
public void testDivideByZero() {
try {
calculator.divide(0);
fail();
}
catch (ArithmeticException e) { }
}
public void notReadyYetTestMultiply() {
calculator.add(10);
calculator.multiply(10);
assertEquals(calculator.getResult()， 100);
}
} |
JUnit 4
package JUnit 4;
import calc.Calculator;
import org.junit.Before;
import org.junit.Ignore;
import org.junit.Test;
import static org.junit.Assert.*;
public class CalculatorTest {
private static Calculator calculator = new Calculator();
@Before public void clearCalculator() {
calculator.clear();
}
@Test public void add() {
calculator.add(1);
calculator.add(1);
assertEquals(calculator.getResult()， 2);
}
@Test public void subtract() {
calculator.add(10);
calculator.subtract(2);
assertEquals(calculator.getResult()， 8);
}
@Test public void divide() {
calculator.add(8);
calculator.divide(2);
assert calculator.getResult() == 5;
}
@Test(expected = ArithmeticException.class)
public void divideByZero() {
calculator.divide(0);
}
@Ignore("not ready yet")
@Test
public void multiply() {
calculator.add(10);
calculator.multiply(10);
assertEquals(calculator.getResult()， 100);
}
} |
三、 包
首先，你可以看到，JUnit 4使用org.junit.*包而JUnit 3.8使用的是junit.framework.*。當(dāng)然，為了向后兼容性起見(jiàn)，JUnit 4jar文件發(fā)行中加入了這兩種包。
四、 繼承
在中，測(cè)試類不必再擴(kuò)展junit.framework.TestCase；事實(shí)上，它們不必須擴(kuò)展任何內(nèi)容。但是，JUnit 4中使用的是注解。為了以一個(gè)測(cè)試用例方式執(zhí)行，一個(gè)JUnit 4類中至少需要一個(gè)@Test注解。例如，如果你僅使用@Before和@After注解而沒(méi)有至少提供一個(gè)@Test方法來(lái)編寫(xiě)一個(gè)類，那么，當(dāng)你試圖 執(zhí)行它時(shí)將得到一個(gè)錯(cuò)誤：
java.lang.Exception: No runnable methods.
五、 斷言（Assert）方法
因?yàn)樵贘Unit 4中一個(gè)測(cè)試類并不繼承自TestCase(在JUnit 3.8中，這個(gè)類中定義了assertEquals()方法)，所以你必須使用前綴語(yǔ)法(舉例來(lái)說(shuō)，Assert.assertEquals())或者 （由于JDK5.0）靜態(tài)地導(dǎo)入Assert類。這樣以來(lái)，你就可以完全象以前一樣使用assertEquals方法(舉例來(lái)說(shuō)， assertEquals())。
另外，在JUnit 4中，還引入了兩個(gè)新的斷言方法，它們專門(mén)用于數(shù)組對(duì)象的比較。如果兩個(gè)數(shù)組包含的元素都相等，那么這兩個(gè)數(shù)組就是相等的。
public static void assertEquals(String message， Object[] expecteds， Object[] actuals);
public static void assertEquals(Object[] expecteds， Object[] actuals); |
由于JDK 5.0的自動(dòng)裝箱機(jī)制的出現(xiàn)，原先的１２個(gè)assertEquals方法全部去掉了。例如，原先JUnit 3.8中的assertEquals(long，long)方法在JUnit 4中要使用assertEquals(Object，Object)。對(duì)于assertEquals(byte，byte)、assertEquals (int，int)等也是這樣。這種改進(jìn)將有助于避免反模式。
在JUnit 4中，新集成了一個(gè)assert關(guān)鍵字(見(jiàn)我們的例子中的divide()方法)。你可以象使用assertEquals方法一樣來(lái)使用它，因?yàn)樗鼈兌紥?出相同的異常(java.lang.AssertionError)。JUnit 3.8的assertEquals將拋出一個(gè)junit.framework.AssertionFailedError。注意，當(dāng)使用assert時(shí)， 你必須指定Java的"-ea"參數(shù)；否則，斷言將被忽略。
六、 預(yù)設(shè)環(huán)境（Fixture）
Fixture是在測(cè)試期間初始化和釋放任何普通對(duì)象的方法。在JUnit 3.8中，你要使用setUp()來(lái)實(shí)現(xiàn)運(yùn)行每一個(gè)測(cè)試前的初始化工作，然后使用tearDown()來(lái)進(jìn)行每個(gè)測(cè)試后的清理。這兩個(gè)方法在 TestCase類中都得到重載，因此都被唯一定義。注意，我在這個(gè)Setup方法使用的是Java5.0內(nèi)置的@Override注解-這個(gè)注解指示該 方法聲明要重載在超類中的方法聲明。在JUnit 4中，則代之使用的是@Before和@After注解；而且，可以以任何命名(在我們的例子中是clearCalculator())來(lái)調(diào)用這些方法。 在本文后面，我將更多地解釋這些注解。
七、 測(cè)試
JUnit 3.8通過(guò)分析它的簽名來(lái)識(shí)別一個(gè)測(cè)試方法：方法名必須以"test"為前綴，它必須返回void，而且它必須沒(méi)有任何參數(shù)(舉例來(lái)說(shuō)， publicvoidtestDivide())。一個(gè)不遵循這個(gè)命名約定的測(cè)試方法將被框架簡(jiǎn)單地忽略，而且不拋出任何異常（指示發(fā)生了一個(gè)錯(cuò)誤）。
JUnit 4不使用與JUnit 3.8相同的約定。一個(gè)測(cè)試方法不必以'test'為前綴，但是要使用@Test注解。但是，正如在前一個(gè)框架中一樣，一個(gè)測(cè)試方法也必須返回void并 且是無(wú)參數(shù)的。在JUnit 4中，可以在運(yùn)行時(shí)刻控制這個(gè)要求，并且不符合要求的話會(huì)拋出一個(gè)異常：
java.lang.Exception: Method xxx should have no parameters
java.lang.Exception: Method xxx should be void
@Test注解支持可選參數(shù)。它聲明一個(gè)測(cè)試方法應(yīng)該拋出一個(gè)異常。如果它不拋出或者如果它拋出一個(gè)與事先聲明的不同的異常，那么該測(cè)試失敗。在我們的例子中，一個(gè)整數(shù)被零除應(yīng)該引發(fā)一個(gè)ArithmeticException異常。
八、 忽略一個(gè)測(cè)試
記住，不能執(zhí)行多個(gè)方法。然而，如果你不想讓測(cè)試失敗的話，你可以僅僅忽略它。那么，在JUnit 3.8中，我們是如何實(shí)現(xiàn)臨時(shí)禁止一個(gè)測(cè)試的呢?方法是：通過(guò)注釋掉它或者改變命名約定，這樣測(cè)試運(yùn)行機(jī)就無(wú)法找到它。在我的例子中，我使用了方法名 notReadyYetTestMultiply()。它沒(méi)有以"test"開(kāi)頭，所以它不會(huì)被識(shí)別出來(lái)。現(xiàn)在的問(wèn)題是，在成百上千的測(cè)試中間，你可能記 不住重命名這個(gè)方法。
在JUnit 4中，為了忽略一個(gè)測(cè)試，你可以注釋掉一個(gè)方法或者刪除@Test注解(你不能再改變命名約定，否則將拋出一個(gè)異常)。然而，該問(wèn)題將保留：該運(yùn)行機(jī)將不 報(bào)告這樣一個(gè)測(cè)試。現(xiàn)在，你可以把@Ignore注解添加到@Test的前面或者后面。測(cè)試運(yùn)行機(jī)將報(bào)告被忽略的測(cè)試的個(gè)數(shù)，以及運(yùn)行的測(cè)試的數(shù)目和運(yùn)行 失敗的測(cè)試數(shù)目。注意，@Ignore使用一個(gè)可選參數(shù)(一個(gè)String)，如果你想記錄為什么一個(gè)測(cè)試被忽略的話。
九、 運(yùn)行測(cè)試
在JUnit 3.8中，你可以選擇使用若干運(yùn)行機(jī)：文本型，AWT或者Swing。JUnit 4僅僅使用文本測(cè)試運(yùn)行機(jī)。注意，JUnit 4不會(huì)顯示任何綠色條來(lái)通知你測(cè)試成功了。如果你想看到任何類型的綠色的話，那么你可能需要使用JUnit擴(kuò)展或一種集成了JUnit的IDE（例如 IDEA或者Eclipse）。
首先，我想使用老式但好用的junit.textui.TestRunner來(lái)運(yùn)行該JUnit 3.8測(cè)試類(考慮到使用assert關(guān)鍵字，我使用了-ea參數(shù))。
java -ea junit.textui.TestRunner junit3.CalculatorTest
..F.E.
There was 1 error:
1) testDivide(junit3.CalculatorTest)java.lang.AssertionError
at junit3.CalculatorTest.testDivide(CalculatorTest.java:33)
There was 1 failure:
1) testSubtract(junit3.CalculatorTest)junit.framework.AssertionFailedError: expected:＜9＞ but was:＜8＞
at junit3.CalculatorTest.testSubtract(CalculatorTest.java:27)
FAILURES!!!
Tests run: 4， Failures: 1， Errors: 1 |
TestDivide產(chǎn)生一個(gè)錯(cuò)誤，因?yàn)閿嘌源_定了8/2不等于5。TestSubstract產(chǎn)生一個(gè)失敗，因?yàn)?0-2應(yīng)該等于8，但是在這個(gè)實(shí)現(xiàn)中存在一個(gè)錯(cuò)誤：它返回9。
現(xiàn)在，我使用新的org.junit.runner.JUnitCore運(yùn)行機(jī)來(lái)運(yùn)行這兩個(gè)類。注意，它能執(zhí)行JUnit 4和JUnit 3.8測(cè)試，甚至是這二者的結(jié)合。
java -ea org.junit.runner.JUnitCore junit3.CalculatorTest
JUnit version 4.1
..E.E.
There were 2 failures:
1) testSubtract(junit3.CalculatorTest)
junit.framework.AssertionFailedError: expected:＜9＞ but was:＜8＞
at junit.framework.Assert.fail(Assert.java:47)
2) testDivide(junit3.CalculatorTest)
java.lang.AssertionError
at junit3.CalculatorTest.testDivide(CalculatorTest.java:33)
FAILURES!!!
Tests run: 4， Failures: 2
***
java -ea org.junit.runner.JUnitCore JUnit 4.CalculatorTest
JUnit version 4.1
...E.EI
There were 2 failures:
1) subtract(JUnit 4.CalculatorTest)
java.lang.AssertionError: expected:＜9＞ but was:＜8＞
at org.junit.Assert.fail(Assert.java:69)
2) divide(JUnit 4.CalculatorTest)
java.lang.AssertionError
at JUnit 4.CalculatorTest.divide(CalculatorTest.java:40)
FAILURES!!!
Tests run: 4， Failures: 2 |
第一個(gè)非常明顯的區(qū)別是，JUnit版本號(hào)被顯示于控制臺(tái)中(4.1)。第二個(gè)區(qū)別是，JUnit 3.8區(qū)分失敗和錯(cuò)誤；JUnit 4則僅使用失敗進(jìn)行簡(jiǎn)化。一個(gè)新奇的地方是，字母"I"，它顯示一個(gè)測(cè)試被忽略。