org.apache.jdo.impl.sco

Class TreeMap

java.lang.Object

java.util.AbstractMap

java.util.TreeMap

org.apache.jdo.impl.sco.TreeMap

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.util.Map, java.util.NavigableMap, java.util.SortedMap, SCO, SCOMap

public class TreeMap
extends java.util.TreeMap
implements SCOMap

A mutable 2nd class object that represents TreeMap.

Version:

1.0.1

Author:

Marina Vatkina

See Also:

TreeMap, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap

java.util.AbstractMap.SimpleEntry, java.util.AbstractMap.SimpleImmutableEntry

Nested classes/interfaces inherited from interface java.util.Map

java.util.Map.Entry

Constructor Summary

Constructors

Constructor and Description
TreeMap(java.lang.Class keyType, java.lang.Class valueType, boolean allowNulls) Creates a new empty TreeMap object.
TreeMap(java.lang.Class keyType, java.lang.Class valueType, boolean allowNulls, java.util.Comparator c) Creates a new empty TreeMap object that has the specified initial capacity.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	allowNulls() Returns whether nulls are permitted as keys or values.
void	clear() Removes all of the elements from this map.
void	clearInternal() Clears Map without recording the event.
java.lang.Object	clone() Creates and returns a copy of this object.
java.util.Comparator	comparator()
boolean	containsKey(java.lang.Object key) These methods need to thaw the map before performing the operation.
boolean	containsValue(java.lang.Object value)
java.util.Iterator	eitherIterator() Get an iterator regardless of whether the map is frozen.
java.util.Set	entrySet()
boolean	equals(java.lang.Object o)
java.lang.Object	firstKey()
java.util.Iterator	frozenIterator() Get an iterator over the frozen elements of this map.
java.lang.Object	get(java.lang.Object key)
java.util.Collection	getAddedKeys() Returns the Collection of added keys
java.util.Collection	getAddedValues() Returns the Collection of added values
java.lang.String	getFieldName() Returns the field name
java.lang.Class	getKeyType() Returns the type of the key assignment compatible with all keys of this map.
java.lang.Object	getOwner() Returns the owner object of the SCO instance
java.util.Collection	getRemovedKeys() Returns the Collection of removed keys
java.util.Collection	getRemovedValues() Returns the Collection of removed values
java.lang.Class	getValueType() Returns the type of the value assignment compatible with all values of this map.
int	hashCode()
java.util.SortedMap	headMap(java.lang.Object toKey)
boolean	isEmpty()
java.util.Set	keySet()
java.lang.Object	lastKey()
java.lang.Object	put(java.lang.Object key, java.lang.Object value) Associates the specified value with the specified key in this map.
void	putAll(java.util.Map t) Copies all of the mappings from the specified map to this one.
void	putAllInternal(java.util.Map t) Copies all of the mappings from the specified map to this one without recording the event.
void	putInternal(java.lang.Object key, java.lang.Object value) Associates the specified value with the specified key in this map without recording the event.
java.lang.Object	remove(java.lang.Object key) Removes the mapping for this key from this map if present.
void	removeInternal(java.lang.Object key) Removes mappings from the Map without recording the event.
void	reset() Resets removed and added lists after flush
void	setFrozen(java.util.Map.Entry[] entries) Set the contents of this Map from the frozen elements.
void	setOwner(java.lang.Object owner, int fieldNumber) Sets the owner and field number.
int	size()
java.util.SortedMap	subMap(java.lang.Object fromKey, java.lang.Object toKey)
java.util.SortedMap	tailMap(java.lang.Object fromKey)
java.lang.String	toString()
void	unsetOwner(java.lang.Object owner, int fieldNumber) Nullifies references to the owner Object iff the passed in owner and fieldNumber match.
java.util.Collection	values()

Methods inherited from class java.util.TreeMap

ceilingEntry, ceilingKey, descendingKeySet, descendingMap, firstEntry, floorEntry, floorKey, headMap, higherEntry, higherKey, lastEntry, lowerEntry, lowerKey, navigableKeySet, pollFirstEntry, pollLastEntry, subMap, tailMap

Methods inherited from class java.lang.Object

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

Constructor Detail

TreeMap

public TreeMap(java.lang.Class keyType,
       java.lang.Class valueType,
       boolean allowNulls)

Creates a new empty TreeMap object.

Parameters:

keyType - the type of the keys allowed.

valueType - the type of the values allowed.

allowNulls - true if nulls are allowed.

See Also:

TreeMap

TreeMap

public TreeMap(java.lang.Class keyType,
       java.lang.Class valueType,
       boolean allowNulls,
       java.util.Comparator c)

Creates a new empty TreeMap object that has the specified initial capacity.

Parameters:

keyType - the type of the keys allowed.

valueType - the type of the values allowed.

allowNulls - true if nulls are allowed

c - the comparator that will be used to sort this map. A null value indicates that the elements' natural ordering should be used.

See Also:

TreeMap

Method Detail

put

