compact1, compact2, compact3

java.io

Class BufferedInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

java.io.BufferedInputStream

All Implemented Interfaces:

Closeable ， AutoCloseable

public class BufferedInputStream
extends FilterInputStream

A BufferedInputStream为另一个输入流添加了功能，即缓冲输入和支持mark和reset方法的功能。 当创建BufferedInputStream时，将创建一个内部缓冲区数组。 当从流中读取或跳过字节时，内部缓冲区将根据需要从所包含的输入流中重新填充，一次有多个字节。 mark操作会记住输入流中的一点，并且reset操作会导致从最近的mark操作之后读取的所有字节在从包含的输入流中取出新的字节之前重新读取。

从以下版本开始：

JDK1.0

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	buf 存储数据的内部缓冲区数组。
protected int	count 索引一大于缓冲区中最后一个有效字节的索引。
protected int	marklimit mark方法调用后，最大超前允许，后续调用 reset方法失败。
protected int	markpos pos字段在最后一个 mark方法被调用时的值。
protected int	pos 缓冲区中的当前位置。

Fields inherited from class java.io.FilterInputStream

in

构造方法摘要

构造方法

Constructor and Description
BufferedInputStream(InputStream in) 创建一个 BufferedInputStream并保存其参数，输入流 in ，供以后使用。
BufferedInputStream(InputStream in, int size) 创建 BufferedInputStream具有指定缓冲区大小，并保存其参数，输入流 in ，供以后使用。

方法摘要

Modifier and Type	Method and Description
int	available() 返回从该输入流中可以读取（或跳过）的字节数的估计值，而不会被下一次调用此输入流的方法阻塞。
void	close() 关闭此输入流并释放与流相关联的任何系统资源。
void	mark(int readlimit) 见的总承包 mark的方法 InputStream 。
boolean	markSupported() 测试这个输入流是否支持 mark和 reset方法。
int	read() 见 read法 InputStream的一般合同。
int	read(byte[] b, int off, int len) 从给定的偏移开始，将字节输入流中的字节读入指定的字节数组。
void	reset() 见 reset法 InputStream的一般合同。
long	skip(long n) 见 skip法 InputStream的一般合同。

Methods inherited from class java.io.FilterInputStream

read

Methods inherited from class java.lang.Object

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

字段详细信息

buf

protected volatile byte[] buf

存储数据的内部缓冲区数组。 必要时，可以用不同大小的另一个阵列代替。

count

protected int count

索引一大于缓冲区中最后一个有效字节的索引。 此值始终在0到buf.length ; 元素buf[0]至buf[count-1]包含从底层输入流获得的缓冲输入数据。

pos

protected int pos

缓冲区中的当前位置。 这是从buf数组读取的下一个字符的索引。

此值始终在0到count 。 如果小于count ，那么buf[pos]是作为输入提供的下一个字节; 如果等于count ，那么接下来的read或skip操作将需要从包含的输入流读取更多的字节。

另请参见：

buf

markpos

protected int markpos

pos字段在最后一个mark方法被调用时的值。

此值始终在-1到pos 。 如果输入流中没有标记位置，则此字段为-1 。 如果在输入流中有一个标记的位置，那么buf[markpos]是reset操作后作为输入提供的第一个字节。 如果markpos不是-1 ，然后从位置的所有字节buf[markpos]通过buf[pos-1]必须保留在缓冲器阵列中（尽管它们可以被移动到缓冲器阵列中的另一个处，与适当的调整的值count ， pos和markpos ）; 除非pos和markpos之间的markpos超过marklimit 。

另请参见：

mark(int) ， pos

marklimit

protected int marklimit

读取的最大的一个电话后，允许提前mark后续调用方法之前reset方法失败。 每当之间的差别pos和markpos超过marklimit ，则标记可以被设置下降markpos到-1 。

另请参见：

mark(int) ， reset()

构造方法详细信息

BufferedInputStream

