java.lang.Object
|---java.io.InputStream
|---|---java.io.ByteArrayInputStream
public class ByteArrayInputStream
extends InputStream
ByteArrayInputStream 包含一个内部缓冲区，其中包含可以从流中读取的字节。 内部计数器跟踪读取方法提供的下一个字节。
关闭 ByteArrayInputStream 无效。 可以在流关闭后调用此类中的方法，而不会生成 IOException。
Since:
JDK1.0
| 修饰符和类型 | 字段 | 描述 |
|---|---|---|
| protected byte[] | buf | 由流的创建者提供的字节数组。 |
| protected int | count | 比输入流缓冲区中最后一个有效字符大一的索引。 |
| protected int | mark | 流中当前标记的位置。 |
| protected int | pos | 要从输入流缓冲区读取的下一个字符的索引。 |
| 构造函数 | 描述 |
|---|---|
| ByteArrayInputStream(byte[] buf) | 创建一个ByteArrayInputStream，使其使用buf作为其缓冲区阵列。 |
| ByteArrayInputStream(byte[] buf, int offset, int length) | 创建ByteArrayInputStream，使用buf作为其缓冲区阵列。 |
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| int | available() | 返回可以从该输入流中读取（或跳过）的剩余字节数。 |
| void | close() | 关闭一个ByteArrayInputStream没有任何效果。 |
| void | mark(int readAheadLimit) | 设置流中的当前标记位置。 |
| boolean | markSupported() | 测试这个InputStream是否支持mark/reset。 |
| int | read() | 从这个输入流中读取下一个字节的数据。 |
| int | read(byte[] b, int off, int len) | 从这个输入流中读取最多为len字节的数据到一个字节数组。 |
| void | reset() | 将缓冲区重置到标记位置。 |
| long | skip(long n) | 从这个输入流中跳过n个字节的输入。 |
| 从java.io.InputStream类继承的方法 |
|---|
| read |
| 从java.lang.Object类继承的方法 |
|---|
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
protected byte[] buf
一个由流的创建者提供的字节数组。buf[0]到buf[count-1]元素是唯一可以从流中读取的字节；buf[pos]元素是下一个要读取的字节。
protected int count
比输入流缓冲区中最后一个有效字符大一的索引。这个值应该总是非负的，并且不大于buf的长度。它比可以从输入流缓冲区读取的buf中最后一个字节的位置大一。
protected int mark
当前在流中标记的位置。ByteArrayInputStream对象在构造时默认标记在零位置。它们可以通过mark()方法标记在缓冲区的另一个位置。当前的缓冲区位置被reset()方法设置为这个点。
如果没有设置标记，那么标记的值就是传递给构造函数的偏移量（如果没有提供偏移量，则为0）。
Since:
JDK1.1
protected int pos
从输入流缓冲区读取下一个字符的索引。这个值应该总是非负的，并且不大于count的值。要从输入流缓冲区读取的下一个字节将是buf[pos]。
public ByteArrayInputStream(byte[] buf)
创建一个ByteArrayInputStream，使其使用buf作为其缓冲区阵列。缓冲区数组不会被复制。pos的初始值是0，count的初始值是buf的长度。
参数。
| 参数名称 | 参数描述 |
|---|---|
| buf | 输入缓冲区。 |
public ByteArrayInputStream(byte[] buf, int offset, int length)
创建ByteArrayInputStream，使用buf作为其缓冲阵列。pos的初始值是offset，count的初始值是offset+length和buf.length的最小值。缓冲区数组不被复制。缓冲区的标记被设置为指定的偏移量。
参数。
| 参数名称 | 参数描述 |
|---|---|
| buf | 输入缓冲区。 |
| offset | 要读取的第一个字节在缓冲区的偏移量。 |
| length | 从缓冲区读取的最大字节数。 |
public int read()
从这个输入流中读取下一个字节的数据。字节值以0-255范围内的一个int形式返回。如果因为已经到达流的末端而没有可用的字节，将返回值-1。
这个读取方法不能阻塞。
指定的对象：
read in class InputStream
返回：
下一个字节的数据，或者如果已经到达了流的末端，则返回-1。
public int read(byte[] b, int off, int len)
从这个输入流中读取最多为len字节的数据到一个字节数组。如果pos等于count，则返回-1，表示文件结束。否则，读取的字节数k等于len和count-pos中较小的那个。如果k是正数，那么buf[pos]到buf[pos+k-1]的字节将以System.arraycopy的方式被复制到b[off]到b[off+k-1]。数值k被添加到pos中，k被返回。
这个读取方法不能阻塞。
重写。
read 在类InputStream中
参数。
| 参数名称 | 参数描述 |
|---|---|
| b | 读取数据的缓冲区。 |
| off | 目的数组中的起始偏移量 b |
| len | 读取的最大字节数。 |
返回：
读入缓冲区的总字节数，如果没有更多的数据，因为已经达到了流的终点，则返回-1。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| NullPointerException | 如果b为空。 |
| IndexOutOfBoundsException | 如果off为负数，len为负数，或者len大于b.length - off |
public long skip(long n)
从这个输入流中跳过n个字节的输入。如果到了输入流的末端，可能会跳过更少的字节。被跳过的实际字节数k等于n和count-pos中的较小值。k的值被加到pos中，k被返回。
覆盖。
skip in class InputStream
参数。
| 参数名称 | 参数描述 |
|---|---|
| n | 要跳过的字节数。 |
返回：
实际跳过的字节数。
public int available()
返回可以从该输入流中读取（或跳过）的剩余字节数。
返回的值是count - pos，即从输入缓冲区读出的剩余字节数。
重写：
在类InputStream中可用
返回：
可以从这个输入流中读取（或跳过）的剩余字节数，不存在阻塞问题。
public boolean markSupported()
测试这个InputStream是否支持mark/reset。ByteArrayInputStream的markSupported方法总是返回true。
重写：
markSupported in class InputStream
返回：
true 如果这个流实例支持mark和reset方法；否则false。
Since:
JDK1.1
public void mark(int readAheadLimit)
设置流中的当前标记位置。ByteArrayInputStream对象在构造时默认被标记在0的位置。他们可以通过这个方法在缓冲区内的其他位置进行标记。
如果没有设置标记，那么标记的值就是传递给构造函数的偏移量（如果没有提供偏移量则为0）。
注意：这个类的readAheadLimit没有意义。
重写：
mark in class InputStream
参数：
| 参数名称 | 参数描述 |
|---|---|
| readAheadLimit | 在标记位置变得无效之前可以读取的最大限制字节数。 |
Since:
JDK1.1
public void reset()
将缓冲区重置到标记的位置。标记的位置是0，除非标记了另一个位置或者在构造函数中指定了一个偏移。
重述：
reset in class InputStream
public void close() throws IOException
关闭ByteArrayInputStream没有效果。该类中的方法可以在流关闭后调用，而不会生成IOException。
规定:
关闭接口自动关闭
规定:
close in interface可关闭
覆盖:
在类InputStream中关闭
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IOException | 如果发生I/O错误。 |
备案信息： 粤ICP备15087711号-2
Copyright © 2008-2024 啊嘎哇在线工具箱 All Rights.
本站所有资料来源于网络，版权归原作者所有，仅作学习交流使用，如不慎侵犯了您的权利，请联系我们。