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

Class StrictListImpl<E>

java.lang.Object

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

All Implemented Interfaces:

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

public final class StrictListImpl<E>
extends Object
implements StrictList<E>

Since:

3.9.0

See Also:

• Serialized Form

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
void	add(int index, E element)
boolean	add(E element)
boolean	addAll(int index, Iterable<? extends E> elements)
boolean	addAll(Iterable<? extends E> elements)
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.
void	clear()
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()
E	remove(int index)
boolean	remove(E element)
boolean	removeAll(Iterable<? extends E> elements)
boolean	retainAll(Iterable<? extends E> elements)
E	set(int index, E element)
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> StrictListImpl<T>	toTransformed(NotStrictTransformer<E,T> transformer)	Each element from the collection will be transformed or skipped (if transformer returns null)
<T> StrictListImpl<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

Constructor Details

StrictListImpl

public StrictListImpl()

StrictListImpl

public StrictListImpl(@Nullable
 E... elements)

StrictListImpl

public StrictListImpl(@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>

add

public boolean add(@NotNull
 E element)

Specified by:

add in interface StrictCollection<E>

add

public void add(int index,
 @NotNull
 E element)

Specified by:

add in interface StrictList<E>

addAll

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

Specified by:

addAll in interface StrictCollection<E>

addAll

public boolean addAll(int index,
 @NotNull
 Iterable<? extends E> elements)

Specified by:

addAll in interface StrictList<E>

remove

public boolean remove(@Nullable
 E element)

Specified by:

remove in interface StrictCollection<E>

remove

@NotNull
public E remove(int index)

Specified by:

remove in interface StrictList<E>

removeAll

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

Specified by:

removeAll in interface StrictCollection<E>

retainAll

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

Specified by:

retainAll in interface StrictCollection<E>

clear

public void clear()

Specified by:

clear in interface StrictCollection<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>

set

@NotNull
public E set(int index,
 @NotNull
 E element)

Specified by:

set in interface StrictList<E>

iterator

public Iterator<E> iterator()

Specified by:

iterator in interface Iterable<E>

toTransformed

@NotNull
public <T> StrictListImpl<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>

Specified by:

toTransformed in interface StrictList<E>

Type Parameters:

T - type of elements in transformed collection

Parameters:

transformer - transformer

Returns:

transformed collection

Since:

3.9.0

toTransformed

@NotNull
public <T> StrictListImpl<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>

Specified by:

toTransformed in interface StrictList<E>

Type Parameters:

T - type of elements in transformed collection

Parameters:

transformer - transformer

Returns:

transformed collection

toImmutable

@NotNull
public ImmutableStrictList<E> toImmutable()

Specified by:

toImmutable in interface ReadOnlyStrictList<E>

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

toString

@NotNull
public String toString()

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

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>