Spring Boot で @RestController を使って REST API をどう構築するのか?

Question

IT Interview Practice · Accepted Answer

Spring Boot の REST エンドポイントは、`@RestController` 上のメソッドで、HTTP 動詞とパスにマッピングされます。`@RestController` = `@Controller` + `@ResponseBody` なので、戻り値はビューに解決される代わりに、レスポンス本文へ直接シリアライズされます (Jackson による JSON)。 ## CRUD コントローラ ```java @RestController @RequestMapping("/api/users") // base path for every method below public class UserController { private final UserService service; public UserController(UserService service) { this.service = service; } @GetMapping("/{id}") // GET /api/users/42 public UserDto get(@PathVariable Long id) { // bind {id} from the URL return service.findById(id); // returned object -> JSON } @PostMapping // POST /api/users @ResponseStatus(HttpStatus.CREATED) // 201 instead of 200 public UserDto create(@Valid @RequestBody UserDto body) { // JSON -> object return service.create(body); } @GetMapping // GET /api/users?role=admin public List list(@RequestParam(required = false) String role) { return service.findByRole(role); } } ``` 主要なアノテーション: `@PathVariable` はパスから値を取り出し、`@RequestParam` はクエリ文字列パラメータを読み、`@RequestBody` は JSON ペイロードをデシリアライズします。`@Valid` を追加すると、メソッドが実行される前に受信 DTO に対して Bean Validation (`@NotNull`、`@Email` など) がトリガーされます。 ## 適切なステータスと本文を返す ```java @GetMapping("/{id}") public ResponseEntity get(@PathVariable Long id) { return service.find(id) .map(ResponseEntity::ok) // 200 + body .orElse(ResponseEntity.notFound().build()); // 404, no body } ``` ## なぜ重要なのかこれは日常的なバックエンドの仕事なので、面接官は流暢さを期待します。強い答えは、JPA エンティティを公開する代わりに **DTO** を使うこと、`@Valid` で入力を検証すること、`ResponseEntity` で正しいステータスコードを返すことに言及します — おもちゃのエンドポイントと本物の API の違いです。

CRUD コントローラ

適切なステータスと本文を返す

なぜ重要なのか

関連する質問