|
|
|
Berkeley DB version 4.4.20 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.sleepycat.collections.StoredContainer com.sleepycat.collections.StoredCollection com.sleepycat.collections.StoredEntrySet com.sleepycat.collections.StoredSortedEntrySet
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:
StoredContainer.size()
method always throws
UnsupportedOperationException
because, for performance reasons,
databases do not maintain their total record count.StoredIterator.close()
or StoredIterator.close(java.util.Iterator)
to release the underlying database cursor resources.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.
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, hashCode, iterator, iterator, join, removeAll, retainAll, toArray, toArray, toList |
Methods inherited from class com.sleepycat.collections.StoredContainer |
areDuplicatesAllowed, areDuplicatesOrdered, areKeysRenumbered, clear, getCursorConfig, isDirtyRead, isDirtyReadAllowed, isEmpty, isOrdered, isSecondary, isTransactional, isWriteAllowed, size |
Methods inherited from class java.lang.Object |
clone, finalize, getClass, 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 |
public Comparator comparator()
Comparable
interface or not.
This method does not conform to the SortedSet.comparator()
interface.
comparator
in interface SortedSet
public Object first()
SortedSet.first()
interface.
first
in interface SortedSet
RuntimeExceptionWrapper
- if a DatabaseException
is thrown.public Object last()
SortedSet.last()
interface.
last
in interface SortedSet
RuntimeExceptionWrapper
- if a DatabaseException
is thrown.public SortedSet headSet(Object toMapEntry)
SortedSet.headSet(java.lang.Object)
interface.
Note that the return value is a StoredCollection and must be treated as such; for example, its iterators must be explicitly closed.
headSet
in interface SortedSet
toMapEntry
- the upper bound.
RuntimeExceptionWrapper
- if a DatabaseException
is thrown.public SortedSet headSet(Object toMapEntry, boolean toInclusive)
SortedSet
interface.
Note that the return value is a StoredCollection and must be treated as such; for example, its iterators must be explicitly closed.
toMapEntry
- is the upper bound.toInclusive
- is true to include toMapEntry.
RuntimeExceptionWrapper
- if a DatabaseException
is thrown.public SortedSet tailSet(Object fromMapEntry)
SortedSet.tailSet(java.lang.Object)
interface.
Note that the return value is a StoredCollection and must be treated as such; for example, its iterators must be explicitly closed.
tailSet
in interface SortedSet
fromMapEntry
- is the lower bound.
RuntimeExceptionWrapper
- if a DatabaseException
is thrown.public SortedSet tailSet(Object fromMapEntry, boolean fromInclusive)
SortedSet
interface.
Note that the return value is a StoredCollection and must be treated as such; for example, its iterators must be explicitly closed.
fromMapEntry
- is the lower bound.fromInclusive
- is true to include fromMapEntry.
RuntimeExceptionWrapper
- if a DatabaseException
is thrown.public SortedSet subSet(Object fromMapEntry, Object toMapEntry)
SortedSet.subSet(java.lang.Object, java.lang.Object)
interface.
Note that the return value is a StoredCollection and must be treated as such; for example, its iterators must be explicitly closed.
subSet
in interface SortedSet
fromMapEntry
- is the lower bound.toMapEntry
- is the upper bound.
RuntimeExceptionWrapper
- if a DatabaseException
is thrown.public SortedSet subSet(Object fromMapEntry, boolean fromInclusive, Object toMapEntry, boolean toInclusive)
SortedSet
interface.
Note that the return value is a StoredCollection and must be treated as such; for example, its iterators must be explicitly closed.
fromMapEntry
- is the lower bound.fromInclusive
- is true to include fromMapEntry.toMapEntry
- is the upper bound.toInclusive
- is true to include toMapEntry.
RuntimeExceptionWrapper
- if a DatabaseException
is thrown.
|
Berkeley DB version 4.4.20 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |