Пакет 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, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/nio/charset/package-summary.html