TestSuite

JUnit Gossip: TestSuite

您定義自己的TestCase，並使用TestRunner來運行測試，事實上TestRunner並不直接運行 TestCase上的單元方法，而是透過TestSuite，TestSuite與TestCase都實作了Test介面，TestSuite可以將數個TestCase組合在一起，這是 Composite 模式，這讓每個TestCase保持簡單。

來看看一個例子：

MathToolTest.java

package onlyfun.caterpillar.test;

import onlyfun.caterpillar.MathTool;
import junit.framework.TestCase;

public class MathToolTest extends TestCase {
    public MathToolTest(String testMethod) {
        super(testMethod);
    }

    public void testGcd() {
        assertEquals(5, MathTool.gcd(10, 5));
    }
    
    public static void main(String[] args) {
        junit.textui.TestRunner.run(MathToolTest.class);
    }
}

JUnit並沒有規定您一定要使用testXXX()這樣的方式來命名您的測試方法，如果您要提供自己的方法（當然JUnit 鼓勵您使用testXXX()這樣的方法名稱），則可以如上撰寫，為了要能夠使用建構式提供測試方法名稱，您的TestCase必須提供如下的建構式：

public MathToolTest(String testMethod) {
super(testMethod);
}

在這個例子中，您並沒有看到任何的TestSuite，這是因為TestRunner的run()方法中會建立TestSuite：

static public void run(Class testClass) {
run(new TestSuite(testClass));
}

在這個TestSuite的建構式中，會使用反射（reflection）自動找出testXXX()方法，並加入為待執行的測試方法，TestRunner的run()方法中會去執行TestSuite上的run()方法，然後TestSuite會將之委託給TestCase上的run()方法，而該run()方法中執行每一個testXXX()方法。簡而言之，上例的寫法，所有MathToolTest中的testXXX()方法都會被執行。

如果您使用上面範例的run()方法，則TestRunner就會像上面這樣自動為您建立一個TestSuite，並找出testXXX()方法，您也自行定義suite()方法，組合想要進行的測試：

public static Test suite() {
// 這會找出預設的testXXX()方法
     TestSuite suite = new TestSuite(MathTool.class);
// 這邊可以加入指定的測試方法名稱
     suite.addTest(new MathToolTest("otherTest"));
     return suite;
}

然後使用TestRunner的另一個版本run()方法來執行測試：

junit.textui.TestRunner.run(MathToolTest.suite());

如果要加入更多的測試方法，使用addTest()就可以了，您還可以將數個TestSuite組合在一起，例如在一個TestAll類別中如下定義suite()：

public static Test suite() {
    TestSuite suite= new TestSuite();
    suite.addTestSuite(TestCase1.class);
    suite.addTestSuite(TestCase2.class);
    return suite;
}

addTestSuite()方法定義如下，一樣的，這個執行結果是找出每個TestCase中的testXXX()方法：

public void addTestSuite(Class testClass) {
addTest(new TestSuite(testClass));
}

如此之來，您可以一次運行所有的測試，而不必個別的運行每一個測試案例，例如：

junit.textui.TestRunner.run(TestAll.suite());

TestCase與TestSuite都實作了Test介面，其運行方式為 Command 模式的一個實例，而TestSuite可以組合數個TestSuite或TestCase，這是 Composite 模式的一個實例。

From Gossip@caterpillar

JUnit Gossip: TestSuite