Jackcess 5.2.0 · io.github.spannm.jackcess.Cursor · APIdia, the JavaDoc alternative

Modifier and Type	Class and Description
public static interface	Cursor.Id Identifier for a cursor.
public static interface	Cursor.Position Value object which maintains the current position of the cursor.
public static interface	Cursor.Savepoint Value object which represents a complete save state of the cursor.

Method Summary

Modifier and Type	Method and Description
public void	afterLast() Resets this cursor for reverse traversal (sets cursor to after the last row).
public void	beforeFirst() Resets this cursor for forward traversal (sets cursor to before the first row).
public boolean	currentRowMatches(Column column from the table for this cursor which is being matched by the valuePattern columnPattern, Object value which is equal to the corresponding value in the matched row. If this object is an instance of `java.util.function.Predicate`, it will be applied to the potential row value instead (overriding any configured ColumnMatcher) valuePattern) Returns `true` if the current row matches the given pattern.
public boolean	currentRowMatches(Map<String, ?> column names and values which must be equal to the corresponding values in the matched row. If a value is an instance of `java.util.function.Predicate`, it will be applied to the potential row value instead (overriding any configured ColumnMatcher) rowPattern) Returns `true` if the current row matches the given pattern.
public void	deleteCurrentRow() Delete the current row.
public boolean	Returns: `true` if a valid row was found with the given value, `false` if no row was found findFirstRow(Column column from the table for this cursor which is being matched by the valuePattern columnPattern, Object value which is equal to the corresponding value in the matched row. If this object is an instance of `java.util.function.Predicate`, it will be applied to the potential row value instead (overriding any configured ColumnMatcher) valuePattern) Moves to the first row (as defined by the cursor) where the given column has the given value.
public boolean	Returns: `true` if a valid row was found with the given values, `false` if no row was found findFirstRow(Map<String, ?> column names and values which must be equal to the corresponding values in the matched row. If a value is an instance of `java.util.function.Predicate`, it will be applied to the potential row value instead (overriding any configured ColumnMatcher) rowPattern) Moves to the first row (as defined by the cursor) where the given columns have the given values.
public boolean	Returns: `true` if a valid row was found with the given value, `false` if no row was found findNextRow(Column column from the table for this cursor which is being matched by the valuePattern columnPattern, Object value which is equal to the corresponding value in the matched row. If this object is an instance of `java.util.function.Predicate`, it will be applied to the potential row value instead (overriding any configured ColumnMatcher) valuePattern) Moves to the next row (as defined by the cursor) where the given column has the given value.
public boolean	Returns: `true` if a valid row was found with the given values, `false` if no row was found findNextRow(Map<String, ?> column names and values which must be equal to the corresponding values in the matched row. If a value is an instance of `java.util.function.Predicate`, it will be applied to the potential row value instead (overriding any configured ColumnMatcher) rowPattern) Moves to the next row (as defined by the cursor) where the given columns have the given values.
public boolean	Returns: `true` if a valid row was found with the given id, `false` if no row was found findRow(RowId rowId) Moves to the row with the given rowId.
public ColumnMatcher	getColumnMatcher() Returns the currently configured ColumnMatcher, always non-`null`.
public Row	getCurrentRow() Returns the current row in this cursor (Column name -> Column value).
public Row	getCurrentRow(Collection<String> Only column names in this collection will be returned columnNames) Returns the current row in this cursor (Column name -> Column value).
public Object	getCurrentRowValue(Column column) Returns the given column from the current row.
public ErrorHandler	getErrorHandler() Gets the currently configured ErrorHandler (always non-`null`).
public Cursor.Id	Returns: the unique identifier of this cursor, usable for validating a `Savepoint` getId() Returns the unique identifier of this cursor, usable for validating a `Savepoint`.
public Row	Returns: The next row in this table (Column name -> Column value), or `null` if no next row is found getNextRow() Moves to the next row in the table and returns it.
public Row	Returns: The next row in this table (Column name -> Column value), or `null` if no next row is found getNextRow(Collection<String> Only column names in this collection will be returned columnNames) Moves to the next row in the table and returns it.
public Row	Returns: The previous row in this table (Column name -> Column value), or `null` if no previous row is found getPreviousRow() Moves to the previous row in the table and returns it.
public Row	Returns: The previous row in this table (Column name -> Column value), or `null` if no previous row is found getPreviousRow(Collection<String> Only column names in this collection will be returned columnNames) Moves to the previous row in the table and returns it.
public Cursor.Savepoint	getSavepoint() Returns the current state of the cursor which can be restored at a future point in time by a call to `restoreSavepoint`.
public Table	Returns: the table over which this cursor iterates getTable() Returns the table over which this cursor iterates.
public boolean	isAfterLast() Returns `true` if the cursor is currently positioned after the last row, `false` otherwise.
public boolean	isBeforeFirst() Returns `true` if the cursor is currently positioned before the first row, `false` otherwise.
public boolean	isCurrentRowDeleted() Returns `true` if the row at which the cursor is currently positioned is deleted, `false` otherwise (including invalid rows).
public Iterator<Row>	iterator() Redeclares java.lang.Iterable.iterator. Calls `beforeFirst` on this cursor and returns a modifiable Iterator which will iterate through all the rows of this table.
public int	Returns: the number of rows moved. moveNextRows(int numRows) Moves forward as many rows as possible up to the given number of rows.
public int	Returns: the number of rows moved. movePreviousRows(int numRows) Moves backward as many rows as possible up to the given number of rows.
public boolean	Returns: `true` if a valid next row was found, `false` otherwise moveToNextRow() Moves to the next row as defined by this cursor.
public boolean	Returns: `true` if a valid previous row was found, `false` otherwise moveToPreviousRow() Moves to the previous row as defined by this cursor.
public IterableBuilder	newIterable() Convenience method for constructing a new IterableBuilder for this cursor.
public void	reset() Resets this cursor for forward traversal.
public void	restoreSavepoint(Cursor.Savepoint savepoint) Moves the cursor to a savepoint previously returned from `getSavepoint`.
public void	setColumnMatcher(ColumnMatcher columnMatcher) Sets a new ColumnMatcher.
public void	setCurrentRowValue(Column column, Object value) Updates a single value in the current row.
public void	setErrorHandler(ErrorHandler newErrorHandler) Sets a new ErrorHandler.
public default Stream<Row>	Returns: a Stream using the default Iterator. stream() Returns a Stream using the default Iterator.
public Object[]	Returns: the given row values if long enough, otherwise a new array, updated with the current row values updateCurrentRow(Object... row) Update the current row.
public <M extends Map<String, Object>> M	Returns: the given row, updated with the current row values updateCurrentRowFromMap(M row) Update the current row.

