java.io
클래스 FilterInputStream

java.lang.Object 
  java.io.InputStream 
      java.io.FilterInputStream

모든 구현된 인터페이스:

Closeable

알려진 직계 서브 클래스:

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

public class FilterInputStream
extends InputStream 

FilterInputStream는 다른 입력 스트림을 포함해, 그것을 데이터의 기본적인 소스로서 사용해, 데이터를 도중에 변환하거나 추가 기능을 제공하거나 합니다. 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 volatile InputStream  in

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

생성자 상세

FilterInputStream

protected FilterInputStream(InputStream  in)

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

파라미터:

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

메서드의 상세

read

public int read()
         throws IOException 

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

이 메서드는 단순하게 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()를 실행해, 그 결과를 리턴합니다.

오버라이드(override):

클래스 InputStream 내의 available

반환값:

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

예외:

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

관련 항목:

in

close

public void close()
           throws IOException 

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

정의:

인터페이스 Closeable 내의 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()