Класс ListResourceBundle

java.lang.Object

java.util.ResourceBundle

java.util.ListResourceBundle

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

public abstract class ListResourceBundle extends ResourceBundle

ListResourceBundle — абстрактный подкласс ResourceBundle, который управляет ресурсами для локали в удобном и простом в использовании списке. Дополнительные сведения о пакетах ресурсов в целом см. в ResourceBundle.

Подклассы должны переопределить getContents и предоставить массив, каждый элемент которого является парой объектов. Первый элемент каждой пары — ключ, который должен быть String, а второй элемент — значение, связанное с этим ключом.

В следующем примере показаны два элемента семейства пакетов ресурсов с базовым именем "MyResources". "MyResources" — элемент семейства пакетов по умолчанию, а "MyResources_fr" — французский элемент. Эти элементы основаны на ListResourceBundle (в связанном примере показано, как добавить в это семейство пакет на основе файла свойств). Ключи в этом примере имеют вид "s1" и т. д. Вы можете выбрать любые ключи, если они совпадают с ключами, которые использует ваша программа для получения объектов из пакета. Ключи чувствительны к регистру.


public class MyResources extends ListResourceBundle {
    protected Object[][] getContents() {
        return new Object[][] {
        // LOCALIZE THIS
            {"s1", "The disk \"{1}\" contains {0}."},  // MessageFormat pattern
            {"s2", "1"},                               // location of {0} in pattern
            {"s3", "My Disk"},                         // sample disk name
            {"s4", "no files"},                        // first ChoiceFormat choice
            {"s5", "one file"},                        // second ChoiceFormat choice
            {"s6", "{0,number} files"},                // third ChoiceFormat choice
            {"s7", "3 Mar 96"},                        // sample date
            {"s8", new Dimension(1,5)}                 // real object, not just string
        // END OF MATERIAL TO LOCALIZE
        };
    }
}

public class MyResources_fr extends ListResourceBundle {
    protected Object[][] getContents() {
        return new Object[][] {
        // LOCALIZE THIS
            {"s1", "Le disque \"{1}\" {0}."},          // MessageFormat pattern
            {"s2", "1"},                               // location of {0} in pattern
            {"s3", "Mon disque"},                      // sample disk name
            {"s4", "ne contient pas de fichiers"},     // first ChoiceFormat choice
            {"s5", "contient un fichier"},             // second ChoiceFormat choice
            {"s6", "contient {0,number} fichiers"},    // third ChoiceFormat choice
            {"s7", "3 mars 1996"},                     // sample date
            {"s8", new Dimension(1,3)}                 // real object, not just string
        // END OF MATERIAL TO LOCALIZE
        };
    }
}

Реализация подкласса ListResourceBundle должна быть потокобезопасной, если он одновременно используется несколькими потоками. Реализации методов этого класса по умолчанию потокобезопасны.

С версии:

1.1

См. также:

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в классе ResourceBundle

ResourceBundle.Control

Модификатор и тип	Класс	Описание
`static class`	`ResourceBundle.Control`	`ResourceBundle.Control` определяет набор методов обратного вызова, которые вызываются фабричными методами `ResourceBundle.getBundle` в процессе загрузки пакета.

Краткое описание полей

Поля, объявленные в классе ResourceBundle

parent

Модификатор и тип	Поле	Описание
`protected ResourceBundle`	`parent`	Родительский пакет этого пакета.

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

Конструктор	Описание
`ListResourceBundle()`	Единственный конструктор.

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

Модификатор и тип	Метод	Описание
`protected abstract Object[][]`	`getContents()`	Возвращает массив, каждый элемент которого является парой объектов в массиве `Object`.
`Enumeration<String>`	`getKeys()`	Возвращает `Enumeration` ключей, содержащихся в этом `ResourceBundle` и его родительских пакетах.
`final Object`	`handleGetObject(String key)`	Получает объект по указанному ключу из этого пакета ресурсов.
`protected Set<String>`	`handleKeySet()`	Возвращает `Set` ключей, содержащихся только в этом `ResourceBundle`.

Методы, объявленные в классе ResourceBundle

clearCache, clearCache, containsKey, getBaseBundleName, getBundle, getBundle, getBundle, getBundle, getBundle, getBundle, getBundle, getBundle, getLocale, getObject, getString, getStringArray, keySet, setParent

