Класс CharsetProvider

java.lang.Object

java.nio.charset.spi.CharsetProvider

public abstract class CharsetProvider extends Object

Класс поставщика службы кодировок.

Поставщик кодировок — это конкретный подкласс данного класса с конструктором без аргументов и некоторым количеством связанных классов реализации Charset. Поставщики кодировок развёртываются в пути модулей приложения или пути классов приложения. Чтобы их можно было обнаружить, поставщики кодировок должны быть доступны для system class loader. Дополнительные сведения о развёртывании поставщика кодировок в виде модуля или в пути классов см. в разделе Deploying Service Providers.

Для поставщика кодировок, развёрнутого в модуле, в объявлении модуля необходимо указать директиву provides. Директива provides указывает как службу, так и поставщика службы. В этом случае службой является java.nio.charset.spi.CharsetProvider.

Например, поставщик кодировок, развёрнутый в виде модуля, может содержать следующую директиву:

    provides java.nio.charset.spi.CharsetProvider with com.example.ExternalCharsetProvider;

Поставщик кодировок, развёрнутый в пути классов, идентифицирует себя с помощью файла конфигурации поставщика с именем java.nio.charset.spi.CharsetProvider в каталоге ресурсов META-INF/services. Файл должен содержать список полных имён конкретных классов поставщиков кодировок, по одному на строку. Строка завершается символом перевода строки ('\n'), возврата каретки ('\r') или возврата каретки, за которым непосредственно следует символ перевода строки. Пробелы и символы табуляции вокруг каждого имени, а также пустые строки игнорируются. Символом комментария является '#' ('\u0023'); в каждой строке все символы после первого символа комментария игнорируются. Файл должен быть закодирован в UTF-8.

Если имя конкретного класса поставщика кодировок указано более чем в одном файле конфигурации или указано в одном файле конфигурации несколько раз, дубликаты игнорируются. Файл конфигурации, в котором указано имя конкретного поставщика, не обязательно должен находиться в том же jar-файле или другой единице распространения, что и сам поставщик. Поставщик должен быть доступен из того же загрузчика классов, который первоначально использовался для поиска файла конфигурации; это не обязательно загрузчик классов, загрузивший файл.

С момента выпуска:

1.4

См. также:

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

CharsetProvider()

Модификатор	Конструктор	Описание
`protected`	Инициализирует новый поставщик кодировок.

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

Модификатор и тип	Метод	Описание
`abstract Charset`	`charsetForName(String charsetName)`	Получает кодировку с указанным именем.
`abstract Iterator<Charset>`	`charsets()`	Создаёт итератор для перебора кодировок, поддерживаемых этим поставщиком.

Методы, объявленные в классе 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, либо до истечения заданного периода реального времени.

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

CharsetProvider

protected CharsetProvider()

Инициализирует новый поставщик кодировок.

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

charsets

public abstract Iterator<Charset> charsets()

Создаёт итератор для перебора кодировок, поддерживаемых этим поставщиком. Этот метод используется при реализации метода Charset.availableCharsets.

Возвращает:: Новый итератор

charsetForName

public abstract Charset charsetForName(String charsetName)

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

Параметры:: charsetName - Имя запрошенной кодировки; это может быть каноническое имя или псевдоним
Возвращает:: Объект кодировки с указанным именем или null, если эта кодировка не поддерживается данным поставщиком

© 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.