|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectjava.util.AbstractCollection<E>
java.util.AbstractList<E>
com.google.common.collect.ImmutableList<E>
public abstract class ImmutableList<E>
A high-performance, immutable, random-access List implementation.
Does not permit null elements.
Unlike Collections.unmodifiableList(java.util.List extends T>), which is a view of a
separate collection that can still change, an instance of ImmutableList contains its own private data and will never change.
ImmutableList is convenient for public static final lists
("constant lists") and also lets you easily make a "defensive copy" of a list
provided to your class by a caller.
Note: Although this class is not final, it cannot be subclassed as it has no public or protected constructors. Thus, the immutability guarantee can be trusted.
ImmutableSet,
Serialized Form| Field Summary |
|---|
| Fields inherited from class java.util.AbstractList |
|---|
modCount |
| Method Summary | ||
|---|---|---|
boolean |
contains(java.lang.Object object)
|
|
static
|
copyOf(java.lang.Iterable<? extends E> elements)
Returns an immutable list containing the given elements, in order. |
|
int |
indexOf(java.lang.Object object)
|
|
int |
lastIndexOf(java.lang.Object object)
|
|
static
|
of()
Returns the empty immutable list. |
|
static
|
of(E... elements)
Returns an immutable list containing the given elements, in order. |
|
static
|
of(E element)
Returns an immutable list containing a single element. |
|
| Methods inherited from class java.util.AbstractList |
|---|
add, add, addAll, clear, equals, get, hashCode, iterator, listIterator, listIterator, remove, removeRange, set, subList |
| Methods inherited from class java.util.AbstractCollection |
|---|
addAll, containsAll, isEmpty, remove, removeAll, retainAll, size, toArray, 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, size, toArray, toArray |
| Method Detail |
|---|
public static <E> ImmutableList<E> of()
Collections.emptyList(), and is preferable mainly for consistency
and maintainability of your code.
public static <E> ImmutableList<E> of(E element)
Collections.singleton(T), but will not
accept a null element. It is preferable mainly for consistency and
maintainability of your code.
public static <E> ImmutableList<E> of(E... elements)
java.lang.NullPointerException - if any of elements is nullpublic static <E> ImmutableList<E> copyOf(java.lang.Iterable<? extends E> elements)
list is a List<String>, then ImmutableList.copyOf(list) returns an ImmutableList<String>
containing each of the strings in list, while
ImmutableList.of(list)} returns an ImmutableList<List<String>>
containing one element (the given list itself).
Note: Despite what the method name suggests, if elements
is an ImmutableList, no copy will actually be performed, and the
given list itself will be returned.
java.lang.NullPointerException - if any of elements are null
public int indexOf(@Nullable
java.lang.Object object)
indexOf in interface java.util.List<E>indexOf in class java.util.AbstractList<E>
public int lastIndexOf(@Nullable
java.lang.Object object)
lastIndexOf in interface java.util.List<E>lastIndexOf in class java.util.AbstractList<E>
public boolean contains(@Nullable
java.lang.Object object)
contains in interface java.util.Collection<E>contains in interface java.util.List<E>contains in class java.util.AbstractCollection<E>
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||