javax.crypto

Class CipherInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

javax.crypto.CipherInputStream

All Implemented Interfaces:

Closeable， AutoCloseable

public class CipherInputStream
extends FilterInputStream

一个cipherinputstream由输入密码，read()方法返回，阅读从底层InputStream但已被密码同时处理的数据。密码必须完全初始化之前被cipherinputstream使用。

例如，如果密码被初始化为解密的cipherinputstream将尝试读取数据和解密，解密后的数据返回之前。

这类坚持严格的语义，特别是失败的语义，其祖先类java.io.filterinputstream和java.io.inputstream。这类有其祖先类的指定方法，并覆盖他们所有的。此外，这个类捕获所有不被它的祖先类抛出的异常。特别是，该skip方法跳过，和available方法只计算所处理的数据包的密码。

对于一个程序员使用这类不使用的方法不定义或修改这个类是至关重要的（如一个新的方法或构造函数是后来加入到一个超类），因为这些方法的设计与实现是不太可能考虑cipherinputstream安全的影响。

从以下版本开始：

一点四

另请参见：

InputStream， FilterInputStream， Cipher， CipherOutputStream

Field Summary

Fields inherited from class java.io.FilterInputStream

in

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	CipherInputStream(InputStream is) 构建一个从InputStream cipherinputstream没有指定一个密码。
	CipherInputStream(InputStream is, Cipher c) 构建从InputStream和密码cipherinputstream。

方法摘要

Modifier and Type	Method and Description
int	available() 返回可以从这个输入流中读取的字节数，而不阻塞。
void	close() 关闭此输入流并释放与流关联的任何系统资源。
boolean	markSupported() 如果输入流的支持 mark和 reset方法，它不。
int	read() 从这个输入流读取下一个数据字节。
int	read(byte[] b) 读到 b.length从输入流到字节数组数据字节。
int	read(byte[] b, int off, int len) 读到 len字节从输入流到字节数组数据。
long	skip(long n) 跳过 n字节的输入可从输入流中读取的字节不阻塞。

Methods inherited from class java.io.FilterInputStream

mark, reset

Methods inherited from class java.lang.Object

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

Constructor Detail

CipherInputStream

public CipherInputStream(InputStream is,
                         Cipher c)

构建从InputStream和密码cipherinputstream。
note：如果指定的输入流或密码为空，一个空指针异常被抛出后，当他们使用。

参数

is -待处理的输入流

c -初始化密码对象

CipherInputStream

protected CipherInputStream(InputStream is)

构建一个从InputStream cipherinputstream没有指定一个密码。这是用nullcipher构建cipherinputstream效果。
note：如果指定的输入流为空，一个空指针异常被抛出后，使用时。

参数

is -待处理的输入流

方法详细信息

read

public int read()
         throws IOException

从这个输入流读取下一个数据字节。字节的值在范围 0一 int到 255返回。如果没有可用的字节，因为已到达流的末尾，则返回值 -1。此方法块，直到输入数据可用，流的结束被检测到，或抛出异常。

重写：

read 方法重写，继承类 FilterInputStream

结果

下一个数据字节，或 -1如果到达流的末尾。

异常

IOException如果I/O错误发生。

从以下版本开始：

jce1.2

另请参见：

FilterInputStream.in

read

public int read(byte[] b)
         throws IOException

读到 b.length字节从输入流到字节数组数据。

对InputStream的read方法调用三参数与参数的方法b，read 0，和b.length。

重写：

read 方法重写，继承类 FilterInputStream

参数

b -缓冲区中读取数据。

结果

读入缓冲的字节总数，或 -1是没有更多的数据，因为已到达流的末尾。

异常

IOException如果I/O错误发生。

从以下版本开始：

jce1.2

另请参见：

InputStream.read(byte[], int, int)

read

public int read(byte[] b,
                int off,
                int len)
         throws IOException

读到 len从输入流到字节数组数据字节。该方法块，直到有一个输入可用。如果第一个参数是 null,到 len字节读入并丢弃。

重写：

read 方法重写，继承类 FilterInputStream

参数

b -缓冲区中读取数据。

off -开始抵消目标数组 buf

len -的最大字节数读。

结果

读入缓冲的字节总数，或 -1如果没有更多的数据，因为已到达流的末尾。

异常

IOException如果I/O错误发生。

从以下版本开始：

jce1.2

另请参见：

InputStream.read()

skip

public long skip(long n)
          throws IOException

跳过 n字节的输入可从输入流中读取的字节不阻塞。

少于请求的字节数可能被跳过。的实际字节数不等于n或打个电话available结果，以较小者为准。如果n小于零，没有字节被跳过。

跳过的字节数实际返回。

重写：

skip 方法重写，继承类 FilterInputStream

参数

n -字节数被跳过。

结果

跳过的实际字节数。

异常

IOException如果I/O错误发生。

从以下版本开始：

jce1.2

available

public int available()
              throws IOException

返回可以从这个输入流中读取的字节数，而不阻塞。对 InputStream返回 0的 available方法。这种方法 应该是由子类重写。

重写：

available 方法重写，继承类 FilterInputStream

结果

可以从这个输入流中读取的字节数，而不阻塞。

异常

IOException如果I/O错误发生。

从以下版本开始：

jce1.2

close

public void close()
           throws IOException

关闭此输入流并释放与流关联的任何系统资源。

对CipherInputStream的close方法调用其数据输入流的close方法。

Specified by:

close 接口 Closeable

Specified by:

close 接口 AutoCloseable

重写：

close 方法重写，继承类 FilterInputStream

异常

IOException如果I/O错误发生。

从以下版本开始：

jce1.2

另请参见：

FilterInputStream.in

markSupported

public boolean markSupported()

如果输入流的支持 mark和 reset方法，它不。

重写：

markSupported 方法重写，继承类 FilterInputStream

结果

false，由于这类不支持 mark和 reset方法。

从以下版本开始：

jce1.2

另请参见：

InputStream.mark(int)， InputStream.reset()