org.zkoss.util
Class FastReadArray

java.lang.Object
  org.zkoss.util.FastReadArray

All Implemented Interfaces:

Serializable, Cloneable

public class FastReadArray
extends Object
implements Serializable, Cloneable

An array of objects that are fast to read but a bit slower to add and remove.

It is thread-safe.

Typical use:

Object[] ary = fra.toArray();
for (int j = 0; j < ary.length; ++j)
  whatever;

Since:

3.0.6

Author:

tomyeh

See Also:

Serialized Form

Constructor Summary

FastReadArray()
Constructs an array of Object.

FastReadArray(Class klass)
Constructs an array of the specified class.

Method Summary

void	add(Object val) Adds an object.
Object	clone()
boolean	equals(Object o)
int	hashCode()
boolean	isEmpty() Returns if it is empty.
boolean	remove(Object val) Removes an object.
boolean	removeBy(Comparable val, boolean atMostOne) Removes the object(s) that matches the specified condition.
int	size() Returns the size.
Object[]	toArray() Returns the array (never null).
String	toString()

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

FastReadArray

public FastReadArray()

Constructs an array of Object.

FastReadArray

public FastReadArray(Class klass)

Constructs an array of the specified class.

Method Detail

toArray

public Object[] toArray()

Returns the array (never null). To read, you shall store the return value in a local variable and then iterate thru it.

Note: the return array is readonly. Don't modify the value of any element.

isEmpty

public boolean isEmpty()

Returns if it is empty.

size

public int size()

Returns the size.

add

public void add(Object val)

Adds an object.

remove

public boolean remove(Object val)

Removes an object.

Returns:

whether the object is removed successfully (i.e., found).

removeBy

public boolean removeBy(Comparable val,
                        boolean atMostOne)

Removes the object(s) that matches the specified condition. By match we mean Comparable.compareTo(java.lang.Object) returns 0. In other words, this method invokes val.compareTo() against each element in this array.

Parameters:

atMostOne - whether to remove the first matched object only. If true, only the first matched object, if any, is removed. If false, all matched object are removed.

clone

public Object clone()

Overrides:

clone in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object