Автор неизвестен - Платформа J2Me

В данном третьем подходе приложения определяют классы Java, которые содержат локализованные ресурсы. Каждый класс содержит ресурсы для одной региональной настройки. Файлы откомпилированы и упакованы как часть JAR приложения. При работе локализованные ресурсы затем достаются с помощью создания экземпляра соответствующего класса.

Эта разработка аналогична разработке иерархии пакетов ресурсов J2SE. Классы java.util.ResourceBundle и java.util.ListResourceBundle J2SE являются абстрактными классами, определяющими структуру создания агрегаций произвольных чувствительных к региональным настройкам объектов Java. Эти объекты могут быть любыми объектами Java.

Этот подход к разработке интернационализации определяет свою собственную версию классов ResourceBundle и ListResourceEundle J2SE. В листингах 9.7 и 9.8 показаны их реализации, которые определяют, соответственно, подмножества классов ResourceBundle и ListResourceBundle платформы J2SE. Хотя эти реализации являются собственными, сигнатуры методов являются теми же, что и у их аналогов в J2SE.

Листинг 9.7. Класс ResourceBundle определяет структуру для агрегирования ресурсов, не заключающую в себе информацию об абстракции, требуемой для выполнения агрегирования

import Java.util.Hashtable;

/**

Данный класс определяет базовый класс для определения локализованных ресурсов приложения. Он реализует подмножество класса java.util.ResourceBundle J2SE, но придерживается интерфейса, определенного данным классом.

public abstract class ResourceBundle

«Родительские» ресурсы. Если ресурс не найден в данном пакете, производятся поиски родительского пакета.

*/

protected ResourceBundle parent;

/**

Конструктор No-arg. public ResourceBundle () super();

/**

Получает пакет ресурсов с указанным именем класса.

Имя класса уже содержит язык и код страны назначения в стандартном формате.

Например, имя класса пакета ресурсов может быть «I18NDeraoResources_fr_FR».

@param className Полное имя класса, такое, как «I18NDemoResources_fr_FR».

@возвращает объект пакета ресурсов.

*/

public static ResourceBundle getBundle(String classNarae) throws IllegalArgumentException,

KissingResourceException

{

return ResourceBundle.getBundle(className, "");

}

/**

Получает пакет ресурсов с указанным базовым именем.

@param baseName Полностью определенное имя класса извлекаемого пакета.

Например, базовое имя «I18NDemo_fr_FR» — «HSNDerao».

Sparam строка региональной настройки, представляющая региональную настройку, для которой должен быть извлечен пакет ресурсов.

Ожидаемая форма <язык>.<страна> в соответствии с ISO 639 и ISO 3166, соответственно.

@выдает пакет ресурсов для возвращения

*/

public static ResourceBundle getBundle(String baseName, String locale)

throws IllegalArgumentException, MissingResourceException

{

Class c; if (baseName == null)

{

throw new IllegalArgumentException("No basename.");

{

String className = baseName + «_» + locale;

ResourceBundle bundle = null;

try

{

с = Class.forName(className);

bundle = (ResourceBundle) с. newlnstance();

}

catch (ClassNotFoundException cnfe)

throw new

MissingResourceException("Class not found.");

}

catch (InstantiationException ie)

{

throw new

MissingResourceException("Can11 instantiate.");

}

catch (IllegalAccessException iae)

{

throw new

MissingResourceException("Can1t access.");

}

return bundle;

}

/**

Извлекает объект с указанным ключом. Если ключ не найден, ищется родительский пакет.

@param key Ключ объекта

@выдает объект с указанным ключом

*/

public final Object getObject(String key)

throws MissingResourceException

}

Object obj; if (key == null)

{

throw new NullPointerException();

}

obj = handleGetObject(key); if (obj == null SS parent 1= null)

{

obj = parent.getObject(key);

}

if (obj == null)

{

throw new MissingResourceException ();

return obj;

}

/**

Ищет данный пакет ресурсов для объекта с указанным ключом.

@param key Ключ поиска желаемого объекта.

@выдает объект с указанным ключом.

*/

protected abstract Object handleGetObject(String key);

}

Листинг 9.8. Класс. ListResourceBundle использует «список» (в действительности двухмерный массив объектов) для агрегирования ресурсов

/**

Этот класс определяет пакет ресурсов как подходящий массив ресурсов.

Он воспроизводит класс того же имени, определяемый платформой J2SE, java.util.ListResourceBundle.

Данный класс абстрактен. Приложения вынуждены создавать его подклассы и определять конкретные классы, которые содержат локализованные ресурсы.

0пределенные подклассы конкретного приложения должны быть названы так, чтобы имя содержало язык и страну региональной настройки, в соответствии со стандартами ISO 639 и ISO 3166 для языковых и страновых кодов соответственно.

*/

