Локализация и интернационализация в Java. Practical Tasks

Положили в messages_ru.properties строку title=Отчёт, запустили программу — а на консоли вместо «Отчёт» набор символов вида «Ð...». До Java 9 класс ResourceBundle читал properties-файлы в кодировке ISO-8859-1, и кириллица из файла в UTF-8 превращалась в мусор. Начиная с Java 9 (JEP 226) такие файлы по умолчанию читаются в UTF-8, но это лишь один из нюансов, на которых спотыкаются при первой локализации.

На этой странице — 3 задачи по локализации и интернационализации в Java: properties-файлы с текстами на русском и английском, отчет, заголовок которого меняется вместе с локалью, и цены в валюте текущей локали для учебного интернет-магазина. Для решения понадобятся классы Locale, ResourceBundle и NumberFormat; общая теория — в уроке «Локализация и интернационализация в Java».

Темы Java на русском и английском (ResourceBundle)

1. Создать properties-файлы на русском и английском языках, содержащие названия изученных тем по Java.
2. Создать метод, который получает в качестве параметра локаль и распечатывает всю информацию из properties-файла.

Класс FullReport: отчет с заголовком на языке локали

Отчёт о сотрудниках · part 2 of 4 · ← part 1 · part 3 →

1. Создать класс FullReport, который выводит ту же информацию, что и класс Report (часть 1 на странице заданий по строкам), но заголовок отчета должен изменяться в зависимости от выбранной локали (используем класс ResourceBundle).
2. Для форматирования чисел использовать класс NumberFormat.

Чек с ценами в валюте текущей локали

Интернет-магазин · part 4 of 11 · ← part 3 · part 5 →

1. При покупке вывести на консоль отчет о купленных продуктах. Денежные единицы должны соответствовать текущей локали (используем класс NumberFormat). Например, для локали uk_UA:

   Продукты        Цена
   --------------------------------------
   Джинсы     1 500,78 ₴
   Юбка       1 000,56 ₴
   Галстук      500,78 ₴
   --------------------------------------
   Итого:     3 002,12 ₴
   

2. Отчет должен быть на языке текущей локали — используем ResourceBundle.

Solution on Patreon →

На чём чаще всего ошибаются

В задачах на локализацию программа чаще всего ломается не из-за логики, а из-за окружения: properties-файл не попал в classpath, в одном из файлов не хватает ключа, а отформатированная сумма содержит неразрывный пробел вместо обычного. В таблице — симптом, причина и исправление.

Что выведет этот код: запасная локаль

Если для запрошенной локали нет своего properties-файла, ResourceBundle.getBundle() сначала ищет файл для локали по умолчанию (Locale.getDefault()) и только потом берёт базовый файл без суффикса. Поэтому на компьютере с русской локалью «немецкий» отчет внезапно выводится по-русски, а не на языке базового файла.

// src/main/resources/messages.properties:    title=Report
// src/main/resources/messages_ru.properties: title=Отчёт
Locale.setDefault(Locale.of("ru", "RU"));   // до Java 19: new Locale("ru", "RU")

ResourceBundle bundle = ResourceBundle.getBundle("messages", Locale.GERMANY);
System.out.println(bundle.getString("title"));
System.out.println(bundle.getLocale());
// Вывод:
// Отчёт
// ru

Файла messages_de_DE.properties нет, поэтому поиск переходит к локали по умолчанию ru_RU и находит messages_ru.properties. Чтобы при отсутствии перевода всегда получать базовый файл, отключите этот шаг через ResourceBundle.Control:

ResourceBundle bundle = ResourceBundle.getBundle("messages", Locale.GERMANY,
        ResourceBundle.Control.getNoFallbackControl(ResourceBundle.Control.FORMAT_DEFAULT));
System.out.println(bundle.getString("title"));
System.out.println(bundle.getLocale().equals(Locale.ROOT));
// Вывод:
// Report
// true

Вариант с Control работает в обычном (немодульном) проекте; если вызвать его из именованного модуля Java 9+, будет выброшено UnsupportedOperationException.