Inherited from java.lang.Iterable:: forEach spliterator

Method Detail

afterLast	back to summary
public void afterLast() Resets this cursor for reverse traversal (sets cursor to after the last row).

beforeFirst	back to summary
public void beforeFirst() Resets this cursor for forward traversal (sets cursor to before the first row).

currentRowMatches back to summary

currentRowMatches	back to summary
public boolean currentRowMatches(Column columnPattern, Object valuePattern) throws IOException Returns `true` if the current row matches the given pattern. Parameters columnPattern:Column column from the table for this cursor which is being matched by the valuePattern valuePattern:Object value which is equal to the corresponding value in the matched row. If this object is an instance of `java.util.function.Predicate`, it will be applied to the potential row value instead (overriding any configured ColumnMatcher)

public boolean currentRowMatches(Column columnPattern, Object valuePattern) throws IOException

Returns true if the current row matches the given pattern.

Parameters

columnPattern:Column: column from the table for this cursor which is being matched by the valuePattern
valuePattern:Object: value which is equal to the corresponding value in the matched row. If this object is an instance of java.util.function.Predicate, it will be applied to the potential row value instead (overriding any configured ColumnMatcher)

currentRowMatches back to summary

currentRowMatches	back to summary
public boolean currentRowMatches(Map<String, ?> rowPattern) throws IOException Returns `true` if the current row matches the given pattern. Parameters rowPattern:Map<String, ?> column names and values which must be equal to the corresponding values in the matched row. If a value is an instance of `java.util.function.Predicate`, it will be applied to the potential row value instead (overriding any configured ColumnMatcher)

public boolean currentRowMatches(Map<String, ?> rowPattern) throws IOException

Returns true if the current row matches the given pattern.

Parameters

rowPattern:Map<String, ?>: column names and values which must be equal to the corresponding values in the matched row. If a value is an instance of java.util.function.Predicate, it will be applied to the potential row value instead (overriding any configured ColumnMatcher)

