oracle.fmwplatform.envspec.model.topology

Class ArrayListForContainerAware<P extends oracle.fmwplatform.envspec.common.ParentContainerWithVariables,E extends oracle.fmwplatform.envspec.common.ContainerAware<P>>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.ArrayList<E>

oracle.fmwplatform.envspec.model.topology.NoNullArrayList<E>

oracle.fmwplatform.envspec.model.topology.ArrayListForContainerAware<P,E>

All Implemented Interfaces:

Serializable, Cloneable, Iterable<E>, Collection<E>, List<E>, RandomAccess

public class ArrayListForContainerAware<P extends oracle.fmwplatform.envspec.common.ParentContainerWithVariables,E extends oracle.fmwplatform.envspec.common.ContainerAware<P>>
extends NoNullArrayList<E>

Array list for holding entities that need to be aware of the containing object.

Since:

12.2.1

See Also:

Serialized Form

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
ArrayListForContainerAware(P parentContainerWithVariables) Constructs an empty list with an initial capacity of ten.

Method Summary

Modifier and Type	Method and Description
boolean	add(E e) Appends the specified element to the end of this list.
void	add(int index, E e) Inserts the specified element in the list at the specified position.
boolean	addAll(Collection<? extends E> c) Appends all of the elements in the specified collection to the end of this list, in the order that they are returned by the specified collection's Iterator.
boolean	addAll(int index, Collection<? extends E> c) Inserts the elements in the specified collection at the specified position.
static <P extends oracle.fmwplatform.envspec.common.ParentContainerWithVariables,E extends oracle.fmwplatform.envspec.common.ContainerAware<P>> ArrayListForContainerAware<P,E>	checkContainerAwareList(List<E> elements, P parent) Static convenience method for establishing a container-aware element list.
E	set(int index, E e) Adds the specified element to this list at the specified position.

Methods inherited from class java.util.ArrayList

clear, clone, contains, ensureCapacity, forEach, get, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeIf, removeRange, replaceAll, retainAll, size, sort, spliterator, subList, toArray, toArray, trimToSize

Methods inherited from class java.util.AbstractList

equals, hashCode

Methods inherited from class java.util.AbstractCollection

containsAll, toString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.List

containsAll, equals, hashCode

Methods inherited from interface java.util.Collection

parallelStream, stream

Constructor Detail

ArrayListForContainerAware

public ArrayListForContainerAware(P parentContainerWithVariables)

Constructs an empty list with an initial capacity of ten. Sets the parent on this

Parameters:

parentContainerWithVariables - the container to set as the parent

Method Detail

add

public boolean add(E e)

Appends the specified element to the end of this list. Sets the parent on the added element.

Specified by:

add in interface Collection<E extends oracle.fmwplatform.envspec.common.ContainerAware<P>>

Specified by:

add in interface List<E extends oracle.fmwplatform.envspec.common.ContainerAware<P>>

Overrides:

add in class NoNullArrayList<E extends oracle.fmwplatform.envspec.common.ContainerAware<P>>

Parameters:

e - element to be appended to this list

Returns:

true (as specified by Collection.add(E))

addAll

public boolean addAll(Collection<? extends E> c)

Appends all of the elements in the specified collection to the end of this list, in the order that they are returned by the specified collection's Iterator. The behavior of this operation is undefined if the specified collection is modified while the operation is in progress. (This implies that the behavior of this call is undefined if the specified collection is this list, and this list is nonempty.) Sets the parent on the added elements.

Specified by:

addAll in interface Collection<E extends oracle.fmwplatform.envspec.common.ContainerAware<P>>

Specified by:

addAll in interface List<E extends oracle.fmwplatform.envspec.common.ContainerAware<P>>

Overrides:

addAll in class NoNullArrayList<E extends oracle.fmwplatform.envspec.common.ContainerAware<P>>

Parameters:

c - collection containing elements to be added to this list

Returns:

true if this list changed as a result of the call

Throws:

NullPointerException - if the specified collection is null

add

public void add(int index,
                E e)

Inserts the specified element in the list at the specified position. Sets the parent on the added element.

Specified by:

add in interface List<E extends oracle.fmwplatform.envspec.common.ContainerAware<P>>

Overrides:

add in class NoNullArrayList<E extends oracle.fmwplatform.envspec.common.ContainerAware<P>>

Parameters:

index - position to add in this list

e - element to be appended to this list

addAll

public boolean addAll(int index,
                      Collection<? extends E> c)

Inserts the elements in the specified collection at the specified position. Sets the parent on the added elements.

Specified by:

addAll in interface List<E extends oracle.fmwplatform.envspec.common.ContainerAware<P>>

Overrides:

addAll in class NoNullArrayList<E extends oracle.fmwplatform.envspec.common.ContainerAware<P>>

Parameters:

index - position to add in this list

c - collection containing elements to be added to this list

Returns:

true (as specified by Collection.add(E))

set

public E set(int index,
             E e)

Adds the specified element to this list at the specified position. Sets the parent on the added element.

Specified by:

set in interface List<E extends oracle.fmwplatform.envspec.common.ContainerAware<P>>

Overrides:

set in class NoNullArrayList<E extends oracle.fmwplatform.envspec.common.ContainerAware<P>>

Parameters:

index - position to add in this list

e - element to be appended to this list

Returns:

the element that was added

checkContainerAwareList

public static <P extends oracle.fmwplatform.envspec.common.ParentContainerWithVariables,E extends oracle.fmwplatform.envspec.common.ContainerAware<P>> ArrayListForContainerAware<P,E> checkContainerAwareList(List<E> elements,
                                                                                                                                                                                                               P parent)

Static convenience method for establishing a container-aware element list. This is a required check for elements that deserialize, since they are given simple ArrayLists or null. If the list is already a container-aware element list, the same list is returned. If the existing list is null, an empty list is returned. Otherwise, a new container-aware element list containing the child elements is returned.

Type Parameters:

E - generic type used for the list of elements

P - generic type used for the container-aware parent

Parameters:

elements - the existing list of container-aware child elements

parent - the parent of the container-aware child elements

Returns:

a container-aware element list, never null