ts.tester
クラス Tester

java.lang.Object
  上位を拡張 ts.tester.Tester
直系の既知のサブクラス:
FunctionTester

public abstract class Tester
extends java.lang.Object

試験実行クラスの抽象クラス。
様々な試験実行クラスの基底となる抽象クラスである。 このクラスを継承したクラスの試験ケースメソッドを実行する。
試験ケースメソッドの条件は、試験実行クラスに直に定義されている、 引数と戻り値がない、アクセス指定子がパブリックのメソッドである。
このクラスでは、試験ケースメソッドとその前後に呼び出されるメソッドのセット を試験ケースとしている。 試験ケースを構成するメソッドは以下の通りである。 メソッドは以下の順番どおりに呼び出される。

バージョン:
$Revision: 1.2 $, $Date: 2007/02/16 16:12:48 $
作成者:
佐藤隆之.

コンストラクタの概要
Tester()
          デフォルトコンストラクタ。
 
メソッドの概要
protected abstract  void endInvocation(java.lang.String methodName)
          試験ケースの終了処理を実行する。
protected abstract  void endTesting()
          試験全体の終了処理を実行する。
protected abstract  void initInvocation(java.lang.String methodName)
          試験ケースの初期化を実行する。
protected abstract  void initTesting()
          試験全体の初期化を実行する。
protected  void postInvocation(java.lang.String methodName)
          試験ケースの後処理を実行する。
protected  void postTesting()
          試験全体の後処理を実行する。
protected  void preInvocation(java.lang.String methodName)
          試験ケースの前処理を実行する。
protected  void preTesting()
          試験全体の前処理を実行する。
static void run(java.lang.Class<? extends Tester> testerClass, java.lang.String methodName)
          指定された試験実行クラスの試験ケースを実行する。
static void run(Tester tester, java.lang.String methodName)
          指定された試験実行オブジェクトの試験ケースを実行する。
protected  void stopTesting(java.lang.Exception exc)
          試験が中断されたときに呼ばれるメソッド。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

Tester

public Tester()
デフォルトコンストラクタ。

メソッドの詳細

initTesting

protected abstract void initTesting()
試験全体の初期化を実行する。
全ての試験ケースや試験全体の前処理よりも先に呼び出される。 試験実行オブジェクトが、必要な初期処理を実装するために用意されている。


preTesting

protected void preTesting()
試験全体の前処理を実行する。
全ての試験ケースが開始される前に呼び出される。 試験ケースの実装者が、必要な前処理を実行する機会を与える。


initInvocation

protected abstract void initInvocation(java.lang.String methodName)
試験ケースの初期化を実行する。
試験ケースメソッドや試験ケースの前処理よりも先に呼び出される。 試験実行オブジェクトが、必要な初期処理を実装するために用意されている。

パラメータ:
methodName - 試験ケースメソッド名。

preInvocation

protected void preInvocation(java.lang.String methodName)
試験ケースの前処理を実行する。
試験ケースメソッドの直前に呼び出される。 試験ケースの実装者が、必要な前処理を実行する機会を提供する。

パラメータ:
methodName - 試験ケースメソッド名。

postInvocation

protected void postInvocation(java.lang.String methodName)
試験ケースの後処理を実行する。
試験ケースメソッドの直後に呼び出される。 試験ケースの実装者が、必要な後処理を実行する機会を提供する。

パラメータ:
methodName - 試験ケースメソッド名。

endInvocation

protected abstract void endInvocation(java.lang.String methodName)
試験ケースの終了処理を実行する。
試験ケースメソッドや試験ケースの後処理メソッドよりも後に呼び出される。 試験実行オブジェクトが、必要な終了処理を実装するために用意されている。

パラメータ:
methodName - 試験ケースメソッド名。

postTesting

protected void postTesting()
試験全体の後処理を実行する。
全ての試験ケースの実行が完了した直後に呼び出される。 試験ケースの実装者が、必要な後処理を実行する機会を提供する。


endTesting

protected abstract void endTesting()
試験全体の終了処理を実行する。
全ての試験ケースメソッドや試験全体の後処理メソッドの後に呼び出される。 試験実行オブジェクトが、必要な終了処理を実装するために用意されている。


stopTesting

