НОУ ИНТУИТ | Программирование на Java. Лекция 14: Пакет java.util

Опубликован: 11.12.2003 | Уровень: специалист | Доступ: свободно

Локализация

Класс Locale

Класс Locale предназначен для отображения определенного региона. Под регионом принято понимать не только географическое положение, но также языковую и культурную среду. Например, помимо того, что указывается страна Швейцария, можно указать также и язык - французский или немецкий.

Определено два варианта конструкторов в классе Locale:

Locale(String language, String country)
Locale(String language, String country, 
       String variant)

Первые два параметра в обоих конструкторах определяют язык и страну, для которой определяется локаль, согласно кодировке ISO. Список поддерживаемых стран и языков можно получить и с помощью вызова статических методов Locale.getISOLanguages() Locale.getISOCountries(), соответственно. Во втором варианте конструктора указан также строковый параметр variant, в котором кодируется информация о платформе. Если здесь необходимо указать дополнительные параметры, то их требуется разделить символом подчеркивания, причем, более важный параметр должен следовать первым.

Пример использования:

Locale l = new Locale("ru","RU");
Locale l = new Locale("en","US","WINDOWS");

Статический метод getDefault() возвращает текущую локаль, сконструированную на основе настроек операционной системы, под управлением которой функционирует JVM.

Для наиболее часто использующихся локалей заданы константы. Например, Locale.US или Locale.GERMAN.

После того как экземпляр класса Locale создан, с помощью различных методов можно получить дополнительную информацию о локали.

public class Test {
   public Test() {
   }
   public static void main(String[] args) {
      Test test = new Test();
      Locale l = Locale.getDefault();
      System.out.println(l.getCountry() + " " + 
         l.getDisplayCountry() + " " + l.getISO3Country());
      System.out.println(l.getLanguage() + " " + 
         l.getDisplayLanguage() + " " + l.getISO3Language());
      System.out.println(l.getVariant() + " " + l.getDisplayVariant());
   l = new Locale("ru","RU","WINDOWS");
      System.out.println(l.getCountry() + " " + 
         l.getDisplayCountry() + " " + l.getISO3Country());
      System.out.println(l.getLanguage() + " " + 
         l.getDisplayLanguage() + " " + l.getISO3Language());
      System.out.println(l.getVariant() + " " + l.getDisplayVariant());
   }
}

Пример 14.26.

Результатом будет:

US United States USA
en English eng

RU Russia RUS
ru Russian rus
WINDOWS WINDOWS

Пример 14.27.

Класс ResourceBundle

Абстрактный класс ResourceBundle предназначен для хранения объектов, специфичных для локали. Например, когда необходимо получить набор строк, зависящих от локали, используют ResourceBundle.

Применение ResourceBundle настоятельно рекомендуется, если предполагается использовать программу в многоязыковой среде. С помощью этого класса легко манипулировать наборами ресурсов, зависящих от локалей, их можно менять, добавлять новые и т.д.

Набор ресурсов - это фактически набор классов, имеющих одно базовое имя. Далее наименование класса дополняется наименованием локали, с которой связывается этот класс. Например, если имя базового класса будет MyResources, то для английской локали имя класса будет MyResources_en, для русской - MyResources_ru. Помимо этого, может добавляться идентификатор языка, если для данного региона определено несколько языков. Например, MyResources_de_CH - так будет выглядеть швейцарский вариант немецкого языка. Кроме того, можно указать дополнительный признак variant (см. описание Locale ). Так, описанный раннее пример для платформы UNIX будет выглядеть следующим образом: MyResources_de_CH_UNIX .

Загрузка объекта для нужной локали производится с помощью статического метода getBundle.:

ResourceBundle myResources = 
   ResourceBundle.getBundle("MyResources", 
                             someLocale);

На основе указанного базового имени (первый параметр), указанной локали (второй параметр) и локали по умолчанию (задается настройками ОС или JVM) генерируется список возможных имен ресурса. Причем, указанная локаль имеет более высокий приоритет, чем локаль по умолчанию. Если обозначить составляющие указанной локали (язык, страна, вариант) как 1, а локали по умолчанию - 2, то список примет следующий вид:

baseclass + "_" + language1 + "_" + country1 + "_" + variant1 
baseclass + "_" + language1 + "_" + country1 + "_" + variant1 + 
   ".properties" 
