junit.framework
クラス TestSuite

java.lang.Object
  |
  +--junit.framework.TestSuite

すべての実装インタフェース:

Test

直系の既知のサブクラス:

ActiveTestSuite

public class TestSuite

extends java.lang.Object

implements Test

TestSuiteクラスは、Testの合成です。 このクラスはテストケースの集合を順次実行します。 以下に動的テストでの例を示します。

  TestSuite suite= new TestSuite();
  suite.addTest(new MathTest("testAdd"));
  suite.addTest(new MathTest("testDivideByZero"));
 

別の方法として、自動でテスト（メソッド）を抽出・実行することも出来ます。 その場合、TestSuite のコンストラクタに実行したいクラスのClassオブジェクトを引渡します。

 TestSuite suite= new TestSuite(MathTest.class);
 

このコンストラクタでは、"test"で始まる引数なしの全てのメソッドを抽出します。

関連項目:

Test

コンストラクタの概要

TestSuite()
空の TestSuite を作成します。

TestSuite(java.lang.Class theClass)
指定されたClassオブジェクトから TestSuite を作成します。

TestSuite(java.lang.Class theClass, java.lang.String name)
指定されたClassオブジェクトと名前で TestSuite を作成します。

TestSuite(java.lang.String name)
空のTestSuiteを生成するコンストラクタです。

メソッドの概要

void	addTest(Test test) テスト（Testオブジェクト）をこのオブジェクトに追加します。
void	addTestSuite(java.lang.Class testClass) 引数のクラスのテストをこのオブジェクトに追加します。
int	countTestCases() このテストによって実行される予定のテストケース数をカウントします。
static Test	createTest(java.lang.Class theClass, java.lang.String name) ・・・このコードは、恐れを知らない勇者によるものである。
java.lang.String	getName() このTestの合成に付けられた名前を返却します。
static java.lang.reflect.Constructor	getTestConstructor(java.lang.Class theClass) 引数のClassのコンストラクタを取得します。
void	run(TestResult result) このオブジェクトに格納されたテストを実行し、引数のTestResultに結果を格納します。
void	runTest(Test test, TestResult result) テストを実行します。
void	setName(java.lang.String name) このTestの合成に付けられる名前を設定します。
Test	testAt(int index) 指定されたインデックスのTestオブジェクトを返却します。
int	testCount() このオブジェクトに含まれるTestオブジェクトの数を返却します。
java.util.Enumeration	tests() このオブジェクトに含まれるTestを、enumerationで返却します。
java.lang.String	toString() このオブジェクトの文字列表現を返却します。

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

TestSuite

public TestSuite()

空の TestSuite を作成します。

TestSuite

public TestSuite(java.lang.Class theClass,
                 java.lang.String name)

指定されたClassオブジェクトと名前で TestSuite を作成します。

関連項目:

TestSuite(Class)

TestSuite

public TestSuite(java.lang.Class theClass)

指定されたClassオブジェクトから TestSuite を作成します。 "test"で始まる引数なしの全てのメソッドが抽出されます。 Parts of this method was written at 2337 meters in the H?ffih?tte, Kanton Uri

TestSuite

public TestSuite(java.lang.String name)

空のTestSuiteを生成するコンストラクタです。

メソッドの詳細

addTest

public void addTest(Test test)

テスト（Testオブジェクト）をこのオブジェクトに追加します。

addTestSuite

public void addTestSuite(java.lang.Class testClass)

引数のクラスのテストをこのオブジェクトに追加します。
（訳者注）引数のクラスに定義された、"test"で始まる全てのテストメソッドを このオブジェクトの実行対象として追加します。 "test"で始まるメソッドがpublicでない場合、警告メッセージが設定され、テストは失敗します。

createTest

public static Test createTest(java.lang.Class theClass,
                              java.lang.String name)

・・・このコードは、恐れを知らない勇者によるものである。 オレゴン山脈に月が沈もうとする頃の、早朝のマーリン【アーサー伝説より】のように・・・（笑）
（訳者注）嘘ついてないです！！ほんとにこういうコメントなんですってば。ほら（↓）

     ...as the moon sets over the early morning Merlin, Oregon
     mountains, our intrepid adventurers type...
 

countTestCases

public int countTestCases()

このテストによって実行される予定のテストケース数をカウントします。

定義:

インタフェース Test 内の countTestCases

getTestConstructor

public static java.lang.reflect.Constructor getTestConstructor(java.lang.Class theClass)
                                                        throws java.lang.NoSuchMethodException

引数のClassのコンストラクタを取得します。 引数なしコンストラクタ、または引数が１個のStringのみのコンストラクタが定義されている場合、 java.lang.reflect.Constructorオブジェクトを返却します。
（訳者注）上記の両方のコンストラクタが定義されている場合、引数がStringのコンストラクタが優先されます。

例外:

java.lang.NoSuchMethodException - 引数なしコンストラクタ、および引数が１個のStringのみのコンストラクタが定義されていない場合

run

public void run(TestResult result)

このオブジェクトに格納されたテストを実行し、引数のTestResultに結果を格納します。

定義:

インタフェース Test 内の run

runTest

public void runTest(Test test,
                    TestResult result)

テストを実行します。
（訳者注）元のソースコードでは、このメソッドにコメントはありません。
　　　　　そもそも、こんなのはこのクラスでpublic定義しなくても・・・

パラメータ:

test - 実行対象のテスト

result - テスト結果の格納先

testAt

public Test testAt(int index)

指定されたインデックスのTestオブジェクトを返却します。

testCount

public int testCount()

このオブジェクトに含まれるTestオブジェクトの数を返却します。

tests

public java.util.Enumeration tests()

このオブジェクトに含まれるTestを、enumerationで返却します。

toString

public java.lang.String toString()

このオブジェクトの文字列表現を返却します。 このTestの合成が名前を持っている場合、その名前が返却されます。

オーバーライド:

クラス java.lang.Object 内の toString

setName

public void setName(java.lang.String name)

このTestの合成に付けられる名前を設定します。

パラメータ:

name - The name to set

getName

public java.lang.String getName()

このTestの合成に付けられた名前を返却します。
全てのTestが名前をもたない場合は、nullが返却されます。