鸿蒙OS BufferedInputStream
BufferedInputStream
java.lang.Object
|---java.io.InputStream
|---|---java.io.FilterInputStream
|---|---|---java.io.BufferedInputStream
public class BufferedInputStream
extends FilterInputStreamBufferedInputStream 向另一个输入流添加了功能，即缓冲输入并支持标记和重置方法的能力。 创建 BufferedInputStream 时，会创建一个内部缓冲区数组。 当流中的字节被读取或跳过时，内部缓冲区会根据需要从包含的输入流中重新填充，一次很多字节。 标记操作会记住输入流中的一个点，并且重置操作会导致在从包含的输入流中获取新字节之前重新读取自最近一次标记操作以来读取的所有字节。
Since:
JDK1.0
字段摘要
| 修饰符和类型 | 字段 | 描述 |
|---|---|---|
| protected byte[] | buf | 存储数据的内部缓冲区数组。 |
| protected int | count | 比缓冲区中最后一个有效字节的索引大一的索引。 |
| protected int | marklimit | 在随后调用 reset 方法失败之前调用 mark 方法后允许的最大预读。 |
| protected int | markpos | 调用最后一个标记方法时 pos 字段的值。 |
| protected int | pos | 缓冲区中的当前位置。 |
| 从类 java.io.FilterInputStream 继承的字段 |
|---|
| in |
构造函数摘要
| 构造函数 | 描述 |
|---|---|
| BufferedInputStream(InputStream in) | 创建一个 BufferedInputStream 并保存其参数，即输入流，以供以后使用。 |
| BufferedInputStream(InputStream in, int size) | 创建具有指定缓冲区大小的 BufferedInputStream，并保存其参数，即输入流，以供以后使用。 |
方法总结
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| 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 方法的通用约定。 |
| 从类 java.io.FilterInputStream 继承的方法 |
|---|
| read |
| 从类 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] 包含从底层输入流获得的缓冲输入数据。
marklimit
protected int marklimit
在随后调用 reset 方法失败之前调用 mark 方法后允许的最大预读。 每当 pos 和 markpos 之间的差值超过 marklimit 时，可以通过将 markpos 设置为 -1 来删除该标记。
markpos
protected int markpos
调用最后一个标记方法时 pos 字段的值。
该值始终在 -1 到 pos 的范围内。 如果输入流中没有标记位置，则该字段为-1。 如果输入流中有标记位置，则 buf[markpos] 是复位操作后作为输入提供的第一个字节。 如果 markpos 不是 -1，则从位置 buf[markpos] 到 buf[pos-1] 的所有字节都必须保留在缓冲区数组中（尽管它们可以移动到缓冲区数组中的另一个位置，并适当调整 计数、位置和标记位置）； 除非且直到 pos 和 markpos 之间的差异超过 marklimit，否则它们可能不会被丢弃。
pos
protected int pos
缓冲区中的当前位置。 这是要从 buf 数组中读取的下一个字符的索引。
该值始终在 0 到 count 的范围内。 如果它小于 count，则 buf[pos] 是作为输入提供的下一个字节； 如果它等于 count，那么下一次读取或跳过操作将需要从包含的输入流中读取更多字节。
构造函数详细信息
BufferedInputStream
public BufferedInputStream(InputStream in)
创建一个 BufferedInputStream 并保存其参数，即输入流，以供以后使用。 创建一个内部缓冲区数组并将其存储在 buf 中。
参数：
| 参数名称 | 参数描述 |
|---|---|
| in | 底层输入流。 |
BufferedInputStream
public BufferedInputStream(InputStream in, int size)
创建具有指定缓冲区大小的 BufferedInputStream，并保存其参数，即输入流，以供以后使用。 创建一个长度大小的内部缓冲区数组并将其存储在 buf 中。
参数：
| 参数名称 | 参数描述 |
|---|---|
| in | 底层输入流。 |
| size | 缓冲区大小。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果 size <= 0. |
方法详情
read
public int read() throws IOException
参见 InputStream 的 read 方法的通用约定。
覆盖：
读入类 FilterInputStream
返回:
数据的下一个字节，如果到达流的末尾，则为 -1。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果此输入流已通过调用其 close() 方法关闭，或者发生 I/O 错误。 |
read
public int read(byte[] b, int off, int len) throws IOException
从此字节输入流中将字节读取到指定的字节数组中，从给定的偏移量开始。
该方法实现了 InputStream 类对应的 [InputStream#read(byte], int, int) 方法的通用约定。 作为额外的便利，它尝试通过重复调用底层流的读取方法来读取尽可能多的字节。 此迭代读取将继续，直到满足以下条件之一：
- 已读取指定数量的字节，
- 底层流的read方法返回-1，表示文件结束，或者
- 底层流的可用方法返回零，表示进一步的输入请求将阻塞。
如果对底层流的第一次读取返回 -1 以指示文件结束，则此方法返回 -1。 否则，此方法返回实际读取的字节数。
鼓励但不要求此类的子类尝试以相同方式读取尽可能多的字节。
覆盖：
读入类 FilterInputStream
参数：
| 参数名称 | 参数描述 |
|---|---|
| b | 目标缓冲区。 |
| off | 开始存储字节的偏移量。 |
| len | 要读取的最大字节数。 |
返回:
读取的字节数，如果已到达流的末尾，则为 -1。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果此输入流已通过调用其 close() 方法关闭，或者发生 I/O 错误。 |
skip
public long skip(long n) throws IOException
参见 InputStream 的 skip 方法的通用约定。
覆盖：
跳过类 FilterInputStream
参数：
| 参数名称 | 参数描述 |
|---|---|
| n | 要跳过的字节数。 |
返回:
跳过的实际字节数。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果流不支持查找，或者此输入流已通过调用其 close() 方法关闭，或者发生 I/O 错误。 |
available
public int available() throws IOException
返回可以从此输入流中读取（或跳过）的字节数的估计值，而不会被下一次调用此输入流的方法阻塞。 下一次调用可能是同一个线程或另一个线程。 单次读取或跳过这么多字节不会阻塞，但可能会读取或跳过更少的字节。
此方法返回缓冲区中要读取的剩余字节数 (count - pos) 和调用 in.available() 的结果之和。
覆盖：
在类 FilterInputStream 中可用
返回:
估计可以从该输入流中读取（或跳过）而不阻塞的字节数。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果此输入流已通过调用其 close() 方法关闭，或者发生 I/O 错误。 |
mark
public void mark(int readlimit)
参见 InputStream 的 mark 方法的通用约定。
覆盖：
在类 FilterInputStream 中标记
参数：
| 参数名称 | 参数描述 |
|---|---|
| readlimit | 在标记位置无效之前可以读取的最大字节数。 |
reset
public void reset() throws IOException
参见 InputStream 的 reset 方法的通用约定。
如果 markpos 为 -1（未设置标记或标记已失效），则抛出 IOException。 否则，将 pos 设置为等于 markpos。
覆盖：
在类 FilterInputStream 中重置
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果此流尚未被标记，或者如果标记已失效，或者流已通过调用其 close() 方法关闭，或者发生 I/O 错误。 |
markSupported
public boolean markSupported()
测试此输入流是否支持 mark 和 reset 方法。 BufferedInputStream 的 markSupported 方法返回 true。
覆盖：
类 FilterInputStream 中的 markSupported
返回:
一个布尔值，指示此流类型是否支持标记和重置方法。
close
public void close() throws IOException
关闭此输入流并释放与该流关联的所有系统资源。 关闭流后，进一步的 read()、available()、reset() 或 skip() 调用将引发 IOException。 关闭以前关闭的流没有效果。
指定者：
在接口 AutoCloseable 中关闭
指定者：
在接口Closeable中关闭
覆盖：
在类 FilterInputStream 中关闭
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生 I/O 错误。 |