Перейти к основному содержимому

Форматирование валют в Spring с использованием Thymeleaf

· 3 мин. чтения

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

Поскольку мы установили заголовок Accept-Language для США, валюта отформатирована с десятичной точкой и знаком доллара.

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 .