«1. Введение
В этом уроке мы узнаем, как форматировать валюты по локали с помощью Thymeleaf.
2. Зависимости Maven
Давайте начнем с импорта зависимости Spring Boot Thymeleaf:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
<version>2.2.7.RELEASE</version>
</dependency>
3. Настройка проекта
Наш проект будет простым веб-приложением Spring, которое отображает валюты в зависимости от локали пользователя. . Давайте создадим наш шаблон Thymeleaf, currency.html, в resources/templates/currencies:
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>Currency table</title>
</head>
</html>
Мы также можем создать класс контроллера, который будет обрабатывать наши запросы:
@Controller
public class CurrenciesController {
@GetMapping(value = "/currency")
public String exchange(
@RequestParam(value = "amount") String amount, Locale locale) {
return "currencies/currencies";
}
}
4. Форматирование
Когда касается валют, нам нужно отформатировать их в зависимости от локали запрашивающей стороны.
В этом случае мы будем отправлять заголовок Accept-Language с каждым запросом, чтобы представить локаль нашего пользователя.
4.1. Валюта
Класс Numbers, предоставляемый Thymeleaf, поддерживает форматирование валют. Итак, давайте обновим наше представление, вызвав метод formatCurrency
<p th:text="${#numbers.formatCurrency(param.amount)}"></p>
Когда мы запустим наш пример, мы увидим правильно отформатированную валюту:
@Test
public void whenCallCurrencyWithUSALocale_ThenReturnProperCurrency() throws Exception {
mockMvc.perform(MockMvcRequestBuilders.get("/currency")
.header("Accept-Language", "en-US")
.param("amount", "10032.5"))
.andExpect(status().isOk())
.andExpect(content().string(containsString("$10,032.50")));
}
США, валюта отформатирована с десятичной точкой и знаком доллара.
4.2. Денежные массивы
Мы также можем использовать класс Numbers для форматирования массивов. В результате мы добавим еще один параметр запроса в наш контроллер:
@GetMapping(value = "/currency")
public String exchange(
@RequestParam(value = "amount") String amount,
@RequestParam(value = "amountList") List amountList, Locale locale) {
return "currencies/currencies";
}
Далее мы можем обновить наше представление, включив в него вызов метода listFormatCurrency:
<p th:text="${#numbers.listFormatCurrency(param.amountList)}"></p>
Теперь давайте посмотрим, как выглядит результат например:
@Test
public void whenCallCurrencyWithUkLocaleWithArrays_ThenReturnLocaleCurrencies() throws Exception {
mockMvc.perform(MockMvcRequestBuilders.get("/currency")
.header("Accept-Language", "en-GB")
.param("amountList", "10", "20", "30"))
.andExpect(status().isOk())
.andExpect(content().string(containsString("£10.00, £20.00, £30.00")));
}
Результат показывает список валют с добавленным правильным форматированием Соединенного Королевства.
4.3. Нули в конце
Используя Strings#replace, мы можем удалить нули в конце.
<p th:text="${#strings.replace(#numbers.formatCurrency(param.amount), '.00', '')}"></p>
Теперь мы можем видеть полную сумму без двойных нулей в конце:
@Test
public void whenCallCurrencyWithUSALocaleWithoutDecimal_ThenReturnCurrencyWithoutTrailingZeros()
throws Exception {
mockMvc.perform(MockMvcRequestBuilders.get("/currency")
.header("Accept-Language", "en-US")
.param("amount", "10032"))
.andExpect(status().isOk())
.andExpect(content().string(containsString("$10,032")));
}
4.4. Десятичные дроби
В зависимости от локали десятичные дроби могут быть отформатированы по-разному. Поэтому, если мы хотим заменить десятичную точку запятой, мы можем использовать метод formatDecimal, предоставляемый классом Numbers:
<p th:text="${#numbers.formatDecimal(param.amount, 1, 2, 'COMMA')}"></p>
Посмотрим на результат в тесте:
@Test
public void whenCallCurrencyWithUSALocale_ThenReturnReplacedDecimalPoint() throws Exception {
mockMvc.perform(MockMvcRequestBuilders.get("/currency")
.header("Accept-Language", "en-US")
.param("amount", "1.5"))
.andExpect(status().isOk())
.andExpect(content().string(containsString("1,5")));
}
Значение будет в формате «1,5».
5. Заключение
В этом коротком руководстве мы показали, как Thymeleaf можно использовать с Spring Web для обработки валют с использованием локали пользователя.
Как всегда, код доступен на GitHub.