deleteCurrentRow	back to summary
public void deleteCurrentRow() throws IOException Delete the current row. Note, re-deleting an already deleted row is allowed (it does nothing). Exceptions IllegalStateException: if the current row is not valid (at beginning or end of table)

deleteCurrentRow

back to summary

public void deleteCurrentRow() throws IOException

Delete the current row.

Note, re-deleting an already deleted row is allowed (it does nothing).

Exceptions

IllegalStateException:: if the current row is not valid (at beginning or end of table)

findFirstRow back to summary

findFirstRow	back to summary
public boolean findFirstRow(Column columnPattern, Object valuePattern) throws IOException Moves to the first row (as defined by the cursor) where the given column has the given value. This may be more efficient on some cursors than others. If a match is not found (or an exception is thrown), the cursor is restored to its previous state. Warning, this method always starts searching from the beginning of the Table (you cannot use it to find successive matches). Parameters columnPattern:Column column from the table for this cursor which is being matched by the valuePattern valuePattern:Object value which is equal to the corresponding value in the matched row. If this object is an instance of `java.util.function.Predicate`, it will be applied to the potential row value instead (overriding any configured ColumnMatcher) Returns:boolean `true` if a valid row was found with the given value, `false` if no row was found

public boolean findFirstRow(Column columnPattern, Object valuePattern) throws IOException

Moves to the first row (as defined by the cursor) where the given column has the given value. This may be more efficient on some cursors than others. If a match is not found (or an exception is thrown), the cursor is restored to its previous state.

Warning, this method always starts searching from the beginning of the Table (you cannot use it to find successive matches).

Parameters

columnPattern:Column: column from the table for this cursor which is being matched by the valuePattern
valuePattern:Object: value which is equal to the corresponding value in the matched row. If this object is an instance of java.util.function.Predicate, it will be applied to the potential row value instead (overriding any configured ColumnMatcher)

Returns:boolean

true if a valid row was found with the given value, false if no row was found

findFirstRow back to summary

findFirstRow	back to summary
public boolean findFirstRow(Map<String, ?> rowPattern) throws IOException Moves to the first row (as defined by the cursor) where the given columns have the given values. This may be more efficient on some cursors than others. If a match is not found (or an exception is thrown), the cursor is restored to its previous state. Warning, this method always starts searching from the beginning of the Table (you cannot use it to find successive matches). Parameters rowPattern:Map<String, ?> column names and values which must be equal to the corresponding values in the matched row. If a value is an instance of `java.util.function.Predicate`, it will be applied to the potential row value instead (overriding any configured ColumnMatcher) Returns:boolean `true` if a valid row was found with the given values, `false` if no row was found

public boolean findFirstRow(Map<String, ?> rowPattern) throws IOException

Moves to the first row (as defined by the cursor) where the given columns have the given values. This may be more efficient on some cursors than others. If a match is not found (or an exception is thrown), the cursor is restored to its previous state.

Warning, this method always starts searching from the beginning of the Table (you cannot use it to find successive matches).

Parameters

rowPattern:Map<String, ?>: column names and values which must be equal to the corresponding values in the matched row. If a value is an instance of java.util.function.Predicate, it will be applied to the potential row value instead (overriding any configured ColumnMatcher)

Returns:boolean

true if a valid row was found with the given values, false if no row was found

findNextRow back to summary

findNextRow	back to summary
public boolean findNextRow(Column columnPattern, Object valuePattern) throws IOException Moves to the next row (as defined by the cursor) where the given column has the given value. This may be more efficient on some cursors than others. If a match is not found (or an exception is thrown), the cursor is restored to its previous state. Parameters columnPattern:Column column from the table for this cursor which is being matched by the valuePattern valuePattern:Object value which is equal to the corresponding value in the matched row. If this object is an instance of `java.util.function.Predicate`, it will be applied to the potential row value instead (overriding any configured ColumnMatcher) Returns:boolean `true` if a valid row was found with the given value, `false` if no row was found

public boolean findNextRow(Column columnPattern, Object valuePattern) throws IOException

Moves to the next row (as defined by the cursor) where the given column has the given value. This may be more efficient on some cursors than others. If a match is not found (or an exception is thrown), the cursor is restored to its previous state.

