Ch06. 스프링 MVC(기본 기능) - 요청 매핑

기본 요청

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

• @RestController
  • @Controller는 반환 값이 String 이면 뷰 이름으로 인식된다. 그래서 뷰를 찾고 뷰가 랜더링 된다.
  • @RestController는 반환 값으로 뷰를 찾는 것이 아니라, HTTP 메시지 바디에 바로 입력한다. 따라서 실행 결과로 ok 메시지를 받을 수 있다. @ResponseBody와 관련이 있는데, 뒤에서 더 자세히 설명한다.
• @RequestMapping("/hello-basic")
  • /hello-basic URL 호출이 오면 이 메서드가 실행되도록 매핑한다.
  • 대부분의 속성을 배열[] 로 제공하므로 다중 설정이 가능하다. {"/hello-basic", "/hello-go"}
  • @RequestMapping에 method 속성으로 HTTP 메서드를 지정하지 않으면 HTTP 메서드와 무관하게 호출된다.
    • 모두 허용 GET, HEAD, POST, PUT, PATCH, DELETE

HTTP 메서드 매핑, 메서드 매핑 축약

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

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

• 만약 Mappinng 되지 않은 method의 Url를 입력하게 되면 HTTP 405 상태 코드를 반환한다.
• HTTP 메서드를 축약한 애노테이션을 사용하는 것이 더 직관적이다. 코드를 보면 내부에서 @RequestMapping 과 method를 지정해서 사용하는 것을 확인할 수 있다.

PathVariable(경로 변수) 사용

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

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

• @RequestMapping 은 URL 경로를 템플릿화 할 수 있는데, @PathVariable 을 사용하면 매칭 되는 부분을 편리하게 조회할 수 있다.
• @PathVariable 의 이름과 파라미터 이름이 같으면 생략할 수 있다.

특정 파라미터 조건 매핑

@GetMapping(value = "/mapping-param", params = "mode=debug") //특정 파라미터 정보까지 있어야 실행이 된다
public String mappingParam() {
    log.info("mappingParam");
    return "ok";
}

• 파라미터 매핑과 비슷하지만, HTTP 헤더를 사용한다. 

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

 //@PostMapping(value = "/mapping-produce", produces = "text/html")
@PostMapping(value = "/mapping-produce", produces = MediaType.TEXT_HTML_VALUE)
public String mappingProduces() {
    log.info("mappingProduces");
    return "ok";
}

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

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

//@PostMapping(value = "/mapping-consume", consumes = "application/json")
@PostMapping(value = "/mapping-consume", consumes = MediaType.APPLICATION_JSON_VALUE)
public String mappingConsumes() {
    log.info("mappingConsumes");
    return "ok";
}

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