public BufferedInputStream(InputStream in)

创建一个BufferedInputStream并保存其参数，输入流in供以后使用。 内部缓冲区数组创建并存储在buf 。

参数

in - 底层输入流。

BufferedInputStream

public BufferedInputStream(InputStream in,
                           int size)

创建具有BufferedInputStream缓冲区大小的BufferedInputStream，并保存其参数，输入流in供以后使用。 长度为size的内部缓冲区阵列被创建并存储在buf 。

参数

in - 底层输入流。

size - 缓冲区大小。

异常

IllegalArgumentException - 如果 size <= 0 。

方法详细信息

read

public int read()
         throws IOException

见 read法 InputStream的一般合同。

重写：

read在 FilterInputStream

结果

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

异常

IOException - 如果此输入流已通过调用其 close()方法已关闭，或发生I / O错误。

另请参见：

FilterInputStream.in

read

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

从给定的偏移开始，将字节输入流中的字节读入指定的字节数组。

该方法执行InputStream类对应的read方法的一般合同。 作为一个额外的方便，它尝试通过重复调用基础流的read方法来读取尽可能多的字节。 此迭代read继续，直至read条件之一为止：

• 指定的字节数已被读取，
• 底层流的read方法返回-1 ，表示文件结尾，或
• 底层流的available方法返回零，表示进一步的输入请求将阻塞。

如果基础流上的第一个read返回-1以指示文件结束，则此方法返回-1 。 否则，此方法返回实际读取的字节数。

鼓励这个类的子类，但不是必需的，尝试以相同的方式读取尽可能多的字节。

重写：

read在 FilterInputStream

参数

b - 目的缓冲区。

off - 开始存储字节的偏移量。

len - 要读取的最大字节数。

结果

读取的字节数，或 -1如果流已到达）。

异常

IOException - 如果此输入流已通过调用其 close()方法关闭，或发生I / O错误。

另请参见：

FilterInputStream.in

skip

public long skip(long n)
          throws IOException

见的总承包 skip的方法 InputStream 。

重写：

skip在 FilterInputStream

参数

n - 要跳过的字节数。

结果

实际跳过的字节数。

异常

IOException - 如果流不支持查询，或者如果此输入流已通过调用其 close()方法关闭，或发生I / O错误。

available

public int available()
              throws IOException

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

该方法返回缓冲区（ count - pos ）中要读取的剩余字节数和调用in .available（）的结果。

重写：

available在 FilterInputStream

结果

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

异常

IOException - 如果此输入流已通过调用其 close()方法关闭，或发生I / O错误。

mark

public void mark(int readlimit)

见的总承包 mark的方法 InputStream 。

重写：

mark在类别 FilterInputStream

参数

readlimit - 标记位置无效之前可以读取的最大字节数限制。

另请参见：

reset()

reset

public void reset()
           throws IOException

见的总承包reset的方法InputStream 。

如果markpos是-1 （没有设置标记或标记已被无效），则抛出IOException 。 否则， pos设置等于markpos 。

重写：

reset在类别 FilterInputStream

异常

IOException - 如果该流未被标记，或者如果该标记已被无效，或通过调用其 close()方法已关闭流或发生I / O错误。

另请参见：

mark(int)

markSupported

public boolean markSupported()

测试此输入流是否支持mark和reset方法。 markSupported方法BufferedInputStream返回true 。

重写：

markSupported在 FilterInputStream

结果

一个 boolean指示这种流类型是否支持 mark和 reset方法。

另请参见：

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

close

public void close()
           throws IOException

关闭此输入流并释放与流相关联的任何系统资源。 一旦流已关闭，进一步的read（），available（），reset（）或skip（）调用将抛出IOException异常。 关闭以前关闭的流无效。

Specified by:

close在界面 Closeable

Specified by:

close在界面 AutoCloseable

重写：

close在 FilterInputStream

异常

IOException - 如果发生I / O错误。

另请参见：

FilterInputStream.in