SpringBootコース

MyBatisを使ったデータベース有のSpringBootアプリケーション

SpringBoot + MyBatisでTODOリストアプリ作成 (1)

ここでは、タスク情報を管理する**Task**モデルをデータベースと連携するために使用する**MyBatisマッパー**を作成します。
**TaskMapper**インターフェースは、データベース操作を簡潔に記述するための**MyBatisアノテーション**を用いて実装します。
**TaskMapper**は、データベースのタスクテーブルに対応し、以下の機能を提供します
* タスクの新規登録(Create)
* 全タスクの取得(Read)

## 1. MyBatisマッパーの種類
MyBatisではSQLを記述する方法として、以下の2種類のマッパーがあります
1. XMLベース
   * SQLを専用のXMLファイルに記述します。
   * 再利用性が高く、大規模プロジェクトに向いています。
2. アノテーションベース
   * SQLをJavaコード内で直接記述します。
   * 記述がシンプルで、小規模または単純なクエリに適しています。

今回のプロジェクトでは、SQLが比較的シンプルであるため、アノテーションベースを採用します。

## 2. マッパーファイルの作成
### TaskMapper.javaの作成
`TaskMapper`クラスの作成手順は以下のとおりです。

1. 新規作成より、クラスを選択
2. 新規Javaクラスで以下を設定して作成
   * 名前: `*TaskMapper*`
   * ソース・フォルダー: `*todolist/src/main/java*`
   * パッケージ: `*com.example.todolist.mapper*`

作成後、`src/main/java/com/example/todolist/mapper`ディレクトリ内に作成された`TaskMapper.java`をダブルクリックして開きます。
### ソースコード
以下はアノテーションベースで実装されたTaskMapperのコードです。
コピー＆ペーストしてTaskMapperを実装してください。
```java~TaskMapper
package com.example.todolist.mapper;

import java.util.List;

import org.apache.ibatis.annotations.*;

import com.example.todolist.model.Task;

@Mapper
public interface TaskMapper {

    @Select("SELECT * FROM tasks ORDER BY id ASC")
    @Results(id = "TaskResultMap", value = {
        @Result(property = "id", column = "id", id = true),
        @Result(property = "name", column = "name")
    })
    List<Task> getAllTasks();

    @Insert("INSERT INTO tasks (name) VALUES (#{name})")
    @Options(useGeneratedKeys = true, keyProperty = "id")
    void insertTask(Task task);
}

```
### メソッドとSQL文の説明
1. `getAllTasks()`  
   * メソッド説明
     * タスクテーブルの全レコードを取得します。
   * SQL文説明
     * `tasks`テーブル内のすべての列を取得します。
     * `ORDER BY id ASC`により、タスクがIDの昇順で並べ替えられます。
2. `insertTask(Task task)`
   * メソッド説明
     * タスクを新規登録します。idは自動生成されます。
   * SQL文説明
     * 新しいタスクを`tasks`テーブルに挿入します。
     * 挿入時に指定される列は`name`のみで、その他の列（`id`）は自動生成されます。

### ディレクトリ構成
```
src/
└── main/
    ├── java/
    │   └── com/
    │       └── example/
    │           └── todolist/
    │               ├── model/
    │               │   └── Task.java
    │               ├── mapper/
    │               │   └── TaskMapper.java  <-- 今回のレッスンで完成!
    │               └── TodolistApplication.java
    └── resources/
        ├── application.properties
        └── schema.sql
```

以上の手順で、MyBatisの**アノテーションベース**によるマッパーを実装しました。
次回は、このマッパーを使用してサービス層を実装し、コントローラーで利用する方法を説明します。