Berkeley DB
version 5.3.28

com.sleepycat.db
Class CursorConfig

java.lang.Object
  extended by com.sleepycat.db.CursorConfig
All Implemented Interfaces:
Cloneable

public class CursorConfig
extends Object
implements Cloneable

Specify the attributes of database cursor. An instance created with the default constructor is initialized with the system's default settings.


Field Summary
static CursorConfig BULK_CURSOR
          A convenience instance to specify the database cursor will be used to make bulk changes to the underlying database.
static CursorConfig DEFAULT
          Default configuration used if null is passed to methods that create a cursor.
static CursorConfig DEGREE_2
          Deprecated. This has been replaced by READ_COMMITTED to conform to ANSI database isolation terminology.
static CursorConfig DIRTY_READ
          Deprecated. This has been replaced by READ_UNCOMMITTED to conform to ANSI database isolation terminology.
static CursorConfig READ_COMMITTED
          A convenience instance to configure a cursor for read committed isolation.
static CursorConfig READ_UNCOMMITTED
          A convenience instance to configure read operations performed by the cursor to return modified but not yet committed data.
static CursorConfig SNAPSHOT
          A convenience instance to configure read operations performed by the cursor to return values as they were when the cursor was opened, if DatabaseConfig.setMultiversion(boolean) is configured.
static CursorConfig WRITECURSOR
          A convenience instance to specify the Concurrent Data Store environment cursor will be used to update the database.
 
Constructor Summary
CursorConfig()
          An instance created using the default constructor is initialized with the system's default settings.
 
Method Summary
 boolean getBulkCursor()
          Return if the cursor will be used to do bulk operations on the underlying database.
 boolean getDegree2()
          Deprecated. This has been replaced by getReadCommitted() to conform to ANSI database isolation terminology.
 boolean getDirtyRead()
          Deprecated. This has been replaced by getReadUncommitted() to conform to ANSI database isolation terminology.
 boolean getReadCommitted()
          Return if the cursor is configured for read committed isolation.
 boolean getReadUncommitted()
          Return if read operations performed by the cursor are configured to return modified but not yet committed data.
 boolean getSnapshot()
          Return if read operations performed by the cursor are configured to return data as it was when the cursor was opened, without locking.
 boolean getWriteCursor()
          Return if the Concurrent Data Store environment cursor will be used to update the database.
 void setBulkCursor(boolean bulkCursor)
          Specify that the cursor will be used to do bulk operations on the underlying database.
 void setDegree2(boolean degree2)
          Deprecated. This has been replaced by setReadCommitted(boolean) to conform to ANSI database isolation terminology.
 void setDirtyRead(boolean dirtyRead)
          Deprecated. This has been replaced by setReadUncommitted(boolean) to conform to ANSI database isolation terminology.
 void setReadCommitted(boolean readCommitted)
          Configure the cursor for read committed isolation.
 void setReadUncommitted(boolean readUncommitted)
          Configure read operations performed by the cursor to return modified but not yet committed data.
 void setSnapshot(boolean snapshot)
          Configure read operations performed by the cursor to return data as it was when the cursor opened without locking, if DatabaseConfig.setMultiversion(boolean) was configured.
 void setWriteCursor(boolean writeCursor)
          Specify the Concurrent Data Store environment cursor will be used to update the database.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

DEFAULT

public static final CursorConfig DEFAULT
Default configuration used if null is passed to methods that create a cursor.


BULK_CURSOR

public static final CursorConfig BULK_CURSOR
A convenience instance to specify the database cursor will be used to make bulk changes to the underlying database.


READ_COMMITTED

public static final CursorConfig READ_COMMITTED
A convenience instance to configure a cursor for read committed isolation.

This ensures the stability of the current data item read by the cursor but permits data read by this cursor to be modified or deleted prior to the commit of the transaction.


READ_UNCOMMITTED

public static final CursorConfig READ_UNCOMMITTED
A convenience instance to configure read operations performed by the cursor to return modified but not yet committed data.


SNAPSHOT

public static final CursorConfig SNAPSHOT
A convenience instance to configure read operations performed by the cursor to return values as they were when the cursor was opened, if DatabaseConfig.setMultiversion(boolean) is configured.


WRITECURSOR

public static final CursorConfig WRITECURSOR
A convenience instance to specify the Concurrent Data Store environment cursor will be used to update the database.

The underlying Berkeley DB database environment must have been configured as a Concurrent Data Store environment.


DIRTY_READ

