[ 스프링 웹 MVC ] - 스프링 MVC - 기본 기능
로깅
@Slf4j
-
롬복을 활용해서 로그를 사용할 수 있게 해줌
-
로그 라이브러리는 Logback, Log4J, Log4J2 등등 수 많은 라이브러리가 있는데, 그것을 통합해서 인터페이스로 제공하는 것이 바로 SLF4J 라이브러리다.
로그 종류
log.trace("trace log={}", name);
log.debug("debug log={}", name);
log.info(" info log={}", name);
log.warn(" warn log={}", name);
log.error("error log={}", name);
로그 레벨
- LEVEL: TRACE > DEBUG > INFO > WARN > ERROR
- 개발 서버는 debug 출력
- 운영 서버는 info 출력
#전체 로그 레벨 설정(기본 info)
logging.level.root=info
#hello.springmvc 패키지와 그 하위 로그 레벨 설정
logging.level.hello.springmvc=debug
로그의 장점
-
쓰레드, 클래스 정보등을 같이 볼 수 있다.
-
파일이나 네트워크 등, 로그를 별도의 위치에 남길 수 있다.
-
성능이 더 좋아서 실무에서는 전부 로그를 사용
@RestController
@Controller은 반환값이 String이면 해당하는 뷰를 찾아서 반환
@RestController은 메세지 바디에 직접 입력요청 매핑
@RequestMapping("/hello-basic")
-
/hello-basic URL 호출이 오면 이 메서드가 실행되도록 매핑한다
-
{"/hello-basic", "/hello-go"} - 동시 매핑이 가능하다
@GetMapping(value = "/mapping-get-v2")
-
메서드를 결합해서 매핑 가능
@PathVariable
@GetMapping("/mapping/{userId}")
public String mappingPath(@PathVariable("userId") String data) {
log.info("mappingPath userId={}", data);
return "ok";
}
- PathVariable를 통해 매칭되는 부분을 받아 올 수 있다.
- @PathVariable 의 이름과 파라미터 이름이 같으면 생략할 수 있다.
HTTP 요청
요청 파라미터
request.getParameter()
- HttpServletRequest가 제공하는 방식
@RequestParam
- Spring이 제공하는 방식
- 파라미터 이름으로 바인딩
- HTTP 파라미터 이름이 변수 이름과 같으면 @RequestParam(name="xx") 생략 가능
- String , int , Integer 등의 단순 타입이면 @RequestParam 도 생략 가능
public String requestParamV3(
@RequestParam String username,
@RequestParam int age) {
log.info("username={}, age={}", username, age);
return "ok";
}
- @RequestParam(required = false) - 필수값 해제
- 파라미터에 값이 없는 경우 defaultValue 를 사용하면 기본 값을 적용할 수 있다.
- @RequestParam(required = false, defaultValue = "-1")
- 파라미터를 Map, MultiValueMap으로 조회할 수 있다.
@RequestMapping("/request-param-map")
public String requestParamMap(@RequestParam Map<String, Object> paramMap) {
log.info("username={}, age={}", paramMap.get("username"),
paramMap.get("age"));
return "ok";
}
@ModelAttribute
- 개발을 하면 요청 파라미터를 받아 필요한 객체를 만들고 그 객체에 값을 넣어줘야 한다. @ModelAttribute를 사용하면 그 과정을 간편하게 해준다.
@ResponseBody
@RequestMapping("/model-attribute-v1")
public String modelAttributeV1(@ModelAttribute HelloData helloData) {
log.info("username={}, age={}", helloData.getUsername(),
helloData.getAge());
return "ok";
}
- HelloData 객체를 생성
- 요청 파라미터의 이름으로 HelloData 객체의 프로퍼티를 찾는다. 그리고 해당 프로퍼티의 setter를 호출해서 파라미터의 값을 입력(바인딩) 한다.
- ex) 파라미터 이름이 username이면 setUsername() 호출
- @ModelAttribute도 생략이 가능하나 혼란스러울 수 있어 권장하지 않는다.
요청 메세지
단순 텍스트
- 메세지 바디를 통해 데이터가 넘어오는 경우
- HTTP API에서 주로 사용, JSON, XML, TEXT
- InputStream 을 사용해서 직접 읽을 수 있다.
- InputStream(Reader): HTTP 요청 메시지 바디의 내용을 직접 조회
- OutputStream(Writer): HTTP 응답 메시지의 바디에 직접 결과 출력
HttpEntity
@PostMapping("/request-body-string-v3")
public HttpEntity<String> requestBodyStringV3(HttpEntity<String> httpEntity) {
String messageBody = httpEntity.getBody();
log.info("messageBody={}", messageBody);
return new HttpEntity<>("ok");
}
- HttpEntity: HTTP header, body 정보를 편리하게 조회
- 메세지 바디를 직접 조회 가능하고 응답도 가능
- RequestEntity : HttpEntity를 상속받아 HttpMethod, url 정보가 추가
- ResponseEntity : HTTP 상태코드 설정 가능
RequestBody
- RequestBody 를 사용하면 HTTP 메시지 바디 정보를 편리하게 조회
- 헤더 정보가 필요하면 HttpEntity 를 사용하거나 @RequestHeader 를 사용
@ResponseBody
@PostMapping("/request-body-string-v4")
public String requestBodyStringV4(@RequestBody String messageBody) {
log.info("messageBody={}", messageBody);
return "ok";
}
JSON
서블릿
- HTTP 메시지 바디에서 데이터를 읽어와서, 문자로 변환
- 문자로 된 데이터를 objectMapper을 사용해서 객체로 변환
스프링
@PostMapping("/request-body-json-v3")
public String requestBodyJsonV3(@RequestBody HelloData data) {
log.info("username={}, age={}", data.getUsername(), data.getAge());
return "ok";
}
@ResponseBody
@PostMapping("/request-body-json-v4")
public String requestBodyJsonV4(HttpEntity<HelloData> httpEntity) {
HelloData data = httpEntity.getBody();
log.info("username={}, age={}", data.getUsername(), data.getAge());
return "ok";
}
- HttpEntity , @RequestBody 를 사용하면 HTTP 메시지 컨버터가 HTTP 메시지 바디의 내용을 우리가 원하는 문자나 객체 등으로 변환
- @ResponseBody를 사용하면 응답에 객체 상태로 보내 줄 수 있음
- JSON 요청 -> HTTP 메시지 컨버터 -> 객체 - @RequestBody 요청
- 객체 -> HTTP 메시지 컨버터 -> JSON 응답 - @ResponseBody 응답
HTTP 응답
정적 리소스, 뷰 템플릿
정적 리소스
- 정적 리소스는 해당 파일을 변경 없이 그대로 서비스하는 것이다.
기본 경로 : src/main/resources/static
뷰 템플릿
- 스프링 부트는 기본 뷰 템플릿 경로를 제공한다.
기본 경로 : src/main/resources/templates
뷰 템플릿을 호출하는 컨트롤러
@RequestMapping("/response-view-v2")
public String responseViewV2(Model model) {
model.addAttribute("data", "hello!!");
return "response/hello";
}
@RequestMapping("/response/hello")
public void responseViewV3(Model model) {
model.addAttribute("data", "hello!!");
}
- String을 반환하는 경우 - View or HTTP 메시지
- @ResponseBody 가 없으면 response/hello 로 뷰 리졸버가 실행되어서 뷰를 찾고, 렌더링
- void를 반환해도 작동하지만 추천하지 않음
HTTP API, 메시지 바디에 직접 입력
- HTTP API를 제공하는 경우에는 HTML이 아니라 데이터를 전달해야 하므로, HTTP 메시지 바디에 JSON 같은 형식으로 데이터를 실어 보낸다.
@ResponseStatus(HttpStatus.OK)
@ResponseBody
@GetMapping("/response-body-json-v2")
public HelloData responseBodyJsonV2() {
HelloData helloData = new HelloData();
helloData.setUsername("userA");
helloData.setAge(20);
return helloData;
}
- ResponseStatus(HttpStatus.OK) 애노테이션을 사용하면 응답 코드도 설정
- 프로그램 조건에 따라서 동적으로 변경하려면 ResponseEntity 를 사용
- @Controller 대신에 @RestController 애노테이션을 사용하면, 해당 컨트롤러에 모두 @ResponseBody 가 적용
- Rest API(HTTP API)를 만들 때 @RestController을 사용한다.
HTTP 메세지 컨버터
메세지 컨버터
- @ResponseBody를 사용하면 viewResolver 대신에 HttpMessageConverter 가 동작한다.
- HTTP API처럼 JSON 데이터를 HTTP 메시지
바디에서 직접 읽거나 쓰는 경우 HTTP 메시지 컨버터를 사용
HTTP 요청 데이터 읽기
- HTTP 요청이 오고, 컨트롤러에서 @RequestBody , HttpEntity 파라미터를 사용
- 메시지 컨버터가 메시지를 읽을 수 있는지 확인하기 위해 canRead() 를 호출
- 대상 클래스 타입을 지원하는가.
- HTTP 요청의 Content-Type 미디어 타입을 지원하는가.
- canRead() 조건을 만족하면 read() 를 호출해서 객체 생성하고, 반환
HTTP 응답 데이터 생성
- 컨트롤러에서 @ResponseBody , HttpEntity 로 값이 반환된다.
- 메시지 컨버터가 메시지를 쓸 수 있는지 확인하기 위해 canWrite() 를 호출한다.
- 대상 클래스 타입을 지원하는가.
- HTTP 요청의 Accept 미디어 타입을 지원하는가.
- canWrite() 조건을 만족하면 write() 를 호출해서 HTTP 응답 메시지 바디에 데이터를 생성한다.
요청 매핑 핸들러 구조
ArgumentResolver
- RequestMappingHandlerAdaptor 는 ArgumentResolver 를 호출해서 컨트롤러(핸들러)가 필요로 하는 다양한 파라미터의 값(객체)을 생성
- ArgumentResolver 의 supportsParameter() 를 호출해서 해당 파라미터를 지원하는지 체크
- 지원하면 resolveArgument() 를 호출해서 실제 객체를 생성
- 객체를 컨트롤러 호출시 넘김
ReturnValueHandler
- ArgumentResolver 와 비슷한데, 이것은 응답 값을 변환하고 처리한다.
HTTP 메세지 컨버터 위치
- ArgumentResolver가 HTTP 메시지 컨버터를 사용해서 필요한 객체를 생성한다.
- ReturnValueHandler가 HTTP 메시지 컨버터를 호출해서 응답 결과를 만든다.
Author And Source
이 문제에 관하여([ 스프링 웹 MVC ] - 스프링 MVC - 기본 기능), 우리는 이곳에서 더 많은 자료를 발견하고 링크를 클릭하여 보았다 https://velog.io/@sgwon1996/스프링-웹-MVC-스프링-MVC-기본-기능저자 귀속: 원작자 정보가 원작자 URL에 포함되어 있으며 저작권은 원작자 소유입니다.
우수한 개발자 콘텐츠 발견에 전념 (Collection and Share based on the CC Protocol.)