compact1, compact2, compact3

java.util

Класс Base64. Кодер

java.lang. Объект

java.util. Base64. Кодер

Включение class:

Base64

public static class Base64.Encoder
extends Object

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

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

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

С тех пор:

1.8

См. Также:

Base64.Decoder

Сводка метода

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

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

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

Деталь метода

закодировать

public byte[] encode(byte[] src)

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

Параметры:

src - байтовый массив, чтобы закодировать

Возвраты:

Недавно выделенный байтовый массив, содержащий получающиеся закодированные байты.

закодировать

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

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

Это - ответственность invoker этого метода, чтобы удостовериться выходной байтовый массив 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 закодированные символы

закодировать

public ByteBuffer encode(ByteBuffer buffer)

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

Параметры:

buffer - источник ByteBuffer, чтобы закодировать

Возвраты:

Недавно выделенный буфер байта, содержащий закодированные байты.

закодировать

public int encode(ByteBuffer src,
                  ByteBuffer dst,
                  int bytesOut)

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

Буферы читаются из, и пишутся, запускаясь в их текущих позициях. По возврату буферные позиции ввода и вывода будут усовершенствованы, чтобы отразить чтение байтов и записаны, но их пределы не будут изменены.

Работа кодирования остановится и возвратится, если или все остающиеся байты во входном буфере были закодированы и записаны буферу вывода, или у буфера вывода есть недостаточное пространство, чтобы больше кодировать входные байты. Работа кодирования может продолжаться, если есть больше байтов во входном буфере, который будет закодирован, вызывая этот метод снова с буфером вывода, у которого есть более остающиеся байты. Это обычно делается, истощая любые закодированные байты от буфера вывода. В значении, возвращенном из последнего вызова, нужно передать как третий параметр bytesOut если это должно продолжать незаконченное кодирование, 0 иначе.

Рекомендуемый Пример Использования

    ByteBuffer src = ...;
    ByteBuffer dst = ...;
    Base64.Encoder enc = Base64.getMimeDecoder();

    int bytesOut = 0;
    while (src.hasRemaining()) {
        // clear output buffer for decoding
        dst.clear();
        bytesOut = enc.encode(src, dst, bytesOut);

        // read encoded bytes out of "dst"
        dst.flip();
        ...
    }
 

Параметры:

src - входной байт буферизует, чтобы закодировать

dst - выходной буфер байта

bytesOut - возвращаемое значение последнего вызова, если это должно продолжать незаконченную работу кодирования, 0 иначе

Возвраты:

Суммарный итог bytesOut и число байтов, записанных выводу ByteBuffer во время этого вызова.

обертка

public OutputStream wrap(OutputStream os)

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

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

Параметры:

os - поток вывода.

Возвраты:

поток вывода для того, чтобы закодировать данные байта в указанный Base64 закодированный формат