Spring Boot에서 @RestController로 REST API를 어떻게 만드나요?

Question

IT Interview Practice · Accepted Answer

Spring Boot에서 REST endpoint는 `@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); } } ``` 핵심 annotation: `@PathVariable`은 경로에서 값을 꺼내고, `@RequestParam`은 query-string 파라미터를 읽으며, `@RequestBody`는 JSON payload를 역직렬화합니다. `@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`로 올바른 상태 코드를 반환하는 것을 언급합니다 — 장난감 endpoint와 진짜 API의 차이입니다.

CRUD 컨트롤러

적절한 상태와 본문 반환

왜 중요한가

관련 질문