public class IndirectSet extends java.lang.Object implements CollectionChangeTracker, java.util.Set, IndirectCollection, java.lang.Cloneable, java.io.Serializable
To use an IndirectSet:
Implementation notes:
CollectionMapping,
Serialized Form| Modifier and Type | Field and Description |
|---|---|
protected int |
initialCapacity
Store initial size for lazy init.
|
protected float |
loadFactor
Store load factor for lazy init.
|
| Constructor and Description |
|---|
IndirectSet()
Construct an empty IndirectSet.
|
IndirectSet(java.util.Collection c)
Construct an IndirectSet containing the elements of the specified collection.
|
IndirectSet(int initialCapacity)
Construct an empty IndirectSet with the specified initial capacity.
|
IndirectSet(int initialCapacity,
float loadFactor)
Construct an empty IndirectSet with the specified initial capacity and
load factor.
|
| Modifier and Type | Method and Description |
|---|---|
java.beans.PropertyChangeListener |
_persistence_getPropertyChangeListener()
INTERNAL:
Return the property change listener for change tracking.
|
void |
_persistence_setPropertyChangeListener(java.beans.PropertyChangeListener changeListener)
INTERNAL:
Set the property change listener for change tracking.
|
boolean |
add(java.lang.Object element) |
boolean |
addAll(java.util.Collection c) |
protected java.util.Set |
buildDelegate()
INTERNAL:
Return the freshly-built delegate.
|
void |
clear() |
void |
clearDeferredChanges()
INTERNAL:
clear any changes that have been deferred to instantiation.
|
java.lang.Object |
clone() |
protected java.util.Set |
cloneDelegate()
INTERNAL:
Clone the delegate.
|
boolean |
contains(java.lang.Object element) |
boolean |
containsAll(java.util.Collection c) |
boolean |
equals(java.lang.Object o) |
java.util.Collection |
getAddedElements()
INTERNAL:
Return the elements that have been added before instantiation.
|
protected java.util.Set |
getDelegate()
INTERNAL:
Check whether the contents have been read from the database.
|
java.lang.Object |
getDelegateObject()
INTERNAL:
Return the real collection object.
|
java.util.Collection |
getRemovedElements()
INTERNAL:
Return the elements that have been removed before instantiation.
|
java.lang.String |
getTrackedAttributeName()
INTERNAL:
Return the mapping attribute name, used to raise change events.
|
ValueHolderInterface |
getValueHolder()
INTERNAL:
Return the valueHolder.
|
boolean |
hasAddedElements()
INTERNAL:
Return if any elements that have been added before instantiation.
|
boolean |
hasBeenRegistered()
INTERNAL:
Return whether this IndirectSet has been registered in a UnitOfWork
|
boolean |
hasDeferredChanges()
INTERNAL:
Return if any elements that have been added or removed before instantiation.
|
int |
hashCode() |
boolean |
hasRemovedElements()
INTERNAL:
Return if any elements that have been removed before instantiation.
|
boolean |
hasTrackedPropertyChangeListener()
INTERNAL:
Return if the collection has a property change listener for change tracking.
|
boolean |
isEmpty() |
boolean |
isInstantiated()
Return whether the contents have been read from the database.
|
protected boolean |
isRelationshipMaintenanceRequired() |
java.util.Iterator |
iterator() |
protected void |
raiseAddChangeEvent(java.lang.Object element)
Raise the add change event and relationship maintainence.
|
protected void |
raiseRemoveChangeEvent(java.lang.Object element)
Raise the remove change event.
|
boolean |
remove(java.lang.Object element) |
boolean |
removeAll(java.util.Collection c) |
boolean |
retainAll(java.util.Collection c) |
void |
setTrackedAttributeName(java.lang.String attributeName)
INTERNAL:
Set the mapping attribute name, used to raise change events.
|
void |
setUseLazyInstantiation(boolean useLazyInstantiation)
INTERNAL
Set whether this collection should attempt do deal with adds and removes without retrieving the
collection from the dB
|
void |
setValueHolder(ValueHolderInterface valueHolder)
INTERNAL:
Set the value holder.
|
protected boolean |
shouldAvoidInstantiation()
INTERNAL:
Return if add/remove should trigger instantiation or avoid.
|
protected boolean |
shouldUseLazyInstantiation()
Return whether this collection should attempt do deal with adds and removes without retrieving the
collection from the dB
|
int |
size() |
java.lang.Object[] |
toArray() |
java.lang.Object[] |
toArray(java.lang.Object[] a) |
java.lang.String |
toString()
Use the delegate's #toString(); but wrap it with braces to indicate
there is a bit of indirection.
|
protected int initialCapacity
protected float loadFactor
public IndirectSet()
public IndirectSet(int initialCapacity)
initialCapacity - the initial capacity of the setjava.lang.IllegalArgumentException - if the specified initial capacity
is negativepublic IndirectSet(int initialCapacity,
float loadFactor)
initialCapacity - the initial capacity of the setloadFactor - the load factor of the setjava.lang.IllegalArgumentException - if the specified initial capacity
is negativepublic IndirectSet(java.util.Collection c)
c - the initial elements of the setprotected boolean isRelationshipMaintenanceRequired()
public boolean add(java.lang.Object element)
add in interface java.util.Collectionadd in interface java.util.SetSet.add(java.lang.Object)public boolean addAll(java.util.Collection c)
addAll in interface java.util.CollectionaddAll in interface java.util.SetSet.addAll(java.util.Collection)protected java.util.Set buildDelegate()
public void clear()
clear in interface java.util.Collectionclear in interface java.util.SetSet.clear()public void clearDeferredChanges()
clearDeferredChanges in interface IndirectCollectionpublic java.lang.Object clone()
clone in class java.lang.ObjectThis will result in a database query if necessary.protected java.util.Set cloneDelegate()
public boolean contains(java.lang.Object element)
contains in interface java.util.Collectioncontains in interface java.util.SetSet.contains(java.lang.Object)public boolean containsAll(java.util.Collection c)
containsAll in interface java.util.CollectioncontainsAll in interface java.util.SetSet.containsAll(java.util.Collection)public boolean equals(java.lang.Object o)
equals in interface java.util.Collectionequals in interface java.util.Setequals in class java.lang.ObjectSet.equals(java.lang.Object)protected java.util.Set getDelegate()
public java.lang.Object getDelegateObject()
getDelegateObject in interface IndirectCollectionpublic ValueHolderInterface getValueHolder()
getValueHolder in interface IndirectContainerpublic boolean hasBeenRegistered()
public int hashCode()
hashCode in interface java.util.CollectionhashCode in interface java.util.SethashCode in class java.lang.ObjectSet.hashCode()public boolean isEmpty()
isEmpty in interface java.util.CollectionisEmpty in interface java.util.SetSet.isEmpty()public boolean isInstantiated()
isInstantiated in interface IndirectContainerpublic java.util.Iterator iterator()
iterator in interface java.lang.Iterableiterator in interface java.util.Collectioniterator in interface java.util.SetSet.iterator()public boolean remove(java.lang.Object element)
remove in interface java.util.Collectionremove in interface java.util.SetSet.remove(java.lang.Object)public boolean removeAll(java.util.Collection c)
removeAll in interface java.util.CollectionremoveAll in interface java.util.SetSet.removeAll(java.util.Collection)public boolean retainAll(java.util.Collection c)
retainAll in interface java.util.CollectionretainAll in interface java.util.SetSet.retainAll(java.util.Collection)public void setValueHolder(ValueHolderInterface valueHolder)
setValueHolder in interface IndirectContainerpublic void setUseLazyInstantiation(boolean useLazyInstantiation)
setUseLazyInstantiation in interface IndirectCollectionpublic int size()
size in interface java.util.Collectionsize in interface java.util.SetSet.size()protected boolean shouldUseLazyInstantiation()
public java.lang.Object[] toArray()
toArray in interface java.util.CollectiontoArray in interface java.util.SetSet.toArray()public java.lang.Object[] toArray(java.lang.Object[] a)
toArray in interface java.util.CollectiontoArray in interface java.util.SetSet.toArray(java.lang.Object[])public java.lang.String toString()
toString in class java.lang.ObjectAbstractCollection.toString()protected void raiseAddChangeEvent(java.lang.Object element)
protected void raiseRemoveChangeEvent(java.lang.Object element)
public java.beans.PropertyChangeListener _persistence_getPropertyChangeListener()
_persistence_getPropertyChangeListener in interface ChangeTrackerpublic boolean hasTrackedPropertyChangeListener()
public void _persistence_setPropertyChangeListener(java.beans.PropertyChangeListener changeListener)
_persistence_setPropertyChangeListener in interface ChangeTrackerpublic java.lang.String getTrackedAttributeName()
getTrackedAttributeName in interface CollectionChangeTrackerpublic void setTrackedAttributeName(java.lang.String attributeName)
setTrackedAttributeName in interface CollectionChangeTrackerpublic java.util.Collection getRemovedElements()
getRemovedElements in interface IndirectCollectionpublic java.util.Collection getAddedElements()
getAddedElements in interface IndirectCollectionpublic boolean hasAddedElements()
public boolean hasRemovedElements()
public boolean hasDeferredChanges()
hasDeferredChanges in interface IndirectCollectionprotected boolean shouldAvoidInstantiation()