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

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

生徒

「Kotlinでテストを書いていると、他のクラスに依存してる部分ってどうやってテストすればいいんですか？」

先生

「いいところに気づきましたね。テスト対象が他のクラスに依存している場合は、『モック化（Mock）』という方法で対処するんですよ。」

生徒

「モック？それって難しいですか？」

先生

「大丈夫です。これから初心者にもわかりやすく、Kotlinでのモック化の基本とコツを丁寧に解説していきますね！」

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

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

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

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

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

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

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. モックのふるまいを指定するコツ

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

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

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

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

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

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

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. コンストラクタ注入でモックしやすくする

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

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


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

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