SpringBootとSeleniumとJunitの連携
をテンプレートにして作成
[
トップ
] [
新規
|
一覧
|
単語検索
|
最終更新
|
ヘルプ
]
開始行:
* 趣旨 [#h437e461]
画面操作を伴う自動テストのコツを思い出しやすくするためメ...
テストコードにseleniumの自動操作をいれるが、そうなると、...
ところどころ間違いがあるかもしれないが、どうやっていたか...
はてサーバは別途デバッグ起動しておくんだったかな。。。？
という感じで記憶がやばい、いろいろ試行錯誤してして記憶が...
** 背景 [#p6cc1aa9]
AIがすぐに作ってくれなかったのでやり方のコツをメモしておく
**環境構築 [#x6112d19]
***必要な依存関係 [#pabcc8a6]
pom.xmlに以下の依存関係を追加する：
selenium-java
junit-jupiter
webdrivermanager
pomに各jarのバージョン変数を追加
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sour...
<project.reporting.outputEncoding>UTF-8</project.report...
<java.version>1.8</java.version>
<lombok.version>1.18.36</lombok.version>
<selenium.version>4.18.0</selenium.version>
<junit.jupiter.version>5.10.2</junit.jupi...
<assertj.version>3.25.3</assertj.version>
<webdrivermanager.version>5.7.0</webdrive...
</properties>
依存をpomに追加
<dependency>
<groupId>org.sele...
<artifactId>selen...
<version>${seleni...
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.juni...
<artifactId>junit...
<version>${junit....
<scope>test</scope>
</dependency>
<dependency>
<groupId>io.githu...
<artifactId>webdr...
<version>${webdri...
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.apac...
<artifactId>httpc...
<version>5.2.1</v...
<scope>test</scope>
</dependency>
<dependency>
<groupId>commons-...
<artifactId>commo...
<version>2.11.0</...
<scope>test</scope>
</dependency>
これらを設定したら、
mvn dependency:resolve
コマンドを実行
追加するGUIのツール誰か作ってほしい
**テストクラスの基本構造 [#basic_structure]
***アノテーション [#annotations]
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvir...
- ランダムポートでSpringBootアプリケーションを起動
@TestPropertySource
- テスト用のプロパティを設定
***必要なフィールド [#fields]
@LocalServerPort
- SpringBootが割り当てたポート番号を取得
WebDriver
- Seleniumのブラウザ操作用インスタンス
WebDriverWait
- 要素の待機処理用
**Page Objectパターン [#page_object]
画面操作をカプセル化するためのパターン
- 各画面の操作をクラスとして分離
- テストコードの可読性と保守性が向上
***実装例 [#e58785d8]
public class SearchPage {
private WebDriver driver;
private WebDriverWait wait;
public SearchPage(WebDriver driver, WebDriverWait wa...
this.driver = driver;
this.wait = wait;
}
public DetailPage searchAndOpenDetail(String recepti...
// 画面操作のロジック
return new DetailPage(driver, wait);
}
}
**テスト実装のポイント [#test_implementation]
***セットアップ処理 [#setup_process]
@BeforeEach内で実施
- WebDriverManagerでブラウザドライバセットアップ
- ブラウザウィンドウの最大化
- ログイン処理
例：
大体同じような処理をすると思うので、よく使う処理をabstrac...
public abstract class BaseSeleniumTest {
protected WebDriver driver;
protected WebDriverWait wait;
protected String originalWindow;
@BeforeEach
public void setUp() {
WebDriverManager.chromedriver().setup();
driver = new ChromeDriver();
wait = new WebDriverWait(driver, Duration.ofSeco...
driver.manage().window().maximize();
// ログインページにアクセス
driver.get("http://localhost:8080/xxx/login");
// ログインボタンを見つけてクリック
WebElement loginButton = wait.until(ExpectedCond...
By.cssSelector(".xxx")));
loginButton.click();
// 管理画面が表示されるまで待機
wait.until(ExpectedConditions.titleContains("タ...
// 元のウィンドウハンドルを保存
originalWindow = driver.getWindowHandle();
}
@AfterEach
public void tearDown() {
// 新しいウィンドウが開いている場合は閉じる
Set<String> windows = driver.getWindowHandles();
if (windows.size() > 1) {
windows.stream()
.filter(handle -> !handle.equals(origina...
.forEach(handle -> {
driver.switchTo().window(handle);
driver.close();
});
// 元のウィンドウに戻る
driver.switchTo().window(originalWindow);
}
if (driver != null) {
driver.quit();
}
}
}
***クリーンアップ処理 [#cleanup]
@AfterEach内で実施
- ブラウザの終了（driver.quit()）
***要素の待機 [#wait]
WebDriverWaitを使用して要素の表示を待機
wait.until(ExpectedConditions.presenceOfElementLocated(B...
**テスト実行の設定 [#test_execution]
CIなどで、Seleniumを使った自動テストを自動実行の対象から...
***maven-surefire-plugin [#maven_config]
テストの実行制御
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<configuration>
<excludedGroups>selenium</excludedGroups>
</configuration>
</plugin>
**実行方法 [#execution]
***前提条件 [#prerequisites]
- Chromeブラウザがインストール済み
- アプリケーションが起動済み（http://localhost:8080）
- Lombokのjarファイルが`lib`ディレクトリに配置済み
***実行手順 [#execution_steps]
#1. Chromeブラウザのバージョン確認
chrome://version にアクセスして確認
#2. テストコマンドの実行
mvn test -Dtest=テスト対象のクラス名 -Dmaven.compiler.cl...
**トラブルシューティング [#troubleshooting]
***ChromeDriverのバージョン互換性エラー [#chromedriver_er...
以下の順で対応：
#1. Chromeブラウザを最新版にアップデート
#2. キャッシュされたChromeDriverを削除
- 削除対象ディレクトリ: ~/.cache/selenium
#3. テストを再実行
***自動ダウンロードについて [#auto_download]
- ChromeDriverは WebDriverManager により自動的にダウンロ...
- ただし、Chromeブラウザのバージョンと互換性が必要
* テスト箇所にブレークポイントを張りたい場合 [#w0fb11b5]
実行には、VSCodeのフラスコマークのアイコンでデバッグ実行...
* テストの設定についてメモ [#j14cd868]
* Maven Surefireプラグインでテストが実行されない問題の解...
** 問題 [#q2f5203e]
Maven Surefireプラグインでテストを実行しようとすると、以...
[ERROR] Failed to execute goal org.apache.maven.plugins:...
** 原因 [#j3a2c84e]
- maven-surefire-pluginのバージョンが古い（2.22.2など）
- JUnit 4のテストを実行するための適切な設定がない
** 解決方法 [#b2066358]
pom.xmlに以下の設定を追加します：
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>3.5.2</version>
<configuration>
<includes>
<include>**/*Test.java</include>
</includes>
<failIfNoTests>false</failIfNoTests>
<useFile>false</useFile>
<testFailureIgnore>true</testFailureIgnore>
</configuration>
<dependencies>
<dependency>
<groupId>org.apache.maven.surefire</groupId>
<artifactId>surefire-junit4</artifactId>
<version>3.5.2</version>
</dependency>
</dependencies>
</plugin>
** 設定の説明 [#x1092f71]
- version: 最新バージョン（2025年3月時点では3.5.2）に更新
- includes: テストファイルのパターンを指定
- failIfNoTests: テストが見つからない場合にビルドを失敗さ...
- useFile: テスト結果をコンソールに直接出力
- testFailureIgnore: テスト失敗時もビルドを続行
- dependencies: JUnit 4用の依存関係（surefire-junit4）を...
** テスト実行コマンド [#u78c02f5]
特定のテストメソッドを実行する場合：
mvn test "-Dtest=クラス名#メソッド名"
例：
mvn test "-Dtest=xxx.SimpleTest#testAlwaysPass"
全てのテストを実行する場合：
mvn test
** 注意点 [#ed1612e8]
- コマンドラインでパラメータを指定する際は、Windowsのcmd...
- 文字化けが発生する場合は、UTF-8エンコーディングを指定す...
終了行:
* 趣旨 [#h437e461]
画面操作を伴う自動テストのコツを思い出しやすくするためメ...
テストコードにseleniumの自動操作をいれるが、そうなると、...
ところどころ間違いがあるかもしれないが、どうやっていたか...
はてサーバは別途デバッグ起動しておくんだったかな。。。？
という感じで記憶がやばい、いろいろ試行錯誤してして記憶が...
** 背景 [#p6cc1aa9]
AIがすぐに作ってくれなかったのでやり方のコツをメモしておく
**環境構築 [#x6112d19]
***必要な依存関係 [#pabcc8a6]
pom.xmlに以下の依存関係を追加する：
selenium-java
junit-jupiter
webdrivermanager
pomに各jarのバージョン変数を追加
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sour...
<project.reporting.outputEncoding>UTF-8</project.report...
<java.version>1.8</java.version>
<lombok.version>1.18.36</lombok.version>
<selenium.version>4.18.0</selenium.version>
<junit.jupiter.version>5.10.2</junit.jupi...
<assertj.version>3.25.3</assertj.version>
<webdrivermanager.version>5.7.0</webdrive...
</properties>
依存をpomに追加
<dependency>
<groupId>org.sele...
<artifactId>selen...
<version>${seleni...
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.juni...
<artifactId>junit...
<version>${junit....
<scope>test</scope>
</dependency>
<dependency>
<groupId>io.githu...
<artifactId>webdr...
<version>${webdri...
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.apac...
<artifactId>httpc...
<version>5.2.1</v...
<scope>test</scope>
</dependency>
<dependency>
<groupId>commons-...
<artifactId>commo...
<version>2.11.0</...
<scope>test</scope>
</dependency>
これらを設定したら、
mvn dependency:resolve
コマンドを実行
追加するGUIのツール誰か作ってほしい
**テストクラスの基本構造 [#basic_structure]
***アノテーション [#annotations]
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvir...
- ランダムポートでSpringBootアプリケーションを起動
@TestPropertySource
- テスト用のプロパティを設定
***必要なフィールド [#fields]
@LocalServerPort
- SpringBootが割り当てたポート番号を取得
WebDriver
- Seleniumのブラウザ操作用インスタンス
WebDriverWait
- 要素の待機処理用
**Page Objectパターン [#page_object]
画面操作をカプセル化するためのパターン
- 各画面の操作をクラスとして分離
- テストコードの可読性と保守性が向上
***実装例 [#e58785d8]
public class SearchPage {
private WebDriver driver;
private WebDriverWait wait;
public SearchPage(WebDriver driver, WebDriverWait wa...
this.driver = driver;
this.wait = wait;
}
public DetailPage searchAndOpenDetail(String recepti...
// 画面操作のロジック
return new DetailPage(driver, wait);
}
}
**テスト実装のポイント [#test_implementation]
***セットアップ処理 [#setup_process]
@BeforeEach内で実施
- WebDriverManagerでブラウザドライバセットアップ
- ブラウザウィンドウの最大化
- ログイン処理
例：
大体同じような処理をすると思うので、よく使う処理をabstrac...
public abstract class BaseSeleniumTest {
protected WebDriver driver;
protected WebDriverWait wait;
protected String originalWindow;
@BeforeEach
public void setUp() {
WebDriverManager.chromedriver().setup();
driver = new ChromeDriver();
wait = new WebDriverWait(driver, Duration.ofSeco...
driver.manage().window().maximize();
// ログインページにアクセス
driver.get("http://localhost:8080/xxx/login");
// ログインボタンを見つけてクリック
WebElement loginButton = wait.until(ExpectedCond...
By.cssSelector(".xxx")));
loginButton.click();
// 管理画面が表示されるまで待機
wait.until(ExpectedConditions.titleContains("タ...
// 元のウィンドウハンドルを保存
originalWindow = driver.getWindowHandle();
}
@AfterEach
public void tearDown() {
// 新しいウィンドウが開いている場合は閉じる
Set<String> windows = driver.getWindowHandles();
if (windows.size() > 1) {
windows.stream()
.filter(handle -> !handle.equals(origina...
.forEach(handle -> {
driver.switchTo().window(handle);
driver.close();
});
// 元のウィンドウに戻る
driver.switchTo().window(originalWindow);
}
if (driver != null) {
driver.quit();
}
}
}
***クリーンアップ処理 [#cleanup]
@AfterEach内で実施
- ブラウザの終了（driver.quit()）
***要素の待機 [#wait]
WebDriverWaitを使用して要素の表示を待機
wait.until(ExpectedConditions.presenceOfElementLocated(B...
**テスト実行の設定 [#test_execution]
CIなどで、Seleniumを使った自動テストを自動実行の対象から...
***maven-surefire-plugin [#maven_config]
テストの実行制御
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<configuration>
<excludedGroups>selenium</excludedGroups>
</configuration>
</plugin>
**実行方法 [#execution]
***前提条件 [#prerequisites]
- Chromeブラウザがインストール済み
- アプリケーションが起動済み（http://localhost:8080）
- Lombokのjarファイルが`lib`ディレクトリに配置済み
***実行手順 [#execution_steps]
#1. Chromeブラウザのバージョン確認
chrome://version にアクセスして確認
#2. テストコマンドの実行
mvn test -Dtest=テスト対象のクラス名 -Dmaven.compiler.cl...
**トラブルシューティング [#troubleshooting]
***ChromeDriverのバージョン互換性エラー [#chromedriver_er...
以下の順で対応：
#1. Chromeブラウザを最新版にアップデート
#2. キャッシュされたChromeDriverを削除
- 削除対象ディレクトリ: ~/.cache/selenium
#3. テストを再実行
***自動ダウンロードについて [#auto_download]
- ChromeDriverは WebDriverManager により自動的にダウンロ...
- ただし、Chromeブラウザのバージョンと互換性が必要
* テスト箇所にブレークポイントを張りたい場合 [#w0fb11b5]
実行には、VSCodeのフラスコマークのアイコンでデバッグ実行...
* テストの設定についてメモ [#j14cd868]
* Maven Surefireプラグインでテストが実行されない問題の解...
** 問題 [#q2f5203e]
Maven Surefireプラグインでテストを実行しようとすると、以...
[ERROR] Failed to execute goal org.apache.maven.plugins:...
** 原因 [#j3a2c84e]
- maven-surefire-pluginのバージョンが古い（2.22.2など）
- JUnit 4のテストを実行するための適切な設定がない
** 解決方法 [#b2066358]
pom.xmlに以下の設定を追加します：
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>3.5.2</version>
<configuration>
<includes>
<include>**/*Test.java</include>
</includes>
<failIfNoTests>false</failIfNoTests>
<useFile>false</useFile>
<testFailureIgnore>true</testFailureIgnore>
</configuration>
<dependencies>
<dependency>
<groupId>org.apache.maven.surefire</groupId>
<artifactId>surefire-junit4</artifactId>
<version>3.5.2</version>
</dependency>
</dependencies>
</plugin>
** 設定の説明 [#x1092f71]
- version: 最新バージョン（2025年3月時点では3.5.2）に更新
- includes: テストファイルのパターンを指定
- failIfNoTests: テストが見つからない場合にビルドを失敗さ...
- useFile: テスト結果をコンソールに直接出力
- testFailureIgnore: テスト失敗時もビルドを続行
- dependencies: JUnit 4用の依存関係（surefire-junit4）を...
** テスト実行コマンド [#u78c02f5]
特定のテストメソッドを実行する場合：
mvn test "-Dtest=クラス名#メソッド名"
例：
mvn test "-Dtest=xxx.SimpleTest#testAlwaysPass"
全てのテストを実行する場合：
mvn test
** 注意点 [#ed1612e8]
- コマンドラインでパラメータを指定する際は、Windowsのcmd...
- 文字化けが発生する場合は、UTF-8エンコーディングを指定す...
ページ名:
