Spring Bootフレームワークを用いて、シンプルなレンタル管理システムを開発する課題です。


SpringBootコース

テンプレートエンジン(thymeleaf)

レンタル管理システムを作ろう

## 図書と機材（アイテム）管理機能について
ここでは、アイテム管理機能を作成していきます。レンタル管理システムとしては、「レンタルするモノ」を管理する機能になります。

アイテム管理機能は、3種類の機能を実装します。

- 登録機能
- 編集機能
- 削除機能

上記の機能をそれぞれ、**3層アーキテクチャ**に沿って、コントローラー、サービス、リポジトリの3種類に分けて作成していきます。

### 学習のポイント

この章では、図書と機材を管理するアイテム機能を実装します。アイテム管理機能では、ユーザー管理機能で学んだ基本に加えて、以下の点を拡張して学びます：

1. **CRUDの完全実装**：Create（作成）、Read（読み取り）に加えて、Update（更新）操作も含めた完全なCRUD機能を実装します
2. **型の管理**：図書（book）と機材（equipment）という異なる種類のアイテムを同一テーブルで管理する方法を学びます
3. **ステータス管理**：アイテムの貸出状態（available/rented）を管理する方法を理解します
4. **編集フォームの実装**：既存データを編集するためのフォーム実装方法を学びます

アイテム管理機能は、ユーザー管理機能よりも少し複雑な実装となりますが、同じ3層アーキテクチャのパターンに従っています。




## テーブルの作成
1. H2コンソールを開く

2. ブラウザで http://localhost:8080/h2-console/ にアクセス
3. 接続情報を入力し接続
4. 以下のSQLを実行してテーブルを作成、初期データを挿入
```sql
CREATE TABLE items (
  id INT PRIMARY KEY AUTO_INCREMENT,
  type ENUM('book', 'equipment') NOT NULL,
  name VARCHAR(100) NOT NULL,
  status ENUM('available', 'rented') NOT NULL DEFAULT 'available'
);
INSERT INTO items (id, type, name, status) VALUES
(1, 'book', '吾輩は猫である', 'available'),
(2, 'book', 'こころ', 'rented'),
(3, 'equipment', 'ランニングマシン', 'available'),
(4, 'equipment', 'ダンベルセット', 'rented');
```

## アイテム関連クラスの作成
3層アーキテクチャに沿って、以下の順序でクラスを作成していきます。


```mermaid
flowchart 
    subgraph 3層アーキテクチャ
        A[プレゼンテーション層<br><br>◆ItemController]
        B[ビジネス層<br><br>◆ItemService<br>◆Item]
        C[(データアクセス層<br><br>◆ItemRepository)]
    end
    A <-->B
    B <-->C
```

◆とついている部品が、今回作成するクラスになります。


1. Itemクラスの作成
2. ItemRepositoryの作成
3. ItemServiceの作成
4. ItemControllerの作成

の順で作成を進めていきます。

## Itemクラスの作成
アイテム情報を表すモデルクラスを作成します。


### 1-1 .Itemクラスの作成 (Item.java)
下記のクラスを作成しましょう。
- 名前 : Item
- パッケージ： com.example.rental.model

作成できたら、`src/main/java`ディレクトリ内に作成された`Item.java`をダブルクリックして開きます。

### 1-2. Userクラスの実装

- 以下のクラス図とソースコードを参考に、フィールド、メソッドを実装しましょう。
    - IDEによっては、フィールドを記述した後は、各種メソッドを自動作成することも可能です
    - Eclipseの場合、メニューの「ソース」 > 「getterおよびsetterの生成」や、「フィールドを使用してコンストラクターを生成」からメソッドを自動で生成することができます

#### クラス図

```mermaid
classDiagram
    class Item {
        - Integer id;
        - String type;
        - String name;
        - String status;
        + getterおよびsetter()
    } 
```

```java~Item
package com.example.rental.entity;

public class Item {
    private Integer id;
    private String type;
    private String name;
    private String status;
    
    // Getter/Setter
    public Integer getId() { return id; }
    public void setId(Integer id) { this.id = id; }
    
    public String getType() { return type; }
    public void setType(String type) { this.type = type; }
    
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    
    public String getStatus() { return status; }
    public void setStatus(String status) { this.status = status; }
}
```
**コード解説**

- Itemクラスは、データベースのitemsテーブルと対応するモデルクラスです
  - 4つのフィールド（id, type, name, status）はテーブルの各カラムに対応しています
  - typeフィールドは、アイテムの種類（図書か機材か）を示します
  - statusフィールドは、アイテムの貸出状態（利用可能か貸出中か）を示します

実際のアプリケーションでは、これらの列挙型フィールドにはEnum型を使用するのが一般的ですが、シンプルさのために今回は文字列として扱います


### Item.java

## Repositoryの作成

