JUnitのParameterizedTestは、先に決めた入力と期待結果を、一行ずつ同じテストへ渡すために使います。この記事では「件名は空白だけを認めず、Unicodeコードポイント数で1〜100」という仕様を、6行の境界値テストへ移します。100文字を誤って拒否したとき、どのケースが落ちたかまで確かめます。
この記事でわかること
- 選んだ境界値を、caseId付きのCsvSourceへ移す方法
- 失敗した100文字の行から、対象コードへ戻る読み方
- CSVの空欄・空文字・空白・カンマを、意図した値のまま渡す方法
- NullAndEmptySource・ValueSource・MethodSourceを選ぶ基準
テスト対象は、架空の問い合わせ管理で使う件名判定です。何を試すかがまだ決まらない段階は、先に仕様をケースへ分けます。ここでは選んだケースをJUnitで実行する部分を扱います。テストの記述を短くするために、期待結果を実装から計算する進め方にはしません。
まず、件名を受け付ける条件をコードと照合する
対象のTitleRule.accepts(String)はstaticメソッドです。nullと空白だけの文字列を拒否し、残る入力はコードポイント数で1〜100なら許可します。前後の空白をtrimしないので、"a".repeat(100) + " "は101として拒否します。
package info.syachiku.testing;
public final class TitleRule {
private TitleRule() {}
public static boolean accepts(String title) {
if (title == null || title.isBlank()) return false;
int length = title.codePointCount(0, title.length());
return length >= 1 && length <= 100;
}
}JavaのString.length()はUTF-16のコード単位数です。今回の仕様はコードポイント数なので、絵文字のように二つのコード単位を使うものでも、codePointCountに従って数えます。これは見た目の一文字を常に一つと数える仕様ではありません。結合文字や複数のコードポイントから成る絵文字まで、画面上の一文字として数えたい場合は別の要件です。
テストでは「実装がcodePointCountを使っているから、その結果を正解にする」とは考えません。仕様で数え方を決めたうえで、100個の😀なら許可、101個なら拒否という具体的な期待結果を置きます。
6行の境界値を、caseId付きのCsvSourceへ移す
今回は同じASCII文字aを繰り返して、長さだけを変えます。a一つはコードポイント一つなので、文字の種類と長さの条件を同時に変えず、境界の判定へ集中できます。
| caseId | 長さ | 期待結果 | 確認する場所 |
|---|---|---|---|
| T02 | 0 | false | 未入力を許可しない |
| T03 | 1 | true | 下限ちょうど |
| T04 | 2 | true | 下限のすぐ内側 |
| T05 | 99 | true | 上限のすぐ内側 |
| T06 | 100 | true | 上限ちょうど |
| T07 | 101 | false | 上限を超える |
T02から始まるのは、前の記事のケース表と同じIDを使うためです。nullを扱うT01は、この後で別のSourceへ分けます。行を並べるときにIDを振り直してしまうと、仕様表やレビューコメントがどのテストを指していたか追いにくくなります。
次はTitleRuleParameterizedTest.javaの境界値メソッドの抜粋です。importなどを含む全文は後ろに載せています。
@ParameterizedTest(name = "{0}: length={1}, accepted={2}")
@CsvSource({
"T02,0,false", "T03,1,true", "T04,2,true",
"T05,99,true", "T06,100,true", "T07,101,false"
})
void boundary(String caseId, int length, boolean accepted) {
assertEquals(accepted, TitleRule.accepts("a".repeat(length)), caseId);
}@CsvSourceの各行は、左からcaseId、長さ、期待結果です。JUnitが列をString・int・booleanへ渡します。"a".repeat(length)で実際の入力文字列を作り、TitleRule.acceptsの結果を、表から渡したacceptedと比較します。
nameの{0}・{1}・{2}は、メソッドの引数に対応します。テスト表示名はたとえばT06: length=100, accepted=trueになります。さらにassertEqualsのメッセージにもcaseIdを入れているため、実行ツールの表示形式が違っても、失敗したIDを手がかりにできます。
期待値をTitleRule.acceptsで計算してから、もう一度同じメソッドと比較してはいけません。同じ間違いを二度呼べば一致してしまいます。6行のtrue/falseは「1〜100を許可する」という仕様から決めています。
実行し、100文字を拒否する間違いがT06で落ちるか確かめる
ZIPを展開し、READMEとpom.xmlがあるフォルダーで次を実行します。JDK 17とMaven 3.9系が必要です。最初は二つのテストクラスに絞り、境界値とCSVの値が意図どおりか確認できます。
mvn -B -Dtest=TitleRuleParameterizedTest,CsvSourceParsingTest testこの2クラスは件名のテスト14回とCSVの受け渡し確認7回で、計21回成功しています。プロジェクト内のケース設計記事用テスト20回(件名13回・対応開始7回)も含めて確認するときは、mvn -B testで全41回を実行します。いずれも失敗0・エラー0・スキップ0を確認しています。同じ仕様のケースを、前の記事の個別テストとこの記事のパラメータ化テストで重ねて扱うため、「41種類の異なる仕様」を意味しません。このサンプルはJUnit 5.12.2とビルドプラグインをpom.xmlで固定しています。既存のSpring Bootプロジェクトへ持ち込む場合は、管理されているJUnit依存を重ねて追加せず、プロジェクトのバージョン方針を確認してください。
正常な版が成功するだけでは、境界の取り違えを検出できるか分かりません。検証ではTitleRuleのlength <= 100を、コピーした検証用プロジェクトでlength < 100へ変えました。正しく許可するはずの100文字を拒否する、意図的な誤実装です。
失敗ログの抜粋です。
[ERROR] info.syachiku.testing.TitleRuleParameterizedTest.boundary(String, int, boolean)[5] -- Time elapsed: 0.002 s <<< FAILURE!
org.opentest4j.AssertionFailedError: T06 ==> expected: <true> but was: <false>6行の境界値テストではT06が失敗します。長さが100になる別の観点のT10・T12も失敗し、前の記事用の個別テストも含めた全体では計6回の失敗です。まずT06を表へ戻すと、長さ100・期待trueです。失敗した行の入力は"a".repeat(100)なので、空白やUnicodeの扱いを先に疑う必要はありません。次に対象の上限条件を見ると、100を含むはずの比較が100未満へ変わったことを確認できます。
ここで期待値をfalseへ変えて緑にすると、仕様を壊したコードへテストを合わせたことになります。仕様が変わっていないなら対象コードを直し、同じ6行を再実行します。仕様自体が「99まで」に変わる場合は、先に仕様表とケースの意味を更新し、その変更として期待値を直します。
この誤実装は配布する正常版に含めません。何を変えるとどのケースが失敗したかは検証記録へ残しています。失敗件数だけでなく、ケースIDと入力と期待結果の組を確認してください。
空欄・空文字・空白を、CSVで取り違えない
境界値のテストでは長さという数値だけをCSVに置きました。実際の文字列をCSVへ直接書くときは、JUnitがテストへ渡す前にCSVを解析することに注意します。Javaソースに書いた見た目と、メソッドが受け取る値は同じとは限りません。
| CSVの第2列 | 受け取る値 | 間違えやすい点 |
|---|---|---|
| 空欄(引用なし) | null | 空文字を試したつもりになる |
'' | 空文字"" | nullとは別の値 |
' ' | 半角空白一つ | 引用内の空白は残る |
'a,b' | カンマを含む"a,b" | 引用しないと列が分かれる |
NULL | 文字列"NULL" | この設定ではnullの特別な記号ではない |
次の抜粋はCsvSourceParsingTestです。判定対象の不具合を調べる前に、CSVから渡ってきた値そのものをassertNull/assertEqualsで確認しています。switchはこのCSVの受け渡し確認に限定したものです。件名の境界値テストを、ケース名によって別々の業務処理を呼ぶ巨大なswitchにするための例ではありません。
@ParameterizedTest(name = "{0}")
@CsvSource(value = {
"unquoted-null,",
"quoted-empty,''",
"quoted-space,' '",
"quoted-comma,'a,b'",
"literal-NULL,NULL"
}, ignoreLeadingAndTrailingWhitespace = true)
void csvInputIsWhatWeIntended(String kind, String input) {
switch (kind) {
case "unquoted-null" -> assertNull(input);
case "quoted-empty" -> assertEquals("", input);
case "quoted-space" -> assertEquals(" ", input);
case "quoted-comma" -> assertEquals("a,b", input);
case "literal-NULL" -> assertEquals("NULL", input);
default -> fail("Unknown case: " + kind);
}
}さらに、引用していない列の前後空白は、ignoreLeadingAndTrailingWhitespace=trueなら取り除かれます。この設定は既定でもtrueですが、サンプルでは意図を明示します。空白を含む入力を確かめたいのに、JUnitの前処理で" a "が"a"へ変わっていたら、業務コードのtrimを検出できません。
@ParameterizedTest
@CsvSource(value = {"trimmed, a "})
void unquotedWhitespaceIsTrimmedByDefault(String kind, String input) {
assertEquals("a", input);
}
@ParameterizedTest
@CsvSource(value = {"preserved, a "}, ignoreLeadingAndTrailingWhitespace = false)
void unquotedWhitespaceCanBePreserved(String kind, String input) {
assertEquals(" a ", input);
}抜粋の前半は既定設定で" a "が"a"へ変わること、後半はignoreLeadingAndTrailingWhitespace=falseなら元の空白を保持することを、それぞれ確かめています。入力の前後空白を保持するなら、文字列を単一引用符で囲むか、引用していない列をそのまま渡す設定へ変えます。ただし、空白を含む入力が数個だけなら、次のValueSourceやMethodSourceへ分けるほうが、何を渡したかをJavaコードで確認しやすい場合があります。CSVの設定を複雑にする前に、テストの目的に合うSourceを選びます。
nullと空白は別のSource、生成する文字列はMethodSourceへ分ける
nullと空文字を拒否することは、@NullAndEmptySourceで表します。この二つで同じ「拒否する」を確認できるので、メソッドを分けず一つのassertFalseで読めます。空白一つと全角空白は@ValueSourceにJavaの文字列として並べます。
@ParameterizedTest
@NullAndEmptySource
void missing(String input) { assertFalse(TitleRule.accepts(input)); }
@ParameterizedTest
@ValueSource(strings = {" ", "\u3000"})
void blank(String input) { assertFalse(TitleRule.accepts(input)); }空文字は境界値の長さ0でも確かめているため、一部の実行が重なります。ここでは、長さの境界を説明する表と、null・空文字という欠落入力の扱いを説明するテストを、それぞれ読めるようにしています。実行回数を増やす目的で同じデータを増殖させる必要はありません。
一方、絵文字を100個作る、99文字の末尾に空白を足すといった入力は、@MethodSourceへ分けます。CSVの一セルに長大な文字列を書かず、生成する式と期待結果を同じJavaコードで読めます。
static Stream<Arguments> supplementaryAndWhitespace() {
return Stream.of(
Arguments.of("T10", "😀".repeat(100), true),
Arguments.of("T11", "😀".repeat(101), false),
Arguments.of("T12", "a".repeat(99) + " ", true),
Arguments.of("T13", "a".repeat(100) + " ", false)
);
}
@ParameterizedTest(name = "{0}: accepted={2}")
@MethodSource("supplementaryAndWhitespace")
void unicodeAndNoTrim(String caseId, String input, boolean accepted) {
assertEquals(accepted, TitleRule.accepts(input), caseId);
}T10は絵文字100個を許可、T11は101個を拒否します。ここでString.lengthへ書き換える誤りを検出します。T12はa99個と末尾空白で100、T13は100個と末尾空白で101です。T13がtrueになるなら、対象コードが仕様にないtrimをしていないか確認できます。
MethodSourceで入力を生成しても、期待値まで同じ条件式から計算しない点はCsvSourceと同じです。Arguments.ofのtrue/falseは、数え方とtrimしないという仕様に基づいて明示します。Sourceの選択はデータを渡す方法の違いで、仕様の正しさを自動で決める機能ではありません。
対象・テスト・実行設定を同じ版で取得する
ここまでの抜粋を一つのテストクラスにした全文が次です。コピーして一式を動かす場合は、冒頭のZIPを使ってください。package宣言とフォルダーの対応、JUnit依存、実行プラグインまで同じ状態で取得できます。
TitleRuleParameterizedTest.javaの全文
境界値・null・空白・絵文字のテスト全文を開く
package info.syachiku.testing;
import java.util.stream.Stream;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.*;
import static org.junit.jupiter.api.Assertions.*;
class TitleRuleParameterizedTest {
@ParameterizedTest(name = "{0}: length={1}, accepted={2}")
@CsvSource({
"T02,0,false", "T03,1,true", "T04,2,true",
"T05,99,true", "T06,100,true", "T07,101,false"
})
void boundary(String caseId, int length, boolean accepted) {
assertEquals(accepted, TitleRule.accepts("a".repeat(length)), caseId);
}
@ParameterizedTest
@NullAndEmptySource
void missing(String input) { assertFalse(TitleRule.accepts(input)); }
@ParameterizedTest
@ValueSource(strings = {" ", "\u3000"})
void blank(String input) { assertFalse(TitleRule.accepts(input)); }
static Stream<Arguments> supplementaryAndWhitespace() {
return Stream.of(
Arguments.of("T10", "😀".repeat(100), true),
Arguments.of("T11", "😀".repeat(101), false),
Arguments.of("T12", "a".repeat(99) + " ", true),
Arguments.of("T13", "a".repeat(100) + " ", false)
);
}
@ParameterizedTest(name = "{0}: accepted={2}")
@MethodSource("supplementaryAndWhitespace")
void unicodeAndNoTrim(String caseId, String input, boolean accepted) {
assertEquals(accepted, TitleRule.accepts(input), caseId);
}
}CSVの値と空白設定のテスト全文を開く
package info.syachiku.testing;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.CsvSource;
import static org.junit.jupiter.api.Assertions.*;
class CsvSourceParsingTest {
@ParameterizedTest(name = "{0}")
@CsvSource(value = {
"unquoted-null,",
"quoted-empty,''",
"quoted-space,' '",
"quoted-comma,'a,b'",
"literal-NULL,NULL"
}, ignoreLeadingAndTrailingWhitespace = true)
void csvInputIsWhatWeIntended(String kind, String input) {
switch (kind) {
case "unquoted-null" -> assertNull(input);
case "quoted-empty" -> assertEquals("", input);
case "quoted-space" -> assertEquals(" ", input);
case "quoted-comma" -> assertEquals("a,b", input);
case "literal-NULL" -> assertEquals("NULL", input);
default -> fail("Unknown case: " + kind);
}
}
@ParameterizedTest
@CsvSource(value = {"trimmed, a "})
void unquotedWhitespaceIsTrimmedByDefault(String kind, String input) {
assertEquals("a", input);
}
@ParameterizedTest
@CsvSource(value = {"preserved, a "}, ignoreLeadingAndTrailingWhitespace = false)
void unquotedWhitespaceCanBePreserved(String kind, String input) {
assertEquals(" a ", input);
}
}pom.xmlの全文を開く
<?xml version="1.0" ?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>info.syachiku.samples</groupId>
<artifactId>testing-casebook</artifactId>
<version>1.0.0</version>
<properties>
<maven.compiler.release>17</maven.compiler.release>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter</artifactId>
<version>5.12.2</version>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-resources-plugin</artifactId>
<version>3.2.0</version>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.1</version>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>3.5.6</version>
</plugin>
</plugins>
</build>
</project>確認した環境はJava 17.0.8、Maven 3.9.5です。実行には既存の依存キャッシュを使っています。空のキャッシュから初回に依存を取得する手順、別のJDK・OSはこのローカル実行では未確認です。
レビューでは、データの数より「何を間違えると落ちるか」を説明する
パラメータ化で行が増えても、それだけでテストが十分になったとは判断できません。今回なら「T06は100文字を誤拒否する間違い」「T10はコード単位で数える間違い」「T13は勝手にtrimする間違い」を確かめるためにあります。レビューでは、テストの短さより、その入力を選んだ理由と検出できる失敗を示します。
レビューコメント例:上限ちょうどの100文字をtrueとして、caseIdを表示名とassertionへ入れてください。空白込みの入力はCsvSourceの前処理で消えない形にし、末尾空白まで数える仕様を検証します。
- 各行の期待値を仕様から決め、対象コードの結果を正解にしていないか
- 境界値のケースIDから、仕様表と失敗した入力へ戻れるか
- null・空文字・空白・カンマが、意図した値のままテストへ届くか
- 文字の数え方やtrimの有無を、長さだけのケースと分けて確認したか
- テスト対象・テスト全文・pom.xml・GitHub・ZIPが同じ版を指すか
このサンプルが確認するのは、Javaの件名判定とテストへのデータの渡り方です。画面入力から届く値、HTTP応答、DBへの保存は含みません。それらを確かめる必要がある改修では、単体テストが通ることと、機能全体の操作が完了することを分けて範囲を決めます。
テストを書けた後は、残すべきケースを選ぶ力を補う
同じ判定を繰り返せても、どの失敗を防ぐべきかで迷うことは残ります。さらに学ぶなら、テスト記法だけでなく、仕様と照合して意味のある確認を選び、変更に追従できるテストへ整える考え方を補うと役立ちます。
正常な値の次に何を試すか、仕様から考える力を補うなら『ソフトウェアテストの教科書[増補改訂 第2版]』を案内します。JUnitの構文とは別に、同値分割・境界値・条件の組み合わせを整理するための1冊です。
ソフトウェアテストの教科書[増補改訂 第2版]
仕様から、試す入力と期待する結果を選べるようになる。
同値分割・境界値や条件の組合せなど、テストケースを選ぶ考え方を基礎から学ぶ1冊。何を試せばよいかわからない段階で選びます。
- 正常な値を1件試した後、追加するケースに迷う
- 入力と期待値を選んだ理由を説明したい
当サイトはAmazonアソシエイト・プログラムの参加者です。価格・在庫・配送条件はAmazonでご確認ください。
この記事とあわせて読みたい
テストの置き場所や最初の実行で止まったらJUnit入門へ。実際の改修で画面・DBも試すべきか迷ったら、テスト範囲の記事へ進めます。
まとめ:同じ判断を繰り返し、違う理由の失敗は読み分ける
選んだ6行の境界値は、caseId・長さ・期待結果のCsvSourceへ移します。100文字を拒否する間違いがT06で落ちることを確かめ、失敗した行から仕様と対象コードへ戻ります。
nullと空文字はNullAndEmptySource、少数の文字列はValueSource、生成する入力はMethodSourceへ分けられます。渡し方を一つに統一することより、何を渡して何を確認したかを、失敗した後でも説明できる形にすることを優先します。



