Класс CharsetProvider

public abstract class CharsetProvider
extends Object

Класс-поставщик сервисов кодировок.

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

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

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

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

CharsetProvider

protected CharsetProvider()

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

Throws:

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

Методы

charsets

public abstract Iterator<Charset> charsets()

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

Возвращает:

Новый итератор

charsetForName

public abstract Charset charsetForName(String charsetName)

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

Параметры:

charsetName - Имя запрашиваемой кодировки; может быть либо каноническим именем, либо псевдонимом

Возвращает:

Объект кодировки для заданной кодировки или null , если заданная кодировка не поддерживается этим поставщиком