Класс CharsetProvider

Поставщик кодировок символов — это конкретный подкласс данного класса с конструктором без аргументов и некоторым количеством связанных классов реализации Charset. Поставщики кодировок символов развёртываются в пути модулей приложения или в пути классов приложения. Чтобы поставщики кодировок символов можно было найти, они должны быть доступны для system class loader. Дополнительные сведения о развёртывании поставщика кодировок символов в виде модуля или в пути классов см. в разделе Deploying Service Providers.

Для поставщика кодировок символов, развёрнутого в модуле, в объявлении модуля необходимо указать директиву provides. Директива provides указывает как службу, так и поставщика службы. В этом случае службой является java.nio.charset.spi.CharsetProvider.

Например, поставщик кодировок символов, развёрнутый в виде модуля, может содержать следующую директиву:

    provides java.nio.charset.spi.CharsetProvider with com.example.ExternalCharsetProvider;

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

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