Класс AbstractResourceBundleProvider

java.lang.Object

java.util.spi.AbstractResourceBundleProvider

Все реализованные интерфейсы:: ResourceBundleProvider

public abstract class AbstractResourceBundleProvider extends Object implements ResourceBundleProvider

AbstractResourceBundleProvider — это абстрактный класс, предоставляющий базовую поддержку для реализации класса поставщика для ResourceBundleProvider.

Наборы ресурсов могут быть упакованы в одном или нескольких именованных модулях, модулях поставщиков сервисов. Потребитель набора ресурсов — это тот, кто вызывает ResourceBundle.getBundle(String). Для того, чтобы модуль-потребитель загрузил набор ресурсов "com.example.app.MyResources", предоставленный другим модулем, он будет использовать механизм загрузчика сервисов. Необходимо определить интерфейс сервиса с именем "com.example.app.spi.MyResourcesProvider", а модуль поставщика сервиса предоставит класс-реализацию "com.example.app.spi.MyResourcesProvider" следующим образом:

 import com.example.app.spi.MyResourcesProvider;
 class MyResourcesProviderImpl extends AbstractResourceBundleProvider
     implements MyResourcesProvider
 {
     public MyResourcesProviderImpl() {
         super("java.properties");
     }
     // this provider maps the resource bundle to per-language package
     protected String toBundleName(String baseName, Locale locale) {
         return "p." + locale.getLanguage() + "." + baseName;
     }

     public ResourceBundle getBundle(String baseName, Locale locale) {
         // this module only provides bundles in French
         if (locale.equals(Locale.FRENCH)) {
              return super.getBundle(baseName, locale);
         }
         // otherwise return null
         return null;
     }
 }

Обратитесь к ResourceBundleProvider за подробностями.

С:

См. также:

Краткое описание конструкторов

AbstractResourceBundleProvider()

AbstractResourceBundleProvider(String... formats)

Модификатор	Конструктор	Описание
`protected`	Создаёт `AbstractResourceBundleProvider` с форматом "java.properties".
`protected`	Создаёт `AbstractResourceBundleProvider` со специфицированным `formats`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`ResourceBundle`	`getBundle(String baseName, Locale locale)`	Возвращает `ResourceBundle` для заданного `baseName` и `locale`.
`protected String`	`toBundleName(String baseName, Locale locale)`	Возвращает имя набора для заданного `baseName` и `locale`, которое предоставляет этот поставщик.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

AbstractResourceBundleProvider

protected AbstractResourceBundleProvider()

Создаёт AbstractResourceBundleProvider с форматом "java.properties". Этот конструктор эквивалентен AbstractResourceBundleProvider("java.properties").

AbstractResourceBundleProvider

protected AbstractResourceBundleProvider(String... formats)

Создаёт AbstractResourceBundleProvider со специфицированными formats. Метод getBundle(String, Locale) ищет наборы ресурсов для заданного formats. formats должен быть "java.class" или "java.properties".

Параметры:: formats - форматы, используемые для загрузки наборов ресурсов
Исключения:: NullPointerException - если заданный formats равен null; IllegalArgumentException - если заданный formats не равен "java.class" или "java.properties".

Подробное описание методов

toBundleName

protected String toBundleName(String baseName, Locale locale)

Возвращает имя набора для заданного baseName и


 locale

, которое предоставляет этот поставщик.

Примечание API:

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

Например, если baseName — "p.resources.Bundle", то имя набора ресурсов для "p.resources.Bundle" для Locale("ja", "", "XX") и Locale("en") могут быть соответственно "p.resources.ja.Bundle_ja_ _XX" и "p.resources.Bundle_en".

Этот метод вызывается из реализации по умолчанию метода getBundle(String, Locale).

Примечание реализации:

Реализация этого метода по умолчанию такая же, как реализация ResourceBundle.Control.toBundleName(String, Locale).

Параметры:

baseName - базовое имя набора ресурсов, полное имя класса

locale - язык для загрузки набора ресурсов

Возвращает:

имя набора ресурсов

getBundle

public ResourceBundle getBundle(String baseName, Locale locale)

Возвращает ResourceBundle для заданного baseName и locale.

Определено в:: getBundle в интерфейсе ResourceBundleProvider
Примечание реализации:: Реализация этого метода по умолчанию вызывает метод toBundleName, чтобы получить имя набора для baseName и locale, и находит набор ресурсов с именем набора, локальным в модуле этого поставщика. Он будет искать только форматы, указанные при построении этого поставщика.
Параметры:: baseName - базовое имя набора ресурсов, полное имя класса.; locale - язык, для которого должен быть создан набор ресурсов
Возвращает:: ResourceBundle заданного baseName и locale, или null если набор ресурсов не найден
Исключения:: NullPointerException - если baseName или locale равны null; UncheckedIOException - если во время загрузки набора ресурсов произошла любая ошибка ввода-вывода

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/spi/AbstractResourceBundleProvider.html