環境構築から始めるテスト駆動開発 ~Java開発環境を構築する~

はじめに

これは環境構築から始めるテスト駆動開発 ~ プログラミング環境の共通基盤を構築する ~ の開発言語セットアップ記事です。Windows 10 Home で共通基盤が構築されていることを前提としています。

インストール

スタートメニューから Windows PowerShell を選択します。

パッケージ管理ツールをインストールします。

1	> scoop install gradle

バージョンを確認しておきます。

> gradle -v
Welcome to Gradle 6.8.3!

Here are the highlights of this release:
 - Faster Kotlin DSL script compilation
 - Vendor selection for Java toolchains
 - Convenient execution of tasks in composite builds
 - Consistent dependency resolution

For more details see https://docs.gradle.org/6.8.3/release-notes.html


------------------------------------------------------------
Gradle 6.8.3
------------------------------------------------------------

Build time:   2021-02-22 16:13:28 UTC
Revision:     9e26b4a9ebb910eaa1b8da8ff8575e514bc61c78

Kotlin:       1.4.20
Groovy:       2.5.12
Ant:          Apache Ant(TM) version 1.10.9 compiled on September 27 2020
JVM:          11.0.10 (AdoptOpenJDK 11.0.10+9)
OS:           Windows 10 10.0 amd64

Hello world

プログラムを作成する

Projects フォルダ内に Java フォルダを作成してエディタからフォルダを開きます。

新しいターミナルを を実行してターミナルに以下のコマンドを入力します。

1	> gradle init --type java-application

Select build script DSL は 1:Groovy で Select test framework は 4: JUnit Jupiter を指定して Project name と Source package はそのままで実行します。

src/test/java/AppTest.java を開きます。
ファイルを開くと画面左下に Java プロジェクト読み込みの確認メッセージが表示されるので Yes を押します。

読み込みが完了したら Run Test と表示されるのでそこを押します。

アクセスを許可する を押します。

サイドメニューの テスト から実行結果を確認できます。

AppTest.js ファイルを以下のコードに書き換えます。

package Java;

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

class AppTest {
    @Test
    void 何か便利なもの() {
        assertEquals(true, false);
    }
}

Run Test を押してテストを実行します。

テストをパスするようにコードを修正してプログラムを実行します。

package Java;

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

class AppTest {
    @Test
    void 何か便利なもの() {
        assertEquals(true, true);
    }
}

テスティングフレームワークの動作が確認できたので helloWorld メソッドの作成に入ります。まず以下のコードを追加してテストが失敗することを確認します。

package Java;

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

class AppTest {
    @Test
    void 何か便利なもの() {
        assertEquals(true, true);
    }

    @Test
    void 簡単な挨拶を返す() {
        assertEquals("Hello from Java", Program.helloWorld());
    }
}

Program クラスに helloWorld メソッドを追加してテストをパスさせます。

package Java;

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

class AppTest {
    @Test
    void 何か便利なもの() {
        assertEquals(true, true);
    }

    @Test
    void 簡単な挨拶を返す() {
        assertEquals("Hello from Java", Program.helloWorld());
    }
}

class Program {
    static String helloWorld() {
        return "Hello from Java";
    }
}

指定された名前で挨拶を返すようにします。

package Java;

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

class AppTest {
    @Test
    void 何か便利なもの() {
        assertEquals(true, true);
    }

    @Test
    void 簡単な挨拶を返す() {
        assertEquals("Hello from Java", Program.helloWorld());
    }

    @Test
    void 指定された名前で挨拶を返す() {
        assertEquals("Hello from VSCode", Program.helloWorld("VSCode"));
    }
}

class Program {
    static String helloWorld() {
        return "Hello from Java";
    }
}

メソッドに引数を追加します。

package Java;

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

class AppTest {
    @Test
    void 何か便利なもの() {
        assertEquals(true, true);
    }

    @Test
    void 簡単な挨拶を返す() {
        assertEquals("Hello from Java", Program.helloWorld());
    }

    @Test
    void 指定された名前で挨拶を返す() {
        assertEquals("Hello from VSCode", Program.helloWorld("VSCode"));
    }
}

class Program {
    static String helloWorld(String name) {
        return String.format("Hello from %s", name);
    }
}

指定された名前で挨拶を返す テストはパスしましたが今度は 簡単な挨拶を返す テストが失敗するようになりましたのでメソッドをオーバーロードしてテストをパスするようにします。

package Java;

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

class AppTest {
    @Test
    void 何か便利なもの() {
        assertEquals(true, true);
    }

    @Test
    void 簡単な挨拶を返す() {
        assertEquals("Hello from Java", Program.helloWorld());
    }

    @Test
    void 指定された名前で挨拶を返す() {
        assertEquals("Hello from VSCode", Program.helloWorld("VSCode"));
    }
}

class Program {
    static String helloWorld() {
        return "Hello from Java";
    }

    static String helloWorld(String name) {
        return String.format("Hello from %s", name);
    }
}

仕上げに不要なテストを削除してテストケースの文言をわかりやすくしておきます。

package Java;

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

class AppTest {
    @Test
    void 何も指定していない場合は既定の挨拶を返す() {
        assertEquals("Hello from Java", Program.helloWorld());
    }

    @Test
    void 指定された名前で挨拶を返す() {
        assertEquals("Hello from VSCode", Program.helloWorld("VSCode"));
    }
}

class Program {
    static String helloWorld() {
        return "Hello from Java";
    }

    static String helloWorld(String name) {
        return String.format("Hello from %s", name);
    }
}