はじめに

前回はUserServiceを実装しました！
今回はUserContollerを実装していきます！

Controller は Spring Boot アプリケーションにおける「リクエスト処理の窓口」ですね。

サービス層（UserService）やリポジトリ層（UserRepository）と連携しながら、
外部からの HTTP リクエストを処理していきます！

コード

package com.example.noteapp.backend.controller;

import com.example.noteapp.backend.entity.User;
import com.example.noteapp.backend.service.UserService;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/api/users")
public class UserController {

    private final UserService userService;

    public UserController(UserService userService) {
        this.userService = userService;
    }

    @GetMapping
    public ResponseEntity<List<User>> getAllUsers() {
        return ResponseEntity.ok(userService.findAll());
    }

    @GetMapping("/{id}")
    public ResponseEntity<User> getUserById(@PathVariable Long id) {
        return userService.findById(id)
                .map(ResponseEntity::ok)
                .orElse(ResponseEntity.notFound().build());
    }

    @PostMapping
    public ResponseEntity<User> createUser(@RequestBody User user) {
        return ResponseEntity.ok(userService.save(user));
    }

    @DeleteMapping("/{id}")
    public ResponseEntity<Void> deleteUser(@PathVariable Long id) {
        userService.deleteById(id);
        return ResponseEntity.noContent().build();
    }
}

アノテーションの説明

アノテーション	説明
`@RestController`	このクラスが REST API のコントローラーであることを示す。レスポンスは JSON。
`@RequestMapping`	クラスのベースとなるパスを指定する。ここでは `/api/users`。
`@GetMapping`	HTTP GET リクエストを処理する。
`@PostMapping`	HTTP POST リクエストを処理する。
`@DeleteMapping`	HTTP DELETE リクエストを処理する。
`@PathVariable`	URL のパスから変数部分を受け取る。例：`/users/1` → `id=1`。
`@RequestBody`	リクエストの JSON ボディをオブジェクト（Userなど）に変換する。

コンストラクタ

public UserController(UserService userService) {
    this.userService = userService;
}

UserService を依存注入（DI）しています。

コントローラーでビジネスロジックを書くのではなく、Service に任せる構成にしています。

各メソッドの解説

`getAllUsers()`

@GetMapping
public ResponseEntity<List<User>> getAllUsers() {
    return ResponseEntity.ok(userService.findAll());
}

全ユーザーを取得して、200 OK とともに返す

`getUserById(Long id)`

@GetMapping("/{id}")
public ResponseEntity<User> getUserById(@PathVariable Long id) {
    return userService.findById(id)
            .map(ResponseEntity::ok)
            .orElse(ResponseEntity.notFound().build());
}

指定された ID のユーザーを返す
ユーザーが存在しなければ 404 Not Found を返す

`createUser(User user)`

@PostMapping
public ResponseEntity<User> createUser(@RequestBody User user) {
    return ResponseEntity.ok(userService.save(user));
}

ユーザー情報を新規作成または更新
リクエストの JSON を User に変換して保存

`deleteUser(Long id)`

@DeleteMapping("/{id}")
public ResponseEntity<Void> deleteUser(@PathVariable Long id) {
    userService.deleteById(id);
    return ResponseEntity.noContent().build();
}

指定された ID のユーザーを削除
削除に成功したら 204 No Content を返す

各層の関係

層	役割
Controller	リクエストを受け取り、レスポンスを返す。Service に処理を委任。
Service	ビジネスロジックを実装。リポジトリ層を操作。
Repository	データベースアクセスを担当。