java.io
클래스 OutputStream

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

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

ByteArrayOutputStream , FileOutputStream , FilterOutputStream , ObjectOutputStream , OutputStream , PipedOutputStream

public abstract class OutputStream

extends Object

이 추상 클래스는 바이트의 출력 스트림을 표현하는 모든 클래스의 슈퍼 클래스입니다. 출력 스트림은 출력 바이트를 받아들여, 특정의 입수자에게 보냅니다.

OutputStream 의 서브 클래스를 정의할 필요가 있는 어플리케이션에서는 적어도 1 바이트의 출력을 기입하는 메소드를 반드시 제공하지 않으면 되어 이룰 수 있는.

도입된 버젼:

JDK1. 0

관련 항목:

BufferedOutputStream , ByteArrayOutputStream , DataOutputStream , FilterOutputStream , InputStream , write(int)

생성자의 개요

OutputStream ()

메소드의 개요

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

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

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

생성자의 상세

OutputStream

public OutputStream()

메소드의 상세

write

public abstract void write(int b)
                    throws IOException 

이 출력 스트림으로 지정된 바이트를 기입합니다. write 의 범용 규약에서는 1 바이트가 출력 스트림에 기입해집니다. 기입해지는 바이트는 인수 b 의 하위 8 비트입니다. b 의 상위 24 비트는 무시됩니다.

OutputStream 의 서브 클래스는 이 메소드의 구현을 제공하지 않으면 안됩니다.

파라미터:

b - byte

예외:

IOException - 입출력 에러가 발생했을 경우. 특히, 출력 스트림이 닫혀지고 있는 경우에 IOException 가 슬로우 되는 일이 있다

write

public void write(byte[] b)
           throws IOException 

지정된 바이트 배열로부터 이 출력 스트림에 b.length 바이트를 기입합니다. write(b) 의 범용 규약에서는 write(b) 의 효과는 write(b, 0, b.length) 를 호출하는 경우와 완전히 같습니다.

파라미터:

b - 데이터

예외:

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

관련 항목:

write(byte[], int, int)

write

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

오프셋(offset) off 로부터 시작되는 지정의 바이트 배열로부터 이 출력 스트림에 len 바이트를 기입합니다. write(b, off, len) 의 범용 규약에서는 배열 b 내의 일정한 바이트가 출력 스트림에 차례로 기입해집니다. 이 처리로 최초로 기입해지는 바이트는 요소 b[off], 마지막에 기입해지는 바이트는 요소 b[off+len-1] 입니다.

OutputStream 의 write 메소드에서는 기입하는 바이트 마다 인수가 1 개의 메소드를 호출합니다. 서브 클래스에서는 이 메소드를 오버라이드(override) 해, 보다 효율적으로 구현해 주세요.

b 가 null 의 경우는 NullPointerException 가 슬로우 됩니다.

off 가 부의 경우,len 가 부의 경우, 혹은 off+len 가 배열 b 의 길이보다 큰 경우는 IndexOutOfBoundsException 가 슬로우 됩니다.

파라미터:

b - 데이터

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

len - 기입하는 바이트수

예외:

IOException - 입출력 에러가 발생했을 경우. 특히, 출력 스트림이 닫혀지고 있는 경우에 IOException 가 슬로우 된다

flush

public void flush()
           throws IOException 

이 출력 스트림을 플래시 해, 버퍼에 들어가 있는 출력 바이트를 모두 강제적으로 기입합니다. flush 의 범용 규약에서는 그때까지 기입해진 바이트가 출력 스트림의 구현에 의해 버퍼에 넣어지고 있는 경우에 flush 를 호출하면(자), 그러한 바이트는 즉시 그 목적의 전송 먼저 기입해집니다.

OutputStream 의 flush 메소드는 아무것도 실시하지 않습니다.

예외:

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

close

public void close()
           throws IOException 

이 스트림을 닫아 이 스트림에 관련하는 모든 system resource를 해방합니다. close 의 범용 규약에서는 close 는 출력 스트림을 닫습니다. 닫혀진 스트림은 출력 처리를 실행할 수 없습니다. 또, 그것을 다시 열 수 없습니다.

OutputStream 의 close 메소드는 아무것도 실시하지 않습니다.

예외:

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