compact1, compact2, compact3

java.security

Class DigestInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

java.security.DigestInputStream

All Implemented Interfaces:

Closeable， AutoCloseable

public class DigestInputStream
extends FilterInputStream

一个透明的流，它使用通过流的比特来更新相关的消息摘要。

完成消息摘要计算，调用一个在相关消息摘要digest方法在你调用这一消化输入流的read方法。

它可能把这流或关闭（见on）。当它的时候，打电话给一个在消息摘要更新read方法结果。但是当它关闭时，消息摘要未被更新。默认的是要在流上的。

请注意，只有一个消化消化的对象可以计算（见MessageDigest），所以为了计算中间消化，来电者应该保留一个柄上的消化和克隆对象，每个消化来计算的，离开原来的消化不。

另请参见：

MessageDigest， DigestOutputStream

Field Summary

Fields

Modifier and Type	Field and Description
protected MessageDigest	digest 与此流关联的消息摘要。

Fields inherited from class java.io.FilterInputStream

in

构造方法摘要

构造方法

Constructor and Description
DigestInputStream(InputStream stream, MessageDigest digest) 创建一个摘要输入流，使用指定的输入流和消息摘要。

方法摘要

Modifier and Type	Method and Description
MessageDigest	getMessageDigest() 返回与此流关联的消息摘要。
void	on(boolean on) 打开或关闭消化功能。
int	read() 读取一个字节，并更新消息摘要（如果摘要函数是在）。
int	read(byte[] b, int off, int len) 读入一个字节数组，并更新消息摘要（如果摘要函数是在）。
void	setMessageDigest(MessageDigest digest) 将指定的消息摘要与此流关联。
String	toString() 打印此摘要输入流及其相关的消息摘要对象的字符串表示形式。

Methods inherited from class java.io.FilterInputStream

available, close, mark, markSupported, read, reset, skip

Methods inherited from class java.lang.Object

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

Field Detail

digest

protected MessageDigest digest

与此流关联的消息摘要。

Constructor Detail

DigestInputStream

public DigestInputStream(InputStream stream,
                         MessageDigest digest)

创建一个摘要输入流，使用指定的输入流和消息摘要。

参数

stream -输入流。

digest的消息摘要与流关联。

方法详细信息

getMessageDigest

public MessageDigest getMessageDigest()

返回与此流关联的消息摘要。

结果

与此流关联的消息摘要。

另请参见：

setMessageDigest(java.security.MessageDigest)

setMessageDigest

public void setMessageDigest(MessageDigest digest)

将指定的消息摘要与此流关联。

参数

digest -消息摘要是本流相关。

另请参见：

getMessageDigest()

read

public int read()
         throws IOException

读取一个字节，并更新消息摘要（如果摘要函数是在）。也就是说，这种方法从输入流中读取一个字节，阻塞，直到字节实际上是读。如果消化功能是（见 on），该方法将调用的消息摘要与流相关的 update，它传递的字节读。

重写：

read 方法重写，继承类 FilterInputStream

结果

字节读。

异常

IOException如果I/O错误发生。

另请参见：

MessageDigest.update(byte)

read

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

读入一个字节数组，并更新消息摘要（如果摘要函数是在）。即，该方法读取输入流到数组 b到 len字节偏移，开始 off。这种方法块，直到数据实际上是读取。如果消化功能是（见 on），该方法将调用的消息摘要与流相关的 update，传递数据。

重写：

read 方法重写，继承类 FilterInputStream

参数

b -阵列数据读入的。

off -起始偏移为 b数据在哪里应该放。

len -的最大字节数是从输入流中读取到B，起点偏移 off。

结果

读取的实际字节数。这是小于 len如果到达流的末尾读 len字节之前。如果没有读取字节，则返回1，因为当调用调用时，流的结束已经到达了。

异常

IOException如果I/O错误发生。

另请参见：

MessageDigest.update(byte[], int, int)

on

public void on(boolean on)

打开或关闭消化功能。默认是。当它的时候，打电话给一个在消息摘要更新 read方法结果。但是当它关闭时，消息摘要未被更新。

参数

on真把消化功能，虚假的关掉它。

toString

public String toString()

打印此摘要输入流及其相关的消息摘要对象的字符串表示形式。

重写：

toString 方法重写，继承类 Object

结果

对象的字符串表示形式。