java.io
클래스 OutputStreamWriter

java.lang.Object 
  java.io.Writer 
      java.io.OutputStreamWriter

모든 구현된 인터페이스:

Closeable, Flushable, Appendable

알려진 직계 서브 클래스:

FileWriter

public class OutputStreamWriter
extends Writer 

OutputStreamWriter는 문자 스트림로부터 바이트 스트림에의 중개의 역할을 가집니다. 바이트 스트림에 출력해진 문자는 지정된 charset를 사용해 바이트에 encode 됩니다. 사용하는 캐릭터셋는 이름으로 지정하는지, 명시적으로 건네주는지, 또는 플랫폼의 디폴트의 캐릭터셋를 그대로 사용할 수도 있습니다.

write() 메서드를 호출할 때마다, 지정된 문자에 대해서 인코딩 컨버터가 호출됩니다. 결과적으로 생성된 바이트는 버퍼에 축적되고 나서 기본이 되는 출력 스트림에 출력해집니다. 이 버퍼의 사이즈는 지정할 수 있습니다만, 대부분의 경우, 디폴트의 사이즈로 충분합니다. write() 메서드에게 건네지는 문자는 버퍼에 들어가지 않기 때문에 주의해 주세요.

최대한으로 효율화하려면, 컨버터를 빈번하게 호출하지 않게 하기 위해서 BufferedWriter 내부에 OutputStreamWriter를 랩 하도록 고려해 주세요. 다음에 예를 나타냅니다.

 Writer out
   = new BufferedWriter(new OutputStreamWriter(System.out));
 

「사로 게이트 페어」는 2개의 char 치에 의해 나타내지는 문자로 \uD800 ~ \uDBFF 「상위」사로 게이트와 \uDC00 ~ \uDFFF 「하위」사로 게이트로부터 구성됩니다. 사로 게이트 페어에 의해 나타내지는 문자가 지정된 캐릭터셋에 의해 변환할 수 없는 경우는 캐릭터셋 존의 「대체 순서」가 출력 스트림에 출력해집니다.

대응하는 하위 사로 게이트가 없는 상위 사로 게이트, 또는 대응하는 상위 사로 게이트가 없는 하위 사로 게이트는 「부정한 사로 게이트 요소」라고 불립니다. 부정한 사로 게이트 요소를 포함한 문자 스트림은 출력하지 말아 주세요. 부정한 사로 게이트 요소를 출력했을 경우, 이 클래스의 인스턴스의 동작은 보증되지 않습니다.

도입된 버전 :

JDK1. 1

관련 항목:

BufferedWriter, OutputStream, Charset

필드 개요

클래스 java.io. Writer 로부터 상속된 필드

lock

생성자 개요

OutputStreamWriter (OutputStream out)
디폴트의 캐릭터셋를 사용하는 OutputStreamWriter를 작성합니다.

OutputStreamWriter (OutputStream out, Charset cs)
주어진 캐릭터셋를 사용하는 OutputStreamWriter를 작성합니다.

OutputStreamWriter (OutputStream out, CharsetEncoder enc)
주어진 캐릭터셋 엔코더를 사용하는 OutputStreamWriter를 작성합니다.

OutputStreamWriter (OutputStream out, String charsetName)
지정된 캐릭터셋를 사용하는 OutputStreamWriter를 작성합니다.

메서드 개요

void	close () 스트림을 닫습니다.
void	flush () 스트림을 플래시 합니다.
String	getEncoding () 이 스트림로 사용되는 캐릭터셋의 이름을 리턴합니다.
void	write (char[] cbuf, int off, int len) 문자의 배열의 일부를 출력합니다.
void	write (int c) 단일의 문자를 출력합니다.
void	write (String str, int off, int len) 캐릭터 라인의 일부를 출력합니다.

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

append, append, append, write, write

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

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

생성자 상세

OutputStreamWriter

public OutputStreamWriter(OutputStream  out,
                          String  charsetName)
                   throws UnsupportedEncodingException 

지정된 캐릭터셋를 사용하는 OutputStreamWriter를 작성합니다.

파라미터:

out - OutputStream

charsetName - 지원하는 charset 이름

예외:

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

OutputStreamWriter

public OutputStreamWriter(OutputStream  out)

디폴트의 캐릭터셋를 사용하는 OutputStreamWriter를 작성합니다.

파라미터:

out - OutputStream

OutputStreamWriter

public OutputStreamWriter(OutputStream  out,
                          Charset  cs)

주어진 캐릭터셋를 사용하는 OutputStreamWriter를 작성합니다.

파라미터:

out - OutputStream

cs - charset

도입된 버전 :

1.4

OutputStreamWriter

public OutputStreamWriter(OutputStream  out,
                          CharsetEncoder  enc)

주어진 캐릭터셋 엔코더를 사용하는 OutputStreamWriter를 작성합니다.

파라미터:

out - OutputStream

enc - 캐릭터셋 엔코더

도입된 버전 :

1.4

메서드의 상세

getEncoding

public String  getEncoding()

이 스트림로 사용되는 캐릭터셋의 이름을 리턴합니다.

인코딩에 호환명이 있는 경우는 그 이름을 리턴합니다. 호환명이 없는 경우는 인코딩의 표준명을 리턴합니다.

이 인스턴스가 OutputStreamWriter(OutputStream, String) 생성자를 사용해 작성되고 있는 경우, 그 생성자에게 건네진 이름은 아니고, 인코딩의 일의명이 리턴됩니다 . 이 메서드는 스트림이 닫고 있는 경우, null을 돌려주는 일이 있습니다.

반환값:

이 인코딩의 호환명. 스트림이 닫고 있는 경우는 null

관련 항목:

Charset

write

public void write(int c)
           throws IOException 

단일의 문자를 출력합니다.

오버라이드(override):

클래스 Writer 내의 write

파라미터:

c - 출력하는 문자를 지정하는 int

예외:

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

write

public void write(char[] cbuf,
                  int off,
                  int len)
           throws IOException 

문자의 배열의 일부를 출력합니다.

정의:

클래스 Writer 내의 write

파라미터:

cbuf - 문자의 버퍼

off - 문자의 출력 개시 오프셋(offset)

len - 출력하는 문자수

예외:

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

write

public void write(String  str,
                  int off,
                  int len)
           throws IOException 

캐릭터 라인의 일부를 출력합니다.

오버라이드(override):

클래스 Writer 내의 write

파라미터:

str - 캐릭터 라인

off - 문자의 출력 개시 오프셋(offset)

len - 출력하는 문자수

예외:

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

flush

public void flush()
           throws IOException 

스트림을 플래시 합니다.

정의:

인터페이스 Flushable 내의 flush

정의:

클래스 Writer 내의 flush

예외:

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

close

public void close()
           throws IOException 

스트림을 닫습니다.

정의:

인터페이스 Closeable 내의 close

정의:

클래스 Writer 내의 close

예외:

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