아래 에러를 해결하며 알아봤던 스프링 상식들을 정리한다.
Resolved [org.springframework.web.HttpMediaTypeNotSupportedException:
Content type 'multipart/form-data;boundary charset=UTF-8' not supported]
bind.MissingServletRequestParameterException: Required request parameter
아래 목록만 확인해도 분명 위 에러를 해결할 수 있을 것이다..
✅ Spring Controller required 속성
[ required=false 예제]
public String hello(@RequestParam("name") String name,
// required 조건이 없으면 기본값은 true, 필수 파라미터.
// 파라미터 pageNo가 존재하지 않으면 Exception 발생.
@RequestParam(value="pageNo", required=false) String pageNo){
// 파라미터 pageNo가 존재하지 않으면 String pageNo는 null.
@RequestParam은 HTTP 요청 파라미터를 컨트롤러 메소드의 파라미터로 전달받을 때 사용된다. JSP에서 request.getParameter(); 와 비슷하다고 볼 수 있다. 이 @RequestParam이 적용된 파라미터는 필수파라미터다. 그래서 @RequestParam 어노테이션에 명시한 HTTP 요청 파라미터가 존재하지 않을 경우, 스프링 MVC는 잘못된 요청을 의미하는 400 응답 코드를 웹 브라우저에 전송하는 것이다.
1) 필수가 아닌 파라미터인 경우 required 속성 값을 주어 false로 지정해주면 된다. required 속성 값을 따로 작성안할 경우 기본 값은 true로 지정되어 있다.
@RequestParam(value="query", required=false) String query
필수가 아닌 파라미터의 값이 존재하지 않을 경우는 null 값을 할당한다. 하지만 null을 할당할 수 없는 기본 데이터 타입일 경우에는 타입 변환 에러가 발생한다.
2) RequestParam 값이 Null 일 때, 예외 처리
기본 데이터 타입을 사용할 때는 요청 파라미터가 존재하지 않을 때 기본 값을 할당하는 경우가 많다. 이런 경우, defaultValue 속성을 이용해서 기본 값을 지정할 수 있다.
@RequestParam(value="page", defaultValue="1") int page
✅ controller , Restcontroller 확인
@Controller와 @RestController 차이
[ @Controller, @RestController ]
public class CustomerController {
private final CustomerService customerService;
public CustomerController(CustomerService customerService) {
this.customerService = customerService;
}
@GetMapping("/customers")
public String list(Model model) {
model.addAttribute("customers", customerService.getAllCustomers());
return "views/customers";
}
}
위 코드의 첫 줄에 @Controller 어노테이션을 달아준 결과와
@RestController 어노테이션을 달아준 결과의 차이는 각각 다음과 같다.
@controller
@controller는 주로 view를 반환하기 위해 사용되는데, 아래와 같은 흐름으로 Client의 요청에 맞는 View를 반환한다.
1. 클라이언트가 요청을 보내면 dispatche Servlet으로 요청을 받는다.
2. dispatcher servlet은 요청에 해당하는 Controller로 위임 처리를 하도록 Handler Mapping 에게 위임을 처리한다.
3. view Resolver는 Controller 가 반환한 논리 뷰 이름을 실제 물리뷰 경로로 변경하고 View 객체를 반환환한다.
@RestController
그렇다면 View가 아닌 Data를 반환해야하면 어떻게 해야할까?
그럴때 사용하는 것이 @RestController다. @RestController는 데이터 반환을 할 수 있다. 아래와 같은 흐름으로 Client의 요청에 맞는 Data를 반환한다.
1. 클라이언트가 요청을 보내면 dispatche Servlet으로 요청을 받는다.
2. dispatcher servlet은 요청에 해당하는 Controller로 위임 처리를 하도록 Handler Mapping 에게 위임을 처리한다.
3. HttpMessageConverter가 동작하여 요청에 맞는 데이터를 반환.
정리를 해보자면,
@Controller는 view Resolver가 동작하여 view를 반환한다.
첫번째 코드블럭에서는 @Controller를 사용하여 view를 반환했기때문에 정상적으로 view가 보여졌다.
그런데 @RestController는 HttpMessageConverter가 동작하여 데이터를 반환한다. 그래서 "views/customers"에 해당되는 view 경로로 반환이 되지않고 "views/customers" 로 반환이 되어 렌더링 결과에 차이가 생기게 된것이다.
만약 @Controller를 사용하여 Data를 반환하고 싶으면, @ResponseBody 어노테이션을 같이 사용하면 된다.
실제로 어노테이션 코드를 확인해보면 아래와 같이 @RestController = @Controller + @ResponseBody 로 구성된것을 확인할 수 있다.
✅ RequestBody 확인
@RequestParam, @RequestBody, @PathVariable 모두 form 태그에서 데이터를 전달할 때 컨트롤러에서 데이터를 인자에 할당하는 대표적인 방법이다.
Type 1: http://127.0.0.1?index=1&page=2
Type 2: http://127.0.0.1/index/1
Type 1의 경우 파라메터의 값과 이름을 함께 전달하는 방식으로 게시판 등에서 페이지 및 검색 정보를 함께 전달하는 방식을 사용할 때 많이 사용한다.
Type 2의 경우 Rest api에서 값을 호출할 때 주로 많이 사용한다.
@RequestParam
- 프론트엔드로부터 http://localhost:8080/list?id=1 의 형식으로 요청이 넘어오게 된다면 물음표 뒤의 아이디 값을 받는 어노테이션이다.
- 전달받은 데이터를 URI상에서 찾는다.
- Type 1의 URI를 처리할 때 사용한다.
- value 혹은 name으로 넘어오는 데이터의 이름을 설정할 수 있으며 required는 기본적으로 true 이기 때문에 만약 값을 넘기지 않은 채 get을 시도한다면 400에러가 발생하게 된다. defaultValue 설정을 이용하여 값이 넘어오지 않았을 때의 기본값을 설정해줄 수도 있다. (위에서 설명한)
- GET 방식으로 넘어온 URI의 queryString을 받기 적절하다.
- @RequestBody로 데이터를 받을 경우 메소드의 파라미터명이 상관 없지만 @RequestParam으로 데이터를 받을 때는 데이터를 저장하는 이름으로 메소드의 파라미터명을 설정해줘야 한다.
- 해당하는 데이터만 받아올 수 있다. (@RequestBody는 객체를 받아옴)
ex) http://localhost:8080/receive?name=jun&age=13
@PathVariable
- URI 경로의 일부를 파라미터로 사용할 때 이용한다.
@PathVariable에서는 프론트엔드로부터 http://localhost:8080/list/1 의 형식으로 주소에 값자체를 포함하여 요청이 넘어오는 방식이다. 어노테이션 옆의 () 안에 받은 데이터의 이름을 정해주면 받아온 데이터를 타입에 맞춰 사용할 수 있다.
- 템플릿 변수의 값을 추출하고 그 값을 메소드 변수에 할당한다.
- Type 2의 Rest api에서 값을 호출할 때 주로 사용한다.
@RequestBody
- http 요청의 body에 담긴 값을 자바 객체로 변환한다. (json형태의 바디로 들어오는 데이터를 파싱)
- 이 어노테이션을 사용할 시에는, DTO 같은 데이터를 담을 객체를 구현해주어야 한다.
- 비동기 처리 구현시 @ResponseBody와 함께 사용한다.
- 일반적인 GET/POST의 요청 파라미터라면 @RequestBody를 사용하지 않아도 된다.
- xml이나 json 기반의 메시지를 사용하는 요청의 경우 유용하다.
ex) http://localhost:8080/receive
|
@RequestParam |
query 처리 |
|
@PathVariable |
URI 변수 처리 |
|
@RequestBody |
JSON 처리 |
✅ Content-Type 확인
마지막으로 content-type 확인..!
참고: https://u0hun.tistory.com/21 , https://velog.io/@heehee/Spring-Controller-%EC%99%80-RestController
![[Spring Boot] Controller와 RestController, @RequestParam과 @RequestBody의 차이](/posts/spring-controller-vs-restcontroller-requestparam/images/image_1.jpg)