Пакет 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
- Внешние спецификации
| Класс | Описание |
|---|---|
| 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