テスト駆動開発 (TDD) ってなに？

ソフトウェア開発に足を踏み入れたばかりの皆さん、こんにちは！品質の高いコードを書くための強力な武器、「テスト駆動開発（TDD）」と、Javaでテストを書くためのフレームワーク「JUnit」について、解説していきます。

「テスト駆動開発」って聞くと、なんだか難しそうに聞こえるかもしれません。でも、簡単に言えば、**「まずテストを書く、それから動くコードを書く」**っていう開発手法なんです。

え、コードを書く前にテスト？って思いますよね。普通はコードを書いて、それがちゃんと動くか後で確認する、ってイメージじゃないでしょうか。でも、TDDは逆なんです。この逆転の発想が、実はすごい効果を発揮するんですよ。

TDDのサイクルは、たったの3つのステップで回っていきます。

RED（赤）: まず、失敗するテストを書きます。まだその機能を実装していないので、テストは当然失敗しますよね。この状態を「赤」と呼びます。
GREEN（緑）: 次に、テストが通るように最小限のコードを書きます。余計なことはせず、とにかくテストを成功させることだけを考えます。テストが成功したら、この状態を「緑」と呼びます。
REFACTOR（リファクタ）: テストが通ったら、今度は書いたコードをきれいに整理します。重複をなくしたり、分かりやすい名前に変えたり、もっと効率的なコードにしたり。このとき、テストがすでに書かれているので、リファクタリング中に誤って機能を壊してしまってもすぐに気づけます。

この「赤→緑→リファクタ」のサイクルを繰り返すことで、小さな機能を確実に作り上げていきます。

TDDのメリットって？

TDDの考え方を取り入れると、こんなにいいことがあります。

バグが減る: コードを書く前にテストを書くので、自分がどんな機能を実装しようとしているのかが明確になります。また、実装が終わったらすぐにテストで確認できるので、バグを早期に発見できます。
高品質なコードになる: テストが書きやすいコードは、自然とシンプルで分かりやすいコードになります。複雑なコードはテストが書きにくいですからね。
変更に強いコードになる: テストがあるおかげで、安心してコードの修正や機能追加ができます。もし何かを壊してしまっても、テストが教えてくれます。
設計が良くなる: テストを書く過程で、「このクラスはどうあるべきか」「このメソッドはどんな役割を持つべきか」といった設計について深く考えるようになります。

TDDのメリットって？

Javaでテストを書くならJUnit！
1. JUnitを導入してみよう
実際にTDDをやってみよう！～足し算クラスを作ってみる～
もっとテストを書いてみよう！
継続的な学習のヒント
まとめ

Javaでテストを書くならJUnit！

TDDを実践するには、テストを簡単に書けるツールが必要です。Javaの世界では、**JUnit（ジェイユニット）**というフレームワークがデファクトスタンダードになっています。ほとんどのJavaプロジェクトで使われている、まさにテストの「お供」です。

JUnitを使うと、Javaのコードの中にテストコードを記述して、それを自動で実行できるようになります。

JUnitを導入してみよう

JUnitを使うには、プロジェクトにJUnitのライブラリを追加する必要があります。今回は、皆さんが普段使っているであろうビルドツール「Gradle」を使って追加する方法を紹介します。

Gradleの場合:

build.gradle ファイルを開いて、dependencies ブロックに以下の行を追加します。

Gradle

dependencies {
    // JUnit 5 Jupiter API と Engine を追加
    testImplementation 'org.junit.jupiter:junit-jupiter-api:5.11.0'
    testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.11.0'

    // 前回の記事の続きなので、必要に応じて他の依存関係も記述
    // 例:
    // implementation 'com.example:mylibrary:1.0.0'
}

※JUnitのバージョンは執筆時点（2025年6月）での最新版を使用しています。実際の開発では、プロジェクトの要件や環境に合わせて適切なバージョンを選択してください。

testImplementation はコンパイル時に必要な依存関係を、testRuntimeOnly は実行時にのみ必要な依存関係を示します。これでJUnitを使う準備ができました！

実際にTDDをやってみよう！～足し算クラスを作ってみる～

では、実際にTDDのサイクルを回しながら、簡単な「足し算クラス」を作ってみましょう。

1. RED（赤）: 失敗するテストを書く

まず、Calculatorという足し算を行うクラスを作りたいとします。その中にaddというメソッドを作り、2つの数値を足し算できるようにします。

テストコードは、通常src/test/javaディレクトリの下に作成します。テストクラスの名前は、テスト対象のクラス名にTestをつけたものが一般的です。今回はCalculatorTest.javaというファイルを作成します。

Java

// src/test/java/com/example/tdd/CalculatorTest.java

package com.example.tdd; // パッケージ名は適宜変更してください

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertEquals;

public class CalculatorTest {

    @Test // これがテストメソッドであることを示すアノテーション
    void testAddTwoNumbers() {
        // テスト対象のクラスをインスタンス化
        Calculator calculator = new Calculator();
        
        // 期待する結果 (expected) と、実際の計算結果 (actual)
        int expected = 5;
        int actual = calculator.add(2, 3); // まだCalculatorクラスもaddメソッドも存在しない！
        
        // 結果が等しいことをアサート（検証）
        assertEquals(expected, actual, "2と3を足したら5になるはず");
    }
}

