java.io
클래스 FilterInputStream

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

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

BufferedInputStream , CheckedInputStream , CipherInputStream , DataInputStream , DigestInputStream , InflaterInputStream , LineNumberInputStream , ProgressMonitorInputStream , PushbackInputStream

public class FilterInputStream

extends InputStream

다른 입력 스트림을 저장해, 그것을 데이터의 기본적인 소스로서 사용해, 데이터를 도중에 변환하거나 추가 기능을 제공하거나 합니다. FilterInputStream 클래스는 단순하게, 저장되고 있는 입력 스트림에의 모든 요구를 통과시키는 버젼으로 InputStream 의 모든 메소드를 오버라이드(override) 합니다. FilterInputStream 의 서브 클래스는 그러한 메소드를 한층 더 오버라이드(override) 할 수 있어 추가의 메소드 및 필드도 제공할 수 있습니다.

도입된 버젼:

JDK1. 0

필드의 개요

protected InputStream

in 필터 처리되는 입력 스트림입니다.

생성자의 개요

protected

FilterInputStream (InputStream in) 나중에 사용할 수 있게 인수 in 를 this.in 필드에 할당하는 것에 의해,FilterInputStream 를 작성합니다.

메소드의 개요

int	available () 블록 하지 않고 입력 스트림으로부터 읽어들일 수가 있는 바이트수를 돌려줍니다.
void	close () 입력 스트림을 닫아 이 스트림과 관련하는 모든 system resource를 해방합니다.
void	mark (int readlimit) 입력 스트림의 현재 위치에 마크를 설정합니다.
boolean	markSupported () 입력 스트림이 mark 와 reset 메소드를 서포트하고 있을지 어떨지를 판정합니다.
int	read () 이 입력 스트림으로부터 , 데이터의 다음의 바이트를 읽어들입니다.
int	read (byte[] b) 입력 스트림으로부터 바이트 배열에 최대 byte.length 바이트의 데이터를 읽어들입니다.
int	read (byte[] b, int off, int len) 입력 스트림으로부터 바이트 배열에 최대 len 바이트의 데이터를 읽어들입니다.
void	reset () 이 스트림의 위치를, 입력 스트림으로 마지막에 mark 메소드가 불려 갔을 때의 마크 위치에 재설정합니다.
long	skip (long n) 입력 스트림으로부터 의 데이터를 n 바이트만 스킵 해 파기합니다.

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

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

필드의 상세

in

protected InputStream  in

필터 처리되는 입력 스트림입니다.

생성자의 상세

FilterInputStream

protected FilterInputStream(InputStream  in)

나중에 사용할 수 있게 인수 in 를 this.in 필드에 할당하는 것에 의해,FilterInputStream 를 작성합니다.

파라미터:

in - 기본이 되는 입력 스트림. 이 인스턴스가 기초의 스트림없이 생성되는 경우는 null

메소드의 상세

read

public int read()
         throws IOException 

이 입력 스트림으로부터 , 데이터의 다음의 바이트를 읽어들입니다. 그 바이트는 0 ~ 255 의 범위의 int 로서 돌려주어집니다. 스트림의 마지막에 이르러 바이트가 없는 경우는 값 -1 이 돌려주어집니다. 이 메소드는 입력 데이터가 읽히게 되는지 스트림의 마지막이 검출되는지 또는 예외가 슬로우 될 때까지 블록 합니다.

이 메소드는 단순하게 in.read() 를 실행해, 그 결과를 돌려줍니다.

정의:

클래스 InputStream 내의 read

반환값:

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

예외:

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

관련 항목:

in

read

public int read(byte[] b)
         throws IOException 

입력 스트림으로부터 바이트 배열에 최대 byte.length 바이트의 데이터를 읽어들입니다. 이 메소드는 입력 데이터가 읽어들여 가능하게 될 때까지 블록 합니다.

이 메소드는 단순하게 read(b, 0, b.length) 의 호출을 실행해, 그 결과를 돌려줍니다. 대신에 in.read(b) 가 실행되지 않게 해 주세요. FilterInputStream 의 특정의 서브 클래스는 실제로 사용되고 있는 구현 방법으로 의존합니다.

오버라이드(override):

클래스 InputStream 내의 read

파라미터:

b - 데이터의 read처의 버퍼

반환값:

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

예외:

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

관련 항목:

read(byte[], int, int)

