com.ghgande.j2mod.modbus.io

Class FastByteArrayOutputStream

java.lang.Object

java.io.OutputStream

com.ghgande.j2mod.modbus.io.FastByteArrayOutputStream

All Implemented Interfaces:

Closeable, Flushable, AutoCloseable

Direct Known Subclasses:

BytesOutputStream

public class FastByteArrayOutputStream
extends OutputStream

This class is a replacement implementation for ByteArrayOutputStream that does not synchronize every byte written.

Version:

2.0 (March 2016)

Author:

Mark Hayes, Dieter Wimberger, Steve O'Hara (4NG)

Constructor Summary

Constructors

Constructor and Description
FastByteArrayOutputStream(int initialSize, int bumpSize) Creates an output stream with a given bump size and initial size.

Method Summary

Modifier and Type	Method and Description
void	addSize(int sizeAdded) Skip the given number of bytes in the buffer.
byte[]	getBufferBytes() Returns the buffer owned by this object.
int	getBufferLength() Returns the length used in the internal buffer, that is, the offset at which data will be written next.
int	getBufferOffset() Returns the offset of the internal buffer.
void	makeSpace(int sizeNeeded) Ensure that at least the given number of bytes are available in the internal buffer.
void	reset() Resets this FastByteArrayOutputStream.
int	size() Returns the number of bytes written to this FastByteArrayOutputStream.
byte[]	toByteArray() Returns the written bytes in a newly allocated byte[] of length getSize().
void	toByteArray(byte[] toBuf, int offset) Copy the buffered data to the given array.
String	toString()
String	toString(String encoding) Returns the content of this FastByteArrayOutputStream as String.
void	write(byte[] fromBuf)
void	write(byte[] fromBuf, int offset, int length)
void	write(int b)
void	writeTo(OutputStream out) Writes the content of this FastByteArrayOutputStream to the given output stream.

Methods inherited from class java.io.OutputStream

close, flush

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

FastByteArrayOutputStream

public FastByteArrayOutputStream(int initialSize,
                                 int bumpSize)

Creates an output stream with a given bump size and initial size.

Parameters:

initialSize - the initial size of the buffer.

bumpSize - the amount to increment the buffer.

Method Detail

size

public int size()

Returns the number of bytes written to this FastByteArrayOutputStream.

Returns:

the number of bytes written as int.

reset

public void reset()

Resets this FastByteArrayOutputStream.

write

public void write(int b)
           throws IOException

Specified by:

write in class OutputStream

Throws:

IOException

write

public void write(byte[] fromBuf)
           throws IOException

Overrides:

write in class OutputStream

Throws:

IOException

write

public void write(byte[] fromBuf,
                  int offset,
                  int length)
           throws IOException

Overrides:

write in class OutputStream

Throws:

IOException

writeTo

public void writeTo(OutputStream out)
             throws IOException

Writes the content of this FastByteArrayOutputStream to the given output stream.

Parameters:

out - the output stream to be written to.

Throws:

IOException - if an I/O error occurs.

toString

public String toString()

Overrides:

toString in class Object

toString

public String toString(String encoding)
                throws UnsupportedEncodingException

Returns the content of this FastByteArrayOutputStream as String.

Parameters:

encoding - the encoding to be used for conversion.

Returns:

a newly allocated String.

Throws:

UnsupportedEncodingException - if the given encoding is not supported.

toByteArray

public byte[] toByteArray()

Returns the written bytes in a newly allocated byte[] of length getSize().

Returns:

a newly allocated byte[] with the content of the output buffer.

toByteArray

public void toByteArray(byte[] toBuf,
                        int offset)

Copy the buffered data to the given array.

Parameters:

toBuf - the buffer to hold a copy of the data.

offset - the offset at which to start copying.

getBufferBytes

public byte[] getBufferBytes()

Returns the buffer owned by this object.

Returns:

the buffer.

getBufferOffset

public int getBufferOffset()

Returns the offset of the internal buffer.

Returns:

always zero currently.

getBufferLength

public int getBufferLength()

Returns the length used in the internal buffer, that is, the offset at which data will be written next.

Returns:

the buffer length.

makeSpace

public void makeSpace(int sizeNeeded)

Ensure that at least the given number of bytes are available in the internal buffer.

Parameters:

sizeNeeded - the number of bytes desired.

addSize

public void addSize(int sizeAdded)

Skip the given number of bytes in the buffer.

Parameters:

sizeAdded - number of bytes to skip.