java.io
클래스 OutputStream

java.lang.Object 
  java.io.OutputStream

모든 구현된 인터페이스:

Closeable, Flushable

알려진 직계 서브 클래스:

ByteArrayOutputStream, FileOutputStream, FilterOutputStream, ObjectOutputStream, OutputStream, PipedOutputStream

public abstract class OutputStream
extends Object 
implements Closeable,
 Flushable 

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

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가 Throw 된다

flush

public void flush()
           throws IOException 

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

이 스트림의 목적의 송신지가 기본이 되는 OS에 의해 제공되는 추상화 객체인 경우 (파일 등), 스트림을 플래시 하면, 스트림에 직전에 출력해진 바이트만이 OS에 인도해져 출력해집니다. 디스크 드라이버등의 물리 디바이스에 실제로 출력해진다고는 할 수 없습니다.

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

정의:

인터페이스 Flushable 내의 flush

예외:

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

close

public void close()
           throws IOException 

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

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

정의:

인터페이스 Closeable 내의 close

예외:

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