Package com.polarion.alm.shared.api.utils.collections

Class ImmutableStrictList<E>

java.lang.Object

com.polarion.alm.shared.api.utils.collections.ImmutableStrictList<E>

All Implemented Interfaces:

com.google.gwt.user.client.rpc.IsSerializable, IterableWithSize<E>, ReadOnlyStrictCollection<E>, ReadOnlyStrictList<E>, Serializable, Iterable<E>

public final class ImmutableStrictList<E>
extends Object
implements ReadOnlyStrictList<E>

Since:

3.9.0

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static ImmutableStrictList	EMPTY

Constructor Summary

Constructors

Constructor	Description
ImmutableStrictList(E... elements)
ImmutableStrictList(Iterable<? extends E> elements)

Method Summary

Modifier and Type	Method	Description
void	addAllTo(Collection<? super E> collection)
List<E>	asList()	Returns the adapter to List interface for use with 3rd party code or standard Java libraries.
boolean	contains(E element)
boolean	containsAll(Iterable<? extends E> elements)
boolean	equals(Object obj)
E	get(int index)
E	getLast()
int	hashCode()
int	indexOf(E element)
int	indexOfInstance(E instance, int lastKnownIndex)	Searches the given instance using the == operator instead of equals().
boolean	isEmpty()
Iterator<E>	iterator()
int	size()
E[]	toArray(E[] a)	Iterating over array is faster, when checking for concurrent modification is not needed.
ArrayList<E>	toArrayList()	Returns new ArrayList containing the same elements, so modifying the returned list does not modify the original collection.
ImmutableStrictList<E>	toImmutable()
String	toString()
<T> ImmutableStrictList<T>	toTransformed(NotStrictTransformer<E,T> transformer)	Each element from the collection will be transformed or skipped (if transformer returns null)
<T> ImmutableStrictList<T>	toTransformed(StrictTransformer<E,T> transformer)	Each element from the collection will be transformed.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Details

EMPTY

public static ImmutableStrictList EMPTY

Constructor Details

ImmutableStrictList

public ImmutableStrictList(@Nullable
 E... elements)

ImmutableStrictList

public ImmutableStrictList(@NotNull
 Iterable<? extends E> elements)

Method Details

addAllTo

public void addAllTo(@NotNull
 Collection<? super E> collection)

Specified by:

addAllTo in interface IterableWithSize<E>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface IterableWithSize<E>

size

public int size()

Specified by:

size in interface IterableWithSize<E>

contains

public boolean contains(@NotNull
 E element)

Specified by:

contains in interface ReadOnlyStrictCollection<E>

containsAll

public boolean containsAll(@NotNull
 Iterable<? extends E> elements)

Specified by:

containsAll in interface ReadOnlyStrictCollection<E>

indexOf

public int indexOf(@Nullable
 E element)

Specified by:

indexOf in interface ReadOnlyStrictList<E>

Returns:

-1 if the element is not in the collection

indexOfInstance

public int indexOfInstance(@Nullable
 E instance,
 int lastKnownIndex)

Description copied from interface: ReadOnlyStrictList

Searches the given instance using the == operator instead of equals().

Specified by:

indexOfInstance in interface ReadOnlyStrictList<E>

lastKnownIndex - - last known index for optimized search, use -1 if not know

Returns:

-1 if the element is not in the collection

get

@NotNull
public E get(int index)

Specified by:

get in interface ReadOnlyStrictList<E>

getLast

@NotNull
public E getLast()

Specified by:

getLast in interface ReadOnlyStrictList<E>

iterator

public Iterator<E> iterator()

Specified by:

iterator in interface Iterable<E>

toTransformed

@NotNull
public <T> ImmutableStrictList<T> toTransformed(@NotNull
 StrictTransformer<E,T> transformer)

Description copied from interface: ReadOnlyStrictCollection

Each element from the collection will be transformed.

Specified by:

toTransformed in interface ReadOnlyStrictCollection<E>

Specified by:

toTransformed in interface ReadOnlyStrictList<E>

Type Parameters:

T - type of elements in transformed collection

Parameters:

transformer - transformer

Returns:

transformed collection

Since:

3.9.0

toTransformed

@NotNull
public <T> ImmutableStrictList<T> toTransformed(@NotNull
 NotStrictTransformer<E,T> transformer)

Description copied from interface: ReadOnlyStrictCollection

Each element from the collection will be transformed or skipped (if transformer returns null)

Specified by:

toTransformed in interface ReadOnlyStrictCollection<E>

Specified by:

toTransformed in interface ReadOnlyStrictList<E>

Type Parameters:

T - type of elements in transformed collection

Parameters:

transformer - transformer

Returns:

transformed collection

toString

@NotNull
public String toString()

Overrides:

toString in class Object

toArrayList

@NotNull
public ArrayList<E> toArrayList()

Description copied from interface: IterableWithSize

Returns new ArrayList containing the same elements, so modifying the returned list does not modify the original collection.

Specified by:

toArrayList in interface IterableWithSize<E>

toArray

@NotNull
public E[] toArray(@NotNull
 E[] a)

Description copied from interface: IterableWithSize

Iterating over array is faster, when checking for concurrent modification is not needed.

Specified by:

toArray in interface IterableWithSize<E>

Parameters:

a - - must have exactly the same size as the collection

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toImmutable

@NotNull
public ImmutableStrictList<E> toImmutable()

Specified by:

toImmutable in interface ReadOnlyStrictList<E>

asList

@NotNull
public List<E> asList()

Description copied from interface: ReadOnlyStrictList

Returns the adapter to List interface for use with 3rd party code or standard Java libraries. Unlike the IterableWithSize.toArrayList() which returns new list containing the same elements, this method returns live "view" of this list instance meaning that changes done to the returned instance are reflected also in the original list. Unless the original list is immutable, in which case all methods modifying the content throw UnsupportedOperationException The returned list is Serializable

Specified by:

asList in interface ReadOnlyStrictList<E>