beagleutil

Class ThreadSafeIndexer<T>

java.lang.Object

beagleutil.ThreadSafeIndexer<T>

Type Parameters:

T - the type parameter.

public final class ThreadSafeIndexer<T>
extends java.lang.Object

Class ThreadSafeIndexer indexes objects.

Instances of class ThreadSafeIndexer are thread-safe.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_INIT_CAPACITY The default initial capacity, which is 500.

Constructor Summary

Constructors

Constructor and Description
ThreadSafeIndexer() Creates a new ThreadSafeIndexer instance with the default initial capacity.
ThreadSafeIndexer(int initCapacity) Creates a new ThreadSafeIndexerinstance with the specified initial capacity.

Method Summary

Modifier and Type	Method and Description
int	getIndex(T object) Returns the index of the specified object.
int	getIndexIfIndexed(T object) Returns the index of the specified object, or returns -1 if the specified object is not indexed.
T	item(int index) Returns the object with the specified index.
java.util.List<T>	items() Returns an listed of indexed objects.
int	size() Returns the number of indexed objects.
java.lang.String	toString() Returns this.items().toString().

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_INIT_CAPACITY

public static final int DEFAULT_INIT_CAPACITY

The default initial capacity, which is 500.

See Also:

Constant Field Values

Constructor Detail

ThreadSafeIndexer

public ThreadSafeIndexer()

Creates a new ThreadSafeIndexer instance with the default initial capacity.

See Also:

DEFAULT_INIT_CAPACITY

ThreadSafeIndexer

public ThreadSafeIndexer(int initCapacity)

Creates a new ThreadSafeIndexerinstance with the specified initial capacity.

Parameters:

initCapacity - the initial capacity

Throws:

java.lang.IllegalArgumentException - if initCapacity < 1

Method Detail

getIndex

public int getIndex(T object)

Returns the index of the specified object. If the object is not yet indexed, the object will be indexed. Indices are assigned in consecutive order beginning with 0.

Parameters:

object - the object whose index will be retrieved

Returns:

the index of the specified object

Throws:

java.lang.NullPointerException - if object==null

getIndexIfIndexed

public int getIndexIfIndexed(T object)

Returns the index of the specified object, or returns -1 if the specified object is not indexed.

Parameters:

object - an object

Returns:

the index of the specified object, or -1 if the specified object is not indexed

Throws:

java.lang.NullPointerException - if object == null.

size

public int size()

Returns the number of indexed objects.

Returns:

the number of indexed objects

item

public T item(int index)

Returns the object with the specified index.

Parameters:

index - an object index

Returns:

the object with the specified index

Throws:

java.lang.IndexOutOfBoundsException - if index<0 || index>=this.size()

items

public java.util.List<T> items()

Returns an listed of indexed objects. The returned list will have size this.size(), and it will satisfy this.items().get(k).equals(this.item(k))==true for 0 <= k && k < this.size()

Returns:

an array of objects

toString

public java.lang.String toString()

Returns this.items().toString().

Overrides:

toString in class java.lang.Object

Returns:

a string representation of this