Spring 스프링 MVC 컨트롤러 Controller 의 역할

Controller 란?

스프링 MVC에서 컨트롤러(Controller)는 웹 애플리케이션의 핵심 요소 중 하나로, 클라이언트로부터의 HTTP 요청을 처리하고 응답을 관리하는 구성 요소입니다. MVC(Model-View-Controller) 아키텍처의 일부로서, 컨트롤러는 사용자 인터페이스와 비즈니스 로직을 연결하는 중간자 역할을 수행합니다.

스프링 MVC 패턴에서 컨트롤러는 사용자의 요청을 받아 처리한 후 적절한 응답을 반환합니다. 스프링에서는 @Controller와 @RestController 어노테이션을 통해 이러한 컨트롤러를 정의합니다. @Controller는 전통적인 웹 페이지 기반의 컨트롤러를 정의하는 반면, @RestController는 RESTful 웹 서비스를 위한 JSON이나 XML 형태의 데이터를 반환하는 컨트롤러를 만듭니다.

Controller 의 역할

스프링 MVC 프레임워크에서 컨트롤러(Controller)는 HTTP 요청을 받고, 요청에 대한 처리 로직을 실행한 후 결과를 뷰에 전달합니다. 이 과정에서 컨트롤러는 요청 데이터를 파싱하고, 필요한 서비스나 컴포넌트를 호출하며, 데이터 모델을 조작할 수 있습니다. 적절한 뷰를 선택하고 뷰에 모델 데이터를 전달하는 것도 컨트롤러의 책임입니다.

1. HTTP 요청 수신: 컨트롤러는 클라이언트로부터 오는 HTTP 요청을 받습니다. 각 요청은 URL, HTTP 메서드(예: GET, POST), 그리고 필요에 따라 요청 매개변수 또는 본문을 포함합니다.
2. 요청 매핑: 스프링의 @RequestMapping 어노테이션 또는 그와 유사한 어노테이션(@GetMapping, @PostMapping 등)을 사용하여 특정 HTTP 요청을 컨트롤러의 특정 메서드에 매핑합니다. 이렇게 함으로써 어떤 URL과 HTTP 메서드가 어떤 메서드에 의해 처리되는지 정의합니다.
3. 요청 파라미터 처리: 컨트롤러는 HTTP 요청의 파라미터를 추출하고, 이들을 메서드의 매개변수로 바인딩합니다. @RequestParam, @PathVariable, @RequestBody 등의 어노테이션을 사용하여 요청 데이터를 메서드의 매개변수에 매핑할 수 있습니다.
4. 비즈니스 로직 실행: 요청을 처리한 후, 컨트롤러는 필요한 비즈니스 로직을 실행하기 위해 서비스 레이어나 비즈니스 로직을 호출합니다. 이는 데이터를 처리하고, 데이터베이스와 상호 작용하며, 필요한 계산이나 처리를 수행하는 데 사용됩니다.
5. 모델 데이터 설정: 컨트롤러는 뷰에 전달할 데이터를 모델 객체에 설정합니다. 스프링은 컨트롤러에서 반환된 모델 객체를 뷰에 전달하여 사용자에게 최종 결과를 표시할 수 있게 합니다.
6. 뷰 선택 및 응답 반환: 컨트롤러는 처리 결과를 표시할 뷰를 결정합니다. 이는 JSP, HTML, PDF, JSON 등 다양한 형태의 응답을 생성할 수 있습니다. RESTful API를 구축하는 경우, 컨트롤러는 보통 JSON이나 XML 형식의 데이터를 직접 HTTP 응답으로 반환합니다.
7. 예외 처리: 컨트롤러 내에서 발생하는 예외는 @ExceptionHandler 어노테이션을 사용한 메서드로 처리할 수 있습니다. 이를 통해 예외 상황을 적절히 관리하고 사용자에게 의미 있는 응답을 제공할 수 있습니다.

Controller 주요 어노테이션

Controller 작성 예시

스프링 MVC에서 컨트롤러를 작성하는 방법에 대해 설명하겠습니다. 스프링 MVC는 Model-View-Controller 아키텍처를 기반으로 하는 웹 프레임워크입니다. 여기서 컨트롤러는 웹 요청을 받아 처리하고, 결과를 뷰에 전달하는 역할을 합니다.

스프링 MVC 컨트롤러 생성

클래스에 @Controller 어노테이션 추가: 클래스를 스프링의 컨트롤러로 정의합니다.

@Controller
public class MyController {
    // 메소드 정의
}

