Quarkusのレイヤーテスト戦略を完全解説！UnitテストとIntegrationテストを正しく設計する方法

1. Quarkusにおけるレイヤーテスト戦略とは

1. Quarkusにおけるレイヤーテスト戦略とは

Quarkusのレイヤーテスト戦略とは、アプリケーションを構成する「部品（レイヤー）」ごとに、最適なテスト手法を組み合わせて検証する設計思想のことです。 モダンなJava開発、特にクラウドネイティブなQuarkusにおいては、すべての機能を一度に動かすテストだけでは不十分です。 なぜなら、不具合が起きた際に「プログラムの計算ミス」なのか「データベースの接続ミス」なのか、原因の切り分けに時間がかかってしまうからです。

例えば、料理に例えると「野菜が新鮮か（ユニットテスト）」を確認してから、「スープの味付けと具材の相性は良いか（インテグレーションテスト）」を確認するような流れです。 Quarkusではプロジェクト構成が整っているため、これらを明確に分離して自動化できます。

なぜレイヤーを分ける必要があるのか？

一つの巨大なテストですべてをチェックしようとすると、テストの実行に数分〜数十分かかるようになり、開発のテンポが損なわれます。 Quarkusのレイヤーテスト戦略を導入することで、以下の3つのメリットが得られます。

• スピード： 小さい単位のテスト（Unitテスト）を高速に回せる。
• 正確性： どこでエラーが起きたかピンポイントで特定できる。
• 保守性： アプリの規模が大きくなっても、テストコードが管理しやすくなる。

Quarkusは開発者体験（DevEx）を重視しており、テストの待ち時間を最小限に抑える仕組みが備わっています。 次節からは、具体的にそれぞれのレイヤーをどうテストしていくのか見ていきましょう。

2. Unitテストの役割と対象レイヤー

2. Unitテストの役割と対象レイヤー

Unitテスト（ユニットテスト）は、プログラムの最小単位である「クラス」や「メソッド」が、意図通りに動くかを確認するためのテストです。 Quarkusを用いた開発では、主にビジネスロジックを担うService層や、共通処理をまとめたユーティリティクラスが主な検証対象となります。

最大の特徴は、データベースや外部APIといった「外部環境」に一切依存しない点です。 これにより、ネットワークの状態に左右されず、数秒で何百ものテストを実行できるため、開発のスピードを劇的に向上させることができます。

// テスト対象のクラス
public class PriceCalculator {
    public int calculateTax(int price) {
        // 消費税10%を計算するシンプルなロジック
        return (int) (price * 1.1);
    }
}

// Unitテストのイメージ（JUnit5使用）
class PriceCalculatorTest {
    @Test
    void testCalculateTax() {
        PriceCalculator calculator = new PriceCalculator();
        int result = calculator.calculateTax(100);
        // 結果が110になることを確認
        assertEquals(110, result);
    }
}

このように、Unitテストでは複雑な分岐や計算など、純粋なJavaロジックの正確性を徹底的にチェックします。 実行が高速で、もしエラーが起きても「どのメソッドのどの処理が原因か」が即座に特定できるため、テストピラミッドの土台として最も多くの数を作成することが推奨されています。

3. QuarkusでのUnitテストの基本構成

3. QuarkusでのUnitテストの基本構成

QuarkusのUnitテストは、src/test/java配下に配置します。 本体のパッケージ構成と同じ構成にすると、 どのクラスをテストしているのかが分かりやすくなります。 これはJava開発の基本的なルールです。

package com.example.service;

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

public class CalculatorServiceTest {

    @Test
    public void addTest() {
        CalculatorService service = new CalculatorService();
        int result = service.add(2, 3);
        assertEquals(5, result);
    }
}

このようなUnitテストでは、Quarkusの起動は不要です。 Javaのクラス単体を検証することで、 ロジックの正しさを確実に確認できます。

4. Integrationテストの役割と対象レイヤー

4. Integrationテストの役割と対象レイヤー

Integrationテストは、複数のレイヤーが連携した状態を検証するテストです。 Quarkusでは、REST APIやデータベース連携を含めた動作確認が主な対象になります。 Unitテストでは確認できない設定ミスやDIの問題を発見できます。

Integrationテストは実行時間が長くなるため、 重要なシナリオに絞って書くのがポイントです。 Quarkusはテスト時の起動が高速なので、 Integrationテストとの相性が良いフレームワークです。

5. QuarkusのIntegrationテストの書き方

5. QuarkusのIntegrationテストの書き方

QuarkusのIntegrationテストでは、 テスト用にアプリケーションを起動した状態で検証を行います。 REST APIのエンドポイントを呼び出して、 実際のレスポンスを確認する形が一般的です。

package com.example.resource;

import io.quarkus.test.junit.QuarkusTest;
import org.junit.jupiter.api.Test;

import static io.restassured.RestAssured.given;
import static org.hamcrest.CoreMatchers.is;

@QuarkusTest
public class HelloResourceTest {

    @Test
    public void helloTest() {
        given()
          .when().get("/hello")
          .then()
             .statusCode(200)
             .body(is("hello"));
    }
}

このテストでは、Quarkusが内部で起動し、 実際のREST APIが呼び出されます。 本番に近い状態で動作確認できるのがIntegrationテストの強みです。

6. UnitテストとIntegrationテストの使い分け

6. UnitテストとIntegrationテストの使い分け

Quarkusのレイヤーテスト戦略では、 UnitテストとIntegrationテストの役割を明確に分けることが重要です。 すべてをIntegrationテストで行うと、 テストの実行時間が長くなり、開発効率が下がります。

ロジックの検証はUnitテスト、 設定や連携の確認はIntegrationテストという形で分担すると、 バランスの良いテスト構成になります。 これは実務でもよく使われる考え方です。

7. Quarkusプロジェクト構成とテスト設計のポイント

7. Quarkusプロジェクト構成とテスト設計のポイント

Quarkusのプロジェクト構成を意識してテストを書くことで、 どのレイヤーを検証しているのかが明確になります。 テストコードも設計の一部と考えることが大切です。

初心者のうちからレイヤーテスト戦略を意識しておくと、 規模が大きくなっても破綻しにくいJavaアプリを作れます。 Quarkusはその学習を支えてくれる非常に優れたフレームワークです。