Spec-Zone.ru › OpenJDK 21

Пакет java.nio.charset

package java.nio.charset
Определяет наборы символов, декодеры и кодеры для преобразования между байтами и символами Юникода.
Сводка наборов символов, декодеров и кодеров в этом пакете
Имя класса Описание
Charset Именованное отображение между символами и байтами
CharsetDecoder Декодирует байты в символы
CharsetEncoder Кодирует символы в байты
CoderResult Описание результатов кодирования
CodingErrorAction Описание действий, выполняемых при обнаружении ошибок кодирования

Набор символов — это именованное отображение между последовательностями символов Юникода с 16-разрядной кодировкой и последовательностями байтов, в соответствии с определением в RFC 2278. Декодер — это механизм, преобразующий байты в конкретном наборе символов в символы, а кодер — это механизм, преобразующий символы в байты. Кодеры и декодеры работают с буферами байтов и символов. Они совместно называются кодерами.

Класс Charset определяет методы для создания кодеров для заданного набора символов и для получения различных имён, связанных с набором символов. Он также определяет статические методы для проверки поддержки конкретного набора символов, для поиска экземпляров наборов символов по имени и для построения карты, содержащей каждый набор символов, для которого доступна поддержка в текущей виртуальной машине Java.

Большинство пользователей не будут использовать эти классы напрямую; вместо этого они будут использовать существующие конструкторы и методы, связанные с набором символов, в классе String, вместе с существующими классами InputStreamReader и OutputStreamWriter, все реализации которых были переработаны для использования возможностей наборов символов, определённых в этом пакете. Было внесено небольшое количество изменений в классы InputStreamReader и OutputStreamWriter для возможности явного указания объектов наборов символов при создании экземпляров этих классов.

Поддержка новых наборов символов может быть обеспечена через интерфейс, определенный в классе CharsetProvider в пакете java.nio.charset.spi.

Если не указано иное, передача null аргумента конструктору или методу любого класса или интерфейса в этом пакете приведёт к выбрасыванию исключения NullPointerException.

Since:
1.4
Внешние спецификации
  • RFC 2278: Процедуры регистрации наборов символов IANA
Пакет Описание
java.nio
Определяет буферы, которые являются контейнерами для данных, и предоставляет общий обзор других пакетов NIO.
java.nio.charset.spi
Классы поставщиков услуг для пакета java.nio.charset.
java.nio.channels
Определяет каналы, которые представляют подключения к сущностям, способным выполнять операции ввода-вывода, такие как файлы и сокеты; определяет селекторы для операций ввода-вывода с множественным подключением, без блокировки.
java.nio.file
Определяет интерфейсы и классы для доступа виртуальной машины Java к файлам, атрибутам файлов и файловым системам.
Класс Описание
CharacterCodingException
Проверяемое исключение, выбрасываемое при ошибке кодирования или декодирования символов.
Charset
Именованное отображение между последовательностями символов Юникода с 16-разрядной кодировкой и последовательностями байтов.
CharsetDecoder
Механизм, преобразующий последовательность байтов в конкретном наборе символов в последовательность символов Юникода с 16-разрядной кодировкой.
CharsetEncoder
Механизм, преобразующий последовательность символов Юникода с 16-разрядной кодировкой в последовательность байтов в конкретном наборе символов.
CoderMalfunctionError
Ошибка, выбрасываемая, когда метод decodeLoop класса CharsetDecoder или метод encodeLoop класса CharsetEncoder вызывает непредвиденное исключение.
CoderResult
Описание состояния результата работы кодера.
CodingErrorAction
Безопасная по типу перечисление для действий при ошибках кодирования.
IllegalCharsetNameException
Исключение, выбрасываемое без проверки, когда в качестве имени набора символов используется строка, которая не является допустимым именем набора символов.
MalformedInputException
Проверяемое исключение, выбрасываемое при недопустимой последовательности байтов входного потока для заданного набора символов или при недопустимой последовательности символов как 16-разрядной последовательности Юникода.
StandardCharsets
Константные определения для стандартных charsets.
UnmappableCharacterException
Проверяемое исключение, выбрасываемое, когда последовательность входных символов (или байтов) допустима, но не может быть отображена в последовательность выходных байтов (или символов).
UnsupportedCharsetException
Исключение, выбрасываемое без проверки при отсутствии поддержки запрошенного набора символов.

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/charset/package-summary.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API