Полезное для программистов:

Фриланс
Новости
Статьи
   
Рубрики:

Error. Page cannot be displayed. Please contact your service provider for more details. (7)


Локализация приложений

Поиск:
Локализация приложений.

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

Один из основных для локализации классов, это java.util.Locale. Этот класс описывает текущую локаль, локаль - это описание текущего региона, языка и других особенностей. Класс Locale предназначен только для идентификации локали, никаких данных для локализации он не содержит. Самый главный параметр это используемый язык, второй по значимости параметр это страна, и третий параметр это вариант. Вариант не имеет какого-то определенного смысла и предназначен для указания некой дополнительной информации, не описываемой первыми двумя параметрами, например диалекта. Как правило вариант не используется. Из всех параметров обязательным является только язык. Параметр страна является опциональным и предназначен для указания страны пользователя.
Язык описывается двухбуквенным кодом ISO 639, код записывается в нижнем регистре. Страна обозначается двухбуквенным кодом ISO-3166, код записывается в верхнем регистре. Получить список языков и стран можно с помощью Locale.getISOLanguages() и Locale.getISOCountries() соответсвенно. Хотя никаких ограничений на вариант не накладывается, для варианта лучше придерживаться правил формирования идентификаторов в Java, иначе некоторые механизмы могут не работать или работать неправильно.

Задача: создать локаль для описания русского языка на Украине:
Код
Locale locale = new Locale("ru","UA");


Локаль по умолчанию устанавливается исходя из установок ОС, получить ее можно Locale.getDefault(). Переопределить локаль по умолчанию можно из кода Locale.setDefault(locale), из командной строки запуска: -Duser.language=ru -Duser.country=RU.



Для преобразования чисел, дат и сообщений в строковое представление служал форматтеры (см. java.text.Format), они все поддерживают конструкторы с указанием локали, чтобы форматировать в соответсвии с текущей локалью. Эти классы можно использовать без доработки, они полностью локализованы. Единствеено но, может потребоваться написание своего ResourceBundle для поддержки "экзотического" языка или диалекта.



Основная нагрузка по локализации приложений ложится на класс ResourceBundle. Данный класс умеет загружать ресурсы для указанной локали. Для загрузки ресурсов используется ResourceBundle.getBundle(<name>, <locale>, <classLoader>), где:
  • name - имя загружаемого ResourceBundle, имя должно соответсвовать соглашениям об именах классов в Java
  • locale - локаль для которой загружать ресурсы, если отсутсвует используется локаль по умолчанию
  • classLoader - используемый для загрузки ресурсов, если отсутсвует используется ClassLoader вызывающего класса
ResourceBundle по сути похож на java.util.Map, позволяет по ключу получить значение, получить список всех ключей, а вот методов по добалению своих пар ключ-значение или редактированию существующих нет т.к. ResourceBundle неизменяемый. Загрузку ResourceBundle можно вызывать несколько раз, после первого раза все последующие вызовы будут возвращать указатель на ранее загруженный ResourceBundle.

Задача: загрузить ResourceBundle и отобразить локализованное сообщение об ошибке.
Код
ResourceBundle resourceBundle = ResourceBundle.getBundle("ru.vingrad.locale.TutorialAppBundle", getLocale());
JOptionPane.showMessageDialog(null,
                             resourceBundle.getString("Messages.fatalErrorMessage"),
                             resourceBundle.getString("Messages.errorDialogTitle"),
                             JOptionPane.ERROR_MESSAGE);


Ресурсы загружаемые ResourceBundle могут хранится либо в текстовых файлах, организованных наподобие properties, либо в виде классов унаследованных от ListResourceBundle (именно отсюда идет требование к именам ресурсов). Ресурсы реализованные в виде наследников ListResourceBundle быстрее загружаются, позволяют хранить не только строки но любые объекты, но для локализации приложения нужен исходный код классов и компилятор. В то время как ResourceBundle реализованные в виде файлов properties могут быть локализованы в любом текстовом редакторе (может понадобится утилита native2ascii).

