Class LinkedBuffer

java.lang.Object

io.protostuff.LinkedBuffer

public final class LinkedBuffer
extends Object

A buffer that wraps a byte array and has a reference to the next buffer for dynamic increase.

Author:

David Yu

Field Summary

Fields

Modifier and Type	Field	Description
static final int	DEFAULT_BUFFER_SIZE	The default buffer size for a LinkedBuffer.
static final int	MIN_BUFFER_SIZE	The minimum buffer size for a LinkedBuffer.

Method Summary

Modifier and Type	Method	Description
static LinkedBuffer	allocate()	Allocates a new buffer with default size.
static LinkedBuffer	allocate(int size)	Allocates a new buffer with the specified size.
static LinkedBuffer	allocate(int size, LinkedBuffer previous)	Allocates a new buffer with the specified size and appends it to the previous buffer.
LinkedBuffer	clear()	The offset will be reset to its starting position.
static LinkedBuffer	use(byte[] buffer)	Uses the existing byte array as the internal buffer.
static LinkedBuffer	use(byte[] buffer, int start)	Uses the existing byte array as the internal buffer.
static LinkedBuffer	wrap(byte[] array, int offset, int length)	Wraps the byte array buffer as a read-only buffer.
static int	writeTo(DataOutput out, LinkedBuffer node)	Writes the contents of the LinkedBuffer into the DataOutput.
static int	writeTo(OutputStream out, LinkedBuffer node)	Writes the contents of the LinkedBuffer into the OutputStream.

Methods inherited from class Object

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

Field Details

MIN_BUFFER_SIZE

public static final int MIN_BUFFER_SIZE

The minimum buffer size for a LinkedBuffer.

See Also:

• Constant Field Values

DEFAULT_BUFFER_SIZE

public static final int DEFAULT_BUFFER_SIZE

The default buffer size for a LinkedBuffer.

See Also:

• Constant Field Values

Method Details

allocate

public static LinkedBuffer allocate()

Allocates a new buffer with default size.

allocate

public static LinkedBuffer allocate(int size)

Allocates a new buffer with the specified size.

allocate

public static LinkedBuffer allocate(int size,
 LinkedBuffer previous)

Allocates a new buffer with the specified size and appends it to the previous buffer.

wrap

public static LinkedBuffer wrap(byte[] array,
 int offset,
 int length)

Wraps the byte array buffer as a read-only buffer.

use

public static LinkedBuffer use(byte[] buffer)

Uses the existing byte array as the internal buffer.

use

public static LinkedBuffer use(byte[] buffer,
 int start)

Uses the existing byte array as the internal buffer.

writeTo

public static int writeTo(OutputStream out,
 LinkedBuffer node)
                   throws IOException

Writes the contents of the LinkedBuffer into the OutputStream.

Returns:

the total content size of the buffer.

Throws:

IOException

writeTo

public static int writeTo(DataOutput out,
 LinkedBuffer node)
                   throws IOException

Writes the contents of the LinkedBuffer into the DataOutput.

Returns:

the total content size of the buffer.

Throws:

IOException

clear

public LinkedBuffer clear()

The offset will be reset to its starting position. The buffer next to this will be dereferenced.