compact1, compact2, compact3

java.util

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

java.lang. Объект

java.util. Base64. Декодер

Включение class:

Base64

public static class Base64.Decoder
extends Object

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

Дополнительный символ Base64 '=' принимается и интерпретируется как конец закодированных данных байта, но не требуется. Так, если у заключительного модуля закодированных данных байта только есть два или три символа Base64 (без соответствующего дополнительного дополненного символа (ов)), они декодируются как будто сопровождаемый, дополняя символ (ы). Если там дополняет символ, существующий в заключительном модуле, корректное число дополнения символа (ов) должно присутствовать, иначе IllegalArgumentException ( IOException читая из потока Base64), бросается во время декодирования.

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

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

С тех пор:

1.8

См. Также:

Base64.Encoder

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

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

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

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

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

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

public byte[] decode(byte[] src)

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

Параметры:

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

Возвраты:

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

Броски:

IllegalArgumentException - если src не находится в допустимой схеме Base64

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

public byte[] decode(String src)

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

Вызов этого метода имеет точно тот же самый эффект как вызов decode(src.getBytes(StandardCharsets.ISO_8859_1))

Параметры:

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

Возвраты:

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

Броски:

IllegalArgumentException - если src не находится в допустимой схеме Base64

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

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

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

Это - ответственность invoker этого метода, чтобы удостовериться выходной байтовый массив dst имеет достаточно пространства для того, чтобы декодировать все байты от входного байтового массива. Никакие байты не будут быть записанными выходному байтовому массиву, если выходной байтовый массив не будет достаточно большим.

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

Параметры:

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

dst - выходной байтовый массив

Возвраты:

Число байтов, записанных выходному байтовому массиву

Броски:

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

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

public ByteBuffer decode(ByteBuffer buffer)

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

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

Параметры:

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

Возвраты:

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

Броски:

IllegalArgumentException - если src не находится в допустимой схеме Base64.

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

public int decode(ByteBuffer src,
                  ByteBuffer dst)

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

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

Если входной буфер не находится в допустимой схеме кодирования Base64 тогда, некоторые байты, возможно, были записаны буферу вывода прежде, чем IllegalArgumentException будет брошен. Позиции обоих буферов ввода и вывода не будут усовершенствованы в этом случае.

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

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

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

    ByteBuffer src = ...;
    ByteBuffer dst = ...;
    Base64.Decoder dec = Base64.getDecoder();

    while (src.hasRemaining()) {

        // prepare the output byte buffer
        dst.clear();
        dec.decode(src, dst);

        // read bytes from the output buffer
        dst.flip();
        ...
    }
 

Параметры:

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

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

Возвраты:

Число байтов, записанных выходному байту, буферизует во время этого вызова декодирования

Броски:

IllegalArgumentException - если src не находится в допустимой схеме Base64.

обертка

public InputStream wrap(InputStream is)

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

read методы возвращенного InputStream бросит IOException читая байты, которые не могут декодироваться.

Закрытие возвращенного входного потока закроет базовый входной поток.

Параметры:

is - входной поток

Возвраты:

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