com.phloc.commons.io.streams

Class ByteBufferOutputStream

java.lang.Object

java.io.OutputStream

com.phloc.commons.io.streams.ByteBufferOutputStream

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

public class ByteBufferOutputStream
extends OutputStream

Wrapper for an OutputStream around a ByteBuffer.

Author:

Philip Helger

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_BUF_SIZE
static boolean	DEFAULT_CAN_GROW

Constructor Summary

Constructors

Constructor and Description
ByteBufferOutputStream() Create a new object with the DEFAULT_BUF_SIZE buffer size and it can grow.
ByteBufferOutputStream(byte[] aArray) Constructor with an existing byte array to wrap.
ByteBufferOutputStream(byte[] aArray, int nOfs, int nLen) Constructor with an existing byte array to wrap.
ByteBufferOutputStream(ByteBuffer aBuffer, boolean bCanGrow) Constructor
ByteBufferOutputStream(int nBytes) Constructor for an output stream than can grow.
ByteBufferOutputStream(int nBytes, boolean bCanGrow) Constructor

Method Summary

Methods

Modifier and Type	Method and Description
boolean	canGrow()
void	close()
byte[]	getAsByteArray() Get everything as a big byte array, without altering the ByteBuffer.
String	getAsString(Charset aCharset) Get the content as a string without modifying the buffer
ByteBuffer	getBuffer()
void	reset() Reset the backing byte buffer
int	size()
void	write(byte[] aBuf, int nOfs, int nLen)
void	write(ByteBuffer aSrcBuffer) Write the content from the passed byte buffer to this output stream.
void	write(int b)
void	writeTo(byte[] aBuf) Writes the current content to the passed buffer.
void	writeTo(byte[] aBuf, int nOfs, int nLen) Write current content to the passed byte array.
void	writeTo(ByteBuffer aDestBuffer) Write everything currently contained to the specified buffer.
void	writeTo(OutputStream aOS) Write everything to the passed output stream and clear the contained buffer.

Methods inherited from class java.io.OutputStream

flush, write

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_BUF_SIZE

public static final int DEFAULT_BUF_SIZE

See Also:

Constant Field Values

DEFAULT_CAN_GROW

public static final boolean DEFAULT_CAN_GROW

See Also:

Constant Field Values

Constructor Detail

ByteBufferOutputStream

public ByteBufferOutputStream()

Create a new object with the DEFAULT_BUF_SIZE buffer size and it can grow.

ByteBufferOutputStream

public ByteBufferOutputStream(@Nonnegative
                      int nBytes)

Constructor for an output stream than can grow.

Parameters:

nBytes - The initial number of bytes the buffer has. Must be ≥ 0.

ByteBufferOutputStream

public ByteBufferOutputStream(@Nonnegative
                      int nBytes,
                      boolean bCanGrow)

Constructor

Parameters:

nBytes - The number of bytes the buffer has initially. Must be ≥ 0.

bCanGrow - true if the buffer can grow, false otherwise.

ByteBufferOutputStream

public ByteBufferOutputStream(@Nonnull
                      byte[] aArray)

Constructor with an existing byte array to wrap. This output stream cannot grow!

Parameters:

aArray - The array to be backed by a ByteBuffer.

ByteBufferOutputStream

public ByteBufferOutputStream(@Nonnull
                      byte[] aArray,
                      @Nonnegative
                      int nOfs,
                      @Nonnegative
                      int nLen)

Constructor with an existing byte array to wrap. This output stream cannot grow!

Parameters:

aArray - The array to be backed by a ByteBuffer.

nOfs - Offset into the byte array. Must be ≥ 0.

nLen - Number of bytes to wrap. Must be ≥ 0.

ByteBufferOutputStream

public ByteBufferOutputStream(@Nonnull
                      ByteBuffer aBuffer,
                      boolean bCanGrow)

Constructor

Parameters:

aBuffer - The byte buffer to use. May not be null.

bCanGrow - true if the buffer can grow, false otherwise.

Method Detail

getBuffer

@Nonnull
public ByteBuffer getBuffer()

Returns:

The contained buffer. Never null.

canGrow

public boolean canGrow()

Returns:

true if this buffer can grow, false if not.

close

public void close()

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Overrides:

close in class OutputStream

reset

public void reset()

Reset the backing byte buffer

size

@Nonnegative
public int size()

Returns:

The number of bytes currently in the buffer. Always ≥ 0.

getAsByteArray

@Nonnull
@ReturnsMutableCopy
public byte[] getAsByteArray()

Get everything as a big byte array, without altering the ByteBuffer.

Returns:

The content of the buffer as a byte array. Never null.

writeTo

public void writeTo(@Nonnull
           ByteBuffer aDestBuffer)

Write everything currently contained to the specified buffer. If the passed buffer is too small, a BufferOverflowException is thrown. The copied elements are removed from this streams buffer.

Parameters:

aDestBuffer - The destination buffer to write to. May not be null.

writeTo

public void writeTo(@Nonnull
           byte[] aBuf)

Writes the current content to the passed buffer. The copied elements are removed from this streams buffer.

Parameters:

aBuf - The buffer to be filled. May not be null.

writeTo

public void writeTo(@Nonnull
           byte[] aBuf,
           @Nonnegative
           int nOfs,
           @Nonnegative
           int nLen)

Write current content to the passed byte array. The copied elements are removed from this streams buffer.

Parameters:

aBuf - Byte array to write to. May not be null.

nOfs - Offset to start writing. Must be ≥ 0.

nLen - Number of bytes to copy. Must be ≥ 0.

writeTo

public void writeTo(@Nonnull@WillNotClose
           OutputStream aOS)
             throws IOException

Write everything to the passed output stream and clear the contained buffer.

Parameters:

aOS - The output stream to write to. May not be null.

Throws:

IOException

getAsString

@Nonnull
public String getAsString(@Nonnull
                         Charset aCharset)

Get the content as a string without modifying the buffer

Parameters:

aCharset - The charset to use. May not be null.

Returns:

The String representation.

write

public void write(int b)

Specified by:

write in class OutputStream

write

public void write(@Nonnull
         byte[] aBuf,
         @Nonnegative
         int nOfs,
         @Nonnegative
         int nLen)

Overrides:

write in class OutputStream

write

public void write(@Nonnull
         ByteBuffer aSrcBuffer)

Write the content from the passed byte buffer to this output stream.

Parameters:

aSrcBuffer - The buffer to use. May not be null.