org.eclipse.emf.ecore.util

Class DelegatingEcoreEList<E>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

org.eclipse.emf.common.util.AbstractEList<E>

org.eclipse.emf.common.util.DelegatingEList<E>

org.eclipse.emf.common.notify.impl.DelegatingNotifyingListImpl<E>

org.eclipse.emf.ecore.util.DelegatingNotifyingInternalEListImpl<E>

org.eclipse.emf.ecore.util.DelegatingEcoreEList<E>

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Iterable<E>, java.util.Collection<E>, java.util.List<E>, NotifyingList<E>, EList<E>, EStructuralFeature.Setting, InternalEList<E>, InternalEList.Unsettable<E>

Direct Known Subclasses:

DelegatingEcoreEList.Generic, DelegatingEcoreEList.Unsettable, DelegatingFeatureMap

public abstract class DelegatingEcoreEList<E>
extends DelegatingNotifyingInternalEListImpl<E>
implements InternalEList.Unsettable<E>, EStructuralFeature.Setting

A delegating notifying internal EList that implements InternalEList.Unsettable and EStructuralFeature.Setting. At least one of getEStructuralFeature() or getFeatureID() must be specialized since each delegates to the other and without specialization this will lead to stack overflow.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DelegatingEcoreEList.Dynamic<E>
static class	DelegatingEcoreEList.Generic<E>
static class	DelegatingEcoreEList.UnmodifiableEList<E>
static class	DelegatingEcoreEList.Unsettable<E> A delegating Ecore EList with an implementation for tracking the unset state.

Nested classes/interfaces inherited from class org.eclipse.emf.common.util.DelegatingEList

DelegatingEList.EIterator<E1>, DelegatingEList.EListIterator<E1>, DelegatingEList.NonResolvingEIterator<E1>, DelegatingEList.NonResolvingEListIterator<E1>

Nested classes/interfaces inherited from class org.eclipse.emf.common.util.AbstractEList

AbstractEList.BasicIndexOutOfBoundsException

Field Summary

Fields

Modifier and Type	Field and Description
protected InternalEObject	owner

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
DelegatingEcoreEList(InternalEObject owner)

Method Summary

Methods

Modifier and Type	Method and Description
protected boolean	canContainNull() Returns !
boolean	contains(java.lang.Object object) Resolve to compare objects but do not modify list
protected NotificationImpl	createNotification(int eventType, boolean oldValue, boolean newValue)
protected NotificationImpl	createNotification(int eventType, java.lang.Object oldObject, java.lang.Object newObject, int index, boolean wasSet) Creates a notification.
protected void	dispatchNotification(Notification notification) Dispatches a notification to the notifier of the list.
java.lang.Object	get(boolean resolve) Returns the value held by the feature of the object; it optionally resolves the value.
EObject	getEObject() Returns the object holding a value.
EStructuralFeature	getEStructuralFeature() Returns the specific feature holding a value for the object.
java.lang.Object	getFeature() Returns null.
int	getFeatureID() Returns Notification.NO_FEATURE_ID.
protected EClassifier	getFeatureType()
protected EReference	getInverseEReference()
protected java.lang.Class<?>	getInverseFeatureClass()
protected int	getInverseFeatureID()
java.lang.Object	getNotifier() Returns null.
protected boolean	hasInstanceClass()
protected boolean	hasInverse() Returns false.
protected boolean	hasManyInverse()
protected boolean	hasNavigableInverse()
protected boolean	hasProxies()
int	indexOf(java.lang.Object object) Returns the position of the first occurrence of the object in the list.
NotificationChain	inverseAdd(E object, NotificationChain notifications) Does nothing and returns the notifications.
NotificationChain	inverseRemove(E object, NotificationChain notifications) Does nothing and returns the notifications.
protected boolean	isContainment()
protected boolean	isEObject()
protected boolean	isInstance(java.lang.Object object)
protected boolean	isNotificationRequired() Returns false.
boolean	isSet() Returns whether the list is considered set, i.e., whether it's not empty.
protected boolean	isUnique() Returns whether objects are constrained to appear at most once in the list.
int	lastIndexOf(java.lang.Object object) Returns the position of the last occurrence of the object in the list.
protected E	resolve(E object) Returns the resolved object from this list for the purpose of testing whether DelegatingNotifyingListImpl.removeAll(Collection) applies to it.
protected E	resolve(int index, E object) Resolves the object at the index and returns the result.
protected EObject	resolveProxy(EObject eObject)
void	set(java.lang.Object newValue) Set the value held by the feature of the object.
java.lang.Object[]	toArray() Returns an array containing all the objects in sequence.
<T> T[]	toArray(T[] array) Returns an array containing all the objects in sequence.
void	unset() Unsets the value held by the feature of the object.
protected E	validate(int index, E object) Validates a new content object and returns the validated object.

