[MVC] 요청 매핑 (@RequestMapping, PathVariable)

 

 

 

 

🧐 @RequestMapping

요청된 url에 대해서 매핑하기 위하여 사용합니다.

 

예를 들어 다음과 같습니다.

@RequestMapping("/hello-basic")
public String helloBasic() {
    return "ok";
}

 

@RequestMapping을 처리하는 HandlerMapping과 HandlerAdapter는 다음과 같습니다.

• RequestMappingHandlerMapping
• RequestMappingHandlerAdapter

 

 

 

 

 

 

 

 

 

 

 

🧐 URL 경로에 대한 매핑

@RequestMapping("/hello")

• /hello 로 URL 호출이 오면 이 메서드가 실행되도록 매핑합니다.
• 대부분의 속성을 배열로 제공하므로 다음과 같이 다중 설정도 가능합니다.
  • {"/hello", "/hi"}

 

 

 

 

 

 

👉 트레일링 슬래시 

url 마지막에 붙는 슬래시를 트레일링 슬레시라고 합니다. (예를 들어 /hello/)

 

추가적인 설정을 하지 않는 이상, 기본적으로 다음 두 요청은 다르게 인식됩니다.

• /hello
• /hello/

 

스프링에서 위와 관련된 설정을 확인하려면 아래 링크를 참고해주세요

https://stackoverflow.com/questions/59914965/spring-mvc-requestmapping-requires-trailing-slash

 

 

 

 

 

 

 

 

 

 

 

 

 

🧐 HTTP 메서드 지정

@RequestMapping에 method 속성으로 HTTP 메서드를 지정하지 않으면 HTTP 메서드와 무관하게 호출됩니다.

GET, HEAD, POST, PUT, PATCH, DELETE .. 등등 모두 허용됩니다.

 

이들을 아래와 같이 축약하여 사용할 수 있습니다.

• @GetMapping
• @PostMapping
• @PutMapping
• @DeleteMapping
• @PatchMapping

 

예를 들면 다음과 같습니다.

@RequestMapping(value = "/mapping-get", method = RequestMethod.GET)
public String mappingGet() {
    log.info("mappingGet");
    return "ok";
}

위 코드는 축약하여 아래와 같이 사용할 수 있습니다.

 

 

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

 

 

 

 

 

 

 

 

 

🧐 파라미터 추가 매핑

@GetMapping(value = "/hello", params = "mode=debug")

파라미터 정보에 mode=debug 정보가 있어야 한다.

(mode=debug는 하나의 예시일 뿐입니다.)

 

다음과 같이 여러 표현들이 가능합니다.

• params="mode"  : mode 파라미터가 있어야 함
• params="!mode"  : mode 파라미터가 없어야 함 
• params="mode=debug"  : mode 파라미터의 값이 debug여야 함
• params="mode!=debug"  : mode 파라미터의 값이 debug가 아니어야 함
• params={"mode=debug", "data=good"} : mode 파라미터는 debug이고, data는 good이어야 함

 

 

 

 

 

 

 

 

 

 

 

 

 

🧐 헤더 추가 매핑

@GetMapping(value = "/mapping-header", headers = "mode=debug")

• headers="mode",
• headers="!mode"
• headers="mode=debug"
• headers="mode!=debug" 

 

 

 

 

 

 

 

 

 

 

🧐 미디어 타입 조건 매핑 

(Content-Type, consume)

@PostMapping(value = "/mapping-consume", consumes = "application/json")

Header의 Content-Type 값에 매핑됩니다.

 

• consumes="application/json"
• consumes="!application/json"
• consumes="application/*"
• consumes="*/*"
• MediaType.APPLICATION_JSON_VALUE

 

 

 

 

 

 

 

 

 

 

🧐 미디어 타입 조건 매핑 

(Accept, produce)

@PostMapping(value = "/mapping-produce", produces = "text/html")

Header의 Accept 값에 매핑됩니다.

 

• produces = "text/plain"
• produces = {"text/plain", "application/*"}
• produces = MediaType.TEXT_PLAIN_VALUE
• produces = "text/plain;charset=UTF-8"

 

 

 

 

 

 

 

 

 

 

 

 

🧐 PathVariable (경로 변수)

지정할 url에 다음과 같이 변수를 넣어서 지정할 수 있습니다.

@GetMapping("/mapping/{userId}")
public String mappingPath(@PathVariable("userId")String userId){
	log.info("mapping userId={}",userId);
}

요청을 /mapping/123 으로 한다면, userId의 값에는 123이 들어갑니다.

 

 

 

만약 @Pathvariable과 파라미터의 이름이 같으면 생략할 수 있습니다.

@GetMapping("/mapping/{userId}")
public String mappingPath(@PathVariable String userId){
	log.info("mapping userId={}",userId);
}

 

 

 

다음과 같이 다중으로 사용할 수 있습니다.

@GetMapping("/mapping/users/{userId}/orders/{orderId}")
public String mappingPath(
        @PathVariable("userId") String userId,
        @PathVariable("orderId") String orderId
) {
    log.info("mapping Path - userId = {}, orderId = {}", userId, orderId);
    return "ok";
}

 

 

 

 

 

🧐 @Controller

@Controller는 내부에 @Component를 들고 있기 때문에 컴포넌트 스캔의 대상이 됩니다.

추가적으로 스프링 MVC에서 애노테이션(@RequestMapping)기반 컨트롤러(핸들러)로 인식합니다.

 

 

 

 

 

 

 

 

 

Reference

스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술 - 인프런 | 강의