Service 層を導入する

今回作ること

• UserService インターフェースと UserServiceImpl 実装クラスを作成する
• 登録ロジックを UserController から UserService に移動する
• コンストラクタインジェクションで UserService を UserController に注入する

---

これまで、ユーザ登録処理はすべて UserController の中に書いていた。 今回は「Service 層」を導入し、ビジネスロジックを Controller から分離する。

---

なぜ Service 層が必要なのか

UserController は「HTTP リクエストを受け取り、レスポンスを返す」役割に集中すべきである。 現状のようにビジネスロジック（データの処理や保存）を Controller に書き続けると、次のような問題が起きる。

• Controller が肥大化し、どこで何をしているか分かりにくくなる
• ロジックを再利用しにくい（同じ処理を別の Controller から呼べない）
• テストが書きにくくなる

Spring では、ビジネスロジックを Service クラスに書くのが一般的な設計である。 @Service を付けたクラスは、Spring が自動的に管理し、インジェクション（注入）して使える。

---

1. service パッケージを作成する

src/main/java/com/example/ecsample/ 配下に service パッケージを作成する。

ecsample/
└─ src/main/java/com/example/ecsample/
    ├─ controller/
    ├─ form/
    ├─ entity/
    └─ service/          ← 新規作成

---

2. UserService インターフェースを作成する

service/UserService.java を新規作成する。

package com.example.ecsample.service;

import com.example.ecsample.form.UserForm;

public interface UserService {

    /**
     * ユーザを登録する。
     * @param form 登録フォームの入力値
     */
    void register(UserForm form);
}

ポイント インターフェースを定義することで、後で実装を差し替えやすくなる。 現段階では「何ができるか」を宣言するだけで、具体的な処理は UserServiceImpl に書く。

---

3. UserServiceImpl 実装クラスを作成する

service/UserServiceImpl.java を新規作成する。

package com.example.ecsample.service;

import com.example.ecsample.form.UserForm;
import org.springframework.stereotype.Service;

@Service
public class UserServiceImpl implements UserService {

    @Override
    public void register(UserForm form) {
        // 現段階ではコンソールに出力するだけ
        System.out.println("ユーザ登録：" + form.getName() + " <" + form.getEmail() + ">");
    }
}

ポイント

• @Service を付けることで、Spring がこのクラスを管理するコンポーネントとして認識する。
• implements UserService により、UserService インターフェースの実装であることを宣言する。
• 今はコンソール出力だけだが、後の章でDB保存に置き換える。

---

4. UserController を修正してインジェクションする

UserController を修正し、UserService をコンストラクタインジェクションで受け取る。

📄src/main/java/com/example/ecsample/controller/UserController.java+ 追加- 削除

 1package com.example.ecsample.controller;
 2
+3import com.example.ecsample.service.UserService;
 4import com.example.ecsample.form.UserForm;
 5import org.springframework.stereotype.Controller;
 6import org.springframework.ui.Model;
 7import org.springframework.validation.BindingResult;
 8import org.springframework.validation.annotation.Validated;
 9import org.springframework.web.bind.annotation.GetMapping;
 10import org.springframework.web.bind.annotation.ModelAttribute;
 11import org.springframework.web.bind.annotation.PostMapping;
 12
 13@Controller
 14public class UserController {
 15
+16   private final UserService userService;
+17
+18   public UserController(UserService userService) {
+19       this.userService = userService;
+20   }
+21
 22   @GetMapping("/register")
 23   public String showForm(Model model) {
 24       model.addAttribute("form", new UserForm());
 25       return "user/register";
 26   }
 27
 28   @PostMapping("/register")
 29   public String submitForm(
 30           @Validated @ModelAttribute("form") UserForm form,
 31           BindingResult bindingResult,
 32           Model model) {
 33
 34       if (bindingResult.hasErrors()) {
 35           return "user/register";
 36       }
 37
-        System.out.println("name = " + form.getName());
-        System.out.println("email = " + form.getEmail());
-        System.out.println("password = " + form.getPassword());
+38        // ビジネスロジックを Service に委譲する
+39        userService.register(form);
 40
 41       model.addAttribute("form", form);
 42       return "user/result";
 43   }
 44}

コンストラクタインジェクションとは コンストラクタの引数に型を書くだけで、Spring が自動的に対応する実装クラスを探して注入してくれる。 @Autowired アノテーションは Spring Boot 3 では省略できる。

---

5. 動作確認

1. アプリを再起動する。
2. http://localhost:8080/register にアクセスする。
3. フォームに値を入力して送信する。
4. コンソールに ユーザ登録：山田太郎 <taro@example.com> のように出力されれば成功。
5. 画面の動作は変わっていないことを確認する（リファクタリングのため）。

---

ファイル構成の確認

ecsample/
└─ src/main/java/com/example/ecsample/
    ├─ controller/
    │   ├─ HomeController.java
    │   ├─ ProductController.java
    │   └─ UserController.java        ← 修正済み
    ├─ entity/
    │   └─ Product.java
    ├─ form/
    │   └─ UserForm.java
    └─ service/
        ├─ UserService.java            ← 新規作成
        └─ UserServiceImpl.java        ← 新規作成

---

Gitコミット

git add .
git commit -m "feat: UserService層を導入し、登録ロジックをControllerから分離"

---

次の章では、商品データをデータベース（PostgreSQL）から取得するように変更する。