💻 코딩 일기 : [Spring] '@Controller, @RequestMapping' 편

ybk·2024년 4월 7일

spring

목록 보기

4/55

🔔 '@Controller, @RequestMapping'에 대해서 알아보자!

💟 @Controller

@Controller: Spring MVC에서 컨트롤러 클래스를 나타냅니다. 컨트롤러 클래스는 클라이언트로부터의 요청을 처리하고, 해당 요청에 대해 적절한 응답을 생성하는 역할을 합니다. 즉, 웹 애플리케이션의 비즈니스 로직을 처리하고 해당 요청을 적절한 서비스나 DAO(Data Access Object)로 전달하여 데이터를 처리하고, 그 결과를 사용자에게 보여주는 역할을 수행합니다.

예를 들어, 사용자가 웹 애플리케이션의 특정 URL에 접근하면, 해당 URL을 처리하는 메서드가 있는 컨트롤러 클래스가 실행되고, 그에 맞는 응답을 생성하여 사용자에게 반환됩니다.

@Controller
public class Controller01 {
    // 컨트롤러 메서드들
}

💟 @RequestMapping

@RequestMapping: 이 어노테이션은 클라이언트의 요청 URL과 컨트롤러 메서드를 매핑하는 데 사용됩니다. 즉, 어떤 요청 URL이 들어오면 그에 해당하는 특정한 메서드를 실행하도록 지정합니다.

package com.study.controller;

import jakarta.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.context.request.WebRequest;

import java.io.IOException;
import java.io.PrintWriter;


@Controller
public class Controller01 {

    @RequestMapping("/main1")
    public void method1(WebRequest request, HttpServletResponse response) throws IOException {
        //1.요청 분석/가공
        String name = request.getParameter("name");

        //2. 비즈니스 로직 실행
        String data = name + "님 반갑습니다.";

        String result = STR."""
                <html>
                    <body>
                        <h1>\{data}</h1>
                    </body>
                </html>
                """;

        //3. 결과 응답
        response.setContentType("text/html;charset=utf-8");
        PrintWriter writer = response.getWriter();
        writer.print(result);
    }

    // 요청 메세지 첫 줄이 다음과 같으면 실행
    // GET /main1/sub1 HTTP/1.1
    @RequestMapping(value = "/main1/sub1")
    public void method2() {
        System.out.println("Controller01.method2");
    }


    // GET/main1/sub2 HTTP/1.1
    @RequestMapping(value = "/main1/sub2")
    public void method3() {
        System.out.println("Controller01.method3");
    }


}

WebRequest request: 클라이언트의 HTTP 요청을 추상화한 객체로, 요청에 관련된 정보를 제공한다.
HttpServletResponse response: 서버의 HTTP 응답을 추상화한 객체로, 응답을 생성하고 클라이언트에게 전달한다.

위의 예시에서 /main1 URL로 요청이 들어오면 method1() 메서드가 실행되고, 해당 메서드에서는 요청에서 받은 이름을 사용하여 환영 메시지를 생성합니다. 그리고 이 메시지를 HTML 형식으로 포맷하여 클라이언트에게 반환합니다.

또한, /main1/sub1 또는 /main1/sub2 URL로 요청이 들어오면 각각 method2()와 method3() 메서드가 실행되며, 각 메서드는 간단한 로그를 출력합니다.

이렇게 Spring MVC는 요청 URL에 따라 적절한 컨트롤러 메서드를 실행하고, 그 결과를 클라이언트에게 반환합니다.

Spring MVC에서는 @RequestMapping 어노테이션을 좀 더 세분화하여 HTTP 메서드별로 구분하는 것이 가능하며, 다양한 속성을 이용하여 요청을 라우팅할 수 있습니다.

package com.study.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;

@Controller
@RequestMapping("main5")
public class Controller5 {

    @RequestMapping("sub1")
    // /main5/sub1?city=seoul
    public void method1(@RequestParam("city") String param) {
        System.out.println(param + " 검색 로직 실행");
    }

    // /main5/sub2?address=seoul
    // /main5/sub2?address=gangnam
    // /main5/sub2?address=hongdae
    @RequestMapping("sub2")
    public void method2(@RequestParam("address") String param) {
        System.out.println(param + "(으)로 가는 경로 탐색");
    }

    // /main5/sub3?age=13
    // /main5/sub3?age=20
    // /main5/sub3?age=40
    @RequestMapping("sub3")
    public void method3(@RequestParam("age") Integer param) {
        if (param < 18) {
            System.out.println("청소년 관련 정보 출력");
        } else if (param < 35) {
            System.out.println("청년 관련 정보 출력");
        } else if (param < 65) {
            System.out.println("중장년 관련 정보 출력");
        } else {
            System.out.println("노인 관련 정보 출력");
        }
    }

    // /main5/sub4?height=145.1
    @RequestMapping("sub4")
    public void method4(@RequestParam("height") double param) {
        if (param < 145.0) {
            System.out.println("작은 키");
        } else if (param < 190.0) {
            System.out.println("중간 키");
        } else {
            System.out.println("큰 키");
        }
    }
}

@RequestParam: 이 어노테이션은 HTTP 요청 파라미터를 메서드의 파라미터로 바인딩하는 데 사용됩니다. 클라이언트가 전달한 파라미터의 값을 가져와 메서드의 파라미터에 할당합니다. 기본적으로 요청 파라미터와 메서드의 파라미터 이름이 동일해야 하지만, @RequestParam을 사용하여 요청 파라미터 이름과 메서드의 파라미터 이름을 명시적으로 매핑할 수 있습니다.

위의 코드에서 각 메서드는 다양한 요청 파라미터를 받아와서 처리합니다. @RequestParam 어노테이션을 사용하여 각 요청 파라미터의 값을 메서드의 파라미터에 바인딩하고 있습니다. 예를 들어, /main5/sub1?city=seoul 요청은 city라는 파라미터를 받아와서 method1 메서드의 param 파라미터에 할당됩니다.

이렇게 함으로써 Spring MVC는 클라이언트의 요청을 받아 파라미터 값을 추출하고, 해당 값을 사용하여 비즈니스 로직을 수행하는 등의 작업을 수행할 수 있습니다.

ybk

개발자 준비생~

이전 포스트

💻 코딩 일기 : [Spirng] 'AOP' 편

다음 포스트