com.sun.jdo.spi.persistence.support.sqlstore.ejb

Class SunTransactionHelper

java.lang.Object

com.sun.jdo.spi.persistence.support.sqlstore.ejb.TransactionHelperImpl

com.sun.jdo.spi.persistence.support.sqlstore.ejb.SunTransactionHelper

All Implemented Interfaces:

ConnectorNamingEventListener, TransactionHelper

Direct Known Subclasses:

SunContainerHelper

public class SunTransactionHelper
extends TransactionHelperImpl
implements ConnectorNamingEventListener

Sun specific implementation for TransactionHelper interface. This class has a special implementation for registerSynchronization, because it uses a special object that registers Synchronization instance to be processed after any bean's or container beforeCompletion method, but before the corresponding afterCompletion.

Method Summary

Modifier and Type	Method and Description
void	connectorNamingEventPerformed(ConnectorNamingEvent event) Listeners registered for the event will get notified via this method. Listeners interested in the event will override this method and perform their required operations.
String	getDDLNamePrefix(Object info) Returns name prefix for DDL files extracted from the info instance by the application server specific code.
TransactionManager	getLocalTransactionManager() SunTransactionHelper specific code
Connection	getNonTransactionalConnection(Object resource, String username, String password) Called in a managed environment to get a Connection from the application server specific resource.
Transaction	getTransaction() SunTransactionHelper specific code
UserTransaction	getUserTransaction() SunTransactionHelper specific code
void	notifyApplicationUnloaded(ClassLoader classLoader) Called to notify a ApplicationLifeCycleEventListeners that an application is unloaded.
void	registerApplicationLifeCycleEventListener(ApplicationLifeCycleEventListener listener) Called to register a ApplicationLifeCycleEventListener.
void	registerSynchronization(Transaction jta, Synchronization sync) SunTransactionHelper specific code
PersistenceManagerFactory	replaceInternalPersistenceManagerFactory(PersistenceManagerFactory pmf) SunTransactionHelper specific code

Methods inherited from class com.sun.jdo.spi.persistence.support.sqlstore.ejb.TransactionHelperImpl

getConnection, isManaged, postInvoke, preInvoke, setPersistenceManagerFactoryDefaults, translateStatus, unwrapStatement

Methods inherited from class java.lang.Object

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

Method Detail

getTransaction

public Transaction getTransaction()

SunTransactionHelper specific code

Specified by:

getTransaction in interface TransactionHelper

Specified by:

getTransaction in class TransactionHelperImpl

Returns:

the Transaction instance for the calling thread

getUserTransaction

public UserTransaction getUserTransaction()

SunTransactionHelper specific code

Specified by:

getUserTransaction in interface TransactionHelper

Specified by:

getUserTransaction in class TransactionHelperImpl

Returns:

the UserTransaction instance for the calling thread

registerSynchronization

public void registerSynchronization(Transaction jta,
                                    Synchronization sync)
                             throws RollbackException,
                                    SystemException

SunTransactionHelper specific code

Specified by:

registerSynchronization in interface TransactionHelper

Overrides:

registerSynchronization in class TransactionHelperImpl

Parameters:

jta - the Transaction instance for the calling thread.

sync - the internal Synchronization instance to register.

Throws:

SystemException

RollbackException

replaceInternalPersistenceManagerFactory

public PersistenceManagerFactory replaceInternalPersistenceManagerFactory(PersistenceManagerFactory pmf)

SunTransactionHelper specific code

Specified by:

replaceInternalPersistenceManagerFactory in interface TransactionHelper

Overrides:

replaceInternalPersistenceManagerFactory in class TransactionHelperImpl

Parameters:

pmf - PersistenceManagerFactory instance to be replaced

Returns:

the PersistenceManagerFactory known to the runtime

getDDLNamePrefix

public String getDDLNamePrefix(Object info)

Returns name prefix for DDL files extracted from the info instance by the application server specific code. SunTransactionHelper specific code. Delegates the actual implementation to DeploymentHelper#getDDLNamePrefix(Object);

Specified by:

getDDLNamePrefix in interface TransactionHelper

Overrides:

getDDLNamePrefix in class TransactionHelperImpl

Parameters:

info - the instance to use for the name generation.

Returns:

name prefix as String.

getNonTransactionalConnection

public Connection getNonTransactionalConnection(Object resource,
                                                String username,
                                                String password)
                                         throws SQLException

Called in a managed environment to get a Connection from the application server specific resource. In a non-managed environment returns null as it should not be called. SunTransactionHelper specific code uses com.sun.appserv.jdbc.DataSource to get a Connection.

Specified by:

getNonTransactionalConnection in interface TransactionHelper

Specified by:

getNonTransactionalConnection in class TransactionHelperImpl

Parameters:

resource - the application server specific resource.

username - the resource username. If null, Connection is requested without username and password validation.

password - the password for the resource username.

Returns:

a Connection.

Throws:

SQLException

getLocalTransactionManager

public TransactionManager getLocalTransactionManager()

SunTransactionHelper specific code

Specified by:

getLocalTransactionManager in interface TransactionHelper

Specified by:

getLocalTransactionManager in class TransactionHelperImpl

Returns:

javax.transaction.TransactionManager

registerApplicationLifeCycleEventListener

public void registerApplicationLifeCycleEventListener(ApplicationLifeCycleEventListener listener)

Description copied from interface: TransactionHelper

Called to register a ApplicationLifeCycleEventListener. If ApplicationLifeCycle management is active (typically in managed environment), the registered listener will receive a call back for lifecycle events.

Specified by:

registerApplicationLifeCycleEventListener in interface TransactionHelper

Overrides:

registerApplicationLifeCycleEventListener in class TransactionHelperImpl

Parameters:

listener - An instance of ApplicationLifeCycleEventListener.

notifyApplicationUnloaded

public void notifyApplicationUnloaded(ClassLoader classLoader)

Description copied from interface: TransactionHelper

Called to notify a ApplicationLifeCycleEventListeners that an application is unloaded. If ApplicationLifeCycle management is active (typically in managed environment), the registered listener will handle the notification.

Specified by:

notifyApplicationUnloaded in interface TransactionHelper

Overrides:

notifyApplicationUnloaded in class TransactionHelperImpl

Parameters:

classLoader - An instance of the ClassLoader that loaded the application.

connectorNamingEventPerformed

public void connectorNamingEventPerformed(ConnectorNamingEvent event)

Description copied from interface: ConnectorNamingEventListener

Listeners registered for the event will get notified via this method.
Listeners interested in the event will override this method and perform their required operations.

Specified by:

connectorNamingEventPerformed in interface ConnectorNamingEventListener