SavepointManager (Spring Framework API 2.1) - Spring Framework 2.1.0 API 文档英文版

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

The Spring Framework

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.springframework.transaction
Interface SavepointManager

All Known Subinterfaces:: TransactionStatus

All Known Implementing Classes:: AbstractTransactionStatus, DefaultTransactionStatus, JdbcTransactionObjectSupport, SimpleTransactionStatus

public interface SavepointManager

Interface that specifies an API to programmatically manage transaction savepoints in a generic fashion. Extended by TransactionStatus to expose savepoint management functionality for a specific transaction.

Note that savepoints can only work within an active transaction. Just use this programmatic savepoint handling for advanced needs; else, a subtransaction with PROPAGATION_NESTED is preferable.

This interface is inspired by JDBC 3.0's Savepoint mechanism but is independent from any specific persistence technology.

Since:: 1.1
Author:: Juergen Hoeller
See Also:: TransactionStatus, TransactionDefinition.PROPAGATION_NESTED, Savepoint

Method Summary

Object createSavepoint()
          Create a new savepoint.

void releaseSavepoint(Object savepoint)
          Explicitly release the given savepoint.

void rollbackToSavepoint(Object savepoint)
          Roll back to the given savepoint.

Method Summary
`Object`	`createSavepoint()` Create a new savepoint.
`void`	`releaseSavepoint(Object savepoint)` Explicitly release the given savepoint.
`void`	`rollbackToSavepoint(Object savepoint)` Roll back to the given savepoint.

Method Detail

createSavepoint

Object createSavepoint()
                       throws TransactionException

Create a new savepoint. You can roll back to a specific savepoint via rollbackToSavepoint, and explicitly release a savepoint that you don't need anymore via releaseSavepoint.

Note that most transaction managers will automatically release savepoints at transaction completion.

Returns:: a savepoint object, to be passed into rollbackToSavepoint or releaseSavepoint
Throws:: NestedTransactionNotSupportedException - if the underlying transaction does not support savepoints; TransactionException - if the savepoint could not be created, for example because the transaction is not in an appropriate state
See Also:: Connection.setSavepoint()

rollbackToSavepoint

void rollbackToSavepoint(Object savepoint)
                         throws TransactionException

Roll back to the given savepoint. The savepoint will be automatically released afterwards.

Parameters:: savepoint - the savepoint to roll back to
Throws:: NestedTransactionNotSupportedException - if the underlying transaction does not support savepoints; TransactionException - if the rollback failed
See Also:: Connection.rollback(java.sql.Savepoint)

releaseSavepoint

void releaseSavepoint(Object savepoint)
                      throws TransactionException

Explicitly release the given savepoint.