java.io
클래스 OutputStreamWriter

java.lang.Object 
  |
  +--java.io.Writer 
        |
        +--java.io.OutputStreamWriter

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

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 에서 상속받은 메소드

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

도입된 버젼:

1.4

OutputStreamWriter

public OutputStreamWriter(OutputStream  out,
                          CharsetEncoder  enc)

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

파라미터:

out - OutputStream

enc - 캐릭터 인코딩 엔코더

도입된 버젼:

1.4

메소드의 상세

getEncoding

public String  getEncoding()

이 스트림으로 사용되는 캐릭터 인코딩의 이름을 돌려줍니다.

인코딩에 호환명이 있는 경우는 그 이름을 돌려줍니다. 호환명이 없는 경우는 인코딩의 표준명을 돌려줍니다.

이 인스턴스가 OutputStreamWriter(OutputStream, String) constructor를 사용해 작성되고 있는 경우, 그 constructor로 건네진 이름은 아니고, 인코딩의 일의명이 돌려주어집니다. 이 메소드는 스트림이 닫고 있는 경우,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 

스트림을 플래시 합니다.

정의:

클래스 Writer 내의 flush

예외:

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

close

public void close()
           throws IOException 

스트림을 닫습니다.

정의:

클래스 Writer 내의 close

예외:

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