compact1, compact2, compact3

java.io

Class ByteArrayOutputStream

java.lang.Object

java.io.OutputStream

java.io.ByteArrayOutputStream

All Implemented Interfaces:

Closeable， Flushable， AutoCloseable

public class ByteArrayOutputStream
extends OutputStream

这个类实现了一个输出流，其中的数据被写入一个字节数组。当数据被写入时，缓冲区会自动生长。数据可以用 toByteArray()和 toString()检索。

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

从以下版本开始：

JDK1.0

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	buf 存储数据的缓冲区。
protected int	count 缓冲区中有效字节数。

构造方法摘要

构造方法

Constructor and Description
ByteArrayOutputStream() 创建一个新的字节数组输出流。
ByteArrayOutputStream(int size) 创建一个新的字节数组输出流，具有指定大小的缓冲容量，以字节为单位的。

方法摘要

Modifier and Type	Method and Description
void	close() 关闭 ByteArrayOutputStream没有影响。
void	reset() 将这个字节数组输出流的 count场为零，因此，目前累计输出输出流被丢弃。
int	size() 返回缓冲区的当前大小。
byte[]	toByteArray() 创建一个新分配的字节数组。
String	toString() 使用该平台的默认字符集将缓冲区的内容转换为字符串解码字节。
String	toString(int hibyte) 过时的。 这种方法不正确地将字节转换为字符。作为 JDK 1.1，这样的首选方式是通过toString(String enc)方法，它以一个编码名称的争论，或toString()方法，使用平台的默认字符编码。
String	toString(String charsetName) 将缓冲区的内容到一个字符串使用命名 charset解码字节。
void	write(byte[] b, int off, int len) 写 len字节指定字节数组中的起始偏移 off这个字节数组输出流。
void	write(int b) 将指定的字节写入该字节数组输出流中。
void	writeTo(OutputStream out) 写这个字节数组输出流的完整内容到指定的输出流的说法，如果通过调用输出流的写法 out.write(buf, 0, count)。

Methods inherited from class java.io.OutputStream

flush, write

Methods inherited from class java.lang.Object

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

Field Detail

buf

protected byte[] buf

存储数据的缓冲区。

count

protected int count

缓冲区中有效字节数。

Constructor Detail

ByteArrayOutputStream

public ByteArrayOutputStream()

创建一个新的字节数组输出流。缓冲容量最初是32字节，但如果必要的话，它的大小增加了。

ByteArrayOutputStream

public ByteArrayOutputStream(int size)

创建一个新的字节数组输出流，具有指定大小的缓冲容量，以字节为单位的。

参数

size -初始大小。

异常

IllegalArgumentException如果尺寸是负的。

方法详细信息

write

public void write(int b)

将指定的字节写入该字节数组输出流中。

Specified by:

write 方法重写，继承类 OutputStream

参数

b的字节被写入。

write

public void write(byte[] b,
                  int off,
                  int len)

写 len字节指定字节数组中的起始偏移 off这个字节数组输出流。

重写：

write 方法重写，继承类 OutputStream

参数

b -数据。

off的起始偏移量的数据。

len -字节数写。

writeTo

public void writeTo(OutputStream out)
             throws IOException

写这个字节数组输出流的完整内容到指定的输出流的说法，如果通过调用输出流的写法 out.write(buf, 0, count)。

参数

out -输出流中写入数据。

异常

IOException如果I/O错误发生。

reset

public void reset()

将这个字节数组输出流的 count场为零，因此，目前累计输出输出流被丢弃。输出流可以再次使用，再利用已分配的缓冲区空间。

另请参见：

ByteArrayInputStream.count

toByteArray

public byte[] toByteArray()

创建一个新分配的字节数组。它的大小是这个输出流的当前大小和缓冲区的有效内容已被复制到它。

结果

此输出流的当前内容，作为一个字节数组。

另请参见：

size()

size

public int size()

返回缓冲区的当前大小。

结果

该 count字段的值，这是在输出流的有效字节数。

另请参见：

count

toString

public String toString()

使用该平台的默认字符集将缓冲区的内容转换为字符串解码字节。新的 String长度是一个字符集的功能，因此可能不等于缓冲区大小的。

这种方法总是会替换格式不正确的输入，无法映射的字符序列与默认的字符串替换为平台的默认字符集。的CharsetDecoder班时应使用在解码过程中需要更多的控制。

重写：

toString 方法重写，继承类 Object

结果

从缓冲区的内容中解码的字符串。

从以下版本开始：

JDK1.1

toString

public String toString(String charsetName)
                throws UnsupportedEncodingException

将缓冲区的内容到一个字符串使用命名 charset解码字节。新的 String长度是一个字符集的功能，因此可能不相等的字节数组的长度。

这种方法总是会替换格式不正确的输入，无法映射的字符序列，该字符集的默认字符串替换。的CharsetDecoder班时应使用在解码过程中需要更多的控制。

参数

charsetName -支持的 charset名称

结果

从缓冲区的内容中解码的字符串。

异常

UnsupportedEncodingException -如果指定的字符集不支持

从以下版本开始：

JDK1.1

toString

@Deprecated
public String toString(int hibyte)

过时的。 这种方法不正确地将字节转换为字符。作为 JDK 1.1，这样的首选方式是通过toString(String enc)方法，它以一个编码名称的争论，或toString()方法，使用平台的默认字符编码。

创建一个新分配的字符串。它的大小是输出流的当前大小和缓冲区的有效内容已被复制到它。每个字符的字符串是由相应的元素B字节数组中的

     c == (char)(((hibyte & 0xff) << 8) | (b & 0xff))
 

这样：

参数

hibyte -每个Unicode字符的高字节。

结果

输出流的当前内容，作为一个字符串。

另请参见：

size()， toString(String)， toString()

close

public void close()
           throws IOException

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

Specified by:

close 接口 Closeable

Specified by:

close 接口 AutoCloseable

重写：

close 方法重写，继承类 OutputStream

异常

IOException如果I/O错误发生。