Модификатор и тип	Метод	Описание
`static final void`	`clearCache()`	Удаляет из кэша все пакеты ресурсов, загруженные модулем вызывающего кода.
`static final void`	`clearCache(ClassLoader loader)`	Удаляет из кэша все пакеты ресурсов, загруженные указанным загрузчиком классов.
`boolean`	`containsKey(String key)`	Определяет, содержится ли указанный `key` в этом `ResourceBundle` или его родительских пакетах.
`String`	`getBaseBundleName()`	Возвращает базовое имя этого пакета, если оно известно, или `null`, если оно неизвестно.
`static final ResourceBundle`	`getBundle(String baseName)`	Получает пакет ресурсов с указанным базовым именем, локалью по умолчанию и модулем вызывающего кода.
`static ResourceBundle`	`getBundle(String baseName, Module module)`	Получает пакет ресурсов с указанным базовым именем и локалью по умолчанию от имени указанного модуля.
`static final ResourceBundle`	`getBundle(String baseName, Locale locale)`	Получает пакет ресурсов с указанными базовым именем и локалью, а также модулем вызывающего кода.
`static ResourceBundle`	`getBundle(String baseName, Locale locale, ClassLoader loader)`	Получает пакет ресурсов с указанными базовым именем, локалью и загрузчиком классов.
`static ResourceBundle`	`getBundle(String baseName, Locale targetLocale, ClassLoader loader, ResourceBundle.Control control)`	Возвращает пакет ресурсов с указанными базовым именем, целевой локалью, загрузчиком классов и объектом управления.
`static ResourceBundle`	`getBundle(String baseName, Locale targetLocale, Module module)`	Получает пакет ресурсов с указанными базовым именем и локалью от имени указанного модуля.
`static final ResourceBundle`	`getBundle(String baseName, Locale targetLocale, ResourceBundle.Control control)`	Возвращает пакет ресурсов с указанными базовым именем, целевой локалью и объектом управления, используя загрузчик классов вызывающего кода.
`static final ResourceBundle`	`getBundle(String baseName, ResourceBundle.Control control)`	Возвращает пакет ресурсов с указанными базовым именем, локалью по умолчанию и объектом управления.
`Locale`	`getLocale()`	Возвращает локаль этого пакета ресурсов.
`final Object`	`getObject(String key)`	Получает объект по указанному ключу из этого пакета ресурсов или одного из его родительских пакетов.
`final String`	`getString(String key)`	Получает строку по указанному ключу из этого пакета ресурсов или одного из его родительских пакетов.
`final String[]`	`getStringArray(String key)`	Получает массив строк по указанному ключу из этого пакета ресурсов или одного из его родительских пакетов.
`Set<String>`	`keySet()`	Возвращает `Set` всех ключей, содержащихся в этом `ResourceBundle` и его родительских пакетах.
`protected void`	`setParent(ResourceBundle parent)`	Устанавливает родительский пакет этого пакета.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарел, подлежит удалению: этот элемент API может быть удален в будущей версии. Метод завершения устарел и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода для этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения определенного периода реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения определенного периода реального времени.

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

ListResourceBundle

public ListResourceBundle()

Единственный конструктор. (Вызывается конструкторами подклассов, обычно неявно.)

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

handleGetObject

public final Object handleGetObject(String key)

Описание скопировано из класса: ResourceBundle

Получает объект по указанному ключу из этого пакета ресурсов. Возвращает null, если этот пакет ресурсов не содержит объекта с указанным ключом.

Определено в:: handleGetObject в классе ResourceBundle
Параметры:: key — ключ требуемого объекта
Возвращает:: объект для указанного ключа или null

getKeys

public Enumeration<String> getKeys()

Возвращает Enumeration ключей, содержащихся в этом ResourceBundle и его родительских пакетах.

Определено в:

getKeys в классе ResourceBundle

Возвращает:

Enumeration ключей, содержащихся в этом ResourceBundle и его родительских пакетах.

См. также:

handleKeySet

protected Set<String> handleKeySet()

Возвращает Set ключей, содержащихся только в этом ResourceBundle.

Переопределяет:

handleKeySet в классе ResourceBundle

Возвращает:

Set ключей, содержащихся только в этом ResourceBundle

С версии:

1.6

См. также:

getContents

protected abstract Object[][] getContents()

Возвращает массив, каждый элемент которого является парой объектов в массиве Object. Первый элемент каждой пары — ключ, который должен быть String, а второй элемент — значение, связанное с этим ключом. Подробности см. в описании класса.

Возвращает:: массив с Object, представляющим пару «ключ-значение».

© 1993, 2025, 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.