public java.lang.Object put(java.lang.Object key,
                   java.lang.Object value)

Associates the specified value with the specified key in this map. If the map previously contained a mapping for this key, the old value is replaced.

Specified by:

put in interface java.util.Map

Overrides:

put in class java.util.TreeMap

Parameters:

key - key with which the specified value is to be associated.

value - value to be associated with the specified key.

Returns:

previous value associated with specified key, or null if there was no mapping for key. A null return can also indicate that the TreeMap previously associated null with the specified key.

See Also:

TreeMap

putAll

public void putAll(java.util.Map t)

Copies all of the mappings from the specified map to this one. These mappings replace any mappings that this map had for any of the keys currently in the specified Map.

Specified by:

putAll in interface java.util.Map

Overrides:

putAll in class java.util.TreeMap

Parameters:

t - Mappings to be stored in this map.

See Also:

TreeMap

remove

public java.lang.Object remove(java.lang.Object key)

Removes the mapping for this key from this map if present.

Specified by:

remove in interface java.util.Map

Overrides:

remove in class java.util.TreeMap

Parameters:

key - key whose mapping is to be removed from the map.

Returns:

previous value associated with specified key, or null if there was no mapping for key. A null return can also indicate that the map previously associated null with the specified key.

See Also:

TreeMap

containsKey

public boolean containsKey(java.lang.Object key)

These methods need to thaw the map before performing the operation.

Specified by:

containsKey in interface java.util.Map

Overrides:

containsKey in class java.util.TreeMap

containsValue

public boolean containsValue(java.lang.Object value)

Specified by:

containsValue in interface java.util.Map

Overrides:

containsValue in class java.util.TreeMap

entrySet

public java.util.Set entrySet()

Specified by:

entrySet in interface java.util.Map

Specified by:

entrySet in interface java.util.SortedMap

Overrides:

entrySet in class java.util.TreeMap

equals

public boolean equals(java.lang.Object o)

Specified by:

equals in interface java.util.Map

Overrides:

equals in class java.util.AbstractMap

get

public java.lang.Object get(java.lang.Object key)

Specified by:

get in interface java.util.Map

Overrides:

get in class java.util.TreeMap

hashCode

public int hashCode()

Specified by:

hashCode in interface java.util.Map

Overrides:

hashCode in class java.util.AbstractMap

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface java.util.Map

Overrides:

isEmpty in class java.util.AbstractMap

keySet

public java.util.Set keySet()

Specified by:

keySet in interface java.util.Map

Specified by:

keySet in interface java.util.SortedMap

Overrides:

keySet in class java.util.TreeMap

size

public int size()

Specified by:

size in interface java.util.Map

Overrides:

size in class java.util.TreeMap

values

public java.util.Collection values()

Specified by:

values in interface java.util.Map

Specified by:

values in interface java.util.SortedMap

Overrides:

values in class java.util.TreeMap

toString

public java.lang.String toString()

Overrides:

toString in class java.util.AbstractMap

subMap

public java.util.SortedMap subMap(java.lang.Object fromKey,
                         java.lang.Object toKey)

Specified by:

subMap in interface java.util.NavigableMap

Specified by:

subMap in interface java.util.SortedMap

Overrides:

subMap in class java.util.TreeMap

headMap

public java.util.SortedMap headMap(java.lang.Object toKey)

Specified by:

headMap in interface java.util.NavigableMap

Specified by:

headMap in interface java.util.SortedMap

Overrides:

headMap in class java.util.TreeMap

tailMap

public java.util.SortedMap tailMap(java.lang.Object fromKey)

Specified by:

tailMap in interface java.util.NavigableMap

Specified by:

tailMap in interface java.util.SortedMap

Overrides:

tailMap in class java.util.TreeMap

comparator

public java.util.Comparator comparator()

Specified by:

comparator in interface java.util.SortedMap

Overrides:

comparator in class java.util.TreeMap

firstKey

public java.lang.Object firstKey()
                          throws java.util.NoSuchElementException

Specified by:

firstKey in interface java.util.SortedMap

Overrides:

firstKey in class java.util.TreeMap

Throws:

java.util.NoSuchElementException

lastKey

public java.lang.Object lastKey()
                         throws java.util.NoSuchElementException

Specified by:

lastKey in interface java.util.SortedMap

Overrides:

lastKey in class java.util.TreeMap

Throws:

java.util.NoSuchElementException

clear

public void clear()

Removes all of the elements from this map.

Specified by:

clear in interface java.util.Map

Overrides:

clear in class java.util.TreeMap

See Also:

TreeMap

clone

public java.lang.Object clone()

Creates and returns a copy of this object.

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.

Specified by:

clone in interface SCO

Overrides:

clone in class java.util.TreeMap

reset

public void reset()

Description copied from interface: SCOMap

Resets removed and added lists after flush

Specified by:

reset in interface SCOMap

See Also:

SCOMap.reset()

putInternal

public void putInternal(java.lang.Object key,
               java.lang.Object value)

