compact1, compact2, compact3

java.util

Class Base64.Decoder

java.lang.Object

java.util.Base64.Decoder

Enclosing class:

Base64

public static class Base64.Decoder
extends Object

实现了使用Base64编码方案在RFC 4648和RFC 2045指定的解码器解码字节数据这类。

'=' base64填充字符被解释为编码的字节数据的结束，但不是必需的。如果编码的字节数据只有两个或三个Base64字符最后一单元（没有相应的填充字符（S）填充），他们是解码如果跟着填充字符（S）。如果有一个填充字符在最后一单元，填充字符的正确数（S）必须存在，否则IllegalArgumentException（IOException阅读时从一个base64流被解码）。

对Base64.Decoder类的实例用于多个并发线程是安全的。

除非另有说明，通过null争论这一类的方法会导致一个NullPointerException被。

从以下版本开始：

一点八

另请参见：

Base64.Encoder

方法摘要

Modifier and Type	Method and Description
byte[]	decode(byte[] src) 解码使用编码方案的 Base64输入字节数组的所有字节，写结果到新分配的输出字节数组。
int	decode(byte[] src, byte[] dst) 解码使用编码方案的 Base64输入字节数组的所有字节，写结果到给定的输出字节数组，从偏移0。
ByteBuffer	decode(ByteBuffer buffer) 解码所有字节输入字节缓冲区使用的编码方案的 Base64，写作结果到新分配的ByteBuffer。
byte[]	decode(String src) 解码Base64编码的字符串到新分配的字节数组使用的编码方案的 Base64。
InputStream	wrap(InputStream is) 返回 Base64编码解码字节流的输入流。

Methods inherited from class java.lang.Object

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

方法详细信息

decode

public byte[] decode(byte[] src)

解码使用编码方案的 Base64输入字节数组的所有字节，写结果到新分配的输出字节数组。返回的字节数组是所产生的字节的长度。

参数

src -解码的字节数组

结果

包含已解码字节的新分配的字节数组。

异常

IllegalArgumentException -如果 src不是有效的Base64编码方案

decode

public byte[] decode(String src)

解码Base64编码的字符串到新分配的字节数组使用的编码方案的 Base64。

此方法的调用，调用decode(src.getBytes(StandardCharsets.ISO_8859_1))具有完全相同的效果

参数

src -解码字符串

结果

包含已解码字节的新分配的字节数组。

异常

IllegalArgumentException -如果 src不是有效的Base64编码方案

decode

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

解码使用编码方案的 Base64输入字节数组的所有字节，写结果到给定的输出字节数组，从偏移0。

这是该方法的调用者有责任确保输出的字节数组dst具有从输入字节数组解码所有字节足够的空间。如果输出字节数组不够大，则没有将被写入到输出字节数组的字节。

如果输入字节数组不是有效的Base64编码方案，然后一些字节可能被写入之前输出字节数组时抛出。

参数

src -解码的字节数组

dst -输出的字节数组

结果

写入到输出字节数组的字节数

异常

IllegalArgumentException -如果 src不是有效的Base64格式，或 dst没有足够的空间用于解码的输入字节。

decode

public ByteBuffer decode(ByteBuffer buffer)

解码所有字节输入字节缓冲区使用的编码方案的 Base64，写作结果到新分配的ByteBuffer。

返回后，源缓冲区的位置将被更新到它的极限；它的限制将不会被改变。返回的输出缓冲区的位置将是零，其极限将是产生的解码字节数

IllegalArgumentException如果输入缓冲区不在有效的Base64编码方案抛出。在这种情况下，输入缓冲区的位置将不先进。

参数

buffer -缓冲区来解码

结果

包含已解码字节的新分配的字节缓冲区

异常

IllegalArgumentException -如果 src不是有效的Base64编码方案。

wrap

public InputStream wrap(InputStream is)

返回 Base64编码的字节流解码的输入流。

返回的InputStream的read方法将字节IOException阅读时无法解码。

关闭返回的输入流将关闭底层输入流。

参数

is -输入流

结果

用于指定输入流解码base64编码的字节流