类 java.security.DigestOutputStream

java.lang.Object
   |
   +----java.io.OutputStream
           |
           +----java.io.FilterOutputStream
                   |
                   +----java.security.DigestOutputStream

public class DigestOutputStream

extends FilterOutputStream

一个透明的流，它用经过这个流的比特修改与之相链的消息摘要。

为了完成消息摘要的计算，在调用该摘要的输出流的一个 write 方法之后，调用一个与该摘要相联的 digest 方法。

可以打开或关闭这个流 (参见 on)。当它打开时，调用 write 将得到更新信息摘要。但当它关闭时，不更新消息摘要。流的缺省状态是打开。

参见：

MessageDigest, DigestInputStream

变量索引

digest

与这个流相联的消息摘要。

构造子索引

DigestOutputStream(OutputStream, MessageDigest)

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

方法索引

getMessageDigest()

返回与这个流相联的消息摘要。

on(boolean)

启动或禁止这个摘要功能。

setMessageDigest(MessageDigest)

将指定的消息摘要与这个流相联。

toString()

打印该摘要输出流和与之相联的消息摘要对象的字符串表示。

write(byte[], int, int)

使用指定的子数组修改消息摘要 ( 如果启动该摘要功能 )，并且在任何情况下都把子数组写到输出流中。

write(int)

使用指定的字节修改消息摘要 ( 如果启动该摘要功能 )，并且在任何情况下都把字节写到输出流中。

变量

 protected MessageDigest digest

与这个流相联的消息摘要。

构造子

 public DigestOutputStream(OutputStream stream,
                           MessageDigest digest)

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

参数：

tream - 输出流。

digest - 与这个流相联的消息摘要。

方法

 public MessageDigest getMessageDigest()

返回与这个流相联的消息摘要。

返回值：

与这个流相联的消息摘要。

 public void setMessageDigest(MessageDigest digest)

将指定的消息摘要与这个流相联。

参数：

digest - 与这个流相联的消息摘要。

 public void write(int b) throws IOException

使用指定的字节修改消息摘要 ( 如果启动该摘要功能 )，并且在任何情况下都把字节写到输出流中。 即，如果启动了摘要功能 ( 参见 on)，该方法调用与这个流相联的消息摘要的 update，并将字节 b 传给它。然后这个方法把字节写到输出流中，在写完之前它将阻塞等待。

参数：

b - 用于修改并写到输出流中的字节。

抛出： IOException

如果发生一个 I/O 错误。

覆盖：

类 FilterOutputStream 中的 write

参见：

update

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

使用指定的子数组修改消息摘要 ( 如果启动该摘要功能 )，并且在任何情况下都把子数组写到输出流中。 即，如果启动摘要功能 ( 参见 on)，该方法调用与这个流相联的消息摘要的 update，并将子数组规格传给它。 然后该方法把子数组的字节写到输出流中，在实际写完之前将阻塞。

参数：

b - 包含用于修改并写到输出流中的子数组的数组。

off - 数组 b 第一个要修改并写出的字节的偏移量。

len - 数组 b 中，从偏移量 off 开始的要修改和写出的数据的最大字节数。

抛出： IOException

如果发生一个 I/O 错误。

覆盖：

类 FilterOutputStream 中的 write

参见：

update

 public void on(boolean on)

启动或禁止这个摘要功能。 缺省状态为启动。当启动它时，调用 write 将得到更新的信息摘要。 但当禁止它时，不更新消息摘要。

参数：

on - 如果为 true 则启动给摘要功能，如果为 false 则禁止它。

 public String toString()

打印该摘要输出流和与之相联的消息摘要对象的字符串表示。

覆盖：

类 Object 中的 toString