baseclass + "_" + language1 + "_" + country1 
baseclass + "_" + language1 + "_" + country1 + ".properties" 
baseclass + "_" + language1 
baseclass + "_" + language1 + ".properties" 
baseclass + "_" + language2 + "_" + country2 + "_" + variant2 
baseclass + "_" + language2 + "_" + country2 + "_" + variant2 + 
   ".properties" 
baseclass + "_" + language2 + "_" + country2 
baseclass + "_" + language2 + "_" + country2 + ".properties" 
baseclass + "_" + language2 
baseclass + "_" + language2 + ".properties" 
baseclass 
baseclass + ".properties"

Пример 14.28.

Например, если необходимо найти ResourceBundle для локали fr_CH (Швейцарский французский), а локаль по умолчанию en_US, при этом название базового класса ResourceBundle MyResources, то порядок поиска подходящего ResourceBundle будет таков.

MyResources_fr_CH 
MyResources_fr 
MyResources_en_US 
MyResources_en 
MyResources

Результатом работы getBundle будет загрузка необходимого класса ресурсов в память, однако данные этого класса могут быть сохранены на диске. Таким образом, если нужный класс не будет найден, то к требуемому имени класса будет добавлено расширение ".properties" и будет предпринята попытка найти файл с данными на диске.

Следует помнить, что необходимо указывать полностью квалифицированное имя класса ресурсов, т.е. имя пакета, имя класса. Кроме того, класс ресурсов должен быть доступен в контексте его вызова (там, где вызывается getResourceBundle ), то есть не быть private и т.д.

Всегда должен создаваться базовый класс без суффиксов, т.е. если вы создаете ресурсы с именем MyResource, должен быть в наличии класс MyResource.class.

ResourceBundle хранит объекты в виде пар ключ/значение. Как уже отмечалось ранее, класс ResourceBundle абстрактный, поэтому при его наследовании необходимо переопределить методы:

Enumeration getKeys()
protected Object handleGetObject(String key)

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

Рассмотрим пример использования ResourceBundle:

public class MyResource extends ResourceBundle {

   private Hashtable res = null;
   public MyResource() {
      res = new Hashtable();
      res.put("TestKey","English Variant");
   }
   public Enumeration getKeys() {
      return res.keys();
   }
   protected Object handleGetObject(String key) throws 
   java.util.MissingResourceException {
      return res.get(key);
   }
}
public class MyResource_ru_RU extends ResourceBundle {
   private Hashtable res = null;
   public MyResource_ru_RU() {
      res = new Hashtable();
      res.put("TestKey","Русский вариант");
   }
   public Enumeration getKeys() {
      return res.keys();
   }
   protected Object handleGetObject(String key) 
   throws java.util.MissingResourceException {
      return res.get(key);
   }
}
public class Test {
   public Test() {
   }
   public static void main(String[] args) {
      Test test = new Test();
   ResourceBundle rb = ResourceBundle.getBundle("experiment.MyResource",Locale.getDefault());
   System.out.println(rb.getString("TestKey"));
   rb = ResourceBundle.getBundle("experiment.MyResource", new Locale("ru","RU"));
      System.out.println(rb.getString("TestKey"));
   }
}

Пример 14.29.

Результатом будет:

English Variant
Русский Вариант

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

public interface Behavior {
   public String getBehavior();
   public String getCapital();
   }
public class EnglishBehavior implements Behavior{
   public EnglishBehavior() {
   }
   public String getBehavior(){
      return "English behavior";
   }
   public String getCapital(){
      return "London";
   }
}
public class RussianBehavior implements Behavior {
   public RussianBehavior() {
   }
   public String getBehavior(){
      return "Русский вариант поведения";
   }
   public String getCapital(){
      return "Москва";
   }
}
public class MyResourceBundle_ru_RU extends ResourceBundle {
   Hashtable bundle = null;
   public MyResourceBundle_ru_RU() {
      bundle = new Hashtable();
      bundle.put("Bundle description","Набор ресурсов для русской локали");
      bundle.put("Behavior",new RussianBehavior());
   }
   public Enumeration getKeys() {
      return bundle.keys();
   }
   protected Object handleGetObject(String key) throws 
         java.util.MissingResourceException {
      return bundle.get(key);
   }
}

