Berkeley DB Java Edition
version 1.5.1

com.sleepycat.collections
Class StoredSortedEntrySet

java.lang.Object
  |
  +--com.sleepycat.collections.StoredContainer
        |
        +--com.sleepycat.collections.StoredCollection
              |
              +--com.sleepycat.collections.StoredEntrySet
                    |
                    +--com.sleepycat.collections.StoredSortedEntrySet
All Implemented Interfaces:
Cloneable, Collection, Set, SortedSet

public class StoredSortedEntrySet
extends StoredEntrySet
implements SortedSet

The SortedSet returned by Map.entrySet(). This class may not be instantiated directly. Contrary to what is stated by Map.entrySet() this class does support the StoredEntrySet.add(java.lang.Object) and StoredCollection.addAll(java.util.Collection) methods.

The Map.Entry.setValue(java.lang.Object) method of the Map.Entry objects that are returned by this class and its iterators behaves just as the StoredIterator.set(java.lang.Object) method does.

Note that this class does not conform to the standard Java collections interface in the following ways:

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

Author:
Mark Hayes

Method Summary
 Comparator comparator()
          Returns null since comparators are not supported.
 Object first()
          Returns the first (lowest) element currently in this sorted set.
 SortedSet headSet(Object toMapEntry)
          Returns a view of the portion of this sorted set whose elements are strictly less than toMapEntry.
 SortedSet headSet(Object toMapEntry, boolean toInclusive)
          Returns a view of the portion of this sorted set whose elements are strictly less than toMapEntry, optionally including toMapEntry.
 Object last()
          Returns the last (highest) element currently in this sorted set.
 SortedSet subSet(Object fromMapEntry, boolean fromInclusive, Object toMapEntry, boolean toInclusive)
          Returns a view of the portion of this sorted set whose elements are strictly greater than fromMapEntry and strictly less than toMapEntry, optionally including fromMapEntry and toMapEntry.
 SortedSet subSet(Object fromMapEntry, Object toMapEntry)
          Returns a view of the portion of this sorted set whose elements range from fromMapEntry, inclusive, to toMapEntry, exclusive.
 SortedSet tailSet(Object fromMapEntry)
          Returns a view of the portion of this sorted set whose elements are greater than or equal to fromMapEntry.
 SortedSet tailSet(Object fromMapEntry, boolean fromInclusive)
          Returns a view of the portion of this sorted set whose elements are strictly greater than fromMapEntry, optionally including fromMapEntry.
 
Methods inherited from class com.sleepycat.collections.StoredEntrySet
add, contains, remove, toString
 
Methods inherited from class com.sleepycat.collections.StoredCollection
addAll, containsAll, equals, iterator, iterator, join, removeAll, retainAll, toArray, toArray, toList
 
Methods inherited from class com.sleepycat.collections.StoredContainer
areDuplicatesAllowed, areDuplicatesOrdered, areKeysRenumbered, clear, isDirtyRead, isDirtyReadAllowed, isEmpty, isOrdered, isSecondary, isTransactional, isWriteAllowed, size
 
Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface java.util.Set
add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray
 

Method Detail

comparator

public 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 SortedSet.comparator() interface.

Specified by:
comparator in interface SortedSet
Returns:
null.

first

public Object first()
Returns the first (lowest) element currently in this sorted set. This method conforms to the SortedSet.first() interface.

Specified by:
first in interface SortedSet
Returns:
the first element.
Throws:
RuntimeExceptionWrapper - if a DatabaseException is thrown.

last

public Object last()
Returns the last (highest) element currently in this sorted set. This method conforms to the SortedSet.last() interface.

Specified by:
last in interface SortedSet
Returns:
the last element.
Throws:
RuntimeExceptionWrapper - if a DatabaseException is thrown.

headSet

public SortedSet headSet(Object toMapEntry)
Returns a view of the portion of this sorted set whose elements are strictly less than toMapEntry. This method conforms to the SortedSet.headSet(java.lang.Object) interface.

Specified by:
headSet in interface SortedSet
Parameters:
toMapEntry - the upper bound.
Returns:
the subset.
Throws:
RuntimeExceptionWrapper - if a DatabaseException is thrown.

headSet

public SortedSet headSet(Object toMapEntry,
                         boolean toInclusive)
Returns a view of the portion of this sorted set whose elements are strictly less than toMapEntry, optionally including toMapEntry. This method does not exist in the standard SortedSet interface.

Parameters:
toMapEntry - is the upper bound.
toInclusive - is true to include toMapEntry.
Returns:
the subset.
Throws:
RuntimeExceptionWrapper - if a DatabaseException is thrown.

tailSet

public SortedSet tailSet(Object fromMapEntry)
Returns a view of the portion of this sorted set whose elements are greater than or equal to fromMapEntry. This method conforms to the SortedSet.tailSet(java.lang.Object) interface.

Specified by:
tailSet in interface SortedSet
Parameters:
fromMapEntry - is the lower bound.
Returns:
the subset.
Throws:
RuntimeExceptionWrapper - if a DatabaseException is thrown.

tailSet

public SortedSet tailSet(Object fromMapEntry,
                         boolean fromInclusive)
Returns a view of the portion of this sorted set whose elements are strictly greater than fromMapEntry, optionally including fromMapEntry. This method does not exist in the standard SortedSet interface.

Parameters:
fromMapEntry - is the lower bound.
fromInclusive - is true to include fromMapEntry.
Returns:
the subset.
Throws:
RuntimeExceptionWrapper - if a DatabaseException is thrown.

subSet

public SortedSet subSet(Object fromMapEntry,
                        Object toMapEntry)
Returns a view of the portion of this sorted set whose elements range from fromMapEntry, inclusive, to toMapEntry, exclusive. This method conforms to the SortedSet.subSet(java.lang.Object, java.lang.Object) interface.

Specified by:
subSet in interface SortedSet
Parameters:
fromMapEntry - is the lower bound.
toMapEntry - is the upper bound.
Returns:
the subset.
Throws:
RuntimeExceptionWrapper - if a DatabaseException is thrown.

subSet

public SortedSet subSet(Object fromMapEntry,
                        boolean fromInclusive,
                        Object toMapEntry,
                        boolean toInclusive)
Returns a view of the portion of this sorted set whose elements are strictly greater than fromMapEntry and strictly less than toMapEntry, optionally including fromMapEntry and toMapEntry. This method does not exist in the standard SortedSet interface.

Parameters:
fromMapEntry - is the lower bound.
fromInclusive - is true to include fromMapEntry.
toMapEntry - is the upper bound.
toInclusive - is true to include toMapEntry.
Returns:
the subset.
Throws:
RuntimeExceptionWrapper - if a DatabaseException is thrown.

Berkeley DB Java Edition
version 1.5.1

Copyright (c) 1996-2004 Sleepycat Software, Inc. - All rights reserved.