Methods inherited from class org.eclipse.emf.ecore.util.DelegatingNotifyingInternalEListImpl

basicContains, basicContainsAll, basicGet, basicIndexOf, basicIterator, basicLastIndexOf, basicList, basicListIterator, basicListIterator, basicToArray, basicToArray

Methods inherited from class org.eclipse.emf.common.notify.impl.DelegatingNotifyingListImpl

addAllUnique, addAllUnique, addAllUnique, addAllUnique, addUnique, addUnique, basicAdd, basicRemove, basicSet, clear, createNotification, createNotificationChain, doAddAllUnique, doAddAllUnique, doAddAllUnique, doAddAllUnique, doAddUnique, doAddUnique, doClear, doMove, doRemove, doRemoveAll, doSetUnique, getFeatureID, hasShadow, move, remove, removeAll, setUnique, shadowAdd, shadowRemove, shadowSet

Methods inherited from class org.eclipse.emf.common.util.DelegatingEList

containsAll, delegateAdd, delegateAdd, delegateBasicList, delegateClear, delegateContains, delegateContainsAll, delegateEquals, delegateGet, delegateHashCode, delegateIndexOf, delegateIsEmpty, delegateIterator, delegateLastIndexOf, delegateList, delegateListIterator, delegateMove, delegateRemove, delegateSet, delegateSize, delegateToArray, delegateToArray, delegateToString, doClear, equals, get, hashCode, isEmpty, primitiveGet, remove, retainAll, size, toString

Methods inherited from class org.eclipse.emf.common.util.AbstractEList

add, add, addAll, addAll, didAdd, didChange, didClear, didMove, didRemove, didSet, equalObjects, getDuplicates, getNonDuplicates, iterator, listIterator, listIterator, move, set, useEquals

Methods inherited from class java.util.AbstractList

removeRange, subList

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.emf.ecore.util.InternalEList

addAllUnique, addAllUnique, addUnique, addUnique, basicAdd, basicContains, basicContainsAll, basicGet, basicIndexOf, basicIterator, basicLastIndexOf, basicList, basicListIterator, basicListIterator, basicRemove, basicToArray, basicToArray, setUnique

Methods inherited from interface org.eclipse.emf.common.util.EList

move, move

Methods inherited from interface java.util.List

add, add, addAll, addAll, clear, containsAll, equals, get, hashCode, isEmpty, iterator, listIterator, listIterator, remove, remove, removeAll, retainAll, set, size, subList

Field Detail

owner

protected final InternalEObject owner

Constructor Detail

DelegatingEcoreEList

public DelegatingEcoreEList(InternalEObject owner)

Method Detail

canContainNull

protected boolean canContainNull()

Description copied from class: DelegatingNotifyingListImpl

Returns !DelegatingNotifyingListImpl.hasInverse().

Overrides:

canContainNull in class DelegatingNotifyingListImpl<E>

Returns:

!hasInverse.

isUnique

protected boolean isUnique()

Description copied from class: AbstractEList

Returns whether objects are constrained to appear at most once in the list. The default is to return false, but clients can override this to ensure uniqueness of contents. The performance impact is significant: operations such as add are O(n) as a result requiring uniqueness.

Overrides:

isUnique in class AbstractEList<E>

Returns:

whether objects are constrained to appear at most once in the list.

hasInverse

protected boolean hasInverse()

Description copied from class: DelegatingNotifyingListImpl

Returns false.

Overrides:

hasInverse in class DelegatingNotifyingListImpl<E>

Returns:

false.

validate

protected E validate(int index,
         E object)

Description copied from class: AbstractEList

Validates a new content object and returns the validated object. This implementation checks for null, if necessary and returns the argument object. Clients may throw additional types of runtime exceptions in order to handle constraint violations.

Overrides:

validate in class AbstractEList<E>

Parameters:

index - the position of the new content.

