|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.sleepycat.collections.StoredContainer
com.sleepycat.collections.StoredCollection
public abstract class StoredCollection
A abstract base class for all stored collections. This class, and its
base class StoredContainer
, provide implementations of most methods
in the Collection
interface. Other methods, such as add(java.lang.Object, java.lang.Object)
and Collection.remove(java.lang.Object)
, are provided by concrete classes that extend this
class.
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, this class provides the following methods for stored collections only. Note that the use of these methods is not compatible with the standard Java collections interface.
iterator(boolean)
join(com.sleepycat.collections.StoredContainer[], java.lang.Object[], com.sleepycat.je.JoinConfig)
toList()
Field Summary |
---|
Fields inherited from class com.sleepycat.collections.StoredContainer |
---|
view |
Constructor Summary | |
---|---|
StoredCollection(DataView view)
|
Method Summary | |
---|---|
(package private) boolean |
add(Object key,
Object value)
|
boolean |
addAll(Collection coll)
Adds all of the elements in the specified collection to this collection (optional operation). |
(package private) void |
checkIterAddAllowed()
|
boolean |
containsAll(Collection coll)
Returns true if this collection contains all of the elements in the specified collection. |
boolean |
equals(Object other)
Compares the specified object with this collection for equality. |
(package private) Object |
getFirstOrLast(boolean doGetFirst)
|
(package private) int |
getIndexOffset()
|
int |
hashCode()
|
(package private) abstract boolean |
hasValues()
|
(package private) boolean |
iterateDuplicates()
|
Iterator |
iterator()
Returns an iterator over the elements in this collection. |
StoredIterator |
iterator(boolean writeAllowed)
Returns a read or read-write iterator over the elements in this collection. |
StoredIterator |
join(StoredContainer[] indices,
Object[] indexKeys,
JoinConfig joinConfig)
Returns an iterator representing an equality join of the indices and index key values specified. |
(package private) abstract Object |
makeIteratorData(StoredIterator iterator,
DataCursor cursor)
|
boolean |
removeAll(Collection coll)
Removes all this collection's elements that are also contained in the specified collection (optional operation). |
boolean |
retainAll(Collection coll)
Retains only the elements in this collection that are contained in the specified collection (optional operation). |
Object[] |
toArray()
Returns an array of all the elements in this collection. |
Object[] |
toArray(Object[] a)
Returns an array of all the elements in this collection whose runtime type is that of the specified array. |
List |
toList()
Returns a copy of this collection as an ArrayList. |
String |
toString()
Converts the collection to a string representation for debugging. |
Methods inherited from class com.sleepycat.collections.StoredContainer |
---|
areDuplicatesAllowed, areDuplicatesOrdered, areKeysRenumbered, beginAutoCommit, clear, closeCursor, commitAutoCommit, configuredClone, containsKey, containsValue, convertException, get, getCursorConfig, handleException, initAfterClone, isDirtyRead, isDirtyReadAllowed, isEmpty, isOrdered, isSecondary, isTransactional, isWriteAllowed, put, removeKey, removeValue, size |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Methods inherited from interface java.util.Collection |
---|
add, clear, contains, isEmpty, remove, size |
Constructor Detail |
---|
StoredCollection(DataView view)
Method Detail |
---|
final boolean add(Object key, Object value)
public Iterator iterator()
Collection.iterator()
interface.
iterator
in interface Iterable
iterator
in interface Collection
StoredIterator
for this collection.
RuntimeExceptionWrapper
- if a DatabaseException
is
thrown.StoredContainer.isWriteAllowed()
public StoredIterator iterator(boolean writeAllowed)
Collection
interface.
writeAllowed
- is true to open a read-write iterator or false to
open a read-only iterator. If the collection is read-only the iterator
will always be read-only.
StoredIterator
for this collection.
IllegalStateException
- if writeAllowed is true but the collection
is read-only.
RuntimeExceptionWrapper
- if a DatabaseException
is
thrown.StoredContainer.isWriteAllowed()
public Object[] toArray()
Collection.toArray()
interface.
toArray
in interface Collection
RuntimeExceptionWrapper
- if a DatabaseException
is
thrown.public Object[] toArray(Object[] a)
Collection.toArray(Object[])
interface.
toArray
in interface Collection
RuntimeExceptionWrapper
- if a DatabaseException
is
thrown.public boolean containsAll(Collection coll)
Collection.containsAll(java.util.Collection)
interface.
containsAll
in interface Collection
RuntimeExceptionWrapper
- if a DatabaseException
is
thrown.public boolean addAll(Collection coll)
Collection.add(Object)
method of the concrete
collection class, which may or may not be supported.
This method conforms to the Collection.addAll(java.util.Collection)
interface.
addAll
in interface Collection
UnsupportedOperationException
- if the collection is read-only, or
if the collection is indexed, or if the add method is not supported by
the concrete collection.
RuntimeExceptionWrapper
- if a DatabaseException
is
thrown.public boolean removeAll(Collection coll)
Collection.removeAll(java.util.Collection)
interface.
removeAll
in interface Collection
UnsupportedOperationException
- if the collection is read-only.
RuntimeExceptionWrapper
- if a DatabaseException
is
thrown.public boolean retainAll(Collection coll)
Collection.removeAll(java.util.Collection)
interface.
retainAll
in interface Collection
UnsupportedOperationException
- if the collection is read-only.
RuntimeExceptionWrapper
- if a DatabaseException
is
thrown.public boolean equals(Object other)
Collection.equals(java.lang.Object)
interface.
equals
in interface Collection
equals
in class Object
RuntimeExceptionWrapper
- if a DatabaseException
is
thrown.public int hashCode()
hashCode
in interface Collection
hashCode
in class Object
public List toList()
toArray()
but returns a collection instead of an array.
ArrayList
containing a copy of all elements in this
collection.
RuntimeExceptionWrapper
- if a DatabaseException
is
thrown.public String toString()
toString
in class Object
RuntimeExceptionWrapper
- if a DatabaseException
is
thrown.public StoredIterator join(StoredContainer[] indices, Object[] indexKeys, JoinConfig joinConfig)
Collection
interface.
The returned iterator supports only the two methods: hasNext() and next(). All other methods will throw UnsupportedOperationException.
indices
- is an array of indices with elements corresponding to
those in the indexKeys array.indexKeys
- is an array of index key values identifying the
elements to be selected.joinConfig
- is the join configuration, or null to use the
default configuration.
IllegalArgumentException
- if this collection is indexed or if a
given index does not have the same store as this collection.
RuntimeExceptionWrapper
- if a DatabaseException
is
thrown.final Object getFirstOrLast(boolean doGetFirst)
abstract Object makeIteratorData(StoredIterator iterator, DataCursor cursor) throws DatabaseException
DatabaseException
abstract boolean hasValues()
boolean iterateDuplicates()
void checkIterAddAllowed() throws UnsupportedOperationException
UnsupportedOperationException
int getIndexOffset()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |