public abstract class AbstractArray extends Object implements Serializable
Subclasses will want to provide the following methods (which are not declared in this class since subclasses should specify the explicit return type):
<type> get(int)void set(int, <type>)void add(<type>)void add(int, <type>)<type>[] toArray()Clone cannot be supported since the array is not held locally. But the @link #AbstractArray(AbstractArray) constructor can be used for suclasses that need to support clone.
This "type-specific collections" approach was originally developed by Dennis Sosnoski, who provides a more complete library at the referenced URL. Sosnoski's library does not integrate with the jdk collection classes but provides collection-like classes.
| Constructor and Description |
|---|
AbstractArray(AbstractArray toCopy)
Since AbstractArray can support a clone method, this facilitates
sublcasses that want to implement clone (poor man's cloning).
|
AbstractArray(Class type)
Creates the managed array with a default size of 10.
|
AbstractArray(Class type,
int size)
Creates the managed array with the specified size.
|
AbstractArray(Class type,
int[] dimensions)
Construtor for multi-dimensional array types.
|
AbstractArray(int size)
Use when the subclass has a preexisting array.
|
| Modifier and Type | Method and Description |
|---|---|
void |
appendArray(Object ofArrayType)
Appends the supplied array, which must be an array of the same
type as
this, to the end of this. |
void |
clear()
Set the array to the empty state, clearing all the data out and
nulling objects (or "zero-ing" primitives).
|
Object |
copyArray()
Constructs and returns a simple array containing the same data as held
in this growable array.
|
int |
getModCountIncr()
Returns the modification count increment, which is used by
AbstractList subclasses to adjust modCount
AbstractList uses it's modCount field
to invalidate concurrent operations (like iteration) that should
fail if the underlying array changes structurally during the
operation. |
int |
getSize()
Get the number of values currently present in the array.
|
void |
remove(int index)
Remove a value from the array.
|
void |
remove(int start,
int stop)
Removes a range from the array at the specified indices.
|
void |
replaceSubArray(int thisStart,
int thisStop,
Object srcArray,
int srcStart,
int srcStop)
Replace a range of this array with another subarray.
|
void |
replaceSubArray(Object array,
int atIndex)
Allows an array type to overwrite a segment of the array.
|
void |
setSize(int count)
Sets the number of values currently present in the array.
|
String |
toString()
Provides a default comma-delimited representation of array.
|
public AbstractArray(AbstractArray toCopy)
public MyManagedArray(MyManagedArray toCopy) {
super(this);
this.baseArray = ()toCopy.copyArray();
this.someProp = toCopy.someProp;
}
public Object clone() {
return new MyManagedArray(this);
}
toCopy - public AbstractArray(int size)
size - the initial size of the arraypublic AbstractArray(Class type)
type - array element type (primitive type or object class)public AbstractArray(Class type, int[] dimensions)
char[][]. This class only manages the
top level dimension of the array. For single dimension
arrays (the more typical usage), use the other constructors.type - Array element type (primitive type or object class).dimensions - An int array specifying the dimensions. For
a 2D array, something like new int[] {10,0} to
create 10 elements each of which can hold an reference to an
array of the same type.Array.newInstance(java.lang.Class, int[])public AbstractArray(Class type, int size)
type - array element type (primitive type or object class)size - number of elements initially allowed in arraypublic void appendArray(Object ofArrayType)
this, to the end of this.
AbstractList subclasses should update their
modCount after calling this method.
ofArrayType - the array to appendpublic void clear()
Note: This method does not set modCountIncr to
1 even though java.util.ArrayList
would.
AbstractList subclasses should update their
modCount after calling this method.
public Object copyArray()
public void remove(int index)
AbstractList subclasses should always increment
their modCount method after calling this, as
remove always causes a structural modification.
index - index number of value to be removedpublic void remove(int start,
int stop)
start - inclusivestop - exclusivepublic void replaceSubArray(Object array, int atIndex)
(atIndex + 1) + ofArrayType's length
is greater than the current length.
AbstractList subclasses should update their
modCount after calling this method.
array - atIndex - public void replaceSubArray(int thisStart,
int thisStop,
Object srcArray,
int srcStart,
int srcStop)
thisStart - the start index (inclusive) of the subarray in this
array to be replacedthisStop - the stop index (exclusive) of the subarray in this
array to be replacedsrcArray - the source array from which to copysrcStart - the start index (inclusive) of the replacement subarraysrcStop - the stop index (exclusive) of the replacement subarraypublic void setSize(int count)
AbstractList subclasses should update their
modCount after calling this method.
count - number of values to be setpublic int getSize()
public String toString()
toString in class ObjectObject.toString()public int getModCountIncr()
AbstractList subclasses to adjust modCount
AbstractList uses it's modCount field
to invalidate concurrent operations (like iteration) that should
fail if the underlying array changes structurally during the
operation.