Kotlinのテスト対象クラスの依存関係をモック化するコツ！初心者向け単体テスト解説

1. モック（Mock）とは何か？

1. モック（Mock）とは何か？

モックとは、本物のクラスの代わりに使う「偽物のクラス」です。主にテスト専用に使われ、外部の処理や他のクラスに依存せず、テストだけに集中できるようにします。

例えば、「銀行APIに接続するクラス」があるとして、そのクラスを毎回本物でテストすると、時間もお金もかかってしまいます。そこで、その部分だけを偽物にして、テスト中は本物のようにふるまわせるのです。

2. 依存関係とは？なぜモック化が必要なのか

2. 依存関係とは？なぜモック化が必要なのか

クラスが他のクラスを使っている状態を「依存関係」と呼びます。Kotlinのプログラムでも、よく「サービス」や「リポジトリ」などのクラスを他のクラスが使うことがあります。

例えば、OrderServiceがPaymentServiceを使って支払いを処理する場合、OrderServiceのテストでは、PaymentServiceをモックにすることで、支払い処理をシミュレーションできるようになります。

3. モックライブラリ「Mockito-Kotlin」の基本

3. モックライブラリ「Mockito-Kotlin」の基本

Kotlinでは、モックを簡単に作れるライブラリとしてMockito-Kotlinがよく使われます。これはJavaで有名なMockitoのKotlin向け拡張ライブラリです。

以下は、基本的なセットアップとモックの作成例です。

import org.mockito.kotlin.mock
import org.mockito.kotlin.whenever
import org.junit.jupiter.api.Test
import kotlin.test.assertEquals

class OrderServiceTest {

    private val paymentService = mock<PaymentService>()
    private val orderService = OrderService(paymentService)

    @Test
    fun processOrder_successfulPayment_returnsTrue() {
        // モックのふるまいを定義
        whenever(paymentService.charge(1000)).thenReturn(true)

        val result = orderService.processOrder(1000)

        assertEquals(true, result)
    }
}

4. モックのふるまいを指定するコツ

4. モックのふるまいを指定するコツ

whenever(...).thenReturn(...)の形で、モックが呼ばれたときの返り値を指定できます。

こうすることで、実際には何も処理していなくても、まるで本当に動作しているかのようにテストを進めることができます。

これを「スタブ」と呼ぶこともあり、返す値を決めておくテクニックです。

5. テストの対象は1つだけに絞ろう

5. テストの対象は1つだけに絞ろう

モックを使うことで、テストしたいクラスだけに注目できます。

たとえばOrderServiceをテストしているのに、PaymentServiceの動きまで気にしていたら混乱してしまいますよね。だからこそ、依存部分はモックで置き換えて、テスト対象に集中することが大切なのです。

6. verifyでモックが呼ばれたか確認しよう

6. verifyでモックが呼ばれたか確認しよう

モックの強みの1つは「呼ばれたかどうか」を検証できることです。これをverifyという関数で行います。

import org.mockito.kotlin.verify

@Test
fun processOrder_shouldCallPaymentService() {
    whenever(paymentService.charge(500)).thenReturn(true)

    orderService.processOrder(500)

    verify(paymentService).charge(500)
}

これにより、chargeメソッドが正しく呼ばれたかどうかを確認できます。

7. コンストラクタ注入でモックしやすくする

7. コンストラクタ注入でモックしやすくする

テストしやすいコードを書くためには、依存関係を「コンストラクタで渡す」ようにしておくと便利です。これを「コンストラクタインジェクション」と呼びます。

例えば、以下のように書くとテスト時にモックを渡せるようになります。

class OrderService(private val paymentService: PaymentService) {
    fun processOrder(amount: Int): Boolean {
        return paymentService.charge(amount)
    }
}

モックを渡すだけで簡単にテストできるので、初心者にもおすすめの設計です。

8. 不要な処理を避けてテストを高速化

8. 不要な処理を避けてテストを高速化

本物のクラスを使うと、データベースに接続したりネット通信したりする可能性があり、テストに時間がかかってしまいます。

モックを使うことでそうした重たい処理を省略でき、テストが高速で終わります。これにより、開発中に何度でも気軽にテストを実行できるようになります。

9. モック化は「信頼できるテスト」の第一歩

9. モック化は「信頼できるテスト」の第一歩

初心者のうちは、「モックって難しそう」と感じるかもしれませんが、慣れてくるととても便利な存在です。

大事なのは、「このクラスだけちゃんと動いているか確認したい」という目的に集中することです。

モック化は、テストの精度を高め、バグの少ないプログラムを書くための第一歩です。