Класс Base64.Encoder

java.lang.Object

java.util.Base64.Encoder

Включающий класс:: Base64

public static class Base64.Encoder extends Object

Этот класс реализует кодировщик для кодирования данных байтов с использованием схемы кодирования Base64, как указано в RFC 4648 и RFC 2045.

Экземпляры класса Base64.Encoder безопасны для использования несколькими параллельными потоками.

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

Если не удаётся выделить необходимый массив байтов для закодированного результата, методы кодирования этого класса вызовут исключение OutOfMemoryError.

С:

1.8

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`byte[]`	`encode(byte[] src)`	Кодирует все байты из указанного массива байтов в новый массив байтов, используя схему кодирования `Base64`.
`int`	`encode(byte[] src, byte[] dst)`	Кодирует все байты из указанного массива байтов, используя схему кодирования `Base64`, записывая результирующие байты в заданный массив байтов, начиная с смещения 0.
`ByteBuffer`	`encode(ByteBuffer buffer)`	Кодирует все оставшиеся байты из указанного буфера байтов в новый буфер ByteBuffer, используя схему кодирования `Base64`.
`String`	`encodeToString(byte[] src)`	Кодирует указанный массив байтов в строку, используя схему кодирования `Base64`.
`Base64.Encoder`	`withoutPadding()`	Возвращает экземпляр кодировщика, который кодирует эквивалентно данному, но без добавления символов заполнения в конце закодированных данных байтов.
`OutputStream`	`wrap(OutputStream os)`	Оборачивает поток вывода для кодирования данных байтов, используя схему кодирования `Base64`.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание методов

encode

public byte[] encode(byte[] src)

Кодирует все байты из указанного массива байтов в новый массив байтов, используя схему кодирования Base64. Возвращаемый массив байтов имеет длину, соответствующую количеству закодированных байтов.

Параметры:: src - массив байтов для кодирования
Возвращает:: Новый массив байтов, содержащий закодированные байты.

encode

public int encode(byte[] src, byte[] dst)

Кодирует все байты из указанного массива байтов, используя схему кодирования Base64, записывая результирующие байты в заданный массив байтов, начиная с смещения 0.

Ответственность вызывающего метод лежит в обеспечении того, что массив байтов вывода dst имеет достаточный размер для кодирования всех байтов из входного массива. Если массив вывода недостаточно велик, байты не будут записаны.

Параметры:: src - массив байтов для кодирования; dst - массив байтов вывода
Возвращает:: Количество байтов, записанных в массив вывода
Исключения:: IllegalArgumentException - если dst не имеет достаточного размера для кодирования всех входных байтов.

encodeToString

public String encodeToString(byte[] src)

Кодирует указанный массив байтов в строку, используя схему кодирования Base64.

Этот метод сначала кодирует все входные байты в массив байтов Base64, а затем создаёт новую строку, используя закодированный массив байтов и кодировку ISO-8859-1.

Другими словами, вызов этого метода имеет точно такой же эффект, как вызов new String(encode(src), StandardCharsets.ISO_8859_1).

Параметры:: src - массив байтов для кодирования
Возвращает:: Строка, содержащая закодированные символы Base64

encode

public ByteBuffer encode(ByteBuffer buffer)

Кодирует все оставшиеся байты из указанного буфера байтов в новый буфер ByteBuffer, используя схему кодирования Base64. После возвращения, позиция буфера-источника будет обновлена до его предела; его предел не будет изменён. Позиция возвращаемого буфера вывода будет нулевой, а его предел будет равен количеству закодированных байтов.

Параметры:: buffer - исходный буфер ByteBuffer для кодирования
Возвращает:: Новый буфер байтов, содержащий закодированные байты.

wrap

public OutputStream wrap(OutputStream os)

Оборачивает поток вывода для кодирования данных байтов, используя схему кодирования Base64.

Рекомендуется немедленно закрыть возвращаемый поток вывода после использования, при этом он осуществит сброс всех оставшихся байтов в базовый поток вывода. Закрытие возвращаемого потока вывода закроет базовый поток вывода.

Параметры:: os - поток вывода.
Возвращает:: поток вывода для кодирования данных байтов в указанный Base64 формат

withoutPadding

public Base64.Encoder withoutPadding()

Возвращает экземпляр кодировщика, который кодирует эквивалентно данному, но без добавления символов заполнения в конце закодированных данных байтов.

Схема кодирования этого экземпляра кодировщика не изменяется этим вызовом. Возвращаемый экземпляр кодировщика должен использоваться для операций кодирования без заполнения.

Возвращает:: эквивалентный кодировщик, который кодирует без добавления символов заполнения в конце

© 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/util/Base64.Encoder.html