핸들러 메소드 정의: 각 웹 요청을 처리할 메소드를 정의합니다. 이 메소드들은 일반적으로 @RequestMapping 또는 그와 유사한 어노테이션(@GetMapping, @PostMapping 등)을 사용하여 특정 HTTP 요청에 매핑됩니다.

@GetMapping("/hello")
public String sayHello(Model model) {
    model.addAttribute("message", "Hello from Spring MVC");
    return "hello"; // 뷰 이름 반환
}

요청 매핑

• URI와 메소드 연결: @RequestMapping을 사용하여 URI와 메소드를 연결합니다. @GetMapping, @PostMapping 등은 @RequestMapping의 특화된 형태입니다.
• 경로 변수 사용: @PathVariable을 사용하여 URL의 일부를 메소드 파라미터로 추출할 수 있습니다.
• 요청 파라미터 접근: @RequestParam으로 요청 파라미터에 접근할 수 있습니다.

데이터 전달 및 뷰 렌더링

• 모델을 통한 데이터 전달: 메소드의 파라미터로 Model을 사용하여 뷰에 데이터를 전달합니다.
• 뷰 선택: 메소드가 반환하는 문자열은 보통 뷰의 이름을 나타냅니다. 스프링은 이 이름을 사용해 뷰를 찾고 렌더링합니다.

폼 데이터 처리

• 폼 제출 처리: @PostMapping을 사용하여 폼 제출을 처리할 수 있습니다.
• 데이터 바인딩: @ModelAttribute를 사용하여 요청 파라미터를 객체에 바인딩할 수 있습니다.

예외 처리

• 예외 핸들링: @ExceptionHandler를 사용하여 컨트롤러 내의 특정 예외를 처리할 수 있습니다.

예시 코드

@Controller
public class MyController {

    @GetMapping("/greeting")
    public String greeting(@RequestParam(name="name", required=false, defaultValue="World") String name, Model model) {
        model.addAttribute("name", name);
        return "greeting"; // 뷰 이름
    }

    @PostMapping("/submitForm")
    public String submitForm(@ModelAttribute UserForm userForm, Model model) {
        // 폼 데이터 처리
        model.addAttribute("user", userForm);
        return "formResult";
    }

    @ExceptionHandler(Exception.class)
    public String handleException() {
        // 예외 처리 로직
        return "error";
    }
}

이렇게 스프링 MVC에서 컨트롤러를 작성하면, HTTP 요청을 효과적으로 처리하고 응답을 구성할 수 있습니다. 실제 사용 시에는 프로젝트의 요구 사항과 구조에 따라 약간의 변형이 필요할 수 있습니다.

결론

스프링 MVC에서 컨트롤러(Controller)는 웹 애플리케이션의 중추적인 구성 요소로서, 클라이언트로부터의 HTTP 요청을 받아 해당 요청에 맞는 비즈니스 로직을 수행하고, 그 결과를 뷰에 전달하는 역할을 수행합니다. 이 과정에서 컨트롤러는 요청 매핑, 요청 파라미터 처리, 모델 데이터 설정, 뷰 선택 및 응답 반환, 그리고 예외 처리와 같은 다양한 작업을 합니다.

스프링 프레임워크는 @Controller와 @RestController 어노테이션을 통해 다양한 유형의 컨트롤러를 지원합니다. @Controller는 주로 뷰를 반환하는 웹 페이지 기반 컨트롤러를 정의하는 데 사용되고, @RestController는 RESTful API를 구축하는 데 적합하며 주로 JSON이나 XML 같은 데이터 형식을 HTTP 응답으로 직접 반환합니다.

컨트롤러의 핵심 작업은 다음과 같습니다.

1. HTTP 요청 수신 및 매핑: URL과 HTTP 메소드에 기반한 요청을 적절한 메소드에 매핑합니다.
2. 요청 파라미터 처리: @RequestParam, @PathVariable, @RequestBody 등을 사용하여 요청 데이터를 처리합니다.
3. 비즈니스 로직 실행: 필요한 서비스나 컴포넌트를 호출하여 비즈니스 로직을 수행합니다.
4. 모델 데이터 설정 및 뷰 반환: 처리 결과를 모델 객체에 설정하고, 적절한 뷰를 선택하여 응답을 반환합니다.
5. 예외 처리: @ExceptionHandler를 사용하여 예외 상황을 적절히 관리합니다.

스프링 MVC의 컨트롤러를 효과적으로 사용하면, 웹 애플리케이션의 요청 처리와 응답 구성을 유연하고 효율적으로 관리할 수 있습니다.