JdoTransactionManager (Spring Framework)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.springframework.orm.jdo
Class JdoTransactionManager

java.lang.Object
  org.springframework.transaction.support.AbstractPlatformTransactionManager
      org.springframework.orm.jdo.JdoTransactionManager

All Implemented Interfaces:: InitializingBean, PlatformTransactionManager

public class JdoTransactionManager
extends AbstractPlatformTransactionManager
implements InitializingBean

PlatformTransactionManager implementation for single JDO persistence manager factories. Binds a JDO PersistenceManager from the specified factory to the thread, potentially allowing for one thread PersistenceManager per factory. PersistenceManagerFactoryUtils and JdoTemplate are aware of thread-bound persistence managers and take part in such transactions automatically. Using either is required for JDO access code supporting this transaction management mechanism.

This implementation is appropriate for applications that solely use JDO for transactional data access. JTA resp. JtaTransactionManager is necessary for accessing multiple transactional resources. Note that you need to configure your JDO tool accordingly to make it participate in JTA transactions. In contrast to Hibernate, this cannot be transparently provided by the Spring transaction manager implementation.

Since:: 03.06.2003
Author:: Juergen Hoeller
See Also:: setPersistenceManagerFactory(javax.jdo.PersistenceManagerFactory), setDataSource(javax.sql.DataSource), PersistenceManagerFactoryUtils.getPersistenceManager(javax.jdo.PersistenceManagerFactory, boolean), PersistenceManagerFactoryUtils.closePersistenceManagerIfNecessary(javax.jdo.PersistenceManager, javax.jdo.PersistenceManagerFactory), JdoTemplate.execute(org.springframework.orm.jdo.JdoCallback), HibernateTransactionManager

Field Summary

Fields inherited from class org.springframework.transaction.support.AbstractPlatformTransactionManager

logger, SYNCHRONIZATION_ALWAYS, SYNCHRONIZATION_NEVER, SYNCHRONIZATION_ON_ACTUAL_TRANSACTION

Constructor Summary
`JdoTransactionManager()` Create a new JdoTransactionManager instance.
`JdoTransactionManager(javax.jdo.PersistenceManagerFactory pmf)` Create a new JdoTransactionManager instance.

Method Summary
`void`	`afterPropertiesSet()` Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).
`protected DataAccessException`	`convertJdoAccessException(javax.jdo.JDOException ex)` Convert the given JDOException to an appropriate exception from the org.springframework.dao hierarchy.
`protected void`	`doBegin(java.lang.Object transaction, TransactionDefinition definition)` Begin a new transaction with the given transaction definition.
`protected void`	`doCleanupAfterCompletion(java.lang.Object transaction)` Cleanup resources after transaction completion.
`protected void`	`doCommit(DefaultTransactionStatus status)` Perform an actual commit on the given transaction.
`protected java.lang.Object`	`doGetTransaction()` Return a current transaction object, i.e.
`protected void`	`doResume(java.lang.Object transaction, java.lang.Object suspendedResources)` Resume the resources of the current transaction.
`protected void`	`doRollback(DefaultTransactionStatus status)` Perform an actual rollback on the given transaction.
`protected void`	`doSetRollbackOnly(DefaultTransactionStatus status)` Set the given transaction rollback-only.
`protected java.lang.Object`	`doSuspend(java.lang.Object transaction)` Suspend the resources of the current transaction.
`javax.sql.DataSource`	`getDataSource()` Return the JDBC DataSource that this instance manages transactions for.
`JdoDialect`	`getJdoDialect()` Return the JDO dialect to use for this transaction manager.
`javax.jdo.PersistenceManagerFactory`	`getPersistenceManagerFactory()` Return the PersistenceManagerFactory that this instance should manage transactions for.
`protected boolean`	`isExistingTransaction(java.lang.Object transaction)` Check if the given transaction object indicates an existing, i.e.
`protected boolean`	`isRollbackOnly(java.lang.Object transaction)` Check if the given transaction object indicates a rollback-only, assumably from a nested transaction (else, the TransactionStatus of this transaction would have indicated rollback-only).
`void`	`setDataSource(javax.sql.DataSource dataSource)` Set the JDBC DataSource that this instance should manage transactions for.
`void`	`setJdoDialect(JdoDialect jdoDialect)` Set the JDO dialect to use for this transaction manager.
`void`	`setPersistenceManagerFactory(javax.jdo.PersistenceManagerFactory pmf)` Set the PersistenceManagerFactory that this instance should manage transactions for.

Methods inherited from class org.springframework.transaction.support.AbstractPlatformTransactionManager

commit, getTransaction, getTransactionSynchronization, isRollbackOnCommitFailure, rollback, setRollbackOnCommitFailure, setTransactionSynchronization, setTransactionSynchronizationName

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JdoTransactionManager

public JdoTransactionManager()

Create a new JdoTransactionManager instance. A PersistenceManagerFactory has to be set to be able to use it.
See Also:: setPersistenceManagerFactory(javax.jdo.PersistenceManagerFactory)

JdoTransactionManager

public JdoTransactionManager(javax.jdo.PersistenceManagerFactory pmf)

Create a new JdoTransactionManager instance.
Parameters:: pmf - PersistenceManagerFactory to manage transactions for

Method Detail

setPersistenceManagerFactory

public void setPersistenceManagerFactory(javax.jdo.PersistenceManagerFactory pmf)

Set the PersistenceManagerFactory that this instance should manage transactions for.

getPersistenceManagerFactory

public javax.jdo.PersistenceManagerFactory getPersistenceManagerFactory()

Return the PersistenceManagerFactory that this instance should manage transactions for.

setDataSource

public void setDataSource(javax.sql.DataSource dataSource)

Set the JDBC DataSource that this instance should manage transactions for. The DataSource should match the one used by the JDO PersistenceManagerFactory: for example, you could specify the same JNDI DataSource for both.

If the PersistenceManagerFactory uses a DataSource as connection factory, the DataSource will be auto-detected: You can still explictly specify the DataSource, but you don't need to in this case.

A transactional JDBC Connection for this DataSource will be provided to application code accessing this DataSource directly via DataSourceUtils or JdbcTemplate. The Connection will be taken from the JDO PersistenceManager.

Note that you need to use a JDO dialect for a specific JDO implementation to allow for exposing JDO transactions as JDBC transactions.

See Also:: setJdoDialect(org.springframework.orm.jdo.JdoDialect), PersistenceManagerFactory.getConnectionFactory(), LocalPersistenceManagerFactoryBean.setDataSource(javax.sql.DataSource)

getDataSource

public javax.sql.DataSource getDataSource()

Return the JDBC DataSource that this instance manages transactions for.

setJdoDialect

public void setJdoDialect(JdoDialect jdoDialect)

Set the JDO dialect to use for this transaction manager.

The dialect object can be used to retrieve the underlying JDBC connection and thus allows for exposing JDO transactions as JDBC transactions.

getJdoDialect

public JdoDialect getJdoDialect()

Return the JDO dialect to use for this transaction manager.

afterPropertiesSet

public void afterPropertiesSet()

Description copied from interface: InitializingBean

Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).

This method allows the bean instance to perform initialization only possible when all bean properties have been set and to throw an exception in the event of misconfiguration.

Specified by:: afterPropertiesSet in interface InitializingBean