Parameters

columnPattern:Column: column from the table for this cursor which is being matched by the valuePattern
valuePattern:Object: value which is equal to the corresponding value in the matched row. If this object is an instance of java.util.function.Predicate, it will be applied to the potential row value instead (overriding any configured ColumnMatcher)

Returns:boolean

true if a valid row was found with the given value, false if no row was found

findNextRow back to summary

findNextRow	back to summary
public boolean findNextRow(Map<String, ?> rowPattern) throws IOException Moves to the next row (as defined by the cursor) where the given columns have the given values. This may be more efficient on some cursors than others. If a match is not found (or an exception is thrown), the cursor is restored to its previous state. Parameters rowPattern:Map<String, ?> column names and values which must be equal to the corresponding values in the matched row. If a value is an instance of `java.util.function.Predicate`, it will be applied to the potential row value instead (overriding any configured ColumnMatcher) Returns:boolean `true` if a valid row was found with the given values, `false` if no row was found

public boolean findNextRow(Map<String, ?> rowPattern) throws IOException

Moves to the next row (as defined by the cursor) where the given columns have the given values. This may be more efficient on some cursors than others. If a match is not found (or an exception is thrown), the cursor is restored to its previous state.

Parameters

rowPattern:Map<String, ?>: column names and values which must be equal to the corresponding values in the matched row. If a value is an instance of java.util.function.Predicate, it will be applied to the potential row value instead (overriding any configured ColumnMatcher)

Returns:boolean

true if a valid row was found with the given values, false if no row was found

findRow back to summary

findRow	back to summary
public boolean findRow(RowId rowId) throws IOException Moves to the row with the given rowId. If the row is not found (or an exception is thrown), the cursor is restored to its previous state. Returns:boolean `true` if a valid row was found with the given id, `false` if no row was found

public boolean findRow(RowId rowId) throws IOException

Moves to the row with the given rowId. If the row is not found (or an exception is thrown), the cursor is restored to its previous state.

Returns:boolean: true if a valid row was found with the given id, false if no row was found

getColumnMatcher	back to summary
public ColumnMatcher getColumnMatcher() Returns the currently configured ColumnMatcher, always non-`null`.

getCurrentRow	back to summary
public Row getCurrentRow() throws IOException Returns the current row in this cursor (Column name -> Column value).

getCurrentRow	back to summary
public Row getCurrentRow(Collection<String> columnNames) throws IOException Returns the current row in this cursor (Column name -> Column value). Parameters columnNames:Collection<String> Only column names in this collection will be returned

getCurrentRow

back to summary

public Row getCurrentRow(Collection<String> columnNames) throws IOException

Returns the current row in this cursor (Column name -> Column value).

Parameters

columnNames:Collection<String>: Only column names in this collection will be returned

getCurrentRowValue	back to summary
public Object getCurrentRowValue(Column column) throws IOException Returns the given column from the current row.

getErrorHandler	back to summary
public ErrorHandler getErrorHandler() Gets the currently configured ErrorHandler (always non-`null`). This will be used to handle all errors.

getId back to summary

getId	back to summary
public Cursor.Id getId() Returns the unique identifier of this cursor, usable for validating a `Savepoint`. Returns:Cursor.Id the unique identifier of this cursor, usable for validating a `Savepoint`

public Cursor.Id getId()

Returns the unique identifier of this cursor, usable for validating a Savepoint.

Returns:Cursor.Id: the unique identifier of this cursor, usable for validating a Savepoint

getNextRow back to summary

getNextRow	back to summary
public Row getNextRow() throws IOException Moves to the next row in the table and returns it. Returns:Row The next row in this table (Column name -> Column value), or `null` if no next row is found

public Row getNextRow() throws IOException

Moves to the next row in the table and returns it.

Returns:Row: The next row in this table (Column name -> Column value), or null if no next row is found

getNextRow back to summary

getNextRow	back to summary
public Row getNextRow(Collection<String> columnNames) throws IOException Moves to the next row in the table and returns it. Parameters columnNames:Collection<String> Only column names in this collection will be returned Returns:Row The next row in this table (Column name -> Column value), or `null` if no next row is found

public Row getNextRow(Collection<String> columnNames) throws IOException

Moves to the next row in the table and returns it.

Parameters

columnNames:Collection<String>: Only column names in this collection will be returned

