com.sleepycat.collections
public class StoredCollections extends Object
This class consists exclusively of static methods that operate on or return stored collections and maps, jointly called containers. It contains methods for changing certain properties of a container. Because container properties are immutable, these methods always return a new container instance. This allows stored container instances to be used safely by multiple threads. Creating the new container instance is not expensive and creates only two new objects.
When a container is created with a particular property, all containers and iterators derived from that container will inherit the property. For example, if a read-uncommitted Map is created then calls to its subMap(), values(), entrySet(), and keySet() methods will create read-uncommitted containers also.
Method names beginning with "configured" create a new container with a
specified CursorConfig from a given stored container. This allows
configuring a container for read-committed isolation, read-uncommitted
isolation, or any other property supported by CursorConfig
.
All operations performed with the resulting container will be performed with
the specified cursor configuration.
Method Summary | |
---|---|
static Collection | configuredCollection(Collection storedCollection, CursorConfig config)
Creates a configured collection from a given stored collection.
|
static List | configuredList(List storedList, CursorConfig config)
Creates a configured list from a given stored list.
|
static Map | configuredMap(Map storedMap, CursorConfig config)
Creates a configured map from a given stored map.
|
static Set | configuredSet(Set storedSet, CursorConfig config)
Creates a configured set from a given stored set.
|
static SortedMap | configuredSortedMap(SortedMap storedSortedMap, CursorConfig config)
Creates a configured sorted map from a given stored sorted map.
|
static SortedSet | configuredSortedSet(SortedSet storedSortedSet, CursorConfig config)
Creates a configured sorted set from a given stored sorted set.
|
static Collection | dirtyReadCollection(Collection storedCollection) |
static List | dirtyReadList(List storedList) |
static Map | dirtyReadMap(Map storedMap) |
static Set | dirtyReadSet(Set storedSet) |
static SortedMap | dirtyReadSortedMap(SortedMap storedSortedMap) |
static SortedSet | dirtyReadSortedSet(SortedSet storedSortedSet) |
static Iterator | iterator(Iterator iter)
Clones an iterator preserving its current position.
|
Parameters: storedCollection the base collection. config is the cursor configuration to be used for all operations performed via the new collection instance; null may be specified to use the default configuration.
Returns: the configured collection.
Throws: ClassCastException if the given container is not a StoredContainer.
Note that this method may not be called in the JE product, since the StoredList class is not supported.
Parameters: storedList the base list. config is the cursor configuration to be used for all operations performed via the new list instance; null may be specified to use the default configuration.
Returns: the configured list.
Throws: ClassCastException if the given container is not a StoredContainer.
Parameters: storedMap the base map. config is the cursor configuration to be used for all operations performed via the new map instance; null may be specified to use the default configuration.
Returns: the configured map.
Throws: ClassCastException if the given container is not a StoredContainer.
Parameters: storedSet the base set. config is the cursor configuration to be used for all operations performed via the new set instance; null may be specified to use the default configuration.
Returns: the configured set.
Throws: ClassCastException if the given container is not a StoredContainer.
Parameters: storedSortedMap the base map. config is the cursor configuration to be used for all operations performed via the new map instance; null may be specified to use the default configuration.
Returns: the configured map.
Throws: ClassCastException if the given container is not a StoredContainer.
Parameters: storedSortedSet the base set. config is the cursor configuration to be used for all operations performed via the new set instance; null may be specified to use the default configuration.
Returns: the configured set.
Throws: ClassCastException if the given container is not a StoredContainer.
Deprecated: This method has been replaced by StoredCollections in order to conform to ANSI database isolation
terminology. To obtain a dirty-read collection, pass
CursorConfig.READ_UNCOMMITTED
Deprecated: This method has been replaced by StoredCollections in
order to conform to ANSI database isolation terminology. To obtain a
dirty-read list, pass CursorConfig.READ_UNCOMMITTED
Deprecated: This method has been replaced by StoredCollections in
order to conform to ANSI database isolation terminology. To obtain a
dirty-read map, pass CursorConfig.READ_UNCOMMITTED
Deprecated: This method has been replaced by StoredCollections in
order to conform to ANSI database isolation terminology. To obtain a
dirty-read set, pass CursorConfig.READ_UNCOMMITTED
Deprecated: This method has been replaced by StoredCollections in order to conform to ANSI database isolation
terminology. To obtain a dirty-read map, pass
CursorConfig.READ_UNCOMMITTED
Deprecated: This method has been replaced by StoredCollections in order to conform to ANSI database isolation
terminology. To obtain a dirty-read set, pass
CursorConfig.READ_UNCOMMITTED
Parameters: iter an iterator to clone.
Returns: a new {@code Iterator} having the same position as the given iterator.
Throws: ClassCastException if the given iterator was not obtained via a StoredCollection method.