Maven を使用した Kotlin プロジェクトのテスト

Kotlin は Maven エコシステムとシームレスに統合されており、業界標準のツールを使用してバックエンドアプリケーションを検証できます。このガイドでは、JUnit を使用してテストを作成する方法と、Maven プラグインを使用してユニットテストおよび統合テストを実行する方法について説明します。

Kotlin と Java の両方を使用するように Maven プロジェクトをセットアップするための詳細なガイドについては、 を参照してください。

JUnit を使用したテストの作成

JUnit は、Kotlin バックエンド開発における標準的なテスティングフレームワークです。Kotlin は複数の JUnit バージョンをサポートしていますが、現代的なプロジェクトの多くは JUnit 6 を使用すべきです。

JUnit を使用して Kotlin でテストを作成するには、kotlin.test または JUnit パッケージの @Test アノテーションを使用します。

依存関係の追加

kotlin-test ライブラリを使用するのが最も簡単な方法です。これは共通のアサーションセットを提供し、必要な JUnit アーティファクトを自動的に取得します。

JUnit 5 以降

すべての新しいプロジェクトでは、kotlin-test-junit5 アーティファクトを使用してください。これには、ネストされたテストや並列実行などの機能を含む、JUnit の完全なサポートが含まれています。Kotlin/JVM は、最新の安定した JUnit バージョンである JUnit 6 をサポートしています。

pom.xml ファイルを次のように更新します。

<dependencies>
    <dependency>
        <groupId>org.jetbrains.kotlin</groupId>
        <artifactId>kotlin-test-junit5</artifactId>
        <version>2.3.0</version>
        <scope>test</scope>
    </dependency>
</dependencies>

その名称にかかわらず、kotlin-test-junit5 は JUnit 6 を含む最新のすべての JUnit バージョンをサポートしています。

JUnit 4

レガシープロジェクトなどで以前のバージョンの JUnit を使用したい場合は、JUnit 4 を利用する kotlin-test-junit アーティファクトを使用してください。

<!-- pom.xml -->
<dependencies>
    <dependency>
        <groupId>org.jetbrains.kotlin</groupId>
        <artifactId>kotlin-test-junit</artifactId>
        <version>2.3.0</version>
        <scope>test</scope>
    </dependency>
</dependencies>

JUnit を使用したテストの詳細なガイドとサンプルプロジェクトについては、Kotlin による Java コードのテスト チュートリアルを参照してください。

ユニットテストの作成

ユニットテストは、個々の関数やクラスなど、コードの隔離された部分を検証します。 慣例として、ユニットテストには *Test という接尾辞を付けます。例：

import kotlin.test.Test
import kotlin.test.assertEquals

class OrderServiceTest {
    @Test
    fun `calculate total should sum item prices`() {
        val service = OrderService()
        val result = service.calculateTotal(listOf(10.0, 25.0))
        assertEquals(35.0, result)
    }
}

統合テストの作成

統合テストは、サービスとデータベースの間など、コンポーネント間の相互作用を検証します。 慣例として、統合テストには *IT という接尾辞を付けます。例：

import kotlin.test.Test
import kotlin.test.assertNotNull

class UserRepositoryIT {
    @Test
    fun saveFindUser() {
        // データベースまたはサービスとの統合例
        val repository = UserRepository()
        repository.save(User("KotlinUser"))
        
        val user = repository.findByName("KotlinUser")
        assertNotNull(user)
    }
}

テストの実行

Maven プロジェクトでは、クリーンなビルドライフサイクルを確保するために、通常 Surefire と Failsafe の 2 つのプラグインでテスト実行を分担します。

Surefire プラグインによる実行

Surefire プラグイン は、ユニットテスト を処理します。 *Test の命名パターンに従うすべての Kotlin および Java テストを実行します。

デフォルトでは、ビルドライフサイクルの test フェーズで実行され、テストが失敗した場合は直ちにビルドを失敗させます。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.5.5</version>
</plugin>

ユニットテストのみを実行するには、次のコマンドを使用します。

mvn test

Failsafe プラグインによる実行

Failsafe プラグイン は、統合テスト を処理します。 *IT の命名パターンに従うすべての Kotlin および Java テストを実行します。

Surefire とは異なり、Failsafe は integration-test フェーズ中にテストが失敗してもビルドを続行できるため、post-integration-test フェーズのタスク（Docker コンテナの停止など）を実行できます。 テストの失敗があった場合、最終的に verify フェーズでビルドが失敗します。

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-failsafe-plugin</artifactId>
    <version>3.5.5</version>
    <executions>
        <execution>
            <goals>
                <goal>integration-test</goal>
                <goal>verify</goal>
            </goals>
        </execution>
    </executions>
</plugin>

ユニットテストと統合テストの両方を実行するには、次のコマンドを使用します。

mvn verify

その他のテスティングフレームワークの探索

JUnit のほかに、Kotlin のテストをよりイディオマティック（Kotlin らしい書き方）で読みやすくするために、他の人気のあるフレームワークを使用することもできます。

ライブラリ	説明
AssertJ	メソッドチェーンが可能な、流れるような（Fluent）アサーションライブラリ。
Mockito-Kotlin	ヘルパー関数を提供し、Kotlin の型システムとの親和性を高めた Mockito の Kotlin 用ラッパー。
MockK	コルーチンや拡張関数を含む Kotlin 固有の機能をサポートする、Kotlin ネイティブのモックライブラリ。
Kotest	複数のアサーションスタイルと広範なマッチャーをサポートする Kotlin 用アサーションライブラリ。
Strikt	型安全なアサーションとデータクラスのサポートを備えた Kotlin 用アサーションライブラリ。

次のステップ

• kotlin.test ライブラリ の機能を探索する。
• Kotlin の Power-assert コンパイラプラグイン を使用して、テスト出力を改善する。