org.jscsi.target.util

Class FastByteArrayProvider

java.lang.Object

org.jscsi.target.util.FastByteArrayProvider

public final class FastByteArrayProvider
extends Object

Instances of this class can serve as a source for byte arrays of specified lengths. Up to capacity arrays of different lengths can be stored, quickly retrievable with the getArray(int) method. Frequently requested arrays will be returned faster, less frequently used arrays might have to be initialized first and are more likely to be removed.

Author:

Andreas Ergenzinger

Constructor Summary

Constructors

Constructor and Description
FastByteArrayProvider(int capacity) The constructor.

Method Summary

Methods

Modifier and Type	Method and Description
byte[][]	getAll() Returns all stored byte arrays.
byte[]	getArray(int length) Returns a byte array of the specified length.

Methods inherited from class java.lang.Object

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

Constructor Detail

FastByteArrayProvider

public FastByteArrayProvider(int capacity)

The constructor.

Parameters:

capacity - the capacity of the created object.

Method Detail

getArray

public byte[] getArray(int length)

Returns a byte array of the specified length.

Note that the returned array may have been used before and therefore the array's values are not guaranteed to be 0.

The method consecutively checks arrays for an array of the correct length. If such an array exists, it will be moved to one index position closer to the front of the array (if possible), speeding up future retrievals of the same array.

Parameters:

length - the length of the returned array

Returns:

a byte array of the specified length

getAll

public byte[][] getAll()

Returns all stored byte arrays.

This method's primary purpose is to enable testing of byte array storing and reordering.

Returns:

arrays.