Класс CharsetProvider

java.lang.Object

java.nio.charset.spi.CharsetProvider

public abstract class CharsetProvider extends Object

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

Поставщик кодировки — это конкретный подкласс этого класса, имеющий конструктор без аргументов и некоторое количество связанных классов реализации кодировок. Поставщики кодировок могут быть установлены в экземпляре платформы Java в качестве расширений. Поставщики также могут быть доступны путем добавления их в путь класса аплета или приложения или каким-либо другим способом, специфичным для платформы. Поставщики кодировок находятся с помощью context class loader текущей нити.

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

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

Since:

1.4

См. также:

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

CharsetProvider()

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

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

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

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

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

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

CharsetProvider

protected CharsetProvider()

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

Исключения:: SecurityException - Если установлен менеджер безопасности и он запрещает RuntimePermission("charsetProvider")

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

charsets

public abstract Iterator<Charset> charsets()

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

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

charsetForName

public abstract Charset charsetForName(String charsetName)

Возвращает кодировку для заданного имени кодировки.

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

© 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/nio/charset/spi/CharsetProvider.html