この時点でCalculatorクラスもaddメソッドも存在しないので、このテストを実行するとコンパイルエラーになるか、実行しても**失敗（RED）**します。これでOKです！

2. GREEN（緑）: テストが通る最小限のコードを書く

次に、先ほどのテストが成功するように、必要最低限のコードを実装します。src/main/javaディレクトリの下にCalculator.javaファイルを作成しましょう。

Java

// src/main/java/com/example/tdd/Calculator.java

package com.example.tdd; // パッケージ名は適宜変更してください

public class Calculator {

    public int add(int a, int b) {
        return a + b; // とにかくテストが通るように実装
    }
}

これで、再度テストを実行してみましょう。

Gradleを使っている場合は、プロジェクトのルートディレクトリで以下のコマンドを実行します。

Bash

./gradlew test

テストが成功すれば、無事GREENになりました！

3. REFACTOR（リファクタ）: コードをきれいに整理する

今回は非常にシンプルなコードなので、リファクタリングする箇所はあまりありませんが、もし複雑なロジックがあったり、重複するコードがあったりした場合は、このステップでコードを整理します。

例えば、将来的にaddメソッドに複雑な制約（例: 引数が負の数の場合はエラーにするなど）が加わる可能性を考慮して、以下のように書き換えることもできます。

Java

// src/main/java/com/example/tdd/Calculator.java (リファクタリング後)

package com.example.tdd;

public class Calculator {

    public int add(int a, int b) {
        // 例: 引数のバリデーションを追加するならここ
        // if (a < 0 || b < 0) {
        //     throw new IllegalArgumentException("負の数は扱えません");
        // }
        return sum(a, b); // 別のプライベートメソッドに切り出すなど
    }

    // もし共通の処理があればプライベートメソッドにする
    private int sum(int a, int b) {
        return a + b;
    }
}

リファクタリングした後も、必ずテストを実行して、意図しない変更がないか確認します。テストがGREENのままであれば、リファクタリングは成功です！

もっとテストを書いてみよう！

足し算クラスができたので、さらに別のテストケースを追加してみましょう。例えば、ゼロとの足し算や、負の数との足し算などです。

Java

// src/test/java/com/example/tdd/CalculatorTest.java (追記)

package com.example.tdd;

import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertEquals;

public class CalculatorTest {

    @Test
    void testAddTwoNumbers() {
        Calculator calculator = new Calculator();
        int expected = 5;
        int actual = calculator.add(2, 3);
        assertEquals(expected, actual, "2と3を足したら5になるはず");
    }

    @Test
    void testAddWithZero() {
        Calculator calculator = new Calculator();
        assertEquals(10, calculator.add(10, 0), "10と0を足したら10になるはず");
        assertEquals(7, calculator.add(0, 7), "0と7を足したら7になるはず");
    }

    @Test
    void testAddNegativeNumbers() {
        Calculator calculator = new Calculator();
        assertEquals(-5, calculator.add(-2, -3), "-2と-3を足したら-5になるはず");
    }

    @Test
    void testAddPositiveAndNegative() {
        Calculator calculator = new Calculator();
        assertEquals(1, calculator.add(3, -2), "3と-2を足したら1になるはず");
        assertEquals(-1, calculator.add(-3, 2), "-3と2を足したら-1になるはず");
    }
}

このように、さまざまなパターンを想定してテストを追加していくことで、コードの堅牢性がどんどん高まっていきます。新しいテストを追加するたびに、「赤→緑→リファクタ」のサイクルを回すことを意識してくださいね。

継続的な学習のヒント

今回はTDDとJUnitの基本的な考え方と導入方法について学びました。TDDは、慣れるまで少し時間がかかるかもしれませんが、一度身につけてしまえば、あなたの開発スタイルを大きく変える強力な武器になります。

今後の学習のために、いくつかヒントを置いておきます。

アサーションの種類: JUnitにはassertEquals以外にも、assertTrue, assertFalse, assertNull, assertNotNullなど、さまざまなアサーションメソッドがあります。これらを使いこなすことで、より表現力豊かなテストが書けるようになります。
テストのライフサイクル: @BeforeEach, @AfterEach, @BeforeAll, @AfterAllといったアノテーションを使うと、テストの実行前後に特定の処理を行うことができます。例えば、データベース接続の準備や解放などに使われます。
パラメーター化テスト: @ParameterizedTestを使うと、複数の入力データに対して同じテストメソッドを繰り返し実行できます。これは、多くのテストケースを効率的に書くのに役立ちます。
モックとスタブ: 実際のシステムでは、テスト対象のクラスが他の複雑なクラスや外部システム（データベース、APIなど）に依存していることがよくあります。このような場合、依存関係を「モック」や「スタブ」と呼ばれるダミーオブジェクトに置き換えることで、テストを独立して実行できます。これはTDDにおいて非常に重要なテクニックです。