java.io
클래스 FilterOutputStream

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

직계의 기존의 서브 클래스:

BufferedOutputStream , CheckedOutputStream , CipherOutputStream , DataOutputStream , DeflaterOutputStream , DigestOutputStream , PrintStream

public class FilterOutputStream

extends OutputStream

출력 스트림을 필터 처리하는 모든 클래스의 슈퍼 클래스입니다. 그러한 스트림은 기존의 출력 스트림 (기본이 되는 출력 스트림) 위에 있어, 그것을 데이터의 기본의 sink로서 사용해, 도중에 데이터를 변환하거나 또는 추가 기능을 제공하거나 합니다.

FilterOutputStream 클래스 자체는 단지 OutputStream 의 모든 메소드를 오버라이드(override) 해, 이것에 모든 요구를 기본이 되는 출력 스트림에 건네주는 버젼을 추가한 것입니다. FilterOutputStream 의 서브 클래스도, 추가된 메소드와 필드를 제공하는 것 외에 한층 더 이러한 메소드를 오버라이드(override) 하는 일이 있습니다.

도입된 버젼:

JDK1. 0

필드의 개요

protected OutputStream

out 필터 처리되는 기본이 되는 출력 스트림입니다.

생성자의 개요

FilterOutputStream (OutputStream out)
지정된 기본이 되는 출력 스트림의 상위에 출력 스트림 필터를 작성합니다.

메소드의 개요

void	close () 출력 스트림을 닫아 이것에 관련하는 모든 system resource를 해방합니다.
void	flush () 출력 스트림을 플래시 해, 버퍼링 되고 있던 모든 출력 바이트를 강제적으로 스트림에 기입합니다.
void	write (byte[] b) b.length 바이트의 데이터를 출력 스트림에 기입합니다.
void	write (byte[] b, int off, int len) 지정된 byte 배열의, 오프셋(offset) 위치 off 로부터 시작되는 len 바이트를 출력 스트림에 기입합니다.
void	write (int b) 지정된 byte 를 출력 스트림에 기입합니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

필드의 상세

out

protected OutputStream  out

필터 처리되는 기본이 되는 출력 스트림입니다.

생성자의 상세

FilterOutputStream

public FilterOutputStream(OutputStream  out)

지정된 기본이 되는 출력 스트림의 상위에 출력 스트림 필터를 작성합니다.

파라미터:

out - 나중에 사용할 수 있게 this.out 필드에 할당할 수 있는 기본이 되는 출력 스트림. 이 인스턴스가 기본이 되는 스트림없이 생성되는 경우는 null

메소드의 상세

write

public void write(int b)
           throws IOException 

지정된 byte 를 출력 스트림에 기입합니다.

FilterOutputStream 의 write 메소드는 기본이 되는 출력 스트림의 write 메소드를 호출합니다. 즉,out.write(b) 를 실행합니다.

OutputStream 의 abstract write 메소드를 구현합니다.

정의:

클래스 OutputStream 내의 write

파라미터:

b - byte

예외:

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

write

public void write(byte[] b)
           throws IOException 

b.length 바이트의 데이터를 출력 스트림에 기입합니다.

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

이 메소드는 그 기본이 되는 스트림의 1 개의 인수를 취하는 write 메소드에 1 개의 인수 b 를 지정해 호출하는 것은 아닌 것에 주의해 주세요.

오버라이드(override):

클래스 OutputStream 내의 write

파라미터:

b - 기입해지는 데이터

예외:

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

관련 항목:

write(byte[], int, int)

write

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

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

FilterOutputStream 의 write 메소드는 출력하는 각 byte 마다 1 개의 인수를 취하는 write 메소드를 호출합니다.

이 메소드는 기본이 되는 입력 스트림의 write 메소드를 호출할 때 같은 인수를 지정하는 것은 아닌 것에 주의해 주세요. FilterOutputStream 의 서브 클래스는 이 메소드의 것보다 효율이 좋은 구현을 제공하도록(듯이) 하는 것이 좋을 것입니다.

오버라이드(override):

클래스 OutputStream 내의 write

파라미터:

b - 데이터

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

len - 기입하는 바이트수

예외:

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

관련 항목:

write(int)

flush

public void flush()
           throws IOException 

출력 스트림을 플래시 해, 버퍼링 되고 있던 모든 출력 바이트를 강제적으로 스트림에 기입합니다.

FilterOutputStream 의 flush 메소드는 그 기본이 되는 출력 스트림의 flush 메소드를 호출합니다.

오버라이드(override):

클래스 OutputStream 내의 flush

예외:

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

관련 항목:

out

close

public void close()
           throws IOException 

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

FilterOutputStream 의 close 메소드는 우선, 그 flush 메소드를 호출해, 다음에 기본이 되는 출력 스트림의 close 메소드를 호출합니다.

오버라이드(override):

클래스 OutputStream 내의 close

예외:

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

관련 항목:

flush() , out