javax.crypto
클래스 CipherOutputStream

java.lang.Object 
  java.io.OutputStream 
      java.io.FilterOutputStream 
          javax.crypto.CipherOutputStream

모든 구현된 인터페이스:

Closeable, Flushable

public class CipherOutputStream
extends FilterOutputStream 

CipherOutputStream는 OutputStream와 Cipher 로 구성되어 있으므로 write() 메서드는 우선 데이터를 처리하고 나서 기본이 되는 OutputStream에 출력합니다. Cipher는 완전하게 초기화하지 않으면, CipherOutputStream 로 사용할 수 없습니다.

예를 들어 Cipher가 암호화용으로 초기화되고 있으면, CipherOutputStream는 암호화된 데이터를 출력하기 전에 데이터를 암호화하려고 합니다.

이 클래스는 상위 클래스 java.io.OutputStream 및 java.io.FilterOutputStream 시멘틱스, 특히 실패 시멘틱스에 엄밀하게 따릅니다. 이 클래스에서는 그러한 메서드는 상위 클래스에서 엄밀하게 지정되고 있어 모두 오버라이드(override) 됩니다. 게다가 이 클래스는 상위 클래스에서 Throw 되지 않는 모든 예외를 캐치 합니다.

이 클래스를 사용하는 프로그래머는 이 클래스에서 정의되어 있지 않은 메서드, 또는 오버라이드(override)되어 있지 않은 메서드 (새로운 메서드나, 나중에 슈퍼 클래스의 1개에 추가되는 생성자 등)를 절대로 사용하지 말아 주세요. 그러한 메서드의 설계와 구현에서는 CipherOutputStream에 관한 보안상의 영향이 고려되어 있지 않을 가능성이 있기 때문에입니다.

도입된 버전 :

1.4

관련 항목:

OutputStream, FilterOutputStream, Cipher, CipherInputStream

필드 개요

클래스 java.io. FilterOutputStream 로부터 상속된 필드

out

생성자 개요

protected	CipherOutputStream (OutputStream os) OutputStream 로부터 Cipher를 지정하지 않고 CipherOutputStream를 구축합니다.
	CipherOutputStream (OutputStream os, Cipher c) OutputStream 및 Cipher 로부터 CipherOutputStream를 구축합니다.

메서드 개요

void	close () 출력 스트림을 닫아 이 스트림에 관련된 모든 system resource를 해방합니다.
void	flush () 캡슐화된 암호 객체에 의해 이미 처리된, 버퍼에 포함된 출력 바이트를 강제적으로 써내, 이 출력 스트림을 플래시 합니다.
void	write (byte[] b) 지정된 바이트 배열의 b.length 바이트를 이 출력 스트림에 출력합니다.
void	write (byte[] b, int off, int len) 지정된 바이트 배열의, 오프셋(offset) 위치 off로 부터 시작되는 len 바이트를 이 출력 스트림에 출력합니다.
void	write (int b) 지정된 바이트를 이 출력 스트림에 출력합니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

생성자 상세

CipherOutputStream

public CipherOutputStream(OutputStream  os,
                          Cipher  c)

OutputStream 및 Cipher 로부터 CipherOutputStream를 구축합니다.
주: 지정된 출력 스트림 또는 암호가 null인 경우, 나중에 이것들을 사용할 경우에 NullPointerException가 발생되는 일이 있습니다.

파라미터:

os - OutputStream 객체

c - 초기화된 Cipher 객체

CipherOutputStream

protected CipherOutputStream(OutputStream  os)

OutputStream 로부터 Cipher를 지정하지 않고 CipherOutputStream를 구축합니다. 이것은 NullCipher를 사용해 CipherOutputStream를 구축하는 효과를 가집니다.
주: 지정된 출력 스트림이 null인 경우, 나중에 그것을 사용할 경우에 NullPointerException가 발생되는 일이 있습니다.

파라미터:

os - OutputStream 객체

메서드의 상세

write

public void write(int b)
           throws IOException 

지정된 바이트를 이 출력 스트림에 출력합니다.

오버라이드(override):

클래스 FilterOutputStream 내의 write

파라미터:

b - byte

예외:

IOException - 입출력 에러가 발생했을 경우

도입된 버전 :

JCE1. 2

write

public void write(byte[] b)
           throws IOException 

지정된 바이트 배열의 b.length 바이트를 이 출력 스트림에 출력합니다.

CipherOutputStream write 메서드는 인수 b, 0 및 b.length를 지정해 3개의 인수를 취하는 write 메서드를 호출합니다.

오버라이드(override):

클래스 FilterOutputStream 내의 write

파라미터:

b - 데이터

예외:

NullPointerException - b가 null인 경우

IOException - 입출력 에러가 발생했을 경우

도입된 버전 :

JCE1. 2

관련 항목:

write(byte[], int, int)

write

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

지정된 바이트 배열의, 오프셋(offset) 위치 off로 부터 시작되는 len 바이트를 이 출력 스트림에 출력합니다.

오버라이드(override):

클래스 FilterOutputStream 내의 write

파라미터:

b - 데이터

off - 데이터의 개시 오프셋(offset)

len - 출력하는 바이트수

예외:

IOException - 입출력 에러가 발생했을 경우

도입된 버전 :

JCE1. 2

관련 항목:

FilterOutputStream.write(int)

flush

public void flush()
           throws IOException 

캡슐화된 암호 객체에 의해 이미 처리된, 버퍼에 포함된 출력 바이트를 강제적으로 써내, 이 출력 스트림을 플래시 합니다.

캡슐화된 암호에 의해 버퍼에 포함되어 처리되는 것을 기다리고 있는 바이트는 써내지지 않습니다. 예를 들어 캡슐화된 암호가 블록 암호이며, write 메서드의 1개를 사용해 출력해진 바이트수의 합계가 그 암호의 블록 사이즈보다 작은 경우, 바이트는 써내지지 않습니다.

정의:

인터페이스 Flushable 내의 flush

오버라이드(override):

클래스 FilterOutputStream 내의 flush

예외:

IOException - 입출력 에러가 발생했을 경우

도입된 버전 :

JCE1. 2

관련 항목:

FilterOutputStream.out

close

public void close()
           throws IOException 

출력 스트림을 닫아 이 스트림에 관련된 모든 system resource를 해방합니다.

이 메서드는 캡슐화된 암호 객체에 의해 버퍼에 포함된 모든 바이트가 처리되도록 하는 캡슐화된 암호 객체의 doFinal 메서드를 호출합니다. 결과를 써내려면, 이 출력 스트림의 flush 메서드를 호출합니다.

이 메서드는 캡슐화된 암호 객체를 초기 상태에 리셋 해, 기본이 되는 출력 스트림의 close 메서드를 호출합니다.

정의:

인터페이스 Closeable 내의 close

오버라이드(override):

클래스 FilterOutputStream 내의 close

예외:

IOException - 입출력 에러가 발생했을 경우

도입된 버전 :

JCE1. 2

관련 항목:

FilterOutputStream.flush(), FilterOutputStream.out