protected void stopTesting(java.lang.Exception exc)
                    throws java.lang.Exception
試験が中断されたときに呼ばれるメソッド。
試験が中断された場合は、試験全体の後処理や終了処理は呼ばれず、 このメソッドが呼び出される。

パラメータ:
exc - 中断の原因となった例外オブジェクト。
例外:
java.lang.Exception - 引数の例外オブジェクトがこのメソッドで処理されなかった 場合、またはこのメソッドで新たに例外がスローされた場合。
java.lang.AssertionError - 引数がヌルの場合(デバッグモードのみ)。

run

public static void run(Tester tester,
                       java.lang.String methodName)
                throws java.lang.NoSuchMethodException,
                       java.lang.IllegalAccessException,
                       java.lang.Exception
指定された試験実行オブジェクトの試験ケースを実行する。
引数に指定されたTesterオブジェクトのクラスに直に 定義された試験ケースを実行する。 メソッド名にヌルが指定された場合は、直に定義された全てのメソッドを名前の順 に実行する。 親クラスに定義されたメソッドは実行されない。
メソッドの実行前には、本クラスの initTestingメソッド、 preTestingメソッド、 initInvocationメソッド、 preInvocationメソッドが 呼ばれ、メソッドの実行後には、 postInvocationメソッド、 endInvocationメソッド、 postTestingメソッド、 endTestingメソッドが呼ばれる。 これらのメソッドのうち、 initTestinginitInvocationendInvocationendTesting は、試験実行クラス自体の 準備処理や終了処理を実装するために使用される。 preTestingpreInvocationpostInvocationpostTesting 実際の試験ケースを実装するユーザー向けに用意されている。
指定された名前の試験ケースメソッドが存在しない場合は例外をする。 試験ケースメソッドの実行中に例外がスローされた場合は例外をスローする。

パラメータ:
tester - 試験実行オブジェクト。
methodName - 実行する試験ケースメソッド名。
例外:
java.lang.NoSuchMethodException - 指定された名前の引数なし・戻り値なしの メソッドが存在しない場合。
java.lang.IllegalAccessException - 指定された名前のメソッドのアクセス指定子 がパブリックでなかった場合。
java.lang.Exception - メソッドの実行中に例外がスローされた場合。
java.lang.AssertionError - 試験実行オブジェクトにヌルが指定された場合 (デバッグモードのみ)。

run

public static void run(java.lang.Class<? extends Tester> testerClass,
                       java.lang.String methodName)
                throws java.lang.NoSuchMethodException,
                       java.lang.IllegalAccessException,
                       java.lang.Exception
指定された試験実行クラスの試験ケースを実行する。
引数に指定されたTesterの拡張クラスに直に定義された 試験ケースを実行する。 メソッド名にヌルが指定された場合は、直に定義された全てのメソッドを名前順 に実行する。 親クラスに定義されたメソッドは実行されない。
メソッドの実行前には、本クラスの initTestingメソッド、 preTestingメソッド、 initInvocationメソッド、 preInvocationメソッドが 呼ばれ、メソッドの実行後には、 postInvocationメソッド、 endInvocationメソッド、 postTestingメソッド、 endTestingメソッドが呼ばれる。 これらのメソッドのうち、 initTestinginitInvocationendInvocationendTesting は、試験実行クラス自体の 準備処理や終了処理を実装するために使用される。 preTestingpreInvocationpostInvocationpostTesting 実際の試験ケースを実装するユーザー向けに用意されている。
指定された名前の試験ケースメソッドが存在しない場合は例外をする。 試験ケースメソッドの実行中に例外がスローされた場合は例外をスローする。

パラメータ:
testerClass - 試験実行クラス。
methodName - 実行する試験ケースメソッド名。
例外:
java.lang.NoSuchMethodException - 指定された名前の引数なし・戻り値なしの メソッドが存在しない場合。
java.lang.IllegalAccessException - 指定された名前のメソッドのアクセス指定子 がパブリックでなかった場合。
java.lang.Exception - メソッドの実行中に例外がスローされた場合。
java.lang.AssertionError - 試験実行クラスにヌルが指定された場合 (デバッグモードのみ)。


Copyright (C) SATOH Takayuki All Rights Reserved.