java.io
클래스 ByteArrayOutputStream

java.lang.Object 
  java.io.OutputStream 
      java.io.ByteArrayOutputStream

모든 구현된 인터페이스:

Closeable, Flushable

public class ByteArrayOutputStream
extends OutputStream 

데이터가 바이트 배열에 출력해지는 출력 스트림을 구현합니다. 데이터가 출력됨에 따라, 버퍼는 자동적으로 커져 갑니다. toByteArray()와 toString()를 사용해 데이타를 뽑기 시작할 수 있습니다 .

ByteArrayOutputStream를 닫아도, 아무것도 변화는 없습니다. 스트림을 닫은 뒤에 이 클래스의 메서드를 호출해도, IOException는 생성되지 않습니다.

도입된 버전 :

JDK1. 0

필드 개요

protected byte[]	buf 데이터가 포함되는 버퍼입니다.
protected int	count 버퍼안의 유효 바이트수입니다.

생성자 개요

ByteArrayOutputStream ()
바이트 배열 출력 스트림을 새롭게 작성합니다.

ByteArrayOutputStream (int size)
바이트수로 지정된 사이즈의 버퍼를 가지는 바이트 배열 출력 스트림을 새롭게 작성합니다.

메서드 개요

void	close () ByteArrayOutputStream를 닫아도, 아무것도 변화는 없습니다.
void	reset () 바이트 배열 출력 스트림의 count 필드를 제로에 리셋 합니다.
int	size () 버퍼의 현재의 사이즈를 리턴합니다.
byte[]	toByteArray () 메모리를 할당해 바이트 배열을 새롭게 작성합니다.
String	toString () 플랫폼의 디폴트의 캐릭터셋에 따라 바이트를 문자로 변환하면서, 버퍼의 내용을 캐릭터 라인으로 변환합니다.
String	toString (int hibyte) 추천하지 않습니다. 이 메서드는 바이트를 캐릭터 라인에 적절히 변환할 수 없습니다. JDK 1. 1 현재, 추천 되는 방법은 인코딩명을 인수에 취하는 toString(String enc) 메서드인가 플랫폼의 디폴트의 캐릭터셋를 사용하는 toString() 메서드를 사용하는 것입니다.
String	toString (String enc) 지정된 캐릭터셋에 따라 바이트를 문자로 변환하면서, 버퍼의 내용을 캐릭터 라인으로 변환합니다.
void	write (byte[] b, int off, int len) 지정된 바이트 배열의 오프셋(offset) 위치 off로 부터 시작되는 len 바이트를, 바이트 배열 출력 스트림에 출력합니다.
void	write (int b) 지정된 바이트를, 바이트 배열 출력 스트림에 출력합니다.
void	writeTo (OutputStream out) 바이트 배열 출력 스트림의 모든 내용을 지정된 출력 스트림 인수에 출력합니다.

클래스 java.io. OutputStream 로부터 상속된 메서드

flush, write

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

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

필드의 상세

buf

protected byte[] buf

데이터가 포함되는 버퍼입니다.

count

protected int count

버퍼안의 유효 바이트수입니다.

생성자 상세

ByteArrayOutputStream

public ByteArrayOutputStream()

바이트 배열 출력 스트림을 새롭게 작성합니다. 버퍼 용량의 초기값 는 32 바이트입니다만, 이 사이즈는 필요에 따라서 커집니다.

ByteArrayOutputStream

public ByteArrayOutputStream(int size)

바이트수로 지정된 사이즈의 버퍼를 가지는 바이트 배열 출력 스트림을 새롭게 작성합니다.

파라미터:

size - 초기 사이즈

예외:

IllegalArgumentException - 사이즈가 잘못된 값 의 경우

메서드의 상세

write

public void write(int b)

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

정의:

클래스 OutputStream 내의 write

파라미터:

b - 출력하는 바이트

write

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

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

오버라이드(override):

클래스 OutputStream 내의 write

파라미터:

b - 데이터

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

len - 출력하는 바이트수

writeTo

public void writeTo(OutputStream  out)
             throws IOException 

바이트 배열 출력 스트림의 모든 내용을 지정된 출력 스트림 인수에 출력합니다. 이것은 out.write(buf, 0, count)를 사용해 출력 스트림의 write 메서드를 호출하는 것과 같습니다.

파라미터:

out - 데이터를 출력하는 출력 스트림

예외:

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

reset

public void reset()

바이트 배열 출력 스트림의 count 필드를 제로에 리셋 합니다. 이 결과, 현재 출력 스트림에 축적 떠날 수 있어 모든 데이터는 파기됩니다. 이 출력 스트림은 이미 할당할 수 있는 버퍼 스페이스를 사용해, 재차 사용할 수 있습니다 .

관련 항목:

ByteArrayInputStream.count

toByteArray

public byte[] toByteArray()

메모리를 할당해 바이트 배열을 새롭게 작성합니다. 배열의 사이즈는 현재의 출력 스트림과 같아, 버퍼안의 유효 데이터는 여기에 복사됩니다.

반환값:

출력 스트림의 현재의 내용을 바이트 배열로서 돌려주는

관련 항목:

size()

size

public int size()

버퍼의 현재의 사이즈를 리턴합니다.

반환값:

count 필드의 값. 출력 스트림안의 유효 바이트수를 나타내는

관련 항목:

count

toString

public String  toString()

플랫폼의 디폴트의 캐릭터셋에 따라 바이트를 문자로 변환하면서, 버퍼의 내용을 캐릭터 라인으로 변환합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

버퍼의 내용으로부터 변환된 캐릭터 라인

도입된 버전 :

JDK1. 1

toString

public String  toString(String  enc)
                throws UnsupportedEncodingException 

지정된 캐릭터셋에 따라 바이트를 문자로 변환하면서, 버퍼의 내용을 캐릭터 라인으로 변환합니다.

파라미터:

enc - 캐릭터셋의 이름

반환값:

버퍼의 내용으로부터 변환된 캐릭터 라인

예외:

UnsupportedEncodingException - 지정된 캐릭터셋가 지원되어 있지 않은 경우

도입된 버전 :

JDK1. 1

toString

@Deprecated 
public String  toString(int hibyte)

추천하지 않습니다. 이 메서드는 바이트를 캐릭터 라인에 적절히 변환할 수 없습니다. JDK 1. 1 현재, 추천 되는 방법은 인코딩명을 인수에 취하는 toString(String enc) 메서드인가 플랫폼의 디폴트의 캐릭터셋를 사용하는 toString() 메서드를 사용하는 것입니다.

새롭게 메모리를 할당해 캐릭터 라인을 작성합니다. 캐릭터 라인의 사이즈는 현재의 출력 스트림과 같게 되어 버퍼안의 유효 데이터는 여기에 복사됩니다. 작성되는 캐릭터 라인의 각 문자 데이터 c는 바이트 배열의 대응하는 요소 b 로부터, 다음과 같이 됩니다.

 c == (char)(((hibyte &
 0xff) <<
 8) | (b &
 0xff)) 

파라미터:

hibyte - 결과의 각 Unicode 문자의 상위 바이트

반환값:

출력 스트림의 현재의 내용을 나타내는 캐릭터 라인

관련 항목:

size(), toString(String), toString()

close

public void close()
           throws IOException 

ByteArrayOutputStream를 닫아도, 아무것도 변화는 없습니다. 스트림을 닫은 뒤에 이 클래스의 메서드를 호출해도, IOException는 생성되지 않습니다.

정의:

인터페이스 Closeable 내의 close

오버라이드(override):

클래스 OutputStream 내의 close

예외:

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