先生と生徒の会話形式で理解しよう

生徒

「Micronautで作ったアプリのテストって、どのように構成すれば良いのでしょうか？」

先生

「MicronautではJUnit5と連携してユニットテストや統合テストを行うのが一般的です。プロジェクト構成に応じてテストフォルダを整理すると管理がしやすくなります。」

生徒

「JUnit5とMicronautを組み合わせる際の具体的な設定や書き方も知りたいです。」

先生

「それでは、基本的なテスト構成とJUnit5との連携方法をステップごとに解説します。」

1. Micronautプロジェクトにおけるテスト構成の基本

Micronautプロジェクトの構造は、標準的なJavaプロジェクトの慣習に従っています。基本的には src/main/java にアプリケーションを動かすための本番用コードを書き、src/test/java にその動作を確認するためのテストコードを配置します。この「本番とテストを分ける」構成により、誤ってテスト用のプログラムが本番環境に混入するのを防ぎます。

テストには大きく分けて「ユニットテスト（単体テスト）」と「統合テスト」の2種類があります。初心者のうちは、以下のイメージで使い分けると分かりやすいでしょう。

ユニットテスト： 計算処理や文字の加工など、小さな部品単位でのチェック。
統合テスト： データベースやネットワークなど、複数の部品が組み合わさった状態でのチェック。

例えば、プログラミング未経験の方でもイメージしやすい「挨拶を返すだけの簡単なプログラム」を例に、テストの書き方を見てみましょう。まずはテスト対象となる本番コードのイメージです。


package com.example;

import jakarta.inject.Singleton;

@Singleton
public class GreetingService {
    // 渡された名前に「こんにちは」を付けて返すだけのシンプルな機能
    public String sayHello(String name) {
        return "こんにちは、" + name + "さん！";
    }
}

この GreetingService が正しく動くかを確認するために、src/test/java フォルダ内に以下のようなテストコードを作成します。Micronautの強力なDI（依存性注入）機能を使えば、テストしたい部品だけをサッと取り出して検証できるのが大きなメリットです。


package com.example;

import io.micronaut.test.extensions.junit5.annotation.MicronautTest;
import jakarta.inject.Inject;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertEquals;

@MicronautTest // Micronautの機能をテストで使うための魔法のアノテーション
public class GreetingServiceTest {

    @Inject // テスト対象のクラスを自動で準備してもらう
    GreetingService greetingService;

    @Test // これがテスト項目であることを示す
    void testSayHello() {
        // 1. 準備：期待する結果を決める
        String expected = "こんにちは、太郎さん！";
        
        // 2. 実行：実際にメソッドを動かしてみる
        String actual = greetingService.sayHello("太郎");
        
        // 3. 検証：結果が一致するか確認する
        assertEquals(expected, actual);
    }
}

このように、MicronautとJUnit5を組み合わせることで、複雑な設定なしで「プログラムが意図通りに動くか」を自動でチェックする仕組みを構築できます。この基本構成を理解することが、バグの少ない高品質なアプリ開発への第一歩となります。

2. JUnit5とMicronautの連携方法

MicronautはJUnit5の拡張を提供しており、@MicronautTestアノテーションを使うことで、テスト実行時にDIコンテナを自動的に起動してくれます。これにより、サービスやリポジトリなどの依存オブジェクトを注入してテスト可能です。


package com.example.userservice;

import io.micronaut.test.extensions.junit5.annotation.MicronautTest;
import jakarta.inject.Inject;
import org.junit.jupiter.api.Test;

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

@MicronautTest
public class UserServiceTest {

    @Inject
    UserService userService;

    @Test
    void testUserNameCapitalization() {
        String result = userService.capitalizeUserName("micronaut");
        assertEquals("Micronaut", result);
    }
}

この例では、UserServiceのcapitalizeUserNameメソッドをテストしています。@Injectを使ってMicronautのDIによる依存注入が行われ、JUnit5の@Testでテストを実行します。

SEOキーワード：Micronaut JUnit5 連携、Java DI テスト、MicronautTest 使用例、JUnit5 ユニットテスト

3. テストフォルダの整理と命名規則

テストコードを整理するためには、以下のようなフォルダ構成が推奨されます。

src/test/java/com/example/common - 共通ユーティリティのテスト
src/test/java/com/example/userservice - UserService関連のテスト
src/test/java/com/example/orderservice - OrderService関連のテスト

クラス名は対象クラス名の末尾にTestを付けることで、JUnit5の自動検出がスムーズになります。例えばUserService.javaのテストクラスはUserServiceTest.javaと命名します。

SEOキーワード：Micronaut テストフォルダ構成、JUnit5 クラス命名規則、Java テスト管理、Micronaut ユニットテスト整理

4. 統合テストでのMicronaut起動方法

統合テストでは、HTTPリクエストやデータベース接続を伴う機能を検証します。@MicronautTestアノテーションを付けると、必要なコンテキストが自動的に起動されます。さらに、環境プロパティを変更してテスト用の設定で起動することも可能です。


@MicronautTest
public class OrderServiceIntegrationTest {

    @Inject
    OrderService orderService;

    @Test
    void testCreateOrder() {
        Order order = orderService.createOrder("micronaut-book");
        assertEquals("micronaut-book", order.getName());
    }
}

このように統合テストを行うことで、サービス間の依存関係やデータベース連携も含めた実際の動作確認が可能です。

SEOキーワード：Micronaut 統合テスト、JUnit5 統合テスト、Java サービス連携テスト、MicronautTest 統合

5. モックを使った依存サービスのテスト

JUnit5とMicronautではMockitoなどのモックフレームワークを組み合わせることで、外部サービスへの依存を切り離したユニットテストが可能です。@MockBeanアノテーションを使うと、DIコンテナにモックを登録できます。


@MicronautTest
public class PaymentServiceTest {

    @Inject
    PaymentService paymentService;

    @MockBean(PaymentGateway.class)
    PaymentGateway paymentGateway() {
        return Mockito.mock(PaymentGateway.class);
    }

    @Test
    void testProcessPayment() {
        Mockito.when(paymentGateway().charge(100)).thenReturn(true);
        boolean result = paymentService.processPayment(100);
        assertEquals(true, result);
    }
}

この方法により、外部APIやデータベースに依存せずにユニットテストが可能になり、テストの信頼性と速度を向上させられます。

SEOキーワード：Micronaut モックテスト、JUnit5 Mockito 連携、Java 外部依存分離、Micronaut DI モック