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 가 throw 될 가능성이 있습니다.

파라미터:

os - OutputStream 객체

c - 초기화된 Cipher 객체

CipherOutputStream

protected CipherOutputStream(OutputStream  os)

OutputStream 로부터 Cipher 를 지정하지 않고 CipherOutputStream 를 구축합니다. 이것은, NullCipher 를 사용해 CipherOutputStream 를 구축하는 효과를 가집니다.
주:지정된 출력 스트림이 null 의 경우는, 그것의 사용시에 NullPointerException 가 throw 될 가능성이 있습니다.

파라미터:

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