JavaTM Platform
Standard Ed. 6

java.security
클래스 DigestOutputStream

java.lang.Object 
  상위를 확장 java.io.OutputStream 
      상위를 확장 java.io.FilterOutputStream 
          상위를 확장 java.security.DigestOutputStream
모든 구현된 인터페이스:
Closeable , Flushable


public class DigestOutputStream
extends FilterOutputStream

스트림을 통과하는 비트를 사용해, 관련한 메세지 다이제스트를 갱신하는 투명한 스트림입니다.

메세지 다이제스트 계산을 완료하려면 , 이 다이제스트 출력 스트림의 write 메소드의 1 개를 호출한 뒤, 관련한 메세지 다이제스트에 대해서 digest 메소드의 1 개를 호출합니다.

이 스트림을 온 또는 오프 할 수가 있습니다 (on 를 참조). 온의 경우,write 의 1 개에 대한 호출은, 메세지 다이제스트를 갱신합니다. 다만, 오프의 경우에는 메세지 다이제스트는 갱신되지 않습니다. 스트림에 대한 디폴트는 온입니다.

관련 항목:
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 를 건네줍니다. 메소드는 그 후, 그 바이트를 출력 스트림에 기입해, 그 바이트의 기입이 완료할 때까지 다음의 기입을 실시하게 하지 않습니다.

오버라이드(override):
클래스 FilterOutputStream 내의 write
파라미터:
b - 출력 스트림의 갱신 및 출력 스트림에의 기입해에 사용하는 바이트
예외:
IOException - 입출력 에러가 발생했을 경우
관련 항목:
MessageDigest.update(byte)

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException 
다이제스트 기능이 온의 경우로 지정된 부분 배열을 사용해, 메세지 다이제스트를 갱신해, 어떠한 경우에서도 그 부분 배열을 출력 스트림에 기입합니다. 즉, 다이제스트 기능이 온 (on 를 참조)의 경우에는, 이 메소드는, 그 스트림에 관련한 메세지 다이제스트에 대해서 update 를 호출해, 지정된 부분 배열을 건네줍니다. 메소드는 그 후, 부분 배열의 바이트군을 출력 스트림에 기입해, 그 바이트군의 기입이 완료할 때까지 다음의 기입을 실시하게 하지 않습니다.

오버라이드(override):
클래스 FilterOutputStream 내의 write
파라미터:
b - 출력 스트림의 갱신 및 출력 스트림에의 기입해에 사용하는 부분 배열을 포함한 배열
off - b 내의, 갱신 및 기입을 실시하는 선두 바이트의 오프셋(offset)
len - 오프셋(offset) off 로부터 개시해,b 로부터 갱신 및 기입을 실시하는 데이터의 바이트수
예외:
IOException - 입출력 에러가 발생했을 경우
관련 항목:
MessageDigest.update(byte[], int, int)

on

public void on(boolean on)
다이제스트 기능을 온 또는 오프로 합니다. 디폴트는 온입니다. 온의 경우,write 의 1 개에 대한 호출은, 메세지 다이제스트를 갱신합니다. 다만, 오프의 경우에는 메세지 다이제스트는 갱신되지 않습니다.

파라미터:
on - 다이제스트 기능을 온으로 하는 경우는 true, 오프로 하는 경우는 false

toString

public String  toString()
이 다이제스트 출력 스트림과 거기에 관련한 메세지 다이제스트 객체의 캐릭터 라인 표현을 출력합니다.

오버라이드(override):
클래스 Object 내의 toString
반환값:
이 객체의 캐릭터 라인 표현

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.