Package org.miaixz.bus.core.io.stream

Class FastByteArrayOutputStream

java.lang.Object

java.io.OutputStream

org.miaixz.bus.core.io.stream.FastByteArrayOutputStream

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

public class FastByteArrayOutputStream
extends OutputStream

基于快速缓冲FastByteBuffer的OutputStream，随着数据的增长自动扩充缓冲区 可以通过toByteArray()和 toString()来获取数据 close()方法无任何效果，当流被关闭后不会抛出IOException 这种设计避免重新分配内存块而是分配新增的缓冲区，缓冲区不会被GC，数据也不会被拷贝到其他缓冲区。

Since:

Java 17+

Author:

Kimi Liu

Constructor Summary

Constructors

Constructor	Description
FastByteArrayOutputStream()	构造
FastByteArrayOutputStream(int size)	构造

Method Summary

Modifier and Type	Method	Description
void	close()	此方法无任何效果，当流被关闭后不会抛出IOException
byte	get(int index)	获取指定位置的字节
static FastByteArrayOutputStream	of(InputStream in, int limit)	根据输入流的总长度创建一个FastByteArrayOutputStream对象 如果输入流的长度不确定，且
void	reset()	复位
int	size()	长度
byte[]	toByteArray()	转为Byte数组
byte[]	toByteArray(int start, int len)	转为Byte数组
byte[]	toByteArrayZeroCopyIfPossible()	转为Byte数组，如果缓冲区中的数据长度固定，则直接返回原始数组 注意此方法共享数组，不能修改数组内容！
String	toString()
String	toString(Charset charset)	转为字符串
void	write(byte[] b, int off, int len)
void	write(int b)
void	writeTo(OutputStream out)	写出

Methods inherited from class java.io.OutputStream

flush, nullOutputStream, write

Methods inherited from class java.lang.Object

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

Constructor Details

FastByteArrayOutputStream

public FastByteArrayOutputStream()

构造

FastByteArrayOutputStream

public FastByteArrayOutputStream(int size)

构造

Parameters:

size - 预估大小

Method Details

of

public static FastByteArrayOutputStream of(InputStream in,
 int limit)

根据输入流的总长度创建一个FastByteArrayOutputStream对象 如果输入流的长度不确定，且

Parameters:

in - 输入流

limit - 限制大小

Returns:

FastByteArrayOutputStream

write

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

Overrides:

write in class OutputStream

write

public void write(int b)

Specified by:

write in class OutputStream

size

public int size()

长度

Returns:

长度

close

public void close()

此方法无任何效果，当流被关闭后不会抛出IOException

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Overrides:

close in class OutputStream

reset

public void reset()

复位

writeTo

public void writeTo(OutputStream out)
             throws InternalException

写出

Parameters:

out - 输出流

Throws:

InternalException - IO异常

toByteArray

public byte[] toByteArray()

转为Byte数组

Returns:

Byte数组

toByteArray

public byte[] toByteArray(int start,
 int len)

转为Byte数组

Parameters:

start - 起始位置（包含）

len - 长度

Returns:

Byte数组

toByteArrayZeroCopyIfPossible

public byte[] toByteArrayZeroCopyIfPossible()

转为Byte数组，如果缓冲区中的数据长度固定，则直接返回原始数组 注意此方法共享数组，不能修改数组内容！

Returns:

Byte数组

get

public byte get(int index)

获取指定位置的字节

Parameters:

index - 位置

Returns:

字节

toString

public String toString()

Overrides:

toString in class Object

toString

public String toString(Charset charset)

转为字符串

Parameters:

charset - 编码,null表示默认编码

Returns:

字符串