Returns:Row

The next row in this table (Column name -> Column value), or null if no next row is found

getPreviousRow back to summary

getPreviousRow	back to summary
public Row getPreviousRow() throws IOException Moves to the previous row in the table and returns it. Returns:Row The previous row in this table (Column name -> Column value), or `null` if no previous row is found

public Row getPreviousRow() throws IOException

Moves to the previous row in the table and returns it.

Returns:Row: The previous row in this table (Column name -> Column value), or null if no previous row is found

getPreviousRow back to summary

getPreviousRow	back to summary
public Row getPreviousRow(Collection<String> columnNames) throws IOException Moves to the previous row in the table and returns it. Parameters columnNames:Collection<String> Only column names in this collection will be returned Returns:Row The previous row in this table (Column name -> Column value), or `null` if no previous row is found

public Row getPreviousRow(Collection<String> columnNames) throws IOException

Moves to the previous row in the table and returns it.

Parameters

columnNames:Collection<String>: Only column names in this collection will be returned

Returns:Row

The previous row in this table (Column name -> Column value), or null if no previous row is found

getSavepoint back to summary

getSavepoint	back to summary
public Cursor.Savepoint getSavepoint() Returns the current state of the cursor which can be restored at a future point in time by a call to `restoreSavepoint`. Savepoints may be used across different cursor instances for the same table, but they must have the same `Id`.

public Cursor.Savepoint getSavepoint()

Returns the current state of the cursor which can be restored at a future point in time by a call to restoreSavepoint.

Savepoints may be used across different cursor instances for the same table, but they must have the same Id.

getTable	back to summary
public Table getTable() Returns the table over which this cursor iterates. Returns:Table the table over which this cursor iterates

getTable

back to summary

public Table getTable()

Returns the table over which this cursor iterates.

Returns:Table: the table over which this cursor iterates

isAfterLast	back to summary
public boolean isAfterLast() throws IOException Returns `true` if the cursor is currently positioned after the last row, `false` otherwise.

isBeforeFirst	back to summary
public boolean isBeforeFirst() throws IOException Returns `true` if the cursor is currently positioned before the first row, `false` otherwise.

isCurrentRowDeleted	back to summary
public boolean isCurrentRowDeleted() throws IOException Returns `true` if the row at which the cursor is currently positioned is deleted, `false` otherwise (including invalid rows).

iterator back to summary

iterator	back to summary
public Iterator<Row> iterator() Redeclares java.lang.Iterable.iterator. Calls `beforeFirst` on this cursor and returns a modifiable Iterator which will iterate through all the rows of this table. Use of the Iterator follows the same restrictions as a call to `getNextRow`. For more flexible iteration see `newIterable`. Annotations @Override Exceptions UncheckedIOException: if an IOException is thrown by one of the operations, the actual exception will be contained within

public Iterator<Row> iterator()

Redeclares java.lang.Iterable.iterator.

Calls beforeFirst on this cursor and returns a modifiable Iterator which will iterate through all the rows of this table. Use of the Iterator follows the same restrictions as a call to getNextRow.

For more flexible iteration see newIterable.

Annotations

@Override

Exceptions

UncheckedIOException:: if an IOException is thrown by one of the operations, the actual exception will be contained within

moveNextRows	back to summary
public int moveNextRows(int numRows) throws IOException Moves forward as many rows as possible up to the given number of rows. Returns:int the number of rows moved.

moveNextRows

back to summary

public int moveNextRows(int numRows) throws IOException

Moves forward as many rows as possible up to the given number of rows.

Returns:int: the number of rows moved.

movePreviousRows	back to summary
public int movePreviousRows(int numRows) throws IOException Moves backward as many rows as possible up to the given number of rows. Returns:int the number of rows moved.

movePreviousRows

back to summary

public int movePreviousRows(int numRows) throws IOException

Moves backward as many rows as possible up to the given number of rows.

Returns:int: the number of rows moved.

moveToNextRow back to summary

moveToNextRow	back to summary
public boolean moveToNextRow() throws IOException Moves to the next row as defined by this cursor. Returns:boolean `true` if a valid next row was found, `false` otherwise

public boolean moveToNextRow() throws IOException

Moves to the next row as defined by this cursor.

Returns:boolean: true if a valid next row was found, false otherwise

