演習1〜4 振り返り

Day 1 で作ったものを整理します。今日の演習はすべてこの上に積み上がります。

単体テストとは何か

受入れ基準との関係

みなさんは「受入れ基準（Acceptance Criteria）」は知っています。たとえば：

単体テストは、この受入れ基準をコードに翻訳して、自動で確認する仕組みです。

なぜテストを書くのか

単体テストの「単体」とは

「DB・画面・外部APIから切り離して、1クラス（1メソッド）だけを集中的に確認する」という意味です。今回は TaskService のロジックだけを確認します。DBは起動しません。

使う3つのライブラリ

追加インストールは不要です。spring-boot-starter-test に3つすべて含まれています。

テストクラスの骨格

@ExtendWith(MockitoExtension.class)   // Mockitoを有効化する
class TaskServiceTest {

    @Mock
    private TaskRepository repository;  // 偽物のRepository

    @InjectMocks
    private TaskService service;        // テスト対象。偽物のRepositoryが自動で差し込まれる

    @Test
    void findById_存在するIDの場合タスクを返す() {
        // ここにテストを書く
    }
}

モックと when().thenReturn() の仕組み

テストで一番「なんのこと？」となりやすいのが when().thenReturn() です。丁寧に説明します。

なぜ「偽物のRepository」が必要か

本物の TaskRepository は、動いているDBがないと動きません。テストのためだけにDBを起動・セットアップするのは大変です。そこで「呼ばれたら決まった値を返す台本どおりの偽物」を使います。

// 「repository.findById(1L) が呼ばれたら Optional.of(task) を返す」という台本
when(repository.findByIdAndDeletedAtIsNull(1L))
    .thenReturn(Optional.of(task));

given / when / then の3段構造

テストは必ずこの3段で書きます。受入れ基準と対応しています。

@Test
void findById_存在するIDの場合タスクを返す() {

    // ① Given（準備）: 偽物のRepositoryに台本を与える
    Task task = new Task();
    task.setId(1L);
    task.setTitle("テストタスク");
    when(repository.findByIdAndDeletedAtIsNull(1L))
        .thenReturn(Optional.of(task));

    // ② When（実行）: テスト対象のメソッドを呼ぶ
    Task result = service.findById(1L);

    // ③ Then（確認）: 返ってきた値が期待通りか確認する
    assertThat(result.getId()).isEqualTo(1L);
    assertThat(result.getTitle()).isEqualTo("テストタスク");
}

異常系テスト（例外が投げられることを確認）

@Test
void findById_存在しないIDの場合TaskNotFoundExceptionを投げる() {

    // Given: id=999 は存在しない（空を返す台本）
    when(repository.findByIdAndDeletedAtIsNull(999L))
        .thenReturn(Optional.empty());

    // When + Then: 呼び出すと TaskNotFoundException が投げられることを確認
    assertThatThrownBy(() -> service.findById(999L))
        .isInstanceOf(TaskNotFoundException.class);
}

演習5 手順解説

src/test/java/jp/idhd/taskapp/service/TaskServiceTest.java

/tests TaskService の単体テストを JUnit 5 と Mockito で書いてください。AssertJ の assertThat を使って、findById・create の正常系と異常系をテストしてください。説明は日本語でお願いします

./mvnw test

TaskServiceTest に「status を指定せずに create したタスクは TODO になること」を確認するテストを追加してください。status が null のタスクを渡し、返ってきたタスクの status が TODO であることを確認します

./mvnw test

このテストの when().thenReturn() の意味を、テストを書いたことがない人向けに日本語で説明してください

生成されるテストの全体像（参考）

import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;
import static org.assertj.core.api.Assertions.*;
import static org.mockito.Mockito.*;

@ExtendWith(MockitoExtension.class)
class TaskServiceTest {

    @Mock
    private TaskRepository repository;

    @InjectMocks
    private TaskService service;

    @Test
    void findById_存在するIDの場合タスクを返す() {
        // Given
        Task task = new Task(); task.setId(1L);
        when(repository.findByIdAndDeletedAtIsNull(1L))
            .thenReturn(Optional.of(task));
        // When
        Task result = service.findById(1L);
        // Then
        assertThat(result.getId()).isEqualTo(1L);
    }

    @Test
    void findById_存在しないIDの場合TaskNotFoundExceptionを投げる() {
        when(repository.findByIdAndDeletedAtIsNull(999L))
            .thenReturn(Optional.empty());
        assertThatThrownBy(() -> service.findById(999L))
            .isInstanceOf(TaskNotFoundException.class);
    }

    @Test
    void create_statusを指定した場合はそのまま保存される() {
        Task task = new Task(); task.setStatus(TaskStatus.DOING);
        when(repository.save(task)).thenReturn(task);
        Task result = service.create(task);
        assertThat(result.getStatus()).isEqualTo(TaskStatus.DOING);
    }

    @Test
    void create_statusがnullの場合TODOに補正される() {   // 境界値テスト
        Task task = new Task(); task.setStatus(null);
        when(repository.save(task)).thenReturn(task);
        Task result = service.create(task);
        assertThat(result.getStatus()).isEqualTo(TaskStatus.TODO);
    }
}

完了チェック

うまくいかないとき