public static final CursorConfig DIRTY_READ
Deprecated. This has been replaced by READ_UNCOMMITTED to conform to ANSI database isolation terminology.
A convenience instance to configure read operations performed by the cursor to return modified but not yet committed data.


DEGREE_2

public static final CursorConfig DEGREE_2
Deprecated. This has been replaced by READ_COMMITTED to conform to ANSI database isolation terminology.
A convenience instance to configure a cursor for read committed isolation.

This ensures the stability of the current data item read by the cursor but permits data read by this cursor to be modified or deleted prior to the commit of the transaction.

Constructor Detail

CursorConfig

public CursorConfig()
An instance created using the default constructor is initialized with the system's default settings.

Method Detail

setBulkCursor

public void setBulkCursor(boolean bulkCursor)
Specify that the cursor will be used to do bulk operations on the underlying database.

Parameters:
bulkCursor - If true, specify the cursor will be used to do bulk operations on the underlying database.

getBulkCursor

public boolean getBulkCursor()
Return if the cursor will be used to do bulk operations on the underlying database.

Returns:
If the cursor will be used to do bulk operations on the underlying database.

setReadCommitted

public void setReadCommitted(boolean readCommitted)
Configure the cursor for read committed isolation.

This ensures the stability of the current data item read by the cursor but permits data read by this cursor to be modified or deleted prior to the commit of the transaction.

Parameters:
readCommitted - If true, configure the cursor for read committed isolation.

getReadCommitted

public boolean getReadCommitted()
Return if the cursor is configured for read committed isolation.

Returns:
If the cursor is configured for read committed isolation.

setDegree2

public void setDegree2(boolean degree2)
Deprecated. This has been replaced by setReadCommitted(boolean) to conform to ANSI database isolation terminology.

Configure the cursor for read committed isolation.

This ensures the stability of the current data item read by the cursor but permits data read by this cursor to be modified or deleted prior to the commit of the transaction.

Parameters:
degree2 - If true, configure the cursor for read committed isolation.


getDegree2

public boolean getDegree2()
Deprecated. This has been replaced by getReadCommitted() to conform to ANSI database isolation terminology.

Return if the cursor is configured for read committed isolation.

Returns:
If the cursor is configured for read committed isolation.


setReadUncommitted

public void setReadUncommitted(boolean readUncommitted)
Configure read operations performed by the cursor to return modified but not yet committed data.

Parameters:
readUncommitted - If true, configure read operations performed by the cursor to return modified but not yet committed data.

getReadUncommitted

public boolean getReadUncommitted()
Return if read operations performed by the cursor are configured to return modified but not yet committed data.

Returns:
If read operations performed by the cursor are configured to return modified but not yet committed data.

setDirtyRead

public void setDirtyRead(boolean dirtyRead)
Deprecated. This has been replaced by setReadUncommitted(boolean) to conform to ANSI database isolation terminology.

Configure read operations performed by the cursor to return modified but not yet committed data.

Parameters:
dirtyRead - If true, configure read operations performed by the cursor to return modified but not yet committed data.


getDirtyRead

public boolean getDirtyRead()
Deprecated. This has been replaced by getReadUncommitted() to conform to ANSI database isolation terminology.

Return if read operations performed by the cursor are configured to return modified but not yet committed data.

Returns:
If read operations performed by the cursor are configured to return modified but not yet committed data.


setSnapshot

public void setSnapshot(boolean snapshot)
Configure read operations performed by the cursor to return data as it was when the cursor opened without locking, if DatabaseConfig.setMultiversion(boolean) was configured.

Parameters:
snapshot - If true, configure read operations performed by the cursor to return data as it was when the cursor was opened, without locking.

getSnapshot

public boolean getSnapshot()
Return if read operations performed by the cursor are configured to return data as it was when the cursor was opened, without locking.

Returns:
If read operations performed by the cursor are configured to return data as it was when the cursor was opened.

setWriteCursor

public void setWriteCursor(boolean writeCursor)
Specify the Concurrent Data Store environment cursor will be used to update the database.

Parameters:
writeCursor - If true, specify the Concurrent Data Store environment cursor will be used to update the database.

getWriteCursor

public boolean getWriteCursor()
Return if the Concurrent Data Store environment cursor will be used to update the database.

Returns:
If the Concurrent Data Store environment cursor will be used to update the database.

Berkeley DB
version 5.3.28

Copyright (c) 1996, 2013 Oracle and/or its affiliates. All rights reserved.