java.io
클래스 PipedReader

java.lang.Object 
  java.io.Reader 
      java.io.PipedReader

모든 구현된 인터페이스:

Closeable , Readable

public class PipedReader
extends Reader 

파이프에 의한 문자 입력 스트림입니다.

도입된 버젼:

JDK1. 1

필드의 개요

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

lock

생성자 의 개요

PipedReader ()
아직 connected 가 아닌 상태로 PipedReader 를 작성합니다.

PipedReader (int pipeSize)
아직 connected 가 아닌 상태로 PipedReader 를 작성합니다.

PipedReader (PipedWriter src)
PipedReader 를 작성해, 파이프로 연결된 라이터 src 에 접속합니다.

PipedReader (PipedWriter src, int pipeSize)
PipedReader 를 작성해, 파이프로 연결된 라이터 src 에 접속합니다.

메소드의 개요

void	close () 파이프에 의한 스트림을 닫아, 거기에 관련하는 모든 system resource를 해제합니다.
void	connect (PipedWriter src) 파이프로 연결된 리더를 파이프로 연결된 라이터 src 에 접속합니다.
int	read () 파이프로 연결된 스트림로부터 데이터의 다음의 문자를 읽어들입니다.
int	read (char[] cbuf, int off, int len) 최대 len 문자까지의 데이터를, 이 파이프로 연결된 스트림로부터 문자 배열에 읽어들입니다.
boolean	ready () 이 스트림이 읽어들여 가능한가 어떤가를 판정합니다.

클래스 java.io. Reader 로부터 상속된 메소드

mark , markSupported , read , read , reset , skip

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

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

생성자 의 상세

PipedReader

public PipedReader(PipedWriter  src)
            throws IOException 

PipedReader 를 작성해, 파이프로 연결된 라이터 src 에 접속합니다. src 에 기입해진 데이터는, 이 스트림로부터의 입력으로서 사용할 수 있게 됩니다.

파라미터:

src - 접속처의 스트림

예외:

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

PipedReader

public PipedReader(PipedWriter  src,
                   int pipeSize)
            throws IOException 

PipedReader 를 작성해, 파이프로 연결된 라이터 src 에 접속합니다. 그 때, 지정된 파이프 사이즈를 파이프의 버퍼에 사용합니다. src 에 기입해진 데이터는, 이 스트림로부터의 입력으로서 사용할 수 있게 됩니다.

파라미터:

src - 접속처의 스트림

pipeSize - 파이프의 버퍼의 사이즈

예외:

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

IllegalArgumentException - pipeSize <= 0 의 경우

도입된 버젼:

1.6

PipedReader

public PipedReader()

아직 connected 가 아닌 상태로 PipedReader 를 작성합니다. 사용전에,PipedWriter 에 대해서 connected 상태로 할 필요가 있습니다.

PipedReader

public PipedReader(int pipeSize)

아직 connected 가 아닌 상태로 PipedReader 를 작성합니다. 그 때, 지정된 파이프 사이즈를 파이프의 버퍼에 사용합니다. 사용전에,PipedWriter 에 대해서 connected 상태로 할 필요가 있습니다.

파라미터:

pipeSize - 파이프의 버퍼의 사이즈

예외:

IllegalArgumentException - pipeSize <= 0 의 경우

도입된 버젼:

1.6

메소드의 상세

connect

public void connect(PipedWriter  src)
             throws IOException 

파이프로 연결된 리더를 파이프로 연결된 라이터 src 에 접속합니다. 이 객체가 다른 파이프로 연결된 라이터에 접속되고 있는 경우는,IOException 가 throw 됩니다.

src 가 파이프에 의한 미접속의 파이프 라이터로,snk 가 미접속의 파이프 리더인 경우,src 와 snk 는 이하의 호출의 어딘가에 따라 접속됩니다.

snk.connect(src) 

또는

src.connect(snk) 

2 개의 호출은 같은 효과를 가집니다.

파라미터:

src - 파이프에 의한 접속처의 라이터

예외:

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

read

public int read()
         throws IOException 

파이프로 연결된 스트림로부터 데이터의 다음의 문자를 읽어들입니다. 스트림의 마지막에 이르렀기 때문에 읽어들이는 문자가 없는 경우는, 값 -1 이 돌려주어집니다. 입력 데이터를 읽어들일 수 있게 되는지, 파일의 마지막이 검출되는지, 또는 예외가 발생할 때까지, 이 메소드는 블록 됩니다.

오버라이드(override):

클래스 Reader 내의 read

반환값:

데이터의 다음의 문자. 스트림의 마지막에 이르렀을 경우는 -1

예외:

IOException - 파이프가고장나 있는 경우,unconnected 상태인 경우, 닫혀지고 있는 경우, 또는 입출력 에러가 발생했을 경우

read

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

최대 len 문자까지의 데이터를, 이 파이프로 연결된 스트림로부터 문자 배열에 읽어들입니다. 데이터 스트림의 마지막에 이르렀을 경우, 또는 len 문자가 파이프의 버퍼 사이즈를 넘고 있는 경우,len 문자보다 적은 데이터가 읽힙니다. 이 메소드는, 적어도 1 문자의 입력을 이용할 수 있을 때까지 블록 합니다.

정의:

클래스 Reader 내의 read

파라미터:

cbuf - 데이터의 read처의 버퍼

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

len - 읽히는 최대 문자수

반환값:

버퍼에 읽힌 문자의 합계수. 스트림의 마지막에 이르러 데이터가 없는 경우는 -1

예외:

IOException - 파이프가고장나 있는 경우,unconnected 상태인 경우, 닫혀지고 있는 경우, 또는 입출력 에러가 발생했을 경우

ready

public boolean ready()
              throws IOException 

이 스트림이 읽어들여 가능한가 어떤가를 판정합니다. 파이프로 연결된 문자 스트림은, 순환 버퍼가 빈 상태(empty)이 아닌 경우에 읽어들일 수가 있습니다.

오버라이드(override):

클래스 Reader 내의 ready

반환값:

다음의 read()가 입력을 블록 하지 않는 것이 확실한 경우는 true, 그렇지 않은 경우는 false. false 가 돌려주어져도, 다음의 read가 확실히 블록 한다는 것이 아니다

예외:

IOException - 파이프가고장나 있는 경우,unconnected 상태인 경우, 또는 닫혀지고 있는 경우

close

public void close()
           throws IOException 

파이프에 의한 스트림을 닫아, 거기에 관련하는 모든 system resource를 해제합니다.

정의:

인터페이스 Closeable 내의 close

정의:

클래스 Reader 내의 close

예외:

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