Savepoint

  • A Savepoint represents a point in a transaction that can be used to rollback changes made after that point.

  • Savepoints can be named using a string or unnamed with a system-generated ID.

  • The getSavepointId() method retrieves the ID of an unnamed savepoint and throws an exception if called on a named savepoint.

  • The getSavepointName() method retrieves the name of a named savepoint and throws an exception if called on an unnamed savepoint.

public interface Savepoint

The representation of a savepoint, which is a point within the current transaction that can be referenced from the Connection.rollback method. When a transaction is rolled back to a savepoint all changes made after that savepoint are undone.

Savepoints can be either named or unnamed. Unnamed savepoints are identified by an ID generated by the underlying data source.

Public Method Summary

abstract int
getSavepointId()
Retrieves the generated ID for the savepoint that this Savepoint object represents.
abstract String
getSavepointName()
Retrieves the name of the savepoint that this Savepoint object represents.

Public Methods

public abstract int getSavepointId ()

Retrieves the generated ID for the savepoint that this Savepoint object represents.

Returns
  • the numeric ID of this savepoint
Throws
SQLException if this is a named savepoint

public abstract String getSavepointName ()

Retrieves the name of the savepoint that this Savepoint object represents.

Returns
  • the name of this savepoint
Throws
SQLException if this is an un-named savepoint