Класс 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-файле или другом блоке распространения с самим поставщиком. Поставщик должен быть доступен из того же загрузчика классов, который изначально использовался для поиска файла конфигурации; это не обязательно тот загрузчик классов, который загрузил файл.

С:

1.4

См. также:

Charset

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

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, 2021, 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/17/docs/api/java.base/java/nio/charset/spi/CharsetProvider.html