goodslib
Class ArrayOfLong

java.lang.Object
  extended bygoodsjpi.Persistent
      extended bygoodslib.AnyArray
          extended bygoodslib.ArrayOfLong
All Implemented Interfaces:
java.io.Serializable

public class ArrayOfLong
extends AnyArray

ArrayOfLong is just that, an array of longs. It is fully persistent, as it it's derived from Persistent. All reads cause a fetch of the data, all writes mark it dirty and to be saved.

See Also:
Serialized Form

Field Summary
protected  long[] array
          array holds the longs in an []
 
Fields inherited from class goodslib.AnyArray
used
 
Fields inherited from class goodsjpi.Persistent
defaultMetaobject, metaobject
 
Constructor Summary
ArrayOfLong(int size)
          Creates a new ArrayOfLong instance.
ArrayOfLong(int size, int allocatedSize)
          Creates a new ArrayOfLong instance.
ArrayOfLong(long[] src)
          Creates a new ArrayOfLong instance, as a copy of the given long[]
 
Method Summary
 void append(long[] tail)
          append add the given values to the end of the array
 void changeSize(int newSize)
          Resize the amount of space taken by the array.
 void copy(int dstIndex, long[] src, int srcIndex, int count)
          copy into this array from a destination, a given amount of values.
 long getAt(int index)
          Get a long at the specified index
 int indexOf(long val)
          indexOf returns the first occurrence of val
 void insert(int index, int count, long value)
          insert a "count" amount of values at a given index.
 int lastIndexOf(long val)
          Find the lastIndexOf a given value
 long pop()
          Use the array as a stack and pop a value.
 void push(long value)
          Use the array as a stack with the push method.
 void putAt(int index, long value)
          Put a long value at a given index
 void remove(int index, int count)
          remove a number of values.
 long[] toArray()
          toArray converts the internal representation to a long[] , of correct size.
 long top()
          Check the top boolean with the top method.
 
Methods inherited from class goodslib.AnyArray
length
 
Methods inherited from class goodsjpi.Persistent
attachToStorage, clone, clusterWith, finalize, getDatabase, getOid, getStorageId, hashCode, onLoad
 
Methods inherited from class java.lang.Object
equals, getClass, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

array

protected long[] array
array holds the longs in an []

Constructor Detail

ArrayOfLong

public ArrayOfLong(int size)
Creates a new ArrayOfLong instance.

Parameters:
size - is the initial size, (length)

ArrayOfLong

public ArrayOfLong(int size,
                   int allocatedSize)
Creates a new ArrayOfLong instance. (Full of false)

Parameters:
size - , or length of the array
allocatedSize - is the size it can grow to without re-sizing

ArrayOfLong

public ArrayOfLong(long[] src)
Creates a new ArrayOfLong instance, as a copy of the given long[]

Parameters:
src - a long[] that will be copied
Method Detail

putAt

public void putAt(int index,
                  long value)
Put a long value at a given index

Parameters:
index - an int value, where the value should be set
value - the long value to be set

getAt

public long getAt(int index)
Get a long at the specified index

Parameters:
index - of the long you want
Returns:
a long value, at index "index"

changeSize

public void changeSize(int newSize)
Resize the amount of space taken by the array. Either grow or shrink as necessary. You get an IndexOutOfBoundException for negative values.
of course the old data is copied.

Parameters:
newSize - an int denoting the new size.

insert

public void insert(int index,
                   int count,
                   long value)
insert a "count" amount of values at a given index. Throws an IndexOutOfBoundsException for too small (<0) or too big (>length) count or index.

Parameters:
index - , where to start inserting value(s)
count - , how many values to insert
value - a long value to insert

remove

public void remove(int index,
                   int count)
remove a number of values. The array shrinks in it's length, but no resizing is done. Get an IndexOutOfBoundsException for inappropriate index or count values.

Parameters:
index - , where to start removing
count - , how many values to remove

push

public void push(long value)
Use the array as a stack with the push method.

Parameters:
value - , a long to push to the stack

pop

public long pop()
Use the array as a stack and pop a value. (Value is removed) IndexOutOfBoundsExceptions comes when array has hit 0 length.

Returns:
the top most long value

top

public long top()
Check the top boolean with the top method. This returns what pop returns, just it doesn't remove the value. In other stack implementations it may be called peek()

Returns:
a long value

append

public void append(long[] tail)
append add the given values to the end of the array

Parameters:
tail - a long[] that will be appended

toArray

public long[] toArray()
toArray converts the internal representation to a long[] , of correct size. Ie: the .length of the return == this.size()

Returns:
a long[] value

copy

public void copy(int dstIndex,
                 long[] src,
                 int srcIndex,
                 int count)
copy into this array from a destination, a given amount of values. Get a IndexOutOfBounds if the src or count don't fit

Parameters:
dstIndex - , the index (of this array) where to copy to
src - a long[] , where to copy from
srcIndex - an int , where to start copying from
count - an int , how many values to copy

indexOf

public int indexOf(long val)
indexOf returns the first occurrence of val

Parameters:
val - a long to be looked for
Returns:
an int, where the value was found, or -1

lastIndexOf

public int lastIndexOf(long val)
Find the lastIndexOf a given value

Parameters:
val - a long value to be found (from the back)
Returns:
an int , where the value was found, or -1