java.io
클래스 PipedInputStream

java.lang.Object 
  |
  +--java.io.InputStream 
        |
        +--java.io.PipedInputStream

public class PipedInputStream

extends InputStream

파이프로 연결된 입력 스트림은 파이프로 연결된 출력 스트림에 접속됩니다. 즉, 파이프로 연결된 입력 스트림은 파이프로 연결된 출력 스트림에 기입해지는 데이터 바이트를 제공합니다. 일반적으로,PipedInputStream 오브젝트로부터 데이터를 읽어들이는 thread와 대응하는 PipedOutputStream 오브젝트에 데이터를 기입하는 thread는 별들입니다. 단일의 thread로부터 이러한 2 개의 오브젝트를 사용하는 것은 그 thread를 데드 록 시키는 위험이 있기 (위해)때문에, 추천 할 수 없습니다. 파이프로 연결된 입력 스트림은 일정한 범위내에서 버퍼를 보관 유지해, 이것에 의해 기입해 처리와 읽어들여 처리는 분리됩니다.

도입된 버젼:

JDK1. 0

관련 항목:

PipedOutputStream

필드의 개요

protected byte[]	buffer 들어 오는 데이터를 두는 순환 버퍼입니다.
protected int	in 데이터의 다음의 바이트를 파이프로 연결된 접속 끝난 출력 스트림으로부터 받았을 때에, 그 다음의 바이트를 저장하는 순환 버퍼의 인덱스 위치입니다.
protected int	out 파이프로 연결된 이 입력 스트림이 데이터의 다음의 바이트를 읽어들이는 순환 버퍼의 인덱스 위치입니다.
protected static int	PIPE_SIZE 파이프의 순환 입력 버퍼의 사이즈입니다.

생성자의 개요

PipedInputStream ()
PipedInputStream 를, 아직 접속되어 있지 않은 상태로 작성합니다.

PipedInputStream (PipedOutputStream src)
PipedInputStream 를, 파이프로 연결된 출력 스트림 src 에 접속되도록(듯이) 작성합니다.

메소드의 개요

int	available () 블록 하지 않고 이 입력 스트림으로부터 읽어들일 수 있는 바이트수를 돌려줍니다.
void	close () 파이프에 의한 입력 스트림을 닫아 그 스트림에 관련하는 모든 system resource를 해방합니다.
void	connect (PipedOutputStream src) 파이프에 의한 입력 스트림을, 파이프에 의한 출력 스트림 src 에 접속시킵니다.
int	read () 파이프에 의한 입력 스트림으로부터 , 다음의 바이트를 읽어들입니다.
int	read (byte[] b, int off, int len) 파이프에 의한 입력 스트림의 len 바이트까지의 데이터를 바이트의 배열에 읽어들입니다.
protected void	receive (int b) 데이터의 바이트를 받습니다.

클래스 java.io. InputStream 에서 상속받은 메소드

mark , markSupported , read , reset , skip

클래스 java.lang. Object 에서 상속받은 메소드

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

필드의 상세

PIPE_SIZE

protected static final int PIPE_SIZE

파이프의 순환 입력 버퍼의 사이즈입니다.

도입된 버젼:

JDK1. 1

관련 항목:

정수 필드치

buffer

protected byte[] buffer

들어 오는 데이터를 두는 순환 버퍼입니다.

도입된 버젼:

JDK1. 1

in

protected int in

데이터의 다음의 바이트를 파이프로 연결된 접속 끝난 출력 스트림으로부터 받았을 때에, 그 다음의 바이트를 저장하는 순환 버퍼의 인덱스 위치입니다. in<0 는 버퍼가 하늘인 것을 나타내,in==out 는 버퍼가 가득해 있는 것을 나타냅니다.

도입된 버젼:

JDK1. 1

out

protected int out

파이프로 연결된 이 입력 스트림이 데이터의 다음의 바이트를 읽어들이는 순환 버퍼의 인덱스 위치입니다.

도입된 버젼:

JDK1. 1

생성자의 상세

PipedInputStream

public PipedInputStream(PipedOutputStream  src)
                 throws IOException 

PipedInputStream 를, 파이프로 연결된 출력 스트림 src 에 접속되도록(듯이) 작성합니다. src 에 기입해지는 데이터 바이트는 이 스트림으로부터 의 입력으로서 사용할 수 있습니다.

파라미터:

src - 접속처의 스트림

예외:

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

PipedInputStream

public PipedInputStream()

PipedInputStream 를, 아직 접속되어 있지 않은 상태로 작성합니다. 이것을 사용하려면 ,PipedOutputStream 에 접속할 필요가 있습니다.

관련 항목:

connect(java.io.PipedOutputStream) , PipedOutputStream.connect(java.io.PipedInputStream)

메소드의 상세

connect

public void connect(PipedOutputStream  src)
             throws IOException 

파이프에 의한 입력 스트림을, 파이프에 의한 출력 스트림 src 에 접속시킵니다. 이 오브젝트가 파이프에 의하는 것 외의 출력 스트림에 벌써 접속되고 있는 경우는 IOException 가 슬로우 됩니다.

src 가 파이프에 의한 미접속의 출력 스트림으로,snk 가 파이프에 의한 미접속의 입력 스트림인 경우, 2 개의 스트림은 이하의 호출의 어딘가에 따라 접속됩니다.

snk.connect(src) 

또는

src.connect(snk) 

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

파라미터:

src - 파이프에 의한 접속처의 출력 스트림

예외:

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

receive

protected void receive(int b)
                throws IOException 

데이터의 바이트를 받습니다. 이 메소드는 유효한 입력이 아직 없는 경우는 블록 합니다.

파라미터:

b - 받는 바이트

예외:

IOException - 파이프가 고장나 있는 경우

도입된 버젼:

JDK1. 1

read

public int read()
         throws IOException 

파이프에 의한 입력 스트림으로부터 , 다음의 바이트를 읽어들입니다. 값바이트는 0 ~ 255 까지의 범위에서 int 로서 돌려주어집니다. 스트림의 마지막에 이르러 바이트가 없는 경우는 값 -1 이 돌려주어집니다. 이 메소드는 입력 데이터를 읽어들일 수 있게 되는지 스트림의 마지막이 검출되는지 또는 예외가 슬로우 될 때까지 블록 합니다. thread가 데이터 바이트를 접속 끝난 파이프 출력 스트림에 제공하고 있었지만, 그 thread가 이제 생존하고 있지 않는 경우는 IOException 가 슬로우 됩니다.

정의:

클래스 InputStream 내의 read

반환값:

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

예외:

IOException - 파이프가 고장나 있는 경우

read

public int read(byte[] b,
                int off,
                int len)
         throws IOException 

파이프에 의한 입력 스트림의 len 바이트까지의 데이터를 바이트의 배열에 읽어들입니다. 데이터 스트림의 마지막에 이르렀을 경우는 len 바이트보다 적은 데이터 밖에 읽히지 않습니다. 이 메소드는 적어도 1 바이트를 사용할 수 있게 될 때까지 블록 합니다. thread가 데이터 바이트를 접속 끝난 파이프 출력 스트림에 제공하고 있었지만, 그 thread가 이제 생존하고 있지 않는 경우는 IOException 가 슬로우 됩니다.

오버라이드(override):

클래스 InputStream 내의 read

파라미터:

b - 데이터의 read처의 버퍼

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

len - 읽히는 최대 바이트수

반환값:

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

예외:

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

관련 항목:

InputStream.read()

available

public int available()
              throws IOException 

블록 하지 않고 이 입력 스트림으로부터 읽어들일 수 있는 바이트수를 돌려줍니다. 이 메소드는 상위 클래스의 available 메소드를 오버라이드(override) 합니다.

오버라이드(override):

클래스 InputStream 내의 available

반환값:

블록 하지 않고 입력 스트림으로부터 읽어들일 수가 있는 바이트수

예외:

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

도입된 버젼:

JDK1. 0.2

close

public void close()
           throws IOException 

파이프에 의한 입력 스트림을 닫아 그 스트림에 관련하는 모든 system resource를 해방합니다.

오버라이드(override):

클래스 InputStream 내의 close

예외:

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