java.security
類別 DigestOutputStream

java.lang.Object
  java.io.OutputStream
      java.io.FilterOutputStream
          java.security.DigestOutputStream

所有已實作的介面：

Closeable, Flushable

public class DigestOutputStream
extends FilterOutputStream

使用通過串流的位更新關聯訊息摘要的透明串流。

要完成訊息摘要計算，先要調用此摘要輸出串流的一個 write 方法，之後在關聯的訊息摘要上調用 digest 方法之一。

開啟或關閉此串流都是可能的（參見 on）。開啟時，調用 write 方法之一將導致訊息摘要的更新。但是關閉時，不更新訊息摘要。串流在預設情況下是開啟的。

另請參見：

MessageDigest, DigestInputStream

欄位摘要

protected MessageDigest

digest 與此串流關聯的訊息摘要。

從類別 java.io.FilterOutputStream 繼承的欄位

out

建構子摘要

DigestOutputStream(OutputStream stream, MessageDigest digest)
使用指定的輸出串流和訊息摘要創建一個摘要輸出串流。

方法摘要

MessageDigest	getMessageDigest() 返回與此串流關聯的訊息摘要。
void	on(boolean on) 開啟或關閉摘要功能。
void	setMessageDigest(MessageDigest digest) 將指定的訊息摘要與此串流相關聯。
String	toString() 列印此摘要輸出串流及其關聯的訊息摘要物件的字元串表示形式。
void	write(byte[] b, int off, int len) 使用指定的子陣列更新訊息摘要（如果開啟了摘要功能），並將子陣列寫入輸出串流（不管是否開啟了摘要功能）。
void	write(int b) 使用指定的位元組更新訊息摘要（如果開啟了摘要功能），並將位元組寫入輸出串流（不管是否開啟了摘要功能）。

從類別 java.io.FilterOutputStream 繼承的方法

close, flush, write

從類別 java.lang.Object 繼承的方法

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

欄位詳細資訊

digest

protected MessageDigest digest

與此串流關聯的訊息摘要。

建構子詳細資訊

DigestOutputStream

public DigestOutputStream(OutputStream stream,
                          MessageDigest digest)

使用指定的輸出串流和訊息摘要創建一個摘要輸出串流。

參數：

stream - 輸出串流。

digest - 要與此串流關聯的訊息摘要。

方法詳細資訊

getMessageDigest

public MessageDigest getMessageDigest()

返回與此串流關聯的訊息摘要。

返回：

與此串流關聯的訊息摘要。

另請參見：

setMessageDigest(java.security.MessageDigest)

setMessageDigest

public void setMessageDigest(MessageDigest digest)

將指定的訊息摘要與此串流相關聯。

參數：

digest - 要與此串流關聯的訊息摘要。

另請參見：

getMessageDigest()

write

public void write(int b)
           throws IOException

使用指定的位元組更新訊息摘要（如果開啟了摘要功能），並將位元組寫入輸出串流（不管是否開啟了摘要功能）。即如果開啟摘要功能（參見 on），則此方法將在與此串流關聯的訊息摘要上調用 update，將位元組 b 傳遞給該方法。然後，此方法將位元組寫入輸出串流，在實際寫入位元組前一直為阻塞狀態。

覆寫：

類別 FilterOutputStream 中的 write

參數：

b - 要用於更新和寫入輸出串流的位元組。

拋出：

IOException - 如果發生 I/O 錯誤。

另請參見：

MessageDigest.update(byte)

write

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

使用指定的子陣列更新訊息摘要（如果開啟了摘要功能），並將子陣列寫入輸出串流（不管是否開啟了摘要功能）。即如果開啟摘要功能（參見 on），則此方法將在與此串流關聯的訊息摘要上調用 update，將子陣列規範傳遞給該方法。然後，此方法將子陣列位元組寫入輸出串流，在實際寫入位元組前一直為阻塞狀態。

覆寫：

類別 FilterOutputStream 中的 write

參數：

b - 要用於更新和寫入輸出串流的套件含子陣列的陣列。

off - 要更新和寫入的第一個位元組在 b 中的偏移量。

len - 要根據 b 更新和寫入的資料的位元組數，從偏移量 off 開始。

拋出：

IOException - 如果發生 I/O 錯誤。

另請參見：

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

on

public void on(boolean on)

開啟或關閉摘要功能。預設為開啟。開啟時，調用 write 方法之一將導致訊息摘要的更新。但是關閉時，不更新訊息摘要。

參數：

on - 為 true 表示開啟摘要功能，為 false 表示關閉。

toString

public String toString()

列印此摘要輸出串流及其關聯的訊息摘要物件的字元串表示形式。

覆寫：

類別 Object 中的 toString

返回：

該物件的字元串表示形式。