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的方法， InputStream版本将所有请求传递给包含的输入流。 FilterInputStream的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

字段详细信息

in

protected volatile InputStream in

要过滤的输入流。

构造方法详细信息

FilterInputStream

protected FilterInputStream(InputStream in)

通过将参数 in给字段 this.in创建一个 FilterInputStream ，以便记住它以供以后使用。

参数

in - 底层输入流，或 null如果此实例要创建而没有底层流。

方法详细信息

read

public int read()
         throws IOException

从该输入流读取下一个数据字节。 值字节作为int返回为0到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的某些子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 。

异常

NullPointerException - 如果 b是 null 。

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

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

此方法返回in .available（）的结果。

重写：

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()