com.sleepycat.db

## Class CursorConfig

- java.lang.Object
- - com.sleepycat.db.CursorConfig

All Implemented Interfaces:
  java.lang.Cloneable

    public class CursorConfig
    extends java.lang.Object
    implements java.lang.Cloneable

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

### Field Summary

Fields
`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

Constructors
Constructor and Description
`CursorConfig()` An instance created using the default constructor is initialized with the system's default settings.

### Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
`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.