스프링은 자바에서 기본으로 제공하는 타입들에 대해 수많은 포맷터를 기본으로 제공합니다.
IDE에서 Formatter 인터페이스의 구현 클래스를 찾아보면 수 많은 날짜나 시간 관련 포맷터가 제공되는 것을 확인할 수 있습니다.
그런데 포맷터는 기본 형식이 지정되어 있기 때문에, 객체의 각 필드마다 다른 형식으로 포맷을 지정하기는 어렵습니다.
스프링은 이런 문제를 해결하기 위해 애노테이션 기반으로 원하는 형식을 지정해서 사용할 수 있는 매우 유용한 포맷터 두 가지를 기본으로 제공합니다.
- @NumberFormat : 숫자 관련 형식 지정 포맷터 사용, NumberFormatAnnotationFormatterFactory
- @DateTimeFormat : 날짜 관련 형식 지정 포맷터 사용, Jsr310DateTimeFormatAnnotationFormatterFactory
예제를 통해서 사용해보겠습니다.
FormatterController
@Controller
public class FormatterController {
@GetMapping("/formatter/edit")
public String formatterForm(Model model) {
Form form = new Form();
form.setNumber(10000);
form.setLocalDateTime(LocalDateTime.now());
model.addAttribute("form", form);
return "formatter-form";
}
@PostMapping("/formatter/edit")
public String formatterEdit(@ModelAttribute Form form) {
return "formatter-view";
}
@Data
static class Form {
@NumberFormat(pattern = "###,###")
private Integer number;
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime localDateTime;
}
}
templates/formatter-form.html
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<form th:object="${form}" th:method="post">
th:field <input type="text" th:field="*{ipPort}"><br/>
th:value <input type="text" th:value="*{ipPort}">(보여주기 용도)<br/>
<input type="submit"/>
</form>
</body>
</html>
templates/formatter-view.html
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>Title</title>
</head>
<body>
<ul>
<li>${number}: <span th:text="${number}"></span></li>
<li>${{number}}: <span th:text="${{number}}"></span></li>
<li>${ipPort}: <span th:text="${ipPort}"></span></li>
<li>${{ipPort}}: <span th:text="${{ipPort}}"></span></li>
</ul>
</body>
</html>실행
http://localhost:8080/formatter/edit
실행해보면 지정한 포맷으로 출력된 것을 확인할 수 있습니다.
@NumberFormat , @DateTimeFormat 의 자세한 사용법이 다음 링크를 참고하면 됩니다.
https://docs.spring.io/spring-framework/docs/current/reference/html/core.html#format- CustomFormatAnnotations
주의!
메시지 컨버터( HttpMessageConverter )에는 컨버전 서비스가 적용되지 않습니다.
특히 객체를 JSON으로 변환할 때 컨버전 서비스가 적용되지 않습니다.
메시지 컨버터를 사용하면서 HttpMessageConverter의 역할은 HTTP 메시지 바디의 내용을 객체로 변환하거나 객체를 HTTP 메시지 바디에 입력하는 것입니다.
예를 들어서 JSON을 객체로 변환하는 메시지 컨버터는 내부에서 Jackson 같은 라이브러리를 사용합니다.
객체를 JSON으로 변환한다면 그 결과는 이 라이브러리에 달린 것입니다.
따라서 JSON 결과로 만들어지는 숫자나 날짜 포맷을 변경하고 싶으면 해당 라이브러리가 제공하는 설정을 통해서 포맷을 지정해야 합니다. 결과적으로 이것은 컨버전 서비스와 전혀 관계가 없습니다.
컨버전 서비스는 @RequestParam , @ModelAttribute , @PathVariable , 뷰 템플릿 등에서 사용할 수 있습니다.
'스프링 > Spring' 카테고리의 다른 글
| 스프링으로 파일 업로드 구현하기 - MultipartFile 인터페이스 (0) | 2022.01.02 |
|---|---|
| 서블릿의 파일 업로드 - 서블릿이 제공하는 Part (0) | 2022.01.02 |
| 스프링 포맷터(Formatter), 포맷터를 지원하는 ConversionService (0) | 2021.12.30 |
| 컨버전 서비스 사용하기 - ConversionService (타임리프, 폼) (0) | 2021.12.30 |
| 스프링 타입 컨버터 - Converter (0) | 2021.12.30 |