Description copied from interface: SCOMap

Associates the specified value with the specified key in this map without recording the event. Used internaly to initially populate the Map.

Specified by:

putInternal in interface SCOMap

See Also:

SCOMap.putInternal(Object key, Object value)

putAllInternal

public void putAllInternal(java.util.Map t)

Description copied from interface: SCOMap

Copies all of the mappings from the specified map to this one without recording the event. Used internaly to initially populate the Map.

Specified by:

putAllInternal in interface SCOMap

See Also:

SCOMap.putAllInternal(Map t)

getAddedKeys

public java.util.Collection getAddedKeys()

Description copied from interface: SCOMap

Returns the Collection of added keys

Specified by:

getAddedKeys in interface SCOMap

Returns:

Collection of the added keys as java.util.Collection

See Also:

SCOMap.getAddedKeys()

getAddedValues

public java.util.Collection getAddedValues()

Description copied from interface: SCOMap

Returns the Collection of added values

Specified by:

getAddedValues in interface SCOMap

Returns:

Collection of the added values as java.util.Collection

See Also:

SCOMap.getAddedValues()

getRemovedKeys

public java.util.Collection getRemovedKeys()

Description copied from interface: SCOMap

Returns the Collection of removed keys

Specified by:

getRemovedKeys in interface SCOMap

Returns:

Collection of the removed keys as java.util.Collection

See Also:

SCOMap.getRemovedKeys()

getRemovedValues

public java.util.Collection getRemovedValues()

Description copied from interface: SCOMap

Returns the Collection of removed values

Specified by:

getRemovedValues in interface SCOMap

Returns:

Collection of the removed values as java.util.Collection

See Also:

SCOMap.getRemovedValues()

clearInternal

public void clearInternal()

Description copied from interface: SCOMap

Clears Map without recording the event. Used internaly to clear the Map

Specified by:

clearInternal in interface SCOMap

See Also:

SCOMap.clearInternal()

removeInternal

public void removeInternal(java.lang.Object key)

Description copied from interface: SCOMap

Removes mappings from the Map without recording the event. Used internally to update the Map

Specified by:

removeInternal in interface SCOMap

See Also:

SCOMap.removeInternal(Object key)

unsetOwner

public void unsetOwner(java.lang.Object owner,
              int fieldNumber)

Description copied from interface: SCO

Nullifies references to the owner Object iff the passed in owner and fieldNumber match.

Specified by:

unsetOwner in interface SCO

Parameters:

owner - the existing owner object.

fieldNumber - the existing number of the field.

See Also:

SCO.unsetOwner(Object owner, int fieldNumber)

setOwner

public void setOwner(java.lang.Object owner,
            int fieldNumber)

Description copied from interface: SCO

Sets the owner and field number. Called by StateManager upon assignment to a managed instance.

Specified by:

setOwner in interface SCO

Parameters:

owner - the owner object.

fieldNumber - the number of the field associated with this instance.

See Also:

(Object owner, int fieldNumber)

getOwner

public java.lang.Object getOwner()

Description copied from interface: SCO

Returns the owner object of the SCO instance

Specified by:

getOwner in interface SCO

Returns:

owner object

See Also:

SCO.getOwner()

getFieldName

public java.lang.String getFieldName()

Description copied from interface: SCO

Returns the field name

Specified by:

getFieldName in interface SCO

Returns:

field name as java.lang.String

See Also:

SCO.getFieldName()

getKeyType

public java.lang.Class getKeyType()

Description copied from interface: SCOMap

Returns the type of the key assignment compatible with all keys of this map.

Specified by:

getKeyType in interface SCOMap

Returns:

the type of the key assignment compatible with all keys.

See Also:

{

getValueType

public java.lang.Class getValueType()

Description copied from interface: SCOMap

Returns the type of the value assignment compatible with all values of this map.

Specified by:

getValueType in interface SCOMap

Returns:

the type of the value assignment compatible with all values.

See Also:

{

allowNulls

public boolean allowNulls()

Description copied from interface: SCOMap

Returns whether nulls are permitted as keys or values.

Specified by:

allowNulls in interface SCOMap

Returns:

true if nulls are permitted as keys or values.

See Also:

{

setFrozen

public void setFrozen(java.util.Map.Entry[] entries)

Set the contents of this Map from the frozen elements.

Specified by:

setFrozen in interface SCOMap

Parameters:

entries - the frozen entries.

Since:

1.0.1

eitherIterator

public java.util.Iterator eitherIterator()

Get an iterator regardless of whether the map is frozen. If frozen, get a frozen iterator. If thawed, get a regular iterator.

Specified by:

eitherIterator in interface SCOMap

Returns:

the iterator.

frozenIterator

public java.util.Iterator frozenIterator()

Get an iterator over the frozen elements of this map. This allows iterator of the elements without thawing them, as is needed for transcription.

Specified by:

frozenIterator in interface SCOMap

Returns:

the iterator.

Since:

1.0.1