moveToPreviousRow back to summary

moveToPreviousRow	back to summary
public boolean moveToPreviousRow() throws IOException Moves to the previous row as defined by this cursor. Returns:boolean `true` if a valid previous row was found, `false` otherwise

public boolean moveToPreviousRow() throws IOException

Moves to the previous row as defined by this cursor.

Returns:boolean: true if a valid previous row was found, false otherwise

newIterable	back to summary
public IterableBuilder newIterable() Convenience method for constructing a new IterableBuilder for this cursor. An IterableBuilder provides a variety of options for more flexible iteration.

reset	back to summary
public void reset() Resets this cursor for forward traversal. Calls `beforeFirst`.

restoreSavepoint back to summary

restoreSavepoint	back to summary
public void restoreSavepoint(Cursor.Savepoint savepoint) throws IOException Moves the cursor to a savepoint previously returned from `getSavepoint`. Exceptions IllegalArgumentException: if the given savepoint does not have a cursorId equal to this cursor's id

public void restoreSavepoint(Cursor.Savepoint savepoint) throws IOException

Moves the cursor to a savepoint previously returned from getSavepoint.

Exceptions

IllegalArgumentException:: if the given savepoint does not have a cursorId equal to this cursor's id

setColumnMatcher	back to summary
public void setColumnMatcher(ColumnMatcher columnMatcher) Sets a new ColumnMatcher. If `null`, resets to using the default matcher (default depends on Cursor type).

setCurrentRowValue	back to summary
public void setCurrentRowValue(Column column, Object value) throws IOException Updates a single value in the current row. Exceptions IllegalStateException: if the current row is not valid (at beginning or end of table), or deleted.

setCurrentRowValue

back to summary

public void setCurrentRowValue(Column column, Object value) throws IOException

Updates a single value in the current row.

Exceptions

IllegalStateException:: if the current row is not valid (at beginning or end of table), or deleted.

setErrorHandler	back to summary
public void setErrorHandler(ErrorHandler newErrorHandler) Sets a new ErrorHandler. If `null`, resets to using the ErrorHandler configured at the Table level.

stream	back to summary
public default Stream<Row> stream() Returns a Stream using the default Iterator. Returns:Stream<Row> a Stream using the default Iterator.

stream

back to summary

public default Stream<Row> stream()

Returns a Stream using the default Iterator.

Returns:Stream<Row>: a Stream using the default Iterator.

updateCurrentRow	back to summary
public Object[] updateCurrentRow(Object... row) throws IOException Update the current row. Returns:Object[] the given row values if long enough, otherwise a new array, updated with the current row values Exceptions IllegalStateException: if the current row is not valid (at beginning or end of table), or deleted.

updateCurrentRow

back to summary

public Object[] updateCurrentRow(Object... row) throws IOException

Update the current row.

Returns:Object[]

the given row values if long enough, otherwise a new array, updated with the current row values

Exceptions

IllegalStateException:: if the current row is not valid (at beginning or end of table), or deleted.

updateCurrentRowFromMap	back to summary
public <M extends Map<String, Object>> M updateCurrentRowFromMap(M row) throws IOException Update the current row. Returns:M the given row, updated with the current row values Exceptions IllegalStateException: if the current row is not valid (at beginning or end of table), or deleted.

updateCurrentRowFromMap

back to summary

public <M extends Map<String, Object>> M updateCurrentRowFromMap(M row) throws IOException

Update the current row.

Returns:M

the given row, updated with the current row values

Exceptions

IllegalStateException:: if the current row is not valid (at beginning or end of table), or deleted.

public Interface Cursor

Nested and Inner Type Summary

Method Summary

Method Detail

public Interface Cursor.Id

public Interface Cursor.Position

Method Summary

Method Detail

public Interface Cursor.Savepoint

Method Summary

Method Detail

Modifier and Type	Method and Description
public Cursor.Position	Returns: the cursor position captured by this savepoint getCurrentPosition() Returns the cursor position captured by this savepoint.
public Cursor.Id	Returns: the id of the cursor this savepoint was created from, used by `Cursor#restoreSavepoint` to validate that the savepoint is being restored on a compatible cursor getCursorId() Returns the id of the cursor this savepoint was created from, used by `Cursor#restoreSavepoint` to validate that the savepoint is being restored on a compatible cursor.