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

一个 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 当时称为“最后的 mark方法的 pos字段的值。
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) 看到的 InputStream的 mark方法一般合同。
boolean	markSupported() 如果输入流的支持 mark和 reset方法。
int	read() 看到的 InputStream的 read方法一般合同。
int	read(byte[] b, int off, int len) 从这个字节的输入流读取到指定的字节数组中的字节，从给定的偏移量开始。
void	reset() 看到的 InputStream的 reset方法一般合同。
long	skip(long n) 看到的 InputStream的 skip方法一般合同。

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

Field Detail

buf

protected volatile byte[] buf

存储数据的内部缓冲区阵列。当必要时，它可能被另一个不同大小的数组所取代。

count

protected int count

在缓冲区中的最后一个有效字节的索引大于一个索引。这个值总是在范围 0通过 buf.length；元素 buf[0]通过 buf[count-1] contain缓冲输入数据从底层输入流中获取。

pos

protected int pos

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

这个值总是在范围0通过count。如果它小于count，然后buf[pos]是提供作为输入的下一个字节；如果它等于count，那么下一read或skip操作将需要更多的数据被从输入流中读取包含。

另请参见：

buf

markpos

protected int markpos

当时称为“最后的 mark方法的 pos字段的值。

这个值总是在范围-1通过pos。如果输入流中的无标记的位置，这场-1。如果输入流中的一个标记的位置，然后buf[markpos]是提供作为reset运行后输入的第一个字节。如果markpos不-1，那么所有的字节位置buf[markpos]通过buf[pos-1]必须保留在缓冲数组（尽管他们可能会搬到另一个地方在缓冲数组，用适当的调整值count，pos，和markpos）；他们可能不被丢弃，除非pos和markpos之间的差异超过marklimit。

另请参见：

mark(int)， pos

marklimit

protected int marklimit

最大允许读之前调用的方法的后续调用 mark之前的 reset方法失败之后。每当 pos和 markpos超过 marklimit之间的差异，然后马克可能下降到设定 markpos -1。

另请参见：

mark(int)， reset()

Constructor Detail

BufferedInputStream

public BufferedInputStream(InputStream in)

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

参数

in -数据输入流。

BufferedInputStream

public BufferedInputStream(InputStream in,
                           int size)

创建一个具有指定的缓冲区大小 BufferedInputStream，并保存它的参数，输入流 in，供以后使用。长 size内部缓冲区数组创建并存储在 buf。

参数

in -数据输入流。

size -缓冲区大小。

异常

如果 size <= 0 IllegalArgumentException。

方法详细信息

read

public int read()
         throws IOException

看到的 InputStream的 read方法一般合同。

重写：

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迭代直至下列条件之一为真：

• 已读取指定的字节数，
• 对基础流返回-1的read方法，表示文件结束，或
• 的基本流的available方法返回零，表明进一步的输入请求块。

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

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

重写：

read 方法重写，继承类 FilterInputStream

参数

b -目的缓冲区。

off偏移，开始存储字节。

len -最大字节数读。

结果

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

异常

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

另请参见：

FilterInputStream.in

skip

public long skip(long n)
          throws IOException

看到的 InputStream的 skip方法一般合同。

重写：

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)

看到的 InputStream的 mark方法一般合同。

重写：

mark 方法重写，继承类 FilterInputStream

参数

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

另请参见：

reset()

reset

public void reset()
           throws IOException

看到的 InputStream的 reset方法一般合同。

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

重写：

reset 方法重写，继承类 FilterInputStream

异常

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

另请参见：

mark(int)

markSupported

public boolean markSupported()

如果输入流的支持 mark和 reset方法。对 BufferedInputStream返回 true的 markSupported方法。

重写：

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