com.sleepycat.bdb.collection
Class StoredValueSet

java.lang.Object
  |
  +--com.sleepycat.bdb.collection.StoredContainer
        |
        +--com.sleepycat.bdb.collection.StoredCollection
              |
              +--com.sleepycat.bdb.collection.StoredValueSet

All Implemented Interfaces:

Cloneable, Collection, Set

Direct Known Subclasses:

StoredSortedValueSet

public class StoredValueSet

extends StoredCollection

implements Set

The Set returned by Map.values() and Map.duplicates(), 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.

Constructor Summary

StoredValueSet(DataIndex index, DataBinding valueBinding, boolean writeAllowed)
Creates a value set view of a DataIndex.

StoredValueSet(DataIndex index, EntityBinding valueEntityBinding, boolean writeAllowed)
Creates a value set entity view of a DataIndex.

StoredValueSet(DataStore store, DataBinding valueBinding, boolean writeAllowed)
Creates a value set view of a DataStore.

StoredValueSet(DataStore store, EntityBinding valueEntityBinding, boolean writeAllowed)
Creates a value set entity view of a DataStore.

Method Summary

boolean	add(Object entity) Adds the specified entity to this set if it is not already present (optional operation).
boolean	contains(Object value) Returns true if this set contains the specified element.
boolean	remove(Object value) Removes the specified value from this set if it is present (optional operation).
int	size() Always throws UnsupportedOperationException.

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

addAll, containsAll, equals, iterator, iterator, join, join, removeAll, retainAll, toArray, toArray, toList, toString

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

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Set

addAll, clear, containsAll, equals, hashCode, isEmpty, iterator, removeAll, retainAll, toArray, toArray

Constructor Detail

StoredValueSet

public StoredValueSet(DataStore store,
                      DataBinding valueBinding,
                      boolean writeAllowed)

Creates a value set view of a DataStore.

Parameters:

store - is the DataStore underlying the new collection.

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:

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

RuntimeExceptionWrapper - if a DbException is thrown.

StoredValueSet

public StoredValueSet(DataStore store,
                      EntityBinding valueEntityBinding,
                      boolean writeAllowed)

Creates a value set entity view of a DataStore.

Parameters:

store - is the DataStore 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.

Throws:

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

RuntimeExceptionWrapper - if a DbException is thrown.

StoredValueSet

public StoredValueSet(DataIndex index,
                      DataBinding valueBinding,
                      boolean writeAllowed)

Creates a value set view of a DataIndex.

Parameters:

index - is the DataIndex underlying the new collection.

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:

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

RuntimeExceptionWrapper - if a DbException is thrown.

StoredValueSet

public StoredValueSet(DataIndex index,
                      EntityBinding valueEntityBinding,
                      boolean writeAllowed)

Creates a value set entity view of a DataIndex.

Parameters:

index - is the DataIndex 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.

Throws:

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

RuntimeExceptionWrapper - if a DbException is thrown.

Method Detail

add

public boolean add(Object entity)

Adds the specified entity to this set if it is not already present (optional operation). This method conforms to the Set.add(java.lang.Object) interface.

Specified by:

add in interface Set

Parameters:

entity - is the entity to be added.

Returns:

true if the entity was added, that is the key-value pair represented by the entity was not previously present in the collection.

Throws:

UnsupportedOperationException - if the collection is read-only, if the collection is indexed, or if an entity binding is not used.

RuntimeExceptionWrapper - if a DbException is thrown.

contains

public boolean contains(Object value)

Returns true if this set contains the specified element. This method conforms to the Set.contains(Object) interface.

Specified by:

contains in interface Set

Parameters:

value - the value to check.

Returns:

whether the set contains the given value.

remove

public boolean remove(Object value)

Removes the specified value from this set if it is present (optional operation). If an entity binding is used, the key-value pair represented by the given entity is removed. If an entity binding is used, the first occurance of a key-value pair with the given value is removed. This method conforms to the Set.remove(java.lang.Object) interface.

Specified by:

remove in interface Set

Throws:

UnsupportedOperationException - if the collection is read-only.

RuntimeExceptionWrapper - if a DbException is thrown.

size

public int size()

Description copied from class: StoredContainer

Always throws UnsupportedOperationException. The size of a database cannot be obtained reliably or inexpensively. This method therefore violates the Collection.size() and Map.size() interfaces.

Specified by:

size in interface Set

Overrides:

size in class StoredContainer

Returns:

always throws an exception.