java.nio.charset.spi

Класс CharsetProvider

java.lang. Объект

java.nio.charset.spi. CharsetProvider

public abstract class CharsetProvider
extends Object

Класс поставщика услуг набора символов.

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

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

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

С тех пор:

1.4

См. Также:

Charset

Сводка конструктора

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

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

Сводка метода

Методы

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

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

CharsetProvider

protected CharsetProvider()

Инициализирует нового провайдера набора символов.

Броски:

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

Деталь метода

наборы символов

public abstract Iterator<Charset> charsets()

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

Возвраты:

Новый iterator

charsetForName

public abstract Charset charsetForName(String charsetName)

Получает набор символов для данного имени набора символов.

Параметры:

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

Возвраты:

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