Класс Base64.Encoder
- Вложенный класс:
Base64
public static class Base64.Encoder extends Object
Экземпляры класса Base64.Encoder безопасны для одновременного использования несколькими потоками.
Если не указано иное, передача null аргумента методу этого класса вызовет исключение NullPointerException.
Если закодированный выходной массив байтов необходимого размера не может быть выделен, методы кодирования этого класса вызовут исключение OutOfMemoryError.
- С момента:
- 1.8
- См. также:
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
byte[] |
encode |
Кодирует все байты из указанного массива байтов в новый выделенный массив байтов, используя схему кодирования Base64. |
int |
encode |
Кодирует все байты из указанного массива байтов, используя схему кодирования Base64, записывая результирующие байты в заданный массив байтов, начиная с смещения 0. |
ByteBuffer |
encode |
Кодирует все оставшиеся байты из указанного буфера байтов в новый выделенный ByteBuffer, используя схему кодирования Base64. |
String |
encodeToString |
Кодирует указанный массив байтов в строку, используя схему кодирования Base64. |
Base64.Encoder |
withoutPadding() |
Возвращает экземпляр кодировщика, который кодирует эквивалентно этому, но без добавления символа заполнения в конце закодированных данных байтов. |
OutputStream |
wrap |
Оборачивает потоковое устройство вывода для кодирования данных байтов, используя схему кодирования Base64. |
Подробное описание методов
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)
Base64. По завершении, позиция исходного буфера будет обновлена до его предела; его предел не будет изменен. Позиция возвращаемого буфера вывода будет равна нулю, а его предел — количеству результирующих закодированных байтов.- Параметры:
-
buffer- исходный буфер ByteBuffer для кодирования - Возвращает:
- Новый выделенный буфер байтов, содержащий закодированные байты.
wrap
public OutputStream wrap(OutputStream os)
Base64. Рекомендуется немедленно закрыть возвращаемое потоковое устройство вывода после использования, при этом оно будет записывать все возможные оставшиеся байты в базовое потоковое устройство вывода. Закрытие возвращаемого потокового устройства вывода закроет базовое потоковое устройство вывода.
- Параметры:
-
os- потоковое устройство вывода. - Возвращает:
- потоковое устройство вывода для кодирования данных байтов в указанный формат, закодированный в Base64
withoutPadding
public Base64.Encoder withoutPadding()
Схема кодирования этого экземпляра кодировщика не изменяется при этом вызове. Возвращаемый экземпляр кодировщика должен использоваться для операций кодирования без заполнения.
- Возвращает:
- эквивалентный кодировщик, который кодирует без добавления символа заполнения в конце
© 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/util/Base64.Encoder.html