Загрузка ресурсов происходит следующим образом: формируются потенциальные имена для ResourceBundle:
  1. <базовое_имя>_<язык1>_<страна1>_<вариант1>
  2. <базовое_имя>_<язык1>_<страна1>
  3. <базовое_имя>_<язык1>
  4. <базовое_имя>_<язык2>_<страна2>_<вариант2>
  5. <базовое_имя>_<язык2>_<страна2>
  6. <базовое_имя>_<язык2>
  7. <базовое_имя>
где язык1, страна1, вариант1 код языка, страны и вариант локали переданый в качестве параметра загрузки, а язык2, страна2, вариант2 аналогично но для умолчальной локали. Для каждого имени вначале проводится попытка загрузить класс с таким именем, а если он не найден то файл properties, если и он не найден, то пререходим к другому имени. Если все попытки загрузить ResourceBundle закончились неудачно, то выбрасывается исключение MissingResourceException. ResourceBundle без суффиксов (т.е. только <базовое_имя>), называется умолчальным ResourceBundle и должен всегда существовать, в качестве языка для него желательно выбирать английский.

Задача: реализовать приложение с поддержкой русского и английского языков, в качестве умолчального выбрать английский

Приложение:
Код
package ru.vingrad.locale;

import javax.swing.*;
import java.util.Locale;
import java.util.ResourceBundle;
import java.util.Date;
import java.awt.*;
import java.text.MessageFormat;

public class LocalisedFrame extends JFrame
{
 public static final String BUNDLE_NAME               = "ru.vingrad.locale.TutorialAppBundle";
 public final static String FRAME_TITLE_KEY           = "LocalisedFrame.title";
 public final static String FILE_MENU_KEY             = "LocalisedFrame.menu.file";
 public final static String FILE_OPEN_KEY             = "LocalisedFrame.menu.file.open";
 public final static String FILE_OPEN_MNEMONIC_KEY    = "LocalisedFrame.menu.file.openMnemonic";
 public final static String FILE_EXIT_KEY             = "LocalisedFrame.menu.file.exit";
 public final static String FILE_EXIT_MNEMONIC_KEY    = "LocalisedFrame.menu.file.exitMnemonic";
 public final static String SATUS_MESSAGE_KEY         = "LocalisedFrame.status";

 private ResourceBundle resourceBundle;

 public LocalisedFrame(Locale locale)
 {
   if(locale != null)
     setLocale(locale);
   resourceBundle = ResourceBundle.getBundle(BUNDLE_NAME, getLocale());

   setTitle(resourceBundle.getString(FRAME_TITLE_KEY));

   JMenuBar mainMenu = new JMenuBar();
   JMenu fileMenu = new JMenu(resourceBundle.getString(FILE_MENU_KEY));
   JMenuItem openItem = new JMenuItem(resourceBundle.getString(FILE_OPEN_KEY), resourceBundle.getString(FILE_OPEN_MNEMONIC_KEY).charAt(0));
   JMenuItem exitItem = new JMenuItem(resourceBundle.getString(FILE_EXIT_KEY), resourceBundle.getString(FILE_EXIT_MNEMONIC_KEY).charAt(0));

   fileMenu.add(openItem);
   fileMenu.add(exitItem);
   mainMenu.add(fileMenu);
   setJMenuBar(mainMenu);

   JTextArea textArea = new JTextArea(30, 60);
   JLabel statusBar = new JLabel();
   statusBar.setBorder(BorderFactory.createLoweredBevelBorder());
   MessageFormat messageFormat = new MessageFormat(resourceBundle.getString(SATUS_MESSAGE_KEY), getLocale());
   Runtime runtime = Runtime.getRuntime();
   statusBar.setText(messageFormat.format(new Object[]{new Date(), runtime.freeMemory(), runtime.totalMemory()}));

   getContentPane().add(textArea, BorderLayout.CENTER);
   getContentPane().add(statusBar, BorderLayout.SOUTH);

   pack();
   setDefaultCloseOperation(DISPOSE_ON_CLOSE);
   setLocationRelativeTo(null);
 }

 public static void main(String[] args)
 {
   Locale.setDefault(Locale.ENGLISH);
   LocalisedFrame frame = new LocalisedFrame(new Locale("fr"));
   frame.setVisible(true);
 }
}


Умольчальный ResourceBundle (он же английский)
Код
package ru.vingrad.locale;

import static ru.vingrad.locale.LocalisedFrame.*;

import java.util.ListResourceBundle;

public class TutorialAppBundle extends ListResourceBundle
{
 private final static Object[][] content = new Object[][]
 {
   {FRAME_TITLE_KEY,          "Localised application"},
   {FILE_MENU_KEY,            "File"},
   {FILE_OPEN_KEY,            "Open"},
   {FILE_OPEN_MNEMONIC_KEY,   "O"},
   {FILE_EXIT_KEY,            "Exit"},
   {FILE_EXIT_MNEMONIC_KEY,   "x"},
   {SATUS_MESSAGE_KEY,        "Application started at {0,date,long} {0,time,long},    memory free {1,number} from {2,number}"}
 };

 protected Object[][] getContents()
 {
   return content;
 }
}


ResourceBundle для русского языка
Код
package ru.vingrad.locale;

import static ru.vingrad.locale.LocalisedFrame.*;

import java.util.ListResourceBundle;

public class TutorialAppBundle_ru extends ListResourceBundle
{
 private final static Object[][] content = new Object[][]
 {
   {FRAME_TITLE_KEY,          "Локализуемое приложение"},
   {FILE_MENU_KEY,            "Файл"},
   {FILE_OPEN_KEY,            "Открыть"},
   {FILE_OPEN_MNEMONIC_KEY,   "О"},
   {FILE_EXIT_KEY,            "Выход"},
   {FILE_EXIT_MNEMONIC_KEY,   "В"},
   {SATUS_MESSAGE_KEY,        "Приложение запущено {0,date,long} {0,time,long},    памяти свободно {1,number} из {2,number}"}
 };

 protected Object[][] getContents()
 {
   return content;
 }
}
Автор: LSD
Сайт: http://






Просмотров: 7648

 

 

Новые статьи:


Популярные:
  1. Как сделать цикличным проигрывание MIDI-файла?
  2. Создание AVI файла из рисунков
  3. Как устройство "отключить в данной конфигурации"?
  4. Kто в данный момент присоединен через Сеть?
  5. Как узнать количество доступной памяти?
  6. Как реализовать в RichEdit разноцветный текст?
  7. Как скрыть свое приложение от ProcessViewer
  8. Как программно нажать/скрыть/показ кнопку "Start"?
  9. Модуль работы с ресурсами в PE файлах
10. Функции вызова диалоговых окон выбора
11. Проверка граматики средствами Word'а из Delphi.
12. Модуль для упрощенного вызова сообщений
13. Функции для записи и чтение своих данных в, ЕХЕ- файле
14. Рекурсивный просмотр директорий
15. Network Traffic Monitor
16. Разные модули
17. Универсальная функция для обращения к любым экспортируем функциям DLL
18. Библиотека от VladS
19. Протектор для UPX'а
20. Еще об ICQ, сообщения по контакт листу?
21. Использование открытых интерфейсов
22. Теория и практика использования RTTI
23. Работа с TApplication
24. Примеры использования Drag and Drop для различных визуальных компонентов
25. Что такое порт? Правила для работы с портами
26. Симфония на клавиатуре
27. Загрузка DLL
28. Исправление автоинкремента
29. Взаимодействие с чужими окнами
30. Проверить дубляжи в столбце


 

 

 
 
На главную