java.io
클래스 Writer

java.lang.Object 
  java.io.Writer

모든 구현된 인터페이스:

Closeable, Flushable, Appendable

알려진 직계 서브 클래스:

BufferedWriter, CharArrayWriter, FilterWriter, OutputStreamWriter, PipedWriter, PrintWriter, StringWriter

public abstract class Writer
extends Object 
implements Appendable,
 Closeable,
 Flushable 

문자 스트림에 출력하기 위한 추상 클래스입니다. 서브 클래스가 구현할 필요가 있는 메서드는 write(char[], int, int), flush() 및 close() 뿐입니다. 다만, 대부분의 서브 클래스에서는 효율을 자주 하든가 또는 기능을 추가하는 (또는 그 양쪽 모두) 위해, 여기서 정의하는 메서드의 일부를 오버라이드(override) 합니다.

도입된 버전 :

JDK1. 1

관련 항목:

Writer, BufferedWriter, CharArrayWriter, FilterWriter, OutputStreamWriter, FileWriter, PipedWriter, PrintWriter, StringWriter, Reader

필드 개요

protected Object

lock 이 스트림로 조작을 동기 시키는데 사용하는 객체입니다.

생성자 개요

protected	Writer () 그 위기 섹션이 라이터 자체로 동기 하는 새로운 문자 스트림 라이터를 작성합니다.
protected	Writer (Object lock) 그 위기 섹션이 지정된 객체로 동기 하는 새로운 문자 스트림 라이터를 작성합니다.

메서드 개요

Writer	append (char c) 이 라이터로 지정된 문자를 추가합니다.
Writer	append (CharSequence csq) 이 라이터로 지정된 문자 순서를 추가합니다.
Writer	append (CharSequence csq, int start, int end) 지정된 문자 순서의 서브 순서를 이 Writer에 추가합니다.
abstract void	close () 스트림을 닫아 플래시 합니다.
abstract void	flush () 스트림을 플래시 합니다.
void	write (char[] cbuf) 문자의 배열을 출력합니다.
abstract void	write (char[] cbuf, int off, int len) 문자의 배열의 일부를 출력합니다.
void	write (int c) 단일 문자를 출력합니다.
void	write (String str) 캐릭터 라인을 출력합니다.
void	write (String str, int off, int len) 캐릭터 라인의 일부를 출력합니다.

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

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

필드의 상세

lock

protected Object  lock

이 스트림로 조작을 동기 시키는데 사용하는 객체입니다. 효율을 자주 하기 위한, 문자 스트림 객체에서는 다른 객체를 사용해 위기 섹션을 보호할 수 있습니다 . 그 때문에 서브 클래스에서는 this 나 동기 메서드가 아니고, 이 필드의 객체를 사용합니다.

생성자 상세

Writer

protected Writer()

그 위기 섹션이 라이터 자체로 동기 하는 새로운 문자 스트림 라이터를 작성합니다.

Writer

protected Writer(Object  lock)

그 위기 섹션이 지정된 객체로 동기 하는 새로운 문자 스트림 라이터를 작성합니다.

파라미터:

lock - 동기 하는 객체

메서드의 상세

write

public void write(int c)
           throws IOException 

단일 문자를 출력합니다. 출력해지는 문자는 지정된 정수값 의 하위 16 비트에 포함됩니다. 상위 16 비트는 무시됩니다.

유효한 단일 문자의 출력을 지원 하기 위한 서브 클래스에서는 이 메서드를 오버라이드(override) 합니다.

파라미터:

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

예외:

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

write

public void write(char[] cbuf)
           throws IOException 

문자의 배열을 출력합니다.

파라미터:

cbuf - 출력하는 문자의 배열

예외:

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

write

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

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

파라미터:

cbuf - 문자의 배열

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

len - 출력하는 문자수

예외:

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

write

public void write(String  str)
           throws IOException 

캐릭터 라인을 출력합니다.

파라미터:

str - 출력해지는 캐릭터 라인

예외:

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

write

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

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

파라미터:

str - 캐릭터 라인

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

len - 출력하는 문자수

예외:

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

append

public Writer  append(CharSequence  csq)
              throws IOException 

이 라이터로 지정된 문자 순서를 추가합니다.

이 메서드를 out.append(csq) 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

     out.write(csq.toString()) 

문자 순서 csq에 대한 toString 지정에 응해, 순서 전체가 추가되지 않는 것도 있습니다. 예를 들어 문자 버퍼의 toString를 호출하면, 내용이 버퍼의 위치와 리밋트에 의존된 서브 순서가 리턴됩니다 .

정의:

인터페이스 Appendable 내의 append

파라미터:

csq - 추가되는 문자 순서. csq가 null인 경우는 이 Writer에 「null」라고 하는 4 문자가 추가된다

반환값:

이 라이터

예외:

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

도입된 버전 :

1.5

append

public Writer  append(CharSequence  csq,
                     int start,
                     int end)
              throws IOException 

지정된 문자 순서의 서브 순서를 이 Writer에 추가합니다.

csq가 null는 아닐 때에 이 메서드를 out.append(csq, start, end) 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

     out.write(csq.subSequence(start, end). toString()) 

정의:

인터페이스 Appendable 내의 append

파라미터:

csq - 서브 순서의 추가원의 문자 순서. csq가 null 이면, 문자는 csq에 「null」라고 하는 4 문자가 포함되어 있는 것과 같게 추가되는

start - 서브 순서의 최초의 문자의 인덱스

end - 서브 순서의 마지막 문자의 후에 계속되는 문자의 인덱스

반환값:

이 라이터

예외:

IndexOutOfBoundsException - start 또는 end가 잘못된 값 의 경우, start가 end 보다 큰 경우, 혹은 end가 csq.length() 보다 큰 경우

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

도입된 버전 :

1.5

append

public Writer  append(char c)
              throws IOException 

이 라이터로 지정된 문자를 추가합니다.

이 메서드를 out.append(c) 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

     out.write(c) 

정의:

인터페이스 Appendable 내의 append

파라미터:

c - 추가되는 16 비트의 문자

반환값:

이 라이터

예외:

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

도입된 버전 :

1.5

flush

public abstract void flush()
                    throws IOException 

스트림을 플래시 합니다. 스트림이 write() 메서드에 의해 출력해진 문자를 버퍼에 보존되어 있는 경우, 이러한 문자의 목적의 송신지에 즉시 문자를 출력합니다. 게다가 송신지가 다른 문자 스트림 또는 바이트 스트림의 경우는 이 송신지를 플래시 합니다. 즉, 1개의 flush()의 호출로 관련된 Writer 및 OutputStream 모든 버퍼를 플래시 합니다.

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

정의:

인터페이스 Flushable 내의 flush

예외:

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

close

public abstract void close()
                    throws IOException 

스트림을 닫아 플래시 합니다. 스트림을 한 번 닫으면, 이후 write() 또는 flush()를 호출하면, IOException가 발생 됩니다. 다만, 전에 닫은 스트림을 닫아도 효과는 없습니다.

정의:

인터페이스 Closeable 내의 close

예외:

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