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

字段详细信息

digest

protected MessageDigest digest

与此流相关联的消息摘要。

构造方法详细信息

DigestInputStream

public DigestInputStream(InputStream stream,
                         MessageDigest digest)

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

参数

stream - 输入流。

digest - 与此流 digest的消息摘要。

方法详细信息

getMessageDigest

public MessageDigest getMessageDigest()

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

结果

与此流相关联的消息摘要。

另请参见：

setMessageDigest(java.security.MessageDigest)

setMessageDigest

public void setMessageDigest(MessageDigest digest)

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

参数

digest - 要与此流 digest的消息摘要。

另请参见：

getMessageDigest()

read

public int read()
         throws IOException

读取一个字节，并更新消息摘要（如果摘要功能打开）。 也就是说，该方法从输入流读取一个字节，阻塞直到字节被实际读取。 如果摘要功能打开（参见on ），则此方法将在与此流相关update的消息摘要上调用update ，将其读取字节。

重写：

read在类别 FilterInputStream

结果

字节读取。

异常

IOException - 如果发生I / O错误。

另请参见：

MessageDigest.update(byte)

read

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

读取一个字节数组，并更新消息摘要（如果摘要功能打开）。 也就是说，该方法从输入流读取最多len个字节到数组b ，从偏移off开始。 该方法阻塞，直到数据被实际读取。 如果摘要功能打开（参见on ），则此方法将调用update与此流相关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 - true打开摘要功能，false将其关闭。

toString

public String toString()

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

重写：

toString在类别 Object

结果

对象的字符串表示形式。