Controller 해부

학습 목표

⚠️ 컨트롤러 한 개의 모습

@Controller
@RequestMapping("/board")
public class BoardController {

    @Autowired
    private BoardService service;

    @GetMapping("/view/{id}")
    public String view(@PathVariable int id,
                       @RequestParam(defaultValue="false") boolean comment,
                       Model model,
                       HttpSession session) {
        model.addAttribute("board", service.findById(id));
        return "board/view";
    }
}

🛠️ Controller 의 3 가지 일

① 클래스 어노테이션 — @Controller

@Controller
public class BoardController { ... }

• @Controller = 「이 클래스는 Bean 이고 + 웹 요청을 처리한다」
• Spring 컨테이너가 자동 등록
• @Component 의 한 종류 (의미적 표시)
• @RestController 와의 차이는 Part 6 에서

② @RequestMapping — URL 매핑

@Controller
@RequestMapping("/board")        // 클래스 레벨 prefix
public class BoardController {

    @GetMapping("/list")          // GET /board/list
    public String list() { ... }

    @GetMapping("/view/{id}")     // GET /board/view/3
    public String view(@PathVariable int id) { ... }

    @PostMapping("/write")        // POST /board/write
    public String write(Board b) { ... }
}

👉 클래스 + 메서드 어노테이션이 합쳐져 최종 URL.

② HTTP 메서드별 어노테이션

👉 옛 코드는 @RequestMapping(method=GET) 형식. 새 코드는 짧은 @GetMapping 권장.

③ 파라미터 받기 — @RequestParam

@GetMapping("/search")
public String search(
    @RequestParam("q") String query,                    // 필수
    @RequestParam(defaultValue = "1") int page,         // 기본값
    @RequestParam(required = false) String category,    // 선택
    Model model
) {
    // URL: /search?q=spring&page=2&category=java
    // → query="spring", page=2, category="java"
}

• URL 의 ?key=value 부분(쿼리스트링)을 받음
• required=false 또는 defaultValue 로 선택 처리
• 변수명이 같으면 ("q") 생략 가능: @RequestParam String q

③ @PathVariable — URL 경로의 일부

@GetMapping("/board/view/{id}")
public String view(@PathVariable int id) {
    // URL: /board/view/3
    // → id = 3
}

@GetMapping("/board/{boardId}/comment/{commentId}")
public String comment(
    @PathVariable int boardId,
    @PathVariable int commentId
) {
    // URL: /board/3/comment/7
    // → boardId=3, commentId=7
}

👉 REST API 스타일에서 자주 사용. 「리소스를 URL 로 표현」.

③ 객체로 받기 — 자동 바인딩

public class Board {                  // VO
    private String title;
    private String content;
    // getter/setter
}

@PostMapping("/board/write")
public String write(Board board) {     // ⭐ 자동 바인딩
    service.insert(board);
    return "redirect:/board/list";
}

<!-- write.jsp -->
<form action="/board/write" method="post">
    <input name="title" />        <!-- ↔ board.title -->
    <textarea name="content"></textarea>
    <button>저장</button>
</form>

👉 form input 의 name 속성과 VO 필드명이 정확히 일치하면 Spring 이 자동 채워줌.

③ 파라미터 받는 4 가지 정리

④ 응답 데이터 — Model

@GetMapping("/board/view")
public String view(@RequestParam int id, Model model) {
    Board b = service.findById(id);

    model.addAttribute("board", b);          // ${board}
    model.addAttribute("comments",
                        commentService.list(id));   // ${comments}
    model.addAttribute("isOwner",
                        b.getWriterId() == 5);     // ${isOwner}

    return "board/view";
}

<!-- view.jsp -->
<h1>${board.title}</h1>
<c:if test="${isOwner}"><a>수정</a></c:if>
<c:forEach var="c" items="${comments}">
    <p>${c.content}</p>
</c:forEach>

⑤ 반환 타입 — String 의 의미

return "board/view";
// → ViewResolver 가 /WEB-INF/views/board/view.jsp 로 변환

return "redirect:/board/list";
// → 브라우저에 302 리다이렉트 응답
//   브라우저가 /board/list 로 다시 요청

return "forward:/board/list";
// → 서버 내부에서 다른 컨트롤러로 위임
//   브라우저는 변화 모름

👉 redirect: 와 forward: 가 가장 자주 보는 두 접두사.

⑤ Redirect 의 활용 — POST 후 GET 패턴

@PostMapping("/board/write")
public String write(Board b) {
    service.insert(b);
    return "redirect:/board/list";
    // ⭐ "redirect:" 의 이유?
    // 1) 새로고침 시 글이 두 번 등록되는 것 방지
    // 2) 브라우저 주소창의 URL 이 깔끔하게 바뀜
    // 3) "Post-Redirect-Get(PRG) 패턴"
}

⑥ 추가 매개변수 — 자주 보는 것들

public String list(
    Model model,                           // 데이터 운반
    HttpSession session,                   // 세션
    HttpServletRequest request,            // 원본 요청
    HttpServletResponse response,          // 원본 응답
    RedirectAttributes ra,                 // 리다이렉트 시 데이터
    @CookieValue String theme,             // 쿠키
    @RequestHeader("User-Agent") String ua // HTTP 헤더
) { ... }

👉 Spring 이 매개변수 타입을 보고 자동으로 채워줍니다. 순서·개수 자유.

⑦ 흐름 한 줄로 — view 메서드 사례

@GetMapping("/board/view/{id}")    // ① URL 매핑
public String view(
    @PathVariable int id,           // ② URL 의 {id} 자동 받기
    Model model                     // ② 데이터 그릇
) {
    Board b = service.findById(id); // ③ Service 호출
    model.addAttribute("board", b); // ③ 그릇에 담기
    return "board/view";            // ④ View 이름 반환
}

실수 모음 — 자주 만나는 문제

좋은 Controller 의 5 가지 특징

• 얇다 — 비즈니스 로직 없이 위임만
• 한 메서드 = 한 URL — 책임 명확
• 예외 처리는 별도로 — try-catch 남발 X (@ExceptionHandler 활용)
• Service 만 호출 — DAO 직접 호출 X
• 적절한 반환 타입 — JSP 면 String, JSON 이면 객체

실험 — 직접 깨뜨려보기

👉 의도적으로 깨뜨려보면 「어떤 오류 메시지 = 어떤 원인」 매핑이 머리에 박힙니다.

🔄 Before / After

이번 차시의 데이터 흐름

정리

다음: Service 계층 — 비즈니스 로직과 트랜잭션의 자리.