|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectjava.util.AbstractCollection
java.util.AbstractList
org.apache.commons.collections.list.TreeList
public class TreeList
A List implementation that is optimised for fast insertions and
removals at any index in the list.
This list implementation utilises a tree structure internally to ensure that
all insertions and removals are O(log n). This provides much faster performance
than both an ArrayList and a LinkedList where elements
are inserted and removed repeatedly from anywhere in the list.
The following relative performance statistics are indicative of this class:
get add insert iterate remove
TreeList 3 5 1 2 1
ArrayList 1 1 40 1 40
LinkedList 5800 1 350 2 325
ArrayList is a good general purpose list implementation.
It is faster than TreeList for most operations except inserting
and removing in the middle of the list. ArrayList also uses less
memory as TreeList uses one object per entry.
LinkedList is rarely a good choice of implementation.
TreeList is almost always a good replacement for it, although it
does use sligtly more memory.
| Field Summary |
|---|
| Fields inherited from class java.util.AbstractList |
|---|
modCount |
| Constructor Summary | |
|---|---|
TreeList()
Constructs a new empty list. |
|
TreeList(java.util.Collection coll)
Constructs a new empty list that copies the specified list. |
|
| Method Summary | |
|---|---|
void |
add(int index,
java.lang.Object obj)
Adds a new element to the list. |
void |
clear()
Clears the list, removing all entries. |
boolean |
contains(java.lang.Object object)
Searches for the presence of an object in the list. |
java.lang.Object |
get(int index)
Gets the element at the specified index. |
int |
indexOf(java.lang.Object object)
Searches for the index of an object in the list. |
java.util.Iterator |
iterator()
Gets an iterator over the list. |
java.util.ListIterator |
listIterator()
Gets a ListIterator over the list. |
java.util.ListIterator |
listIterator(int fromIndex)
Gets a ListIterator over the list. |
java.lang.Object |
remove(int index)
Removes the element at the specified index. |
java.lang.Object |
set(int index,
java.lang.Object obj)
Sets the element at the specified index. |
int |
size()
Gets the current size of the list. |
java.lang.Object[] |
toArray()
Converts the list into an array. |
| Methods inherited from class java.util.AbstractList |
|---|
add, addAll, equals, hashCode, lastIndexOf, removeRange, subList |
| Methods inherited from class java.util.AbstractCollection |
|---|
addAll, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toString |
| Methods inherited from class java.lang.Object |
|---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
| Methods inherited from interface java.util.List |
|---|
addAll, containsAll, isEmpty, remove, removeAll, retainAll, toArray |
| Constructor Detail |
|---|
public TreeList()
public TreeList(java.util.Collection coll)
coll - the collection to copy
java.lang.NullPointerException - if the collection is null| Method Detail |
|---|
public java.lang.Object get(int index)
get in interface java.util.Listget in class java.util.AbstractListindex - the index to retrieve
public int size()
size in interface java.util.Collectionsize in interface java.util.Listsize in class java.util.AbstractCollectionpublic java.util.Iterator iterator()
iterator in interface java.lang.Iterableiterator in interface java.util.Collectioniterator in interface java.util.Listiterator in class java.util.AbstractListpublic java.util.ListIterator listIterator()
listIterator in interface java.util.ListlistIterator in class java.util.AbstractListpublic java.util.ListIterator listIterator(int fromIndex)
listIterator in interface java.util.ListlistIterator in class java.util.AbstractListfromIndex - the index to start from
public int indexOf(java.lang.Object object)
indexOf in interface java.util.ListindexOf in class java.util.AbstractListpublic boolean contains(java.lang.Object object)
contains in interface java.util.Collectioncontains in interface java.util.Listcontains in class java.util.AbstractCollectionpublic java.lang.Object[] toArray()
toArray in interface java.util.CollectiontoArray in interface java.util.ListtoArray in class java.util.AbstractCollection
public void add(int index,
java.lang.Object obj)
add in interface java.util.Listadd in class java.util.AbstractListindex - the index to add beforeobj - the element to add
public java.lang.Object set(int index,
java.lang.Object obj)
set in interface java.util.Listset in class java.util.AbstractListindex - the index to setobj - the object to store at the specified index
java.lang.IndexOutOfBoundsException - if the index is invalidpublic java.lang.Object remove(int index)
remove in interface java.util.Listremove in class java.util.AbstractListindex - the index to remove
public void clear()
clear in interface java.util.Collectionclear in interface java.util.Listclear in class java.util.AbstractList
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||