открытый абстрактный класс ListResourceBundle дополняет ResourceBundle

/**

Конструктор No-arg.

*/

public ListResourceBundle()

super();

// Массив ресурсов в формате ключ-значение, private static final Object [][] contents = null;

/**

Получает массив ресурсов.

@возвращает двухмерный массив пар ключ-значение, который определяет эту группу.

*/

public abstract Object [][] getContents();

/**

Получает объект, который представляет значение, связанное с указанным ключом.

@param key Ключ пары ключ-значение.

@выдает объект, который представляет значение пары ключ-значение.

*/

public final Object handleGetObject(String key)

{

Object value = null; if. (key == null)

{

return null;

}

Object [][] pairs = getContents ();

for (int i = 0; i < pairs. length; i + +) if (key.equals(pairs [i] [0]))

value = (pairs [i] [1]);

}

}

return value;

}

}

Смысл данной разработки заключается в том, что разработчики приложения создают подклассы ListResourceBundle. Каждый подкласс представляет собой агрегацию локализированных ресурсов для определенной региональной настройки. В листинге 9.9 показан конкретный подкласс ListResourceBundle, который предоставляет ресурсы приложения, локализованные под англоязычный регион. Отметьте, как имя класса отражает поддерживаемую региональную настройку. Эта схема присвоения имен не только облегчает управление классом во время разработки, она также помогает обнаруживать местонахождение и загружать класс во время работы приложения.

Листинг 9.9. Конкретный подкласс ListResourceBundle легко определяет локализованные ресурсы. Каждый подкласс определяет «список» значений ресурсов (в действительности являющийся массивом) и определяет метод getContents (). import javax.microedition.Icdui."Image

import Java. io.lOException;

/**

Данный класс определяет локализованные ресурсы приложения I18NDemo3.

Вы извлекаете ресурс, вызывая метод getObject() в классе ResourceBundle.

*/

public class I18NDemoResources_en_US extends ListResourceBundle

// Содержит один из локализованных ресурсов. Нам необходимо

// инициализировать данную переменную в статическом

// инициализаторе данного класса, private static Image applcon;

private Object [][] contents =

{

("title", "Hello, World"}, // Form title.

("greeting", "My third MIDlet"}, // Form text.

("alert_title", "Button Pressed"), // Alert title.

{"alert_text", "A button was pressed!"),// Alert text.

{"exit", "Exit"}, // «Exit» menu item.

{"menu", "Menu"}, // «Menu» soft button.

{"cancel", "Cancel"}, // «Cancel» menu item.

{"stop", "Stop"}, // «Stop» menu item.

{"ok", "OK"}, // «OK» menu item.

{"alert", "Alert"}, // «Alert» soft button.

{"sayhi","Say Hi"}, // "Say Hi" menu item.

{"screen", "Screen"}, // «Screen» menu item.

{"item", "Item"}, // «Item» menu item.

{"help", "Help"}, // «Help» menu item.

{"app_icon", applcon} // Application icon.

};

/**

Конструктор No-arg.

*/

public I18NDemoResources_en_US()

{

super();

}

public Object ij[] getContents()

{

return contents;

}

// Необходим статический инициализатор для инициализации

// переменных, которые не могут быть инициализированы в

// массиве содержимого. Например, мы не можем выделить что-либо

// в массиве содержимого для создания изображения и,

// выполнить требуемую обработку исключений.

static

{

try

{

applcon = Image.createlmage("i!8n-en_US.png");

}

catch (lOException ioe)

{

System.оut.println(ioe.getMessage)));

ioe.printStackTrace();

}

}

}

Классы, которые определяют локализованные ресурсы для других региональных настроек, должны создавать подкласс непосредственно класса ListResourceBundle. В листинге 9.10 показан подкласс, содержащий ресурсы, локализованные под французский язык. Единственное усилие, требующееся для создания этого класса, — это изменение суффикса имени класса и редактирование текстовых строк. За исключением имени и значений атрибутов класс идентичен англоязычной версии.

Если класс определяет другие ресурсы кроме текстовых строк, тогда при создании экземпляра класса должны быть созданы объекты, соответствующие региональной настройке. Последний объект в списке является примером нетекстового ресурса, который инициализируется при создании экземпляра класса. Класс использует статический инициализатор Java для создания экземпляра статических нестроковых объектов при загрузке класса. Наша программа должна использовать статический инициализатор, потому что каждый класс локализованного ресурса создает определяемое региональной настройкой изображение.