object - the new content.

Returns:

the validated content.

isInstance

protected boolean isInstance(java.lang.Object object)

getNotifier

public java.lang.Object getNotifier()

Description copied from class: DelegatingNotifyingListImpl

Returns null.

Specified by:

getNotifier in interface NotifyingList<E>

Overrides:

getNotifier in class DelegatingNotifyingListImpl<E>

Returns:

null.

getFeature

public java.lang.Object getFeature()

Description copied from class: DelegatingNotifyingListImpl

Returns null.

Specified by:

getFeature in interface NotifyingList<E>

Overrides:

getFeature in class DelegatingNotifyingListImpl<E>

Returns:

null.

See Also:

Notification.getFeature()

getFeatureID

public int getFeatureID()

Description copied from class: DelegatingNotifyingListImpl

Returns Notification.NO_FEATURE_ID.

Specified by:

getFeatureID in interface NotifyingList<E>

Overrides:

getFeatureID in class DelegatingNotifyingListImpl<E>

Returns:

Notification.NO_FEATURE_ID.

See Also:

Notification.getFeatureID(java.lang.Class<?>)

getEStructuralFeature

public EStructuralFeature getEStructuralFeature()

Description copied from interface: EStructuralFeature.Setting

Returns the specific feature holding a value for the object.

Specified by:

getEStructuralFeature in interface EStructuralFeature.Setting

Returns:

the specific feature holding a value for the object.

getFeatureType

protected EClassifier getFeatureType()

getInverseEReference

protected EReference getInverseEReference()

getInverseFeatureID

protected int getInverseFeatureID()

getInverseFeatureClass

protected java.lang.Class<?> getInverseFeatureClass()

hasManyInverse

protected boolean hasManyInverse()

hasNavigableInverse

protected boolean hasNavigableInverse()

isEObject

protected boolean isEObject()

isContainment

protected boolean isContainment()

hasProxies

protected boolean hasProxies()

hasInstanceClass

protected boolean hasInstanceClass()

resolve

protected E resolve(int index,
        E object)

Description copied from class: AbstractEList

Resolves the object at the index and returns the result. This implementation simply returns the object; clients can use this to transform objects as they are fetched.

Overrides:

resolve in class AbstractEList<E>

Parameters:

index - the position of the content.

object - the content.

Returns:

the resolved object.

resolve

protected E resolve(E object)

Description copied from class: DelegatingNotifyingListImpl

Returns the resolved object from this list for the purpose of testing whether DelegatingNotifyingListImpl.removeAll(Collection) applies to it.

Overrides:

resolve in class DelegatingNotifyingListImpl<E>

Parameters:

object - the object to be resolved.

Returns:

the resolved object from this list for the purpose of testing whether removeAll applies to it.

resolveProxy

protected EObject resolveProxy(EObject eObject)

toArray

public java.lang.Object[] toArray()

Description copied from class: DelegatingEList

Returns an array containing all the objects in sequence.

Specified by:

toArray in interface java.util.Collection<E>

Specified by:

toArray in interface java.util.List<E>

Overrides:

toArray in class DelegatingEList<E>

Returns:

an array containing all the objects in sequence.

toArray

public <T> T[] toArray(T[] array)

Description copied from class: DelegatingEList

Returns an array containing all the objects in sequence.

Specified by:

toArray in interface java.util.Collection<E>

Specified by:

toArray in interface java.util.List<E>

Overrides:

toArray in class DelegatingEList<E>

Parameters:

array - the array that will be filled and returned, if it's big enough; otherwise, a suitably large array of the same type will be allocated and used instead.

Returns:

an array containing all the objects in sequence.

createNotification

protected NotificationImpl createNotification(int eventType,
                                  java.lang.Object oldObject,
                                  java.lang.Object newObject,
                                  int index,
                                  boolean wasSet)

Description copied from class: DelegatingNotifyingListImpl

Creates a notification.

Overrides:

createNotification in class DelegatingNotifyingListImpl<E>

Parameters:

eventType - the type of change that has occurred.

oldObject - the value of the notifier's feature before the change occurred.

newObject - the value of the notifier's feature after the change occurred.

index - the position at which the change occurred.

Returns:

a new notification.

createNotification

protected NotificationImpl createNotification(int eventType,
                                  boolean oldValue,
                                  boolean newValue)

dispatchNotification

