java.io
클래스 PipedInputStream

java.lang.Object 
  java.io.InputStream 
      java.io.PipedInputStream

모든 구현된 인터페이스:

Closeable

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 이 리턴됩니다 . 이 메서드는 입력 데이터를 읽어들일 수 있게 되는지, 스트림의 마지막이 검출되는지, 또는 예외가 Throw 될 때까지 블록 합니다. 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를 해방합니다.

정의:

인터페이스 Closeable 내의 close

오버라이드(override):

클래스 InputStream 내의 close

예외:

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