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