• Написание программы, работающей в различных языковых окружениях

• Адаптация интернационализированной программы к конкретному языковому окружению

• java.util
• java.text

• getLanguage() — язык
• getCountry() — cтрана
• getVariant() — вариант

• choose a folder,
  containing colour information
  

• choose a directory,
  containing colour information
  

• choose a folder,
  containing color information
  

• Выберите каталог,
  содержащий цветовую информацию
  

• new Locale.Builder()
      .setLanguage(...).setRegion(...).setVariant(...)
      .build();
  

• Locale(language) – по языку
• Locale(language, country) – по языку и стране
• Locale(language, country, variant) – по языку, стране и варианту

• Locale.of(language, country, variant) – по языку, стране и варианту

• Locale.getAvailableLocales() – список доступных локалей
• Поля UK, US, FRANCE, …

• Locale.getDefault() – получение локали по умолчанию
• Locale.setDefault(locale) – установка локали по умолчанию

• getDisplayName() – имя локали

• getObject(key) – произвольный объект
• getString(key) – в виде строки
• getStringArray(key) – массив строк
• Исключение MissingResourceException

• getLocale() – локаль
• Enumeration<String> getKeys() – ключи

• void printUsage() {
      System.out.println(
          "Usage: Test [<options>] <commands>\n" +
          "Options:\n" +
          "     -o write output\n" +
          "... "
      );
  }
  

• void printUsage(ResourceBundle bundle) {
      System.out.println(String.format(
          "%s Test [%s] %s\n" +
          "%s\n" +
          "     -o %s\n"+
          "...",
          bundle.getString("usage"),      // Usage:
          bundle.getString("options"),         // <options>
          bundle.getString("commands"),   // <commands>
          bundle.getString("Options"),        // Options:
          bundle.getString("-o")          // Write output
      ));
  }
  

• getBundle(baseName) – по имени
• getBundle(baseName, locale) – по локали
• getBundle(baseName, locale, classLoader) – из заданного ClassLoader’а

• baseName_languageS_countryS_variantS
• baseName_languageS_countryS
• baseName_languageS
• baseName_languageD_countryD_variantD
• baseName_languageD_countryD
• baseName_languageD
• baseName

ResourceBundle bundle =
    ResourceBundle.getBundle(
        "UsageResourceBundle",
        Locale.US
    );
printUsage(bundle);

• Класс ListResourceBundle

• Класс PropertyResourceBundle

• Настоящие объекты

• Object[][] getContents() – локализованные данные

• public class UsageResourceBundle_en_US
          extends ListResourceBundle {
      private static final Object[][] CONTENTS = {
          {"usage",            "Usage:"},
          {"options",          "<options>"},
          {"commands",    "<commands>"},
          {"Options",         "Options:"},
          {"-o",                  "Write output"},
      };
      protected Object[][] getContents() {
          return CONTENTS;
      }
  }
  

• Только строки

key1 = value1
key2 : value2
key3 = very long value \
continues on next line
# Comment
…

usage           = Usage:
options         = <options>
Commands  = <commands>
Options        = Options:
-o                 = Write output

• Числа
• Время и дата
• Сообщения

• format(long) – форматировать целое число
• format(double) – форматировать число с плавающей точкой
• Number parse(string) – разобрать локализованное число

• ParseException – ошибка разбора

• getNumberInstance(locale?) – обычные числа
• getIntegerInstance(locale?) – целые числа
  • Округление при выводе
• getPercentInstance(locale?) – проценты
• getCurrencyInstance(locale?) – валюта

• Currency currency – тип валюты
• minimumFractionDigits, (maximum) – число цифр в дробной части
• minimumIntegerDigits, (maximum) – число цифр в целой части
• groupingUsed – группировка разрядов
• parseIntegerOnly – разбор только целых чисел

• Шаблоны форматирования ###,##0.0##

• Десятичная запятая
• Разделители групп
• Бесконечности
• …

• ChoiceFormat(limits, formats) – программно
• ChoiceFormat(pattern) – по шаблону

• limit₀ # format | limit₁ # format | …

• i-й если limits_i ≤ n < limits_i+1

• 0#No files|1#1 file|{0} files

• format(date) – форматировать дату/время
• Date parse(string) – разобрать локализованную дату/время

• ParseException – ошибка разбора

• getDateInstance(dateStyle, locale?) – даты
• getTimeInstance(timeStyle, locale?) – времени
• getDateTimeInstance(dateStyle, timeStyle, locale?) – даты и времени

• DEFAULT, FULL, LONG, MEDIUM, SHORT

• calendar – тип календаря
• timeZone – временная зона

• Шаблоны форматирования

  yyyy.MM.dd G 'at' HH:mm:ss z
  

• Дни недели
• Месяца
• …

• format(arguments[], result, pos) – форматировать сообщение
• MessageFormat.format(pattern, arguments*) – форматировать сообщение по шаблону

• шаблон := (текст { параметр })*
• параметр := индекс[, тип[, стиль]]
• тип := number | date | time | choice

// May 17, 2024: $11.40 available
MessageFormat.format(
    "{0,date}: {1,number,currency} available“,
    new Date(), 11.40
)

• implements Comparator<String>
• getInstance(locale?) – получение экземпляра
• setStrength(int) – «сила» сравнения
  • PRIMARY – различать только буквы
  • SECONDARY – различать диакритику
  • TERTIARY – различать регистр
  • IDENTICAL – различать все символы

• Сравнивает строки в соответствии с заданными правилами

• new RuleBasedCollator("c < e, E; é, É; ê = ě, Ê = Ě < F");
  

• implements Comparable<CollationKey>
• Collator.getCollationKey(string) – создание

• getSourceString() – исходная строка
• toByteArray() – биты ключа

• Сколько предложений?
  • 3
• Сколько слов?

  • 22 (5), 23
• Сколько букв?

  • 45, 98 (89)

• getCharacterInstance(locale?) (word, line, sentence) – создание экземпляра

• first(), last(), next(), previous() – передвижение итератора
  • DONE – конец

• Кодировка:
  • Latin-1
  • UTF-8
• Можно использовать unicode escapes

• --encoding

usage=Применение
options=<Опции>
Commands=<команды>
Options=Опции:
-o=Запись выходного файла

usage=\u040f\u0430\u0401\u00ac\u0490\u00ad\u0490\u00ad\u0401\u0490
options=<\u040b\u0407\u0436\u0401\u0401>
Commands=<\u0404\u00ae\u00ac\u00a0\u00ad\u00a4\u043b>
Options=\u040b\u0407\u0436\u0401\u0401:
-o=\u2021\u00a0\u0407\u0401\u0431\u043c \u045e\u043b\u0435\u00ae\u00a4\u00ad\u00ae\u0408\u00ae \u0434\u00a0\u00a9\u00ab\u00a0