[spring] 스프링 MVC - 요청을 매핑하는 다양한 방법

💡 요청 매핑이란?

• url 요청이 왔을 때 어떤 컨트롤러가 호출되어야 하는지 정해놓는 것을 말한다.

 

✔︎ 사용법

• @RequestMapping을 통해 명시된 url 경로로 요청이 들어올 경우 해당 메서드가 호출된다.
• 단일, 다중 매핑이 가능하다.
  • ex ) @RequestMapping("hello-basic")
  • @RequestMapping({"hello-basic", "hello-go")}

@RestController
public class MappingController {

    private Logger log = LoggerFactory.getLogger(getClass());

    @RequestMapping(value = "/hello-basic", method = RequestMethod.GET)
    public String helloBasic() {
        log.info("helloBasic");
        return "ok";
    }
}

  

 

 

💡 HTTP 메서드 

 

 1️⃣ 위와 같이 @RequestMapping 에 method 속성으로 HTTP 메서드를 지정할 수 있다.

• 만약 HTTP 메서드를 지정해주지 않는다면 HTTP 메서드와 무관하게 호출될 수 있고 
• HTTP 메서드를 지정해주면, 해당 HTTP 메서드로만 호출이 가능하다.
  • 지정하지 않은 HTTP 메서드를 통해 요청이 들어오면 405를 반환한다.

 

 

 2️⃣ HTTP 메서드를 축약한 애노테이션을 사용할 수 있다. 

• 이 경우 좀 더 직관적으로 어떤 메서드를 사용했는지 파악할 수 있다.
• 종류 
  • @GetMapping, @PostMapping, @PutMapping, @PatchMapping, @DeleteMapping

/**
     * 편리한 축약 애노테이션
     * @GetMapping
     * @PostMapping
     * @PutMapping
     * @DeleteMapping
     * @PatchMapping
     */

    @GetMapping(value = "/mapping-get-v2")
    public String mappingGetV2() {
        log.info("mapping-get-v2");
        return "ok";
    }

 

 

💡PathVariable (경로변수 사용)

/**
     * PathVariable(경로변수) 사용
     * 변수명이 같으면 생략 가능
     * @PathVariable("userId") String userId -> @PathVariable userId
     * /mapping/userA
     *
     */
    @GetMapping("/mapping/{userId}")
    public String mappingPath(@PathVariable("userId") String userId) {
        log.info("mappingPath userId={}", userId);
        return "ok";
    }

• @PathVariable을 사용하면 url에 매칭되는 부분을 편리하게 조회할 수 있다.
• 만약 @PathVariable 의 이름과 파라미터의 이름이 같다면 생략할 수 있다. 
• @PathVariable는 다중으로도 사용이 가능하다.

**
     * PathVariable 사용 다중
     */
    @GetMapping("/mapping/users/{userId}/orders/{orderId}")
    public String mappingPath(@PathVariable String userId, @PathVariable Long
            orderId) {
        log.info("mappingPath userId={}, orderId={}", userId, orderId);
        return "ok";
    }

 

 

 

💡 특정 파라미터 조건 매핑

• 잘 사용하지는 않는다.

    /**
     * 파라미터로 추가 매핑
     * params="mode",
     * params="!mode"
     * params="mode=debug"
     * params="mode!=debug" (! = )
     * params = {"mode=debug","data=good"}
     */
    @GetMapping(value = "/mapping-param", params = "mode=debug")
    public String mappingParam() {
        log.info("mappingParam");
        return "ok";
    }

 

 

💡 특정 헤더 조건 매핑

    /**
     *특정 헤더로 추가 매핑
     * headers="mode",
     * headers="!mode"
     * headers="mode=debug"
     * headers="mode!=debug" (! = )
     */
    @GetMapping(value = "/mapping-header", headers = "mode=debug")
    public String mappingHeader() {
        log.info("mappingHeader");
        return "ok";
    }

• HTTP 헤더를 사용한다.

 

 

 

💡 미디어 타입 조건 매핑 - HTTP 요청 Content-Type, consume

    /**
     * Content-Type 헤더 기반 추가 매핑 Media Type
     * consumes="application/json"
     * consumes="!application/json"
     * consumes="application/*"
     * consumes="*\/*"
     * MediaType.APPLICATION_JSON_VALUE
     */
    @PostMapping(value = "/mapping-consume", consumes = "application/json")
    public String mappingConsumes() {
        log.info("mappingConsumes");
        return "ok";
    }

• HTTP 요청의 Content-Type 헤더를 기반으로 미디어 타입으로 매핑한다.
• 맞지 않는다면 HTTP 415 상태코드를 반환한다.

 

 

💡 미디어 타입 조건 매핑 - HTTP 요청 Accept, produce

/**
     * Accept 헤더 기반 Media Type * produces = "text/html"
     * produces = "!text/html"
     * produces = "text/*"
     * produces = "*\/*"
     */
    @PostMapping(value = "/mapping-produce", produces = "text/html")
    public String mappingProduces() {
        log.info("mappingProduces");
        return "ok";
    }
}

• HTTP 요청 Accept 헤더를 기반으로 미디어 타입으로 매핑한다.
• 맞지 않는다면 HTTP 406 상태코드를 반환한다.

 

 

 

<김영한 - '스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술'를  참고하였습니다.>