compact1, compact2, compact3

java.io

Class FilterInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

All Implemented Interfaces:

Closeable， AutoCloseable

已知直接子类：

BufferedInputStream， CheckedInputStream， CipherInputStream， DataInputStream， DeflaterInputStream， DigestInputStream， InflaterInputStream， LineNumberInputStream， ProgressMonitorInputStream， PushbackInputStream

public class FilterInputStream
extends InputStream

一个 FilterInputStream包含一些其他输入流，它使用作为其基本数据源，可能改变数据沿道路或提供额外的功能。这类 FilterInputStream本身只是重写，过去的所有请求的版本包含输入流 InputStream所有方法。子 FilterInputStream可能进一步覆盖其中的一些方法也可以提供额外的方法和字段。

从以下版本开始：

JDK1.0

Field Summary

Fields

Modifier and Type	Field and Description
protected InputStream	in 要过滤的输入流。

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	FilterInputStream(InputStream in) 通过指定参数 in到外地 this.in以便记住它以后使用创建一个 FilterInputStream。

方法摘要

Modifier and Type	Method and Description
int	available() 返回一个可以从这个输入流读取（或跳过）的字节数的估计值，而不阻塞该输入流的下一个调用方的方法。
void	close() 关闭此输入流并释放与流关联的任何系统资源。
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字节输入流中的数据。

Methods inherited from class java.lang.Object

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

Field Detail

in

protected volatile InputStream in

要过滤的输入流。

Constructor Detail

FilterInputStream

protected FilterInputStream(InputStream in)

通过指定参数 in到外地 this.in以便记住它以后使用创建一个 FilterInputStream。

参数

in -潜在的输入流，或 null如果此实例被创建，没有潜在的流。

方法详细信息

read

public int read()
         throws IOException

从这个输入流读取下一个数据字节。字节的值在范围 0一 int到 255返回。如果没有可用的字节，因为已到达流的末尾，则返回值 -1。此方法块，直到输入数据可用，流的结束被检测到，或抛出异常。

该方法简单in.read()执行并返回结果。

Specified by:

read 方法重写，继承类 InputStream

结果

下一个数据字节，或 -1如果到达流的末尾。

异常

IOException如果I/O错误发生。

另请参见：

in

read

public int read(byte[] b)
         throws IOException

读到 byte.length从输入流到字节数组数据字节。该方法块，直到有一个输入可用。

此方法只需执行呼叫read(b, 0, b.length)并返回结果。它不做in.read(b)取而代之的是重要的；某些子类的FilterInputStream取决于实施策略的实际应用。

重写：

read 方法重写，继承类 InputStream

参数

b -缓冲区中读取数据。

结果

读入缓冲的字节总数，或 -1如果没有更多的数据，因为已到达流的末尾。

异常

IOException如果I/O错误发生。

另请参见：

read(byte[], int, int)

read

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

读到 len从输入流到字节数组数据字节。如果 len不为零，该方法阻塞直到输入可用；否则，没有字节读取和 0返回。

该方法简单in.read(b, off, len)执行并返回结果。

重写：

read 方法重写，继承类 InputStream

参数

b -缓冲区中读取数据。

off -开始抵消目标数组 b

len -的最大字节数读。

结果

读入缓冲的字节总数，或 -1如果没有更多的数据，因为已到达流的末尾。

异常

如果是 null b NullPointerException。

IndexOutOfBoundsException -如果 off是负的， len是负的，或 len大于 b.length - off

IOException如果I/O错误发生。

另请参见：

in

skip

public long skip(long n)
          throws IOException

跳过并丢弃 n字节输入流中的数据。 skip方法的可能，因为种种原因，最终跳过一些较小的字节数，可能 0。跳过的字节数实际返回。

此方法只需执行in.skip(n)。

重写：

skip 方法重写，继承类 InputStream

参数

n -字节数被跳过。

结果

跳过的实际字节数。

异常

IOException如果流不支持查找，或者其他一些发生I/O错误。

available

public int available()
              throws IOException

返回一个可以从这个输入流读取（或跳过）的字节数的估计值，而不阻塞该输入流的下一个调用方的方法。下一个调用方可能是同一个线程或另一个线程。一个单一的读或跳过这许多字节将不会阻止，但可以读取或跳过更少的字节数。

此方法返回的结果available() in。

重写：

available 方法重写，继承类 InputStream

结果

可以从这个输入流中读取（或跳过）的字节数的估计，而不阻塞。

异常

IOException如果I/O错误发生。

close

public void close()
           throws IOException

关闭此输入流并释放与流关联的任何系统资源。此方法只需执行 in.close()。

Specified by:

close 接口 Closeable

Specified by:

close 接口 AutoCloseable

重写：

close 方法重写，继承类 InputStream

异常

IOException如果I/O错误发生。

另请参见：

in

mark

public void mark(int readlimit)

标记此输入流中的当前位置。随后打电话给 reset方法重新定位该流的最后标记的位置以便后续读重读相同的字节。

争论的readlimit告诉这个输入流，使许多字节在标记位置获取无效阅读。

此方法只需执行in.mark(readlimit)。

重写：

mark 方法重写，继承类 InputStream

参数

readlimit -字节可以在标记位置无效阅读最大限度。

另请参见：

in， reset()

reset

public void reset()
           throws IOException

重新定位该流在时间的 mark方法的位置上呼吁这个输入流。

此方法只需执行in.reset()。

流标记的目的是要使用的情况下，你需要阅读前面的一点，看看什么在流中。通常这是最容易通过调用一些通用的解析器来完成的。如果流是由解析处理的类型，它只是遵循着幸福。如果流不是该类型的，则解析器失败时应将其抛出一个异常。如果这发生在readlimit字节，它允许外码重置流并尝试另一个解析器。

重写：

reset 方法重写，继承类 InputStream

异常

IOException如果流不明显或者商标已失效。

另请参见：

in， mark(int)

markSupported

public boolean markSupported()

如果输入流的支持 mark和 reset方法。此方法只需执行 in.markSupported()。

重写：

markSupported 方法重写，继承类 InputStream

结果

如果这 true流类型支持 mark和 reset方法； false否则。

另请参见：

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