|
|
|
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.StoredValueSet com.sleepycat.collections.StoredSortedValueSet
The SortedSet returned by Map.values() and which can also be constructed directly if a Map is not needed. Although this collection is a set it may contain duplicate values. Only if an entity value binding is used are all elements guaranteed to be unique.
Note that this class does not conform to the standard Java collections interface in the following ways:
StoredValueSet.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 value sets only. Note that the use of these methods is not compatible with the standard Java collections interface.
Constructor Summary | |
StoredSortedValueSet(Database database,
EntityBinding valueEntityBinding,
boolean writeAllowed)
Creates a sorted value set entity view of a Database . |
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 toValue)
Returns a view of the portion of this sorted set whose elements are strictly less than toValue. |
SortedSet |
headSet(Object toValue,
boolean toInclusive)
Returns a view of the portion of this sorted set whose elements are strictly less than toValue, optionally including toValue. |
Object |
last()
Returns the last (highest) element currently in this sorted set. |
SortedSet |
subSet(Object fromValue,
boolean fromInclusive,
Object toValue,
boolean toInclusive)
Returns a view of the portion of this sorted set whose elements are strictly greater than fromValue and strictly less than toValue, optionally including fromValue and toValue. |
SortedSet |
subSet(Object fromValue,
Object toValue)
Returns a view of the portion of this sorted set whose elements range from fromValue, inclusive, to toValue, exclusive. |
SortedSet |
tailSet(Object fromValue)
Returns a view of the portion of this sorted set whose elements are greater than or equal to fromValue. |
SortedSet |
tailSet(Object fromValue,
boolean fromInclusive)
Returns a view of the portion of this sorted set whose elements are strictly greater than fromValue, optionally including fromValue. |
Methods inherited from class com.sleepycat.collections.StoredValueSet |
add, contains, remove, size |
Methods inherited from class com.sleepycat.collections.StoredCollection |
addAll, containsAll, equals, hashCode, iterator, iterator, join, removeAll, retainAll, toArray, toArray, toList, toString |
Methods inherited from class com.sleepycat.collections.StoredContainer |
areDuplicatesAllowed, areDuplicatesOrdered, areKeysRenumbered, clear, getCursorConfig, isDirtyRead, isDirtyReadAllowed, isEmpty, isOrdered, isSecondary, isTransactional, isWriteAllowed |
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 |
Constructor Detail |
public StoredSortedValueSet(Database database, EntityBinding valueEntityBinding, boolean writeAllowed)
Database
.
database
- is the Database underlying the new collection.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.
IllegalArgumentException
- if formats are not consistently
defined or a parameter is invalid.
RuntimeExceptionWrapper
- if a DatabaseException
is thrown.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 toValue)
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
toValue
- the upper bound.
RuntimeExceptionWrapper
- if a DatabaseException
is thrown.public SortedSet headSet(Object toValue, 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.
toValue
- is the upper bound.toInclusive
- is true to include toValue.
RuntimeExceptionWrapper
- if a DatabaseException
is thrown.public SortedSet tailSet(Object fromValue)
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
fromValue
- is the lower bound.
RuntimeExceptionWrapper
- if a DatabaseException
is thrown.public SortedSet tailSet(Object fromValue, 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.
fromValue
- is the lower bound.fromInclusive
- is true to include fromValue.
RuntimeExceptionWrapper
- if a DatabaseException
is thrown.public SortedSet subSet(Object fromValue, Object toValue)
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
fromValue
- is the lower bound.toValue
- is the upper bound.
RuntimeExceptionWrapper
- if a DatabaseException
is thrown.public SortedSet subSet(Object fromValue, boolean fromInclusive, Object toValue, 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.
fromValue
- is the lower bound.fromInclusive
- is true to include fromValue.toValue
- is the upper bound.toInclusive
- is true to include toValue.
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 |