com.sleepycat.bdb.collection
Class StoredSortedMap

java.lang.Object
  com.sleepycat.bdb.collection.StoredContainer
      com.sleepycat.bdb.collection.StoredMap
          com.sleepycat.bdb.collection.StoredSortedMap

All Implemented Interfaces:

java.lang.Cloneable, java.util.Map, java.util.SortedMap

public class StoredSortedMap
extends StoredMap
implements java.util.SortedMap

A SortedMap view of a DataStore or DataIndex.

In addition to the standard SortedMap methods, this class provides the following methods for stored sorted maps only. Note that the use of these methods is not compatible with the standard Java collections interface.

• StoredMap.duplicates(Object)
• headMap(Object, boolean)
• tailMap(Object, boolean)
• subMap(Object, boolean, Object, boolean)

Nested Class Summary

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

java.util.Map.Entry<K,V>

Constructor Summary

StoredSortedMap(DataIndex index, DataBinding keyBinding, DataBinding valueBinding, boolean writeAllowed)
Creates a sorted map view of a DataIndex.

StoredSortedMap(DataIndex index, DataBinding keyBinding, EntityBinding valueEntityBinding, boolean writeAllowed)
Creates a sorted map entity view of a DataIndex.

StoredSortedMap(DataStore store, DataBinding keyBinding, DataBinding valueBinding, boolean writeAllowed)
Creates a sorted map view of a DataStore.

StoredSortedMap(DataStore store, DataBinding keyBinding, EntityBinding valueEntityBinding, boolean writeAllowed)
Creates a sorted map entity view of a DataStore.

Method Summary

java.util.Comparator	comparator() Returns null since comparators are not supported.
java.lang.Object	firstKey() Returns the first (lowest) key currently in this sorted map.
java.util.SortedMap	headMap(java.lang.Object toKey) Returns a view of the portion of this sorted set whose keys are strictly less than toKey.
java.util.SortedMap	headMap(java.lang.Object toKey, boolean toInclusive) Returns a view of the portion of this sorted map whose elements are strictly less than toKey, optionally including toKey.
java.lang.Object	lastKey() Returns the last (highest) element currently in this sorted map.
java.util.SortedMap	subMap(java.lang.Object fromKey, boolean fromInclusive, java.lang.Object toKey, boolean toInclusive) Returns a view of the portion of this sorted map whose elements are strictly greater than fromKey and strictly less than toKey, optionally including fromKey and toKey.
java.util.SortedMap	subMap(java.lang.Object fromKey, java.lang.Object toKey) Returns a view of the portion of this sorted map whose elements range from fromKey, inclusive, to toKey, exclusive.
java.util.SortedMap	tailMap(java.lang.Object fromKey) Returns a view of the portion of this sorted map whose elements are greater than or equal to fromKey.
java.util.SortedMap	tailMap(java.lang.Object fromKey, boolean fromInclusive) Returns a view of the portion of this sorted map whose elements are strictly greater than fromKey, optionally including fromKey.

Methods inherited from class com.sleepycat.bdb.collection.StoredMap

append, clone, containsKey, containsValue, duplicates, entrySet, equals, get, keySet, put, putAll, remove, toString, values

Methods inherited from class com.sleepycat.bdb.collection.StoredContainer

areDuplicatesAllowed, areDuplicatesOrdered, areKeysRenumbered, clear, isAutoCommit, isDirtyReadAllowed, isDirtyReadEnabled, isEmpty, isIndexed, isOrdered, isTransactional, isWriteAllowed, size

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.SortedMap

entrySet, keySet, values

Methods inherited from interface java.util.Map

clear, containsKey, containsValue, equals, get, hashCode, isEmpty, put, putAll, remove, size

Constructor Detail

StoredSortedMap

public StoredSortedMap(DataStore store,
                       DataBinding keyBinding,
                       DataBinding valueBinding,
                       boolean writeAllowed)

Creates a sorted map view of a DataStore.

Parameters:

store - is the DataStore underlying the new collection.

keyBinding - is the binding used to translate between key buffers and key objects.

valueBinding - is the binding used to translate between value buffers and value objects.

writeAllowed - is true to create a read-write collection or false to create a read-only collection.

Throws:

java.lang.IllegalArgumentException - if formats are not consistently defined or a parameter is invalid.

RuntimeExceptionWrapper - if a DbException is thrown.

StoredSortedMap

public StoredSortedMap(DataStore store,
                       DataBinding keyBinding,
                       EntityBinding valueEntityBinding,
                       boolean writeAllowed)

Creates a sorted map entity view of a DataStore.

Parameters:

store - is the DataStore underlying the new collection.

keyBinding - is the binding used to translate between key buffers and key objects.

valueEntityBinding - is the binding used to translate between key/value buffers and entity value objects.

writeAllowed - is true to create a read-write collection or false to create a read-only collection.

Throws:

java.lang.IllegalArgumentException - if formats are not consistently defined or a parameter is invalid.

RuntimeExceptionWrapper - if a DbException is thrown.

StoredSortedMap

public StoredSortedMap(DataIndex index,
                       DataBinding keyBinding,
                       DataBinding valueBinding,
                       boolean writeAllowed)

Creates a sorted map view of a DataIndex.

Parameters:

index - is the DataIndex underlying the new collection.

keyBinding - is the binding used to translate between key buffers and key objects.

valueBinding - is the binding used to translate between value buffers and value objects.

writeAllowed - is true to create a read-write collection or false to create a read-only collection.

Throws:

java.lang.IllegalArgumentException - if formats are not consistently defined or a parameter is invalid.

RuntimeExceptionWrapper - if a DbException is thrown.

StoredSortedMap

public StoredSortedMap(DataIndex index,
                       DataBinding keyBinding,
                       EntityBinding valueEntityBinding,
                       boolean writeAllowed)

Creates a sorted map entity view of a DataIndex.

Parameters:

index - is the DataIndex underlying the new collection.

keyBinding - is the binding used to translate between key buffers and key objects.

valueEntityBinding - is the binding used to translate between key/value buffers and entity value objects.

writeAllowed - is true to create a read-write collection or false to create a read-only collection.

Throws:

java.lang.IllegalArgumentException - if formats are not consistently defined or a parameter is invalid.

RuntimeExceptionWrapper - if a DbException is thrown.

Method Detail

comparator

public java.util.Comparator comparator()

Returns null since comparators are not supported. The natural ordering of a stored collection is data byte order, whether the data classes implement the Comparable interface or not. This method does not conform to the SortedMap.comparator() interface.

Specified by:

comparator in interface java.util.SortedMap

Returns:

null.

firstKey

public java.lang.Object firstKey()

Returns the first (lowest) key currently in this sorted map. This method conforms to the SortedMap.firstKey() interface.

Specified by:

firstKey in interface java.util.SortedMap

Returns:

the first key.

Throws:

RuntimeExceptionWrapper - if a DbException is thrown.

lastKey

public java.lang.Object lastKey()

Returns the last (highest) element currently in this sorted map. This method conforms to the SortedMap.lastKey() interface.

Specified by:

lastKey in interface java.util.SortedMap

Returns:

the last key.

Throws:

RuntimeExceptionWrapper - if a DbException is thrown.

headMap

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

Returns a view of the portion of this sorted set whose keys are strictly less than toKey. This method conforms to the SortedMap.headMap(K) interface.

Specified by:

headMap in interface java.util.SortedMap

Parameters:

toKey - is the upper bound.

Returns:

the submap.

Throws:

RuntimeExceptionWrapper - if a DbException is thrown.

headMap

public java.util.SortedMap headMap(java.lang.Object toKey,
                                   boolean toInclusive)

Returns a view of the portion of this sorted map whose elements are strictly less than toKey, optionally including toKey. This method does not exist in the standard SortedMap interface.

Parameters:

toKey - is the upper bound.

toInclusive - is true to include toKey.

Returns:

the submap.

Throws:

RuntimeExceptionWrapper - if a DbException is thrown.

tailMap

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

Returns a view of the portion of this sorted map whose elements are greater than or equal to fromKey. This method conforms to the SortedMap.tailMap(K) interface.

Specified by:

tailMap in interface java.util.SortedMap

Parameters:

fromKey - is the lower bound.

Returns:

the submap.

Throws:

RuntimeExceptionWrapper - if a DbException is thrown.

tailMap

public java.util.SortedMap tailMap(java.lang.Object fromKey,
                                   boolean fromInclusive)

Returns a view of the portion of this sorted map whose elements are strictly greater than fromKey, optionally including fromKey. This method does not exist in the standard SortedMap interface.

Parameters:

fromKey - is the lower bound.

fromInclusive - is true to include fromKey.

Returns:

the submap.

Throws:

RuntimeExceptionWrapper - if a DbException is thrown.

subMap

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

Returns a view of the portion of this sorted map whose elements range from fromKey, inclusive, to toKey, exclusive. This method conforms to the SortedMap.subMap(K, K) interface.

Specified by:

subMap in interface java.util.SortedMap

Parameters:

fromKey - is the lower bound.

toKey - is the upper bound.

Returns:

the submap.

Throws:

RuntimeExceptionWrapper - if a DbException is thrown.

subMap

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

Returns a view of the portion of this sorted map whose elements are strictly greater than fromKey and strictly less than toKey, optionally including fromKey and toKey. This method does not exist in the standard SortedMap interface.

Parameters:

fromKey - is the lower bound.

fromInclusive - is true to include fromKey.

toKey - is the upper bound.

toInclusive - is true to include toKey.

Returns:

the submap.

Throws:

RuntimeExceptionWrapper - if a DbException is thrown.