Spring [@RequestMapping 기초 정리 ]

 

스프링 입문 강의, 기초강의를 들었을 때 종종 보았던 RequestMapping에 대한 기초를 다시 다졌다!

아직 기초만 배운 거라 실무에서 어디에 사용할지 감밖에 오지 않지만 언젠간 능수능란하게 다루고 싶다😚

 

 

 

---

RequestMapping(요청 매핑) 이란?

요청이 왔을 때 어떤 컨트롤러가 호출이 되어야 하는지 알려주는 지표 같은 것이다.

 

👉 예시

@RequestMapping(value = "/hello-basic")

 이렇게 매핑을 하면 localhost:8080/hello-basic으로 url을 입력했을 경우에 이것에 해당하는 메서드가 실행된다.

 

 

@RequestMapping은 다중요청도 가능하다!

다중 요청을 하려면 배열로 묶어야 한다. 

@RequestMapping(value = {"/hello", "/hello-basic"})

이것처럼 다중 요청을 할 경우에는 둘 중 아무 url이나 입력해도 된다.

 

 

[ 경로변수(PathVariable) 사용 ]

 

최근 HTTP API는 리소스 경로에 식별자를 넣는 스타일을 선호한다.

쿼리 파마리터로 식별자를 넣는 방법도 있지만 경로 변수를 사용하는 것이 매핑되는 부분을 편리하게 조회할 수 있다.

 

👉 예시

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

 

localhost:8080/mapping/userA
라고 입력하면 userId가 data로 매칭돼서 편하게 사용할 수 있다. 

 

저렇게 data로 꺼내는 방식으로 말고 파라미터 이름이 같으면 생략 가능하다.

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

 

 

➕ 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";
    }

이렇게 다중으로 사용할 수도 있다!!!

 

 

 

[ 특정 헤더 조건 매핑 ]

 

@GetMapping(value = "/mapping-header", headers = "mode=debug")
    public String mappingHeader() {
        log.info("mappingHeader");
        return "ok";
    }

이렇게 작성했을 경우에는 localhost:8080/mapping-header으로 이동했을 때 오류 페이지가 뜬다!

이런 경우에는 localhost:8080/mapping-header?mode=debug로 이동해야 정상적인 페이지로 접근이 가능하다.

 

 

 

[ 미디어 타입 매핑 ]

 

HTTP 요청의 Content-Type 헤더를 기반으로 미디어 타입으로 매핑한다.

만약 맞지 않으면 HTTP 상태 코드를 반환한다.

 

👇 여기에 Content-Type에 관한 내용이 간략하게 요약되어있다!

HTTP 헤더 [협상/전송/쿠키]

 

comsumes는 소비하는 입장이다. 생산은 produce!

포스트맨으로 실습을 해보았기 때문에 Accept를 변경하면서 실습해보았다.

Accept에는 어떤 미디어 타입을 받아들일 수 있는지 입력하면 된다.

 

 

👉 consume 예시

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

이런 경우에는 Content-Type이 application/josn일 때만 사용할 수 있다.

 

 

💻 POSTMAN으로 실습해보자!

 

 

◾ Content-Type을 text로 해봤을 때

이렇게 HTTP 415 상태코드를 반환한다!

 

 

◾ 알맞은 json 형태로 설정했을 때

알맞게 반환됐음을 알 수 있다. 

 

 

👉 produce 예시

 

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

위처럼 produces는 text/html로 설정하게 되면, html만을 출력할 수 있다. 

 

이것도 포스트맨으로 확인해보자!

포스트맨의 header에 있는 Accept로 미디어 타입을 변경할 수 있다.

 

 

◾ Accept를 json (or 다른 타입)으로 설정했을 때

 

이렇게 HTTP 406 상태 코드를 반환한다!! application/json으로 하면 json형태만 출력할 수 있기 때문이다.

 

 

◾ text/html로 입력했을 때 ( */*로 해도 잘 작동됨)

 

 

잘 출력되는 것을 볼 수 있다. 

 

 

 

---

이 개념을 배우고 회원관리 api에 적용만 해보았는데, 확실히 코드도 짧아지고 같은 url을 사용하더라도 메서드 방식을 변환시켜서 좀 더 효율적으로 사용할 수 있는 것 같다. 

 

이 포스팅은 인프런 김영한님의 [스프링MVC 1편 - 백엔드 웹 개발 핵심 기술]을 듣고 작성된 복습 정리 포스팅입니다.