JUnitReport

説明

JUnit タスクによって生成された個々の XML ファイルをマージし、最終的にこのマージされたドキュメントにスタイルシートを適用して、テストケースの結果を参照可能なレポートを表示します。

注: このタスクは、Apache Ant ディストリビューションには含まれていない外部ライブラリに依存します。詳細については、ライブラリ依存関係を参照してください。

パラメータ

属性 説明 必須
tofile JUnit タスクによって以前に生成されたすべての個々の XML テストスイートを集計する XML ファイルの名前です。 いいえ; デフォルトは TESTS-TestSuites.xml です。
todir 個々の XML テストスイートの集計結果として生成されるファイルが書き込まれるディレクトリです。 いいえ; デフォルトは現在のディレクトリです

ネストされた要素として指定されるパラメータ

fileset

junitreport は、ネストされた <FileSet> 要素を使用して、JUnit タスクによって生成された個々の xml ファイルを収集します。

report

マージによって作成されたドキュメントに基づいて、参照可能なレポートを生成します。

パラメータ

属性 説明 必須
format 生成されるレポートのフォーマットです。noframes または frames のいずれかである必要があります。 いいえ; デフォルトは frames です。
styledir スタイルシートが定義されているディレクトリです。以下の規則に従う必要があります。
  • frames フォーマットの場合: スタイルシートは junit-frames.xsl または Saxon 9+ を使用している場合は junit-frames-saxon.xsl という名前である必要があります。
  • noframes フォーマットの場合: スタイルシートは junit-noframes.xsl または Saxon 9+ を使用している場合は junit-noframes-saxon.xsl という名前である必要があります。
 いいえ; デフォルトは埋め込まれたスタイルシートです。
todir 変換の結果から生成されるファイルが書き込まれるディレクトリです。 いいえ; デフォルトは現在のディレクトリです

Ant は frames と noframes のフォーマットについて以下を想定しています。

junit-frames.xsl または junit-noframes.xsl のカスタムバージョンは、上記の規則に従う必要があります。

report タグのネストされた要素

param

Ant 1.7 以降、var タグはネストされた param タグをサポートしています。これらのタグは、XSL パラメータをスタイルシートに渡すことができます。

パラメータ

属性 説明 必須
name XSL パラメータの名前 はい
expression param に配置されるテキストの値です。
元々、XSL 式になることを意図していました。		 はい
if このプロパティが設定されている場合のみ param が渡されます(こちらを参照)。 いいえ
unless このプロパティが設定されている場合、param は渡されません(こちらを参照)。 いいえ

組み込みのスタイルシートは、次のパラメータをサポートしています。

XSL パラメータ 説明 必須
TITLE <title> と <h1> タグで使用されるタイトル いいえ; デフォルトは Unit Test Results です。

classpath

Ant 1.9.5 以降。スタイルシートの読み込みには XSLT タスク と同じようにネストされた <classpath> が使用されます。

factory

Ant 1.9.5 以降。スタイルシートの読み込みには XSLT タスク と同じようにネストされた <factory> を使用してファクトリ設定を指定することができます。

例

reports ディレクトリに TESTS-TestSuites.xml ファイルを生成し、report/html ディレクトリにデフォルトのフレーム付きレポートを生成します。

<junitreport todir="./reports">
    <fileset dir="./reports">
        <include name="TEST-*.xml"/>
    </fileset>
    <report format="frames" todir="./report/html"/>
</junitreport>

この例では、junitreport/junit-frames.xsl というファイルが必要です。XSL パラメータ key1 と key2 は XSL 変換に渡されます。

<junitreport todir="${outputdir}">
    <fileset dir="${jrdir}">
        <include name="TEST-*.xml"/>
    </fileset>
    <report todir="${outputdir}/html"
            styledir="junitreport"
            format="frames">
        <param name="key1" expression="value1"/>
        <param name="key2" expression="value2"/>
    </report>
</junitreport>