Skip to content

Latest commit

 

History

History
109 lines (79 loc) · 4.48 KB

TESTING.md

File metadata and controls

109 lines (79 loc) · 4.48 KB

Mayaaのテスト

ユニットテスト

ユニットテストは src/test/java に配置され、Mavenの test フェーズにて 実行される。

mvn test

ユニットテストカバレッジ

Mavenによって実行されたテストカバレッジをJacocoで計測している。mvn test実行後に 生成されるテストレポートを確認できる。出力先は target/site/jacoco-ut/index.html である。

インテグレーションテスト

実行方法

Mavenの integration-test フェーズで動作確認用のHTMLを配置したMayaaServletを Jetty を用いて立ち上げる。その状態で src/test/java/**/*ITCase を実行する。 起動ポートは 8999 である。

mvn integration-test

なお、IDEなどから個別にテストコードを実行する場合に下記のコマンドでJettyの起動のみ実施可能。

mvn jetty:run

インテグレーションテストカバレッジ

Mavenによって実行されたテストカバレッジをJacocoで計測している。mvn integration-test実行後に 生成されるテストレポートを確認できる。出力先は target/site/jacoco-it/index.html である。

またユニットテストとインテグレーションテストのテストカバレッジを合算したレポートは target/site/jacoco-merged/index.html に出力される。

テストコード

インテグレーションテストコードはサーバサイドで実行されるHTMLファイルおよびMayaaファイルと サーバにアクセスして結果を検証するためのクライアントコードによって記述される。

種類 配置先
クライアント src/test/java
HTML/Mayaa src/integration-test/webapp

クライアントコードはWebDriverを使ったUIテストフレームワークである Selenideを用いてJUnit4のParameterizedテストとして記述している。

パッケージ: org.seasar.mayaa.test.integration

個々のテストケースは ParameterizedテストのデータとしてSelenium IDE により出力される検証コマンドと近い形式で表現されている。

各データはオブジェクト配列の3つの要素で表されており、0番目の要素から それぞれ、シナリオ名、アクセス先URLのパス、検証コマンドの配列となっている。

現行のテストデータはこれまで記述されてきたテストシナリオ( /src/integratin-test/webapp/tests.slp )をJUnitコードに移植している。 過去はSelenium のブラウザ内で実行するテストランナー用のHTMLを tests.slp から生成して実行していたが、今後は直接JUnitに記載すれば十分である。

詳細は WebDriverBase.Commandクラスおよびその継承クラス、これらのクラスの生成 メソッド(verifyTextメソッドなど)、runTestメソッドを参照のこと。

例

{
    "no-injection",
    "/tests/engine/inject_no.html",
    new Command[] {
        verifyTitle("tests_1_01"),
        verifyText("//body/h1", "render test"),
        verifyText("//body/div[@class=\"main\"]/h2", "no inject"),
        verifyText("//div[@class=\"box\"]", "Plain HTML"),
        verifyElementPresent("//meta"),
        verifyElementPresent("//link")
    }
}

なお、verifyText で検証する際は innerHTML をWebDriver経由で取得してテキスト比較をしている。 innerHTML は子要素のノードが (&), (<), (>) を含む場合はそれぞれ実体参照に変換して取得するが、 二重引用符などそれ以外の文字については実体参照に変換しない。 参考: https://developer.mozilla.org/ja/docs/Web/API/Element/innerHTML

そのため、元々のテストケースである tests.slp に記載されている期待値のテキストに 含まれる " についてはJUnit内では"として文字列に含めている。

元テキスト JUnit内の記述 [c<l&a"s>s] "[c<l&a"s>s]"

過去バージョンとの比較

test-warを用いて過去のバージョンと最新のバージョンの実行結果の比較を行うことができる。

export VERSION_1=1.1.34 VERSION_2=1.3.0
mvn clean -Dmayaa.version=$VERSION_1 && mvn package -U -Dmayaa.version=$VERSION_1 && mvn package -U -Dmayaa.version=$VERSION_2
docker compose -f docker-compose-compare.yaml up
mvn test -Dtest=CompareITCase -DVERSION_1=$VERSION_1 -DVERSION_2=$VERSION_2

以上