VPF::Локализация приложений - Форум программистов

batigoal

Дата 16.11.2005, 09:18 (ссылка)

(нет голосов)

Загрузка ...

Нелетучий Мыш

Профиль
Группа: Участник Клуба
Сообщений: 6423
Регистрация: 28.12.2004
Где: Санктъ-Петербургъ

Репутация: 24
Всего: 151

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

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

Один из основных для локализации классов, это 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>_<страна1>
<базовое_имя>_<язык1>
<базовое_имя>_<язык2>_<страна2>_<вариант2>
<базовое_имя>_<язык2>_<страна2>
<базовое_имя>_<язык2>
<базовое_имя>

где язык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;
  }
}

--------------------

"Чтобы правильно задать вопрос, нужно знать большую часть ответа" (Р. Шекли)
ЖоржЖЖ

0 Пользователей читают эту тему (0 Гостей и 0 Скрытых Пользователей)
0 Пользователей:
« Предыдущая тема \| Java: Общие вопросы \| Следующая тема »