Класс 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.

С тех пор:: 1.8
См. также:: Base64.Decoder

Методы

Модификатор и тип	Метод и описание
`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, 2020, 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.