protected void dispatchNotification(Notification notification)

Description copied from class: DelegatingNotifyingListImpl

Dispatches a notification to the notifier of the list.

Overrides:

dispatchNotification in class DelegatingNotifyingListImpl<E>

Parameters:

notification - the notification to dispatch.

isNotificationRequired

protected boolean isNotificationRequired()

Description copied from class: DelegatingNotifyingListImpl

Returns false.

Overrides:

isNotificationRequired in class DelegatingNotifyingListImpl<E>

Returns:

false.

inverseAdd

public NotificationChain inverseAdd(E object,
                           NotificationChain notifications)

Description copied from class: DelegatingNotifyingListImpl

Does nothing and returns the notifications. Clients can override this to update the inverse of a bidirectional relation.

Overrides:

inverseAdd in class DelegatingNotifyingListImpl<E>

Parameters:

object - the object that's been added to the list.

notifications - the chain of accumulating notifications.

Returns:

the notifications.

inverseRemove

public NotificationChain inverseRemove(E object,
                              NotificationChain notifications)

Description copied from class: DelegatingNotifyingListImpl

Does nothing and returns the notifications. Clients can override this to update the inverse of a bidirectional relation.

Overrides:

inverseRemove in class DelegatingNotifyingListImpl<E>

Parameters:

object - the object that's been remove from the list.

notifications - the chain of accumulating notifications.

Returns:

the notifications.

contains

public boolean contains(java.lang.Object object)

Resolve to compare objects but do not modify list

Specified by:

contains in interface java.util.Collection<E>

Specified by:

contains in interface java.util.List<E>

Overrides:

contains in class DelegatingEList<E>

Parameters:

object - the object in question.

Returns:

whether the list contains the object.

indexOf

public int indexOf(java.lang.Object object)

Description copied from class: DelegatingEList

Returns the position of the first occurrence of the object in the list.

Specified by:

indexOf in interface java.util.List<E>

Overrides:

indexOf in class DelegatingEList<E>

Parameters:

object - the object in question.

Returns:

the position of the first occurrence of the object in the list.

lastIndexOf

public int lastIndexOf(java.lang.Object object)

Description copied from class: DelegatingEList

Returns the position of the last occurrence of the object in the list.

Specified by:

lastIndexOf in interface java.util.List<E>

Overrides:

lastIndexOf in class DelegatingEList<E>

Parameters:

object - the object in question.

Returns:

the position of the last occurrence of the object in the list.

getEObject

public EObject getEObject()

Description copied from interface: EStructuralFeature.Setting

Returns the object holding a value.

Specified by:

getEObject in interface EStructuralFeature.Setting

Returns:

the object holding a value.

get

public java.lang.Object get(boolean resolve)

Description copied from interface: EStructuralFeature.Setting

Returns the value held by the feature of the object; it optionally resolves the value.

Specified by:

get in interface EStructuralFeature.Setting

Parameters:

resolve - whether to resolve.

Returns:

the value held by the feature of the object.

See Also:

EObject.eGet(EStructuralFeature, boolean)

set

public void set(java.lang.Object newValue)

Description copied from interface: EStructuralFeature.Setting

Set the value held by the feature of the object. If the new value is this setting itself, or is modified as a side effect of modifying this setting (i.e., if it is a view on the setting), the behavior is undefined and will likely result in simply clearing the list.

Specified by:

set in interface EStructuralFeature.Setting

Parameters:

newValue - the newValue.

See Also:

EObject.eSet(EStructuralFeature, Object)

isSet

public boolean isSet()

Description copied from class: DelegatingNotifyingListImpl

Returns whether the list is considered set, i.e., whether it's not empty. A derived implementation may model this state directly.

Specified by:

isSet in interface EStructuralFeature.Setting

Specified by:

isSet in interface InternalEList.Unsettable<E>

Overrides:

isSet in class DelegatingNotifyingListImpl<E>

Returns:

whether the list is considered set.

See Also:

EObject.eIsSet(org.eclipse.emf.ecore.EStructuralFeature)

unset

public void unset()

Description copied from interface: InternalEList.Unsettable

Unsets the value held by the feature of the object.

Specified by:

unset in interface EStructuralFeature.Setting

Specified by:

unset in interface InternalEList.Unsettable<E>

See Also:

EObject.eUnset(org.eclipse.emf.ecore.EStructuralFeature)