compact1, compact2, compact3

java.io

Class ByteArrayInputStream

java.lang.Object

java.io.InputStream

java.io.ByteArrayInputStream

All Implemented Interfaces:

Closeable， AutoCloseable

public class ByteArrayInputStream
extends InputStream

一个 ByteArrayInputStream包含一个内部缓冲区包含的字节，可以从流中读取。一个内部计数器跟踪下一个字节是由 read提供的方法。

关闭ByteArrayInputStream没有影响。这个类中的方法可以在流一直没有产生一个IOException闭叫。

从以下版本开始：

JDK1.0

另请参见：

StringBufferInputStream

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	buf 由流的创建者提供的字节数组。
protected int	count 输入流缓冲区中的最后一个有效字符的索引一个大于。
protected int	mark 当前在流中的标记位置。
protected int	pos 从输入流缓冲区读取的下一个字符的索引。

构造方法摘要

构造方法

Constructor and Description
ByteArrayInputStream(byte[] buf) 创建一个 ByteArrayInputStream以便它使用 buf作为缓冲数组。
ByteArrayInputStream(byte[] buf, int offset, int length) 创建 ByteArrayInputStream使用 buf作为缓冲数组。

方法摘要

Modifier and Type	Method and Description
int	available() 返回从该输入流读取的剩余字节数（或跳过）。
void	close() 关闭 ByteArrayInputStream没有影响。
void	mark(int readAheadLimit) 在流中设置当前标记位置。
boolean	markSupported() 如果这个测试 InputStream支持马克/复位。
int	read() 从这个输入流读取下一个数据字节。
int	read(byte[] b, int off, int len) 读到 len数据从输入流中的字节数组的字节。
void	reset() 重置缓存到标记的位置。
long	skip(long n) 跳过 n字节的输入从输入流。

Methods inherited from class java.io.InputStream

read

Methods inherited from class java.lang.Object

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

Field Detail

buf

protected byte[] buf

由流的创建者提供的字节数组。通过元素 buf[0] buf[count-1]是唯一能从流中读取字节；元 buf[pos]是下一个要读取的字节。

pos

protected int pos

从输入流缓冲区读取的下一个字符的索引。这个值应该是非负的和不大于 count价值。是从输入流的缓冲中读取下一个字节将 buf[pos]。

mark

protected int mark

当前在流中的标记位置。从字节数组读取的输入流对象被标记为零位置时默认构造。他们可以标记缓冲的另一个位置的 mark()方法。缓冲区的当前位置设置为该点的 reset()方法。

如果没有设置标记，则标记的值是传递给构造函数的偏移量（如果不提供偏移量，则为0）。

从以下版本开始：

JDK1.1

count

protected int count

输入流缓冲区中的最后一个有效字符的索引一个大于。这个值应该是非负的和不大于 buf长度。这是一个比一个大的最后一个字节，在 buf能从输入流的缓冲中读取位置。

Constructor Detail

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一 int到 255返回。如果没有可用的字节，因为已到达流的末尾，则返回值 -1。

这read方法不能阻止。

Specified by:

read 方法重写，继承类 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]字节复制到 b[off]通过的方式进行 System.arraycopy b[off+k-1]。价值 k加入 pos和 k返回。

这read方法不能阻止。

重写：

read 方法重写，继承类 InputStream

参数

b -缓冲区中读取数据。

off -目标数组 b的起始偏移量

len -的最大字节数读。

结果

读入缓冲的字节总数，或 -1如果没有更多的数据，因为已到达流的末尾。

异常

如果是 null b NullPointerException。

IndexOutOfBoundsException -如果 off是负的， len是负的，或 len大于 b.length - off

另请参见：

InputStream.read()

skip

public long skip(long n)

跳过 n字节的输入从输入流。如果达到输入流的结尾，则可能会跳过更少的字节数。要跳过的字节的实际数量 k等于 n和 count-pos较小。价值 k加入 pos和 k返回。

重写：

skip 方法重写，继承类 InputStream

参数

n -字节数被跳过。

结果

跳过的实际字节数。

available

public int available()

返回从该输入流读取的剩余字节数（或跳过）。

返回值count - pos，这是有待从输入缓冲区读取的字节数。

重写：

available 方法重写，继承类 InputStream

结果

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

markSupported

public boolean markSupported()

如果这个测试 InputStream支持马克/复位。对 ByteArrayInputStream的 markSupported方法总是返回 true。

重写：

markSupported 方法重写，继承类 InputStream

结果

如果这 true流实例支持的标记和复位方法； false否则。

从以下版本开始：

JDK1.1

另请参见：

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

mark

public void mark(int readAheadLimit)

在流中设置当前标记位置。从字节数组读取的输入流对象被标记为零位置时默认构造。他们可能会被标记在缓冲区内的另一个位置，通过该方法。

如果没有设置标记，则标记的值是传递给构造函数的偏移量（如果不提供偏移量，则为0）。

注意：这个类的readAheadLimit没有意义。

重写：

mark 方法重写，继承类 InputStream

参数

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

从以下版本开始：

JDK1.1

另请参见：

InputStream.reset()

reset

public void reset()

重置缓存到标记的位置。标记位置为0，除非在构造函数中指定了另一个位置或偏移量。

重写：

reset 方法重写，继承类 InputStream

另请参见：

InputStream.mark(int)， IOException

close

public void close()
           throws IOException

关闭 ByteArrayInputStream没有影响。这个类中的方法可以在流一直没有产生一个 IOException闭叫。

Specified by:

close 接口 Closeable

Specified by:

close 接口 AutoCloseable

重写：

close 方法重写，继承类 InputStream

异常

IOException如果I/O错误发生。