read

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

입력 스트림으로부터 바이트 배열에 최대 len 바이트의 데이터를 읽어들입니다. 이 메소드는 입력이 가능하게 될 때까지 블록 합니다.

이 메소드는 단순하게 in.read(b, off, len) 를 실행해, 그 결과를 돌려줍니다.

오버라이드(override):

클래스 InputStream 내의 read

파라미터:

b - 데이터의 read처의 버퍼

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

len - 읽히는 최대 바이트수

반환값:

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

예외:

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

관련 항목:

in

skip

public long skip(long n)
          throws IOException 

입력 스트림으로부터 의 데이터를 n 바이트만 스킵 해 파기합니다. 다양한 이유로 skip 메소드는 지정되었던 것보다도 적은 바이트수 (0 의 경우도 있다) 밖에 스킵 하지 않는 것이 있습니다. 실제로 스킵 한 바이트수를 돌려줍니다.

이 메소드는 단순하게 in.skip(n) 를 실행합니다.

오버라이드(override):

클래스 InputStream 내의 skip

파라미터:

n - 스킵 하는 바이트수

반환값:

실제로 스킵 된 바이트수

예외:

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

available

public int available()
              throws IOException 

블록 하지 않고 입력 스트림으로부터 읽어들일 수가 있는 바이트수를 돌려줍니다.

이 메소드는 단순하게 in.available(n) 를 실행해, 그 결과를 돌려줍니다.

오버라이드(override):

클래스 InputStream 내의 available

반환값:

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

예외:

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

관련 항목:

in

close

public void close()
           throws IOException 

입력 스트림을 닫아 이 스트림과 관련하는 모든 system resource를 해방합니다. 이 메소드는 단순하게 in.close() 를 실행합니다.

오버라이드(override):

클래스 InputStream 내의 close

예외:

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

관련 항목:

in

mark

public void mark(int readlimit)

입력 스트림의 현재 위치에 마크를 설정합니다. 이것에 이어 reset 메소드를 호출하면(자), 마지막에 마크가 설정된 위치에 스트림을 재설정하기 위해(때문에), 다음번의 read 조작에서는 같은 바이트로부터 읽어들이게 됩니다.

인수 readlimit 는 이 입력 스트림에 대해서, 마크 위치가 무효가 되기 전에 이 인수가 지정하는 바이트수를 읽어들이도록(듯이) 지시합니다.

이 메소드는 단순하게 in.mark(readlimit) 를 실행합니다.

오버라이드(override):

클래스 InputStream 내의 mark

파라미터:

readlimit - 마크 위치가 무효가 되기 전에 읽어들여 가능한 바이트의 최대 리밋트

관련 항목:

in , reset()

reset

public void reset()
           throws IOException 

이 스트림의 위치를, 입력 스트림으로 마지막에 mark 메소드가 불려 갔을 때의 마크 위치에 재설정합니다.

이 메소드는 단순하게 in.reset() 를 실행합니다.

스트림의 마크는 스트림에 무엇이 포함되어 있는지를 체크하기 위해서, 조금 데이터를 예측하기 위해서 사용됩니다. 이것을 가장 용이하게 실행하는 방법은 일반적인 파서를 호출하는 것입니다. 스트림을 파서로 취급할 수 있는 타입이면, 이것으로 모두 잘 되어갑니다. 스트림이 이러한 타입이 아닌 경우는 파서가 실패한 장소에서 예외를 발생시킵니다. readlimit 바이트의 범위내에서 이것이 발생했을 경우는 예외를 검지한 외부 코드가 스트림을 리셋트 해, 별도인 파서로 재시행할 수가 있습니다.

오버라이드(override):

클래스 InputStream 내의 reset

예외:

IOException - 스트림에 마크가 설정되어 있지 않았던 경우, 또는 마크가 무효가 되어 있었을 경우

관련 항목:

in , mark(int)

markSupported

public boolean markSupported()

입력 스트림이 mark 와 reset 메소드를 서포트하고 있을지 어떨지를 판정합니다. 이 메소드는 단순하게 in.markSupported() 를 실행합니다.

오버라이드(override):

클래스 InputStream 내의 markSupported

반환값:

스트림이 mark 와 reset 메소드를 서포트하는 타입의 경우는 true, 그렇지 않은 경우는 false

관련 항목:

in , InputStream.mark(int) , InputStream.reset()