public class MyResourceBundle_en_EN extends ResourceBundle {
   Hashtable bundle = null;
   public MyResourceBundle_en_EN() {
      bundle = new Hashtable();
      bundle.put("Bundle description","English resource set");
      bundle.put("Behavior",new EnglishBehavior());
   }
   public Enumeration getKeys() {
      return bundle.keys();
   }
   protected Object handleGetObject(String key) throws 
         java.util.MissingResourceException {
      return bundle.get(key);
   }
}
public class MyResourceBundle extends ResourceBundle {
   Hashtable bundle = null;
   public MyResourceBundle() {
      bundle = new Hashtable();
      bundle.put("Bundle description","Default resource bundle");
      bundle.put("Behavior",new EnglishBehavior());
   }
   public Enumeration getKeys() {
      return bundle.keys();
   }
   protected Object handleGetObject(String key) throws 
         java.util.MissingResourceException {
      return bundle.get(key);
   }
}
public class Using {
   public Using() {
   }
   public static void main(String[] args) {
      Using u = new Using();
      ResourceBundle rb = 
      ResourceBundle.getBundle("lecture.MyResourceBundle", Locale.getDefault());
      System.out.println((String)rb.getObject("Bundle description"));
      Behavior be = (Behavior)rb.getObject("Behavior");
      System.out.println(be.getBehavior());
      System.out.println(be.getCapital());
      rb = ResourceBundle.getBundle("lecture.MyResourceBundle", new Locale("en","EN"));
      System.out.println((String)rb.getObject("Bundle description"));
      Behavior be = (Behavior)rb.getObject("Behavior");
      System.out.println(be.getBehavior());
      System.out.println(be.getCapital());
   }

Пример 14.30.

Результатом будет:

Русский набор ресурсов
Русский вариант поведения
Москва
English resource bundle
English behavior
London

Пример 14.31.

Классы ListResourceBundle и PropertiesResourceBundle

У класса ResourceBundle определено два прямых потомка ListResourceBundle и PropertiesResourceBundle. PropertiesResourceBundle хранит набор ресурсов в файле, который представляет собой набор строк.

Алгоритм конструирования объекта, содержащего набор ресурсов, был описан в предыдущем параграфе. Во всех случаях, когда в качестве последнего элемента используется .properties, например, baseclass + "_" + language1 + "_" + country1 + ".properties", речь идет о создании ResourceBundle из файла с наименованием baseclass + "_" + language1 + "_" + country1 и расширением properties. Обычно класс ResourceBundle помещают в пакет resources, а файл свойств - в каталог resources. Тогда для того, чтобы инстанциировать нужный класс, необходимо указать полный путь к этому классу (файлу):

getBundle("resources.MyResource",
          Locale.getDefault());

ListResourceBundle хранит набор ресурсов в виде коллекции и является абстрактным классом. Классы, которые наследуют ListResourceBundle, должны обеспечить:

переопределение метода Object[][] getContents(), который возвращает массив ресурсов;
собственно двумерный массив, содержащий ресурсы.

Рассмотрим пример:

public class MyResource extends ListResourceBundle {
   Vector v = new Vector();
   Object[][] resources = {
   {"StringKey","String"},
   {"DoubleKey",new Double(0.0)},
   {"VectorKey",v},
   };
   public MyResource() {
      super();
      v.add("Element 1");
      v.add("Element 2");
      v.add("Element 3");
   }
   protected Object[][] getContents() {
      return resources;
   }
}
public class Test {
   public Test() {
   }
   public static void main(String[] args) {
      Test test = new Test();
      ResourceBundle rb = ResourceBundle.getBundle("experiment.MyResource",Locale.getDefault());
      Vector v = (Vector)rb.getObject("VectorKey");
      Iterator it = v.iterator();
      while(it.hasNext()) {
         System.out.println(it.next());
      }
   }
}

Пример 14.32.

Результатом будет:

Element 1
Element 2
Element 3

Создание ресурсов для локалей, отличных от локали по умолчанию, осуществляется так же, как было показано для ResourceBundle.

Дальше >>

Авторизоваться

Программирование на Java

Пакет java.util

Локализация

Класс Locale

Класс ResourceBundle

Классы ListResourceBundle и PropertiesResourceBundle

Вопросы и ответы