Spring Data Graph

org.springframework.data.graph.neo4j.transaction
Class JotmFactoryBean

java.lang.Object
  extended by org.springframework.data.graph.neo4j.transaction.JotmFactoryBean
All Implemented Interfaces:
DisposableBean, FactoryBean, InitializingBean

public class JotmFactoryBean
extends Object
implements FactoryBean, DisposableBean, InitializingBean

FactoryBean that retrieves the JTA UserTransaction/TransactionManager for ObjectWeb's JOTM. Will retrieve an already active JOTM instance if found (e.g. if running in JOnAS), else create a new local JOTM instance.

With JOTM, the same object implements both the UserTransaction and the TransactionManager interface, as returned by this FactoryBean.

A local JOTM instance is well-suited for working in conjunction with ObjectWeb's XAPool, e.g. with bean definitions like the following:

 <bean id="jotm" class="org.springframework.transaction.jta.JotmFactoryBean"/>
 

<bean id="transactionManager" class="org.springframework.transaction.jta.JtaTransactionManager"> <property name="userTransaction" ref="jotm"/> </bean>

<bean id="innerDataSource" class="org.enhydra.jdbc.standard.StandardXADataSource" destroy-method="shutdown"> <property name="transactionManager" ref="jotm"/> <property name="driverName" value="..."/> <property name="url" value="..."/> <property name="user" value="..."/> <property name="password" value="..."/> </bean>

<bean id="dataSource" class="org.enhydra.jdbc.pool.StandardXAPoolDataSource" destroy-method="shutdown"> <property name="dataSource" ref="innerDataSource"/> <property name="user" value="..."/> <property name="password" value="..."/> <property name="maxSize" value="..."/> </bean>

Note that Spring's JtaTransactionManager will automatically detect that the passed-in UserTransaction reference also implements the TransactionManager interface. Hence, it is not necessary to specify a separate reference for JtaTransactionManager's "transactionManager" property.

Implementation note: This FactoryBean uses JOTM's static access method to obtain the JOTM Current object, which implements both the UserTransaction and the TransactionManager interface, as mentioned above.

Since:
21.01.2004
Author:
Juergen Hoeller
See Also:
JtaTransactionManager.setUserTransaction(javax.transaction.UserTransaction), JtaTransactionManager.setTransactionManager(javax.transaction.TransactionManager), Current

Constructor Summary
JotmFactoryBean()
           
 
Method Summary
 void afterPropertiesSet()
           
 void destroy()
          Stop the local JOTM instance, if created by this FactoryBean.
 org.objectweb.jotm.Jotm getJotm()
          Return the JOTM instance created by this factory bean, if any.
 Object getObject()
           
 Class getObjectType()
           
 boolean isSingleton()
           
 void setDefaultTimeout(int defaultTimeout)
          Set the default transaction timeout for the JOTM instance.
 void setJotmHome(String jotmHome)
           
 void setTransactionRecovery(boolean transactionRecovery)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

JotmFactoryBean

public JotmFactoryBean()
Method Detail

setDefaultTimeout

public void setDefaultTimeout(int defaultTimeout)
Set the default transaction timeout for the JOTM instance.

Should only be called for a local JOTM instance, not when accessing an existing (shared) JOTM instance.


setTransactionRecovery

public void setTransactionRecovery(boolean transactionRecovery)
                            throws SystemException
Throws:
SystemException

setJotmHome

public void setJotmHome(String jotmHome)
Parameters:
jotmHome - the directory that contains conf/jotm.properties

afterPropertiesSet

public void afterPropertiesSet()
                        throws Exception
Specified by:
afterPropertiesSet in interface InitializingBean
Throws:
Exception

getJotm

public org.objectweb.jotm.Jotm getJotm()
Return the JOTM instance created by this factory bean, if any. Will be null if an already active JOTM instance is used.

Application code should never need to access this.


getObject

public Object getObject()
Specified by:
getObject in interface FactoryBean

getObjectType

public Class getObjectType()
Specified by:
getObjectType in interface FactoryBean

isSingleton

public boolean isSingleton()
Specified by:
isSingleton in interface FactoryBean

destroy

public void destroy()
Stop the local JOTM instance, if created by this FactoryBean.

Specified by:
destroy in interface DisposableBean

Spring Data Graph

Copyright © 2011. All Rights Reserved.