Package org.exolab.adaptx.util
Class List
java.lang.Object
org.exolab.adaptx.util.List
- All Implemented Interfaces:
Cloneable
- Direct Known Subclasses:
ListStack
This is my implementation of the JDK 1.2 List interface.
I wrote this because I want people using 1.1.x to be able
to use my apps, but I don't want to use a "synchronized" Vector.
I also wanted to get a start in moving my source to JDK 1.2
I use the implementation of the hashCode method that is listed in the JDK 1.2 API, so this List can be compared correctly to actual JDK 1.2 lists using the equals method. Note: This is not a complete implementation yet, None of the methods that take a Collection have been imlplemented.
I use the implementation of the hashCode method that is listed in the JDK 1.2 API, so this List can be compared correctly to actual JDK 1.2 lists using the equals method. Note: This is not a complete implementation yet, None of the methods that take a Collection have been imlplemented.
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionboolean
Adds the specified Object to the list at the specified indexboolean
Adds the specified Object to the listvoid
clear()
Removes all elements from the listclone()
boolean
Returns true if the specified element is contained in the list.boolean
Compares the specified object with this list for equality.get
(int index) Returns the element at the specified position in this list.int
hashCode()
As defined by the JDK 1.2 API spec:
Returns the hash code value for this list.int
Returns the index of the first occurrence of the specified element, or -1 if the element is not contained in the Listboolean
isEmpty()
Returns true if there are no elements in the List.int
lastIndexOf
(Object obj) Returns the index of the last occurrence of the specified element, or -1 if the element is not contained in the Listremove
(int index) Removes the element at the specified index from the Listboolean
Removes the first occurrence of the specified element from the ListReplaces the element at the specified position in this list with the specified element.int
size()
Returns the number of elements in the ListsubList
(int fromIndex, int toIndex) Returns a new List which contains elements from a given section of this list.Object[]
toArray()
Returns an array containing all of the elements in this list in proper sequence.Object[]
Returns an array containing all of the elements in this list in proper sequence.void
Reduces the capacity of the internal buffer to the current size freeing up unused memory.
-
Constructor Details
-
List
public List()Creates a new BasicSet with the default Size -
List
public List(int size)
-
-
Method Details
-
add
Adds the specified Object to the list- Parameters:
obj
- the Object to add to the list- Returns:
- true if the Object is added to the list
-
add
Adds the specified Object to the list at the specified index- Parameters:
obj
- the Object to add to the list- Returns:
- true if the Object is added to the list
- Throws:
IndexOutOfBoundsException
-
clear
public void clear()Removes all elements from the list -
clone
-
contains
Returns true if the specified element is contained in the list. if the specfied element is null, then if the list contains a null value, true will be returned.- Parameters:
obj
- the element to search the list for- Returns:
- true if specified element is contained in the list
-
equals
Compares the specified object with this list for equality. Returns true if and only if the specified Object is a list and all of its associated elements are equal to the elements of this list -
get
Returns the element at the specified position in this list.- Parameters:
index
- the position of the element to return- Throws:
IndexOutOfBoundsException
-
hashCode
public int hashCode()As defined by the JDK 1.2 API spec:
Returns the hash code value for this list. The hash code of a list is defined to be the result of the following calculation:
hashCode = 1; Iterator i = list.iterator(); while (i.hasNext()) { Object obj = i.next(); hashCode = 31*hashCode + (obj==null ? 0 : obj.hashCode()); }
-
indexOf
Returns the index of the first occurrence of the specified element, or -1 if the element is not contained in the List- Parameters:
obj
- the Object to get the index for
-
isEmpty
public boolean isEmpty()Returns true if there are no elements in the List.- Returns:
- true if there are no elements in the List.
-
lastIndexOf
Returns the index of the last occurrence of the specified element, or -1 if the element is not contained in the List- Parameters:
obj
- the Object to get the last index for
-
remove
Removes the element at the specified index from the List- Parameters:
index
- the position in the list tp remove the element from- Returns:
- the Object that was removed from the list
-
remove
Removes the first occurrence of the specified element from the List- Parameters:
obj
- the Object to remove from the List- Returns:
- true if the Object was removed from the list
-
trimToSize
public void trimToSize()Reduces the capacity of the internal buffer to the current size freeing up unused memory. -
set
Replaces the element at the specified position in this list with the specified element.- Parameters:
index
- the position in the list to place the element atelement
- the element to add to the list- Throws:
IndexOutOfBoundsException
-
size
public int size()Returns the number of elements in the List- Returns:
- the number of elements in the List
-
subList
Returns a new List which contains elements from a given section of this list.- Parameters:
fromIndex
- the start index (inclusize) of elements to add to the new listtoIndex
- the end index (exclusive)of the elements to add to the new list- Returns:
- a new List which contains elements from a given section of this list.
- Throws:
IndexOutOfBoundsException
- for invalid index values
-
toArray
Returns an array containing all of the elements in this list in proper sequence.- Returns:
- the array of elements of this List
-
toArray
Returns an array containing all of the elements in this list in proper sequence.- Returns:
- the array of elements of this List
-