実行時に使用する XMLファイルパス や、レポート出力場所 などの情報を VfUnitに渡す必要があります。
渡す方法は、2種類あります。
- VfUnit.properties
のプロパティファイルを実行カレントディレクトリに配置
KEY=値 の形式で Unicode にて記述してください。
(テキストエディタで編集した場合は native2ascii をして下さい。 Eclipseのプラグイン プロパティエディタ を 使うと楽に記述できます) - Systemプロパティに設定
SystemプロパティのKEYにて "VfUnit." + KEY名称 を指定します。
XML_FILE_PATH を指定する場合には
java -DVfUnit.XML_FILE_PATH=sample/test.xml junit.textui.TestRunner ･･･
のように指定します。
両方指定されていた場合には、Systemプロパティの設定 が優先されます。
KEY一覧
| XML_FILE_PATH | テストXMLのファイルパスを記述します。
resource: から始まる指定の場合は リソースから読込を行い、 http: から始まる指定の場合には URL先から読込を行います。 file: から もしくは 上記以外の場合には ファイルシステムから読込を行います。 ディレクトリ指定の場合は ディレクトリ内の全てのXMLファイルが対象になります。 例外として 「CVS」という名前のディレクトリは除外します。 デフォルトでは 設定はありません。 必ず設定を追加してください。 |
|---|---|
| MAIN_ARGS | アプリケーションに渡すJava引数を指定します。製品デフォルトでは 設定はありません。
|
| IS_ERROR_STOP | Error発生した時にテストを中断するかどうかを指定します。
true もしくは false を指定してください。 デフォルトでは false になります。 |
| VF_COMPONENT_FIND_NAME_TYPE | VF-Componentの名称の検索対象の指定です。
physical もしくは logical を指定してください。 physical の場合は 物理名で検索し、 logicalの場合は論理名で検索します。 デフォルトでは physical になります。 |
| VF_ITEM_FIND_NAME_TYPE | VF-アイテムの名称の検索対象の指定です。
physical もしくは logical を指定してください。 physical の場合は 物理名で検索し、 logicalの場合は論理名で検索します。 デフォルトでは physical になります。 |
| REPORT_IS_ENABLE | 結果レポートを出力するかどうかの指定です。
true もしくは falseを指定してください。 デフォルトでは true になります。 |
| REPORT_DIRECTORY | 結果レポートを出力するかディレクトリパスの指定です。
デフォルトでは ./report/ になります。 |
| REPORT_WRITER_CLASS | 結果レポートを出力するクラスです。
jp.ne.mki.wedge.pub.vfunit.reporter.IReportWriter インターフェースを実装した クラスを指定します。 デフォルトでは jp.ne.mki.wedge.pub.vfunit.reporter.ReportTestListener になります。 デフォルトの実装の jp.ne.mki.wedge.pub.vfunit.reporter.ReportTestListener では、 結果をXML形式にて report.xml という名前でファイル出力します。 |
| REPORT_CONVERTER_CLASS | 結果レポートXMLをHTMLなどに変換するクラスの指定です。
現在提供している クラスは 以下になります。
デフォルトでは jp.ne.mki.wedge.pub.vfunit.reporter.HtmlConverter_Table になります。 |
| DELIMIT_COMPONENT_START | 結果レポート出力時に コンポーネント名称記述 する時の 開始文字列の指定です。
DELIMIT_COMPONENT_START=「 DELIMIT_COMPONENT_END= 」 と指定されていた場合には、"「{コンポーネント名称}」をClickする" のようにレポート出力されます。 デフォルトでは 「 になります。 |
| DELIMIT_COMPONENT_END | 結果レポート出力時に コンポーネント名称記述 する時の 終了文字列の指定です。
デフォルトでは 」 になります。 |
| DELIMIT_ITEM_START | 結果レポート出力時に アイテム名称記述 する時の 開始文字列の指定です。
デフォルトでは 【 になります。 |
| DELIMIT_ITEM_END | 結果レポート出力時に アイテム名称記述 する時の 終了文字列の指定です。
デフォルトでは 】 になります。 |
| DELIMIT_ITEM_VALUE_START | 結果レポート出力時に アイテムの値を記述 する時の 開始文字列の指定です。
デフォルトでは [ になります。 |
| DELIMIT_ITEM_VALUE_END | 結果レポート出力時に アイテムの値を記述 する時の 終了文字列の指定です。
デフォルトでは ] になります。 |
使用時に 必ず修正が必要なものは 『XML_FILE_PATH』 です。
その他の設定は、初期設定のままで動きます。
JUnitの実行
起動は jp.ne.mki.wedge.pub.vfunit.VfUnitXmlSuite のクラスを JUnit のRunnerに渡します。
junit.textui.TestRunner jp.ne.mki.wedge.pub.vfunit.VfUnitXmlSuite
※junit.swingui.TestRunner（GUI版) は
JUnit4では廃止されています。実行時にJUnit3を使用するとGUIでの実行が可能になります。
JUnitが実行できる環境であれば、どこでも実行できます。 バッチファイルに記述するのもよし、Eclipseから実行するのもよし、Antにて記述するのもよし･･･
Eclipseから起動する場合には JUnit実行構成 で jp.ne.mki.wedge.pub.vfunit.VfUnitXmlSuite の
単一テスト実行 を 行います。 
