ByteArrayInputStream
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 |
字段详细信息
buf
protected byte[] buf
一个由流的创建者提供的字节数组。buf[0]到buf[count-1]元素是唯一可以从流中读取的字节;buf[pos]元素是下一个要读取的字节。
count
protected int count
比输入流缓冲区中最后一个有效字符大一的索引。这个值应该总是非负的,并且不大于buf的长度。它比可以从输入流缓冲区读取的buf中最后一个字节的位置大一。
mark
protected int mark
当前在流中标记的位置。ByteArrayInputStream对象在构造时默认标记在零位置。它们可以通过mark()方法标记在缓冲区的另一个位置。当前的缓冲区位置被reset()方法设置为这个点。
如果没有设置标记,那么标记的值就是传递给构造函数的偏移量(如果没有提供偏移量,则为0)。
Since:
JDK1.1
pos
protected int pos
从输入流缓冲区读取下一个字符的索引。这个值应该总是非负的,并且不大于count的值。要从输入流缓冲区读取的下一个字节将是buf[pos]。
构造函数详细信息
ByteArrayInputStream
public ByteArrayInputStream(byte[] buf)
创建一个ByteArrayInputStream,使其使用buf作为其缓冲区阵列。缓冲区数组不会被复制。pos的初始值是0,count的初始值是buf的长度。
参数。
参数名称 | 参数描述 |
---|---|
buf | 输入缓冲区。 |
ByteArrayInputStream
public ByteArrayInputStream(byte[] buf, int offset, int length)
创建ByteArrayInputStream,使用buf作为其缓冲阵列。pos的初始值是offset,count的初始值是offset+length和buf.length的最小值。缓冲区数组不被复制。缓冲区的标记被设置为指定的偏移量。
参数。
参数名称 | 参数描述 |
---|---|
buf | 输入缓冲区。 |
offset | 要读取的第一个字节在缓冲区的偏移量。 |
length | 从缓冲区读取的最大字节数。 |
方法详情
read
public int read()
从这个输入流中读取下一个字节的数据。字节值以0-255范围内的一个int形式返回。如果因为已经到达流的末端而没有可用的字节,将返回值-1。
这个读取方法不能阻塞。
指定的对象:
read in class InputStream
返回:
下一个字节的数据,或者如果已经到达了流的末端,则返回-1。
read
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 |
skip
public long skip(long n)
从这个输入流中跳过n个字节的输入。如果到了输入流的末端,可能会跳过更少的字节。被跳过的实际字节数k等于n和count-pos中的较小值。k的值被加到pos中,k被返回。
覆盖。
skip in class InputStream
参数。
参数名称 | 参数描述 |
---|---|
n | 要跳过的字节数。 |
返回:
实际跳过的字节数。
available
public int available()
返回可以从该输入流中读取(或跳过)的剩余字节数。
返回的值是count – pos,即从输入缓冲区读出的剩余字节数。
重写:
在类InputStream中可用
返回:
可以从这个输入流中读取(或跳过)的剩余字节数,不存在阻塞问题。
markSupported
public boolean markSupported()
测试这个InputStream是否支持mark/reset。ByteArrayInputStream的markSupported方法总是返回true。
重写:
markSupported in class InputStream
返回:
true 如果这个流实例支持mark和reset方法;否则false。
Since:
JDK1.1
mark
public void mark(int readAheadLimit)
设置流中的当前标记位置。ByteArrayInputStream对象在构造时默认被标记在0的位置。他们可以通过这个方法在缓冲区内的其他位置进行标记。
如果没有设置标记,那么标记的值就是传递给构造函数的偏移量(如果没有提供偏移量则为0)。
注意:这个类的readAheadLimit没有意义。
重写:
mark in class InputStream
参数:
参数名称 | 参数描述 |
---|---|
readAheadLimit | 在标记位置变得无效之前可以读取的最大限制字节数。 |
Since:
JDK1.1
reset
public void reset()
将缓冲区重置到标记的位置。标记的位置是0,除非标记了另一个位置或者在构造函数中指定了一个偏移。
重述:
reset in class InputStream
close
public void close() throws IOException
关闭ByteArrayInputStream没有效果。该类中的方法可以在流关闭后调用,而不会生成IOException。
规定:
关闭接口自动关闭
规定:
close in interface可关闭
覆盖:
在类InputStream中关闭
Throws:
Throw名称 | Throw描述 |
---|---|
IOException | 如果发生I/O错误。 |