_templates.javolution.context

Class ArrayFactory

java.lang.Object

_templates.javolution.context.ArrayFactory

public abstract class ArrayFactory
extends Object

This class holds factories to produces arrays of variable length. It allows for object recycling, pre-allocation and stack allocations:[code] // Primitive types. char[] buffer = ArrayFactory.CHARS_FACTORY.array(1024); // Possibly recycled. for (int i = reader.read(buffer, 0, buffer.length); i > 0;) { ... } ArrayFactory.CHARS_FACTORY.recycle(buffer); // // Custom types. static ArrayFactory VERTICES_FACTORY = new ArrayFactory { protected Vertex[] create(int size) { return new Vertex[size]; } }; ... Vertex[] vertices = VERTICES_FACTORY.array(256); [/code]

Version:

5.0, May 5, 2007

Author:

Jean-Marie Dautelle

Field Summary

Fields

Modifier and Type	Field and Description
static ArrayFactory	BOOLEANS_FACTORY Holds factory for boolean arrays.
static ArrayFactory	BYTES_FACTORY Holds factory for byte arrays.
static ArrayFactory	CHARS_FACTORY Holds factory for char arrays.
static ArrayFactory	DOUBLES_FACTORY Holds factory for double arrays.
static ArrayFactory	FLOATS_FACTORY Holds factory for float arrays.
static ArrayFactory	INTS_FACTORY Holds factory for int arrays.
static ArrayFactory	LONGS_FACTORY Holds factory for long arrays.
static ArrayFactory	OBJECTS_FACTORY Holds factory for generic Object arrays.
static ArrayFactory	SHORTS_FACTORY Holds factory for short arrays.

Constructor Summary

Constructors

Constructor and Description
ArrayFactory() Default constructor.

Method Summary

Modifier and Type	Method and Description
Object	array(int capacity) Returns an array possibly recycled or preallocated of specified minimum size.
protected abstract Object	create(int size) Constructs a new array of specified size from this factory (using the new keyword).
void	recycle(Object array) Recycles the specified arrays.

Methods inherited from class java.lang.Object

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

Field Detail

BOOLEANS_FACTORY

public static final ArrayFactory BOOLEANS_FACTORY

Holds factory for boolean arrays.

BYTES_FACTORY

public static final ArrayFactory BYTES_FACTORY

Holds factory for byte arrays.

CHARS_FACTORY

public static final ArrayFactory CHARS_FACTORY

Holds factory for char arrays.

SHORTS_FACTORY

public static final ArrayFactory SHORTS_FACTORY

Holds factory for short arrays.

INTS_FACTORY

public static final ArrayFactory INTS_FACTORY

Holds factory for int arrays.

LONGS_FACTORY

public static final ArrayFactory LONGS_FACTORY

Holds factory for long arrays.

FLOATS_FACTORY

public static final ArrayFactory FLOATS_FACTORY

Holds factory for float arrays.

DOUBLES_FACTORY

public static final ArrayFactory DOUBLES_FACTORY

Holds factory for double arrays.

OBJECTS_FACTORY

public static final ArrayFactory OBJECTS_FACTORY

Holds factory for generic Object arrays.

Constructor Detail

ArrayFactory

public ArrayFactory()

Default constructor.

Method Detail

array

public final Object array(int capacity)

Returns an array possibly recycled or preallocated of specified minimum size.

Parameters:

capacity - the minimum size of the array to be returned.

Returns:

a recycled, pre-allocated or new factory array.

recycle

public void recycle(Object array)

Recycles the specified arrays.

Parameters:

array - the array to be recycled.

create

protected abstract Object create(int size)

Constructs a new array of specified size from this factory (using the new keyword).

Parameters:

size - the size of the array.

Returns:

a new factory array.