|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.triactive.jdo.sco.Map
public class Map
A map object which is backed "directly" by the database. SCO fields declared as type java.util.Map are populated with objects of this type whenever the field is actively being managed by the state manager.
When actively tethered to its owning object, the contents of the map are not mirrored in memory. Operations on the map "pass through" directly to the database.
An instance of this class "disconnects" from it backing storage whenever
unsetOwner()
is called.
This occurs automatically in a variety of scenarios, such as when the object
is cloned or when its owning object (the one whose Map field refers to it)
transitions to a transient state.
When a disconnect occurs, the object switches to being backed by a normal
in-memory HashMap and subsequently behaves like a normal HashMap.
If the disconnect occurs during a transaction the contents of the map are
fully loaded from the database.
Subsequent changes to the map affect only the in-memory copy.
Once disconnected from its owner, an instance is never reconnected.
Nested Class Summary |
---|
Nested classes/interfaces inherited from interface java.util.Map |
---|
java.util.Map.Entry<K,V> |
Constructor Summary | |
---|---|
Map(StateManager ownerSM,
java.lang.String fieldName)
|
|
Map(StateManager ownerSM,
java.lang.String fieldName,
java.lang.Class keyType,
java.lang.Class valueType,
boolean allowNulls)
|
Method Summary | |
---|---|
void |
applyUpdates()
Applies any pending updates for this object to the data store. |
void |
clear()
|
java.lang.Object |
clone()
Creates and returns a copy of this object. |
boolean |
containsKey(java.lang.Object key)
|
boolean |
containsValue(java.lang.Object value)
|
java.util.Set |
entrySet()
|
boolean |
equals(java.lang.Object o)
|
java.lang.Object |
get(java.lang.Object key)
|
java.lang.String |
getFieldName()
Returns the field name. |
java.lang.Object |
getOwner()
Returns the owner object of the SCO instance. |
int |
hashCode()
|
boolean |
isEmpty()
|
java.util.Set |
keySet()
|
void |
makeDirty()
Marks object dirty. |
java.lang.Object |
put(java.lang.Object key,
java.lang.Object value)
|
void |
putAll(java.util.Map m)
|
java.lang.Object |
remove(java.lang.Object key)
|
void |
setValueFrom(java.lang.Object o)
Assigns the value of this second-class object from an existing object of the same or compatible type. |
int |
size()
|
java.lang.String |
toString()
|
void |
unsetOwner()
Nullifies references to the owner Object and Field. |
java.util.Collection |
values()
|
Methods inherited from class java.lang.Object |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public Map(StateManager ownerSM, java.lang.String fieldName)
public Map(StateManager ownerSM, java.lang.String fieldName, java.lang.Class keyType, java.lang.Class valueType, boolean allowNulls)
Method Detail |
---|
public void setValueFrom(java.lang.Object o)
SCO
setValueFrom
in interface SCO
o
- the object from which to copy the value.public java.lang.String getFieldName()
SCO
getFieldName
in interface SCO
public java.lang.Object getOwner()
SCO
getOwner
in interface SCO
public void unsetOwner()
SCO
unsetOwner
in interface SCO
public void applyUpdates()
SCO
applyUpdates
in interface SCO
public void makeDirty()
SCO
makeDirty
in interface SCO
public java.lang.Object clone()
Mutable second-class Objects are required to provide a public clone method in order to allow for copying PersistenceCapable objects. In contrast to Object.clone(), this method must not throw a CloneNotSupportedException.
clone
in class java.lang.Object
public boolean equals(java.lang.Object o)
equals
in interface java.util.Map
equals
in class java.lang.Object
public int hashCode()
hashCode
in interface java.util.Map
hashCode
in class java.lang.Object
public int size()
size
in interface java.util.Map
public boolean isEmpty()
isEmpty
in interface java.util.Map
public boolean containsValue(java.lang.Object value)
containsValue
in interface java.util.Map
public boolean containsKey(java.lang.Object key)
containsKey
in interface java.util.Map
public java.lang.Object get(java.lang.Object key)
get
in interface java.util.Map
public java.lang.Object put(java.lang.Object key, java.lang.Object value)
put
in interface java.util.Map
public void putAll(java.util.Map m)
putAll
in interface java.util.Map
public java.lang.Object remove(java.lang.Object key)
remove
in interface java.util.Map
public void clear()
clear
in interface java.util.Map
public java.util.Set keySet()
keySet
in interface java.util.Map
public java.util.Collection values()
values
in interface java.util.Map
public java.util.Set entrySet()
entrySet
in interface java.util.Map
public java.lang.String toString()
toString
in class java.lang.Object
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |