oracle.jdbc
Interface OracleSavepoint

All Superinterfaces:

java.sql.Savepoint

All Known Implementing Classes:

OracleSavepoint

public interface OracleSavepoint

extends java.sql.Savepoint

This interface defines the Oracle extensions to the standard JDBC interface java.sql.Savepoint. For pre-JDK 1.4 applications, this interface provides the equivalent functions in java.sql.Savepoint. You can use java.sql.Savepoint in your application where you do not make use of Oracle extensions. However, when your application uses the Oracle extensions to java.sql.Savepoint, you must use oracle.jdbc.OracleSavepoint.

A savepoint is a point within the current local 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. Named savepoints do not have such IDs associated with them.

Method Summary

int	getSavepointId() Retrieves the generated ID for the savepoint that this OracleSavepoint object represents.
java.lang.String	getSavepointName() Retrieves the name of the savepoint this OracleSavepoint object represents.

Method Detail

getSavepointId

public int getSavepointId()
                   throws java.sql.SQLException

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

Specified by:

getSavepointId in interface java.sql.Savepoint

Returns:

the numeric ID of this savepoint

Throws:

java.sql.SQLException - if this is a named savepoint

Since:

9.0.2

getSavepointName

public java.lang.String getSavepointName()
                                  throws java.sql.SQLException

Retrieves the name of the savepoint this OracleSavepoint object represents.

Specified by:

getSavepointName in interface java.sql.Savepoint

Returns:

the name of this savepoint

Throws:

java.sql.SQLException - if this is an un-named savepoint

Since:

9.0.2