### ItemRepository.java
```java~ItemRepository
//src/main/java/com/example/demo/repository/ItemRepository.java
package com.example.demo.repository;

import com.example.demo.entity.Item;
import org.apache.ibatis.annotations.*;

import java.util.List;

@Mapper
public interface ItemRepository {

    @Select("SELECT * FROM items")
    List<Item> findAll();

    @Select("SELECT * FROM items WHERE id = #{id}")
    Item findById(Integer id);

    @Insert("""
        INSERT INTO items (type, name, status) 
        VALUES (#{type}, #{name}, #{status})
        """)
    void insert(Item item);

    @Update("""
        UPDATE items 
        SET type = #{type}, name = #{name}, status = #{status}
        WHERE id = #{id}
        """)
    void update(Item item);

    @Delete("DELETE FROM items WHERE id = #{id}")
    void delete(Integer id);
}
```

## サービスの作成

### ItemService.java
```java~ItemService.java
// src/main/java/com/example/demo/service/ItemService.java
package com.example.demo.service;

import com.example.demo.entity.Item;
import com.example.demo.repository.ItemRepository;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class ItemService {

    private final ItemRepository itemRepository;

    public ItemService(ItemRepository itemRepository) {
        this.itemRepository = itemRepository;
    }

    public List<Item> getAllItems() {
        return itemRepository.findAll();
    }

    public Item getItemById(Integer id) {
        return itemRepository.findById(id);
    }

    public void saveItem(Item item) {
        if (item.getId() == null) {
            itemRepository.insert(item);
        } else {
            itemRepository.update(item);
        }
    }

    public void deleteItem(Integer id) {
        itemRepository.delete(id);
    }
}
```

## コントローラの作成

### ItemController.java
```java~ItemController
// src/main/java/com/example/demo/controller/ItemController.java
package com.example.demo.controller;

import com.example.demo.entity.Item;
import com.example.demo.service.ItemService;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.*;

@Controller
@RequestMapping("/items")
public class ItemController {

    private final ItemService itemService;

    public ItemController(ItemService itemService) {
        this.itemService = itemService;
    }

    @GetMapping
    public String listItems(Model model) {
        model.addAttribute("items", itemService.getAllItems());
        return "item-list";
    }

    @GetMapping("/new")
    public String showCreateForm(Model model) {
        model.addAttribute("item", new Item());
        return "item-form";
    }

    @PostMapping
    public String createOrUpdateItem(@ModelAttribute Item item) {
        itemService.saveItem(item);
        return "redirect:/items";
    }

    @GetMapping("/edit/{id}")
    public String showEditForm(@PathVariable Integer id, Model model) {
        model.addAttribute("item", itemService.getItemById(id));
        return "item-form";
    }

    @GetMapping("/delete/{id}")
    public String deleteItem(@PathVariable Integer id) {
        itemService.deleteItem(id);
        return "redirect:/items";
    }
}
```

## テンプレートの作成

### アイテム一覧 (`item-list.html`)
```html~item-list
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>アイテム一覧</title>
</head>
<body>
<h1>アイテム一覧</h1>
<a href="/items/new">新規アイテム登録</a>
<table border="1">
    <thead>
        <tr>
            <th>ID</th>
            <th>タイプ</th>
            <th>名前</th>
            <th>ステータス</th>
            <th>操作</th>
        </tr>
    </thead>
    <tbody>
    <tr th:each="item : ${items}">
        <td th:text="${item.id}"></td>
        <td th:text="${item.type}"></td>
        <td th:text="${item.name}"></td>
        <td th:text="${item.status}"></td>
        <td>
            <a th:href="@{/items/edit/{id}(id=${item.id})}">編集</a>
            <a th:href="@{/items/delete/{id}(id=${item.id})}"
                onclick="return confirm('削除しますか？')">
                削除
            </a>
        </td>
    </tr>
    </tbody>
</table>
</body>
</html>
```

*   アイテム登録/編集フォーム (`item-form.html`)

```html~item-form
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>アイテム登録/編集</title>
</head>
<body>
<h1>アイテム登録/編集</h1>
<form th:action="@{/items}" method="post" th:object="${item}">
    <input type="hidden" th:field="*{id}" />
    <label for="type">タイプ:</label>
    <select id="type" th:field="*{type}">
        <option value="book">図書</option>
        <option value="equipment">機材</option>
    </select>
    <br/>
    <label for="name">名前:</label>
    <input type="text" id="name" th:field="*{name}" required />
    <br/>
    <label for="status">ステータス:</label>
    <select id="status" th:field="*{status}">
        <option value="available">available</option>
        <option value="rented">rented</option>
    </select>
    <br/>
    <button type="submit">保存</button>
</form>
<a href="/items">アイテム一覧に戻る</a>
</body>
</html>
```

6. 図書と機材（アイテム）のCRUD機能