Класс 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

Конструкторы

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

Методы

Модификатор и тип	Метод	Описание
`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 если кодировка с заданным именем не поддерживается этим поставщиком