/*
* JBoss, the OpenSource J2EE webOS
*
* Distributable under LGPL license.
* See terms of license at gnu.org.
*/
package org.jboss.tm;
import java.util.HashMap;
import java.util.Hashtable;
import java.util.Map;
import javax.management.ObjectName;
import javax.naming.Context;
import javax.naming.InitialContext;
import javax.naming.Name;
import javax.naming.Reference;
import javax.naming.spi.ObjectFactory;
import javax.transaction.TransactionManager;
import javax.transaction.xa.XAException;
import org.jboss.logging.Logger;
import org.jboss.system.ServiceMBeanSupport;
/**
* This is a JMX service which manages the TransactionManager.
* The service creates it and binds a Reference to it into JNDI.
*
* @see TxManager
* @author Rickard Öberg
* @author Ole Husgaard
* @author Toby Allsopp
* @version $Revision: 1.3.2.6 $
*
* @jmx.mbean extends="org.jboss.system.ServiceMBean"
*/
public class TransactionManagerService
extends ServiceMBeanSupport
implements TransactionManagerServiceMBean, ObjectFactory
{
// Constants -----------------------------------------------------
public static String JNDI_NAME = "java:/TransactionManager";
public static String JNDI_IMPORTER = "java:/TransactionPropagationContextImporter";
public static String JNDI_EXPORTER = "java:/TransactionPropagationContextExporter";
// Attributes ----------------------------------------------------
private int timeout = 300; // default tx timeout, dupl. in TM when it exists.
//private String xidClassName = null;
private ObjectName xidFactory;
private final Map xaExceptionFormatters = new HashMap();
// Static --------------------------------------------------------
static TxManager tm;
// ServiceMBeanSupport overrides ---------------------------------
protected void startService()
throws Exception
{
XidFactoryMBean xidFactoryObj = (XidFactoryMBean) getServer().getAttribute(xidFactory, "Instance");
TransactionImpl.xidFactory = xidFactoryObj;
TransactionImpl.txManagerService = this;
// Get a reference to the TxManager singleton.
tm = TxManager.getInstance();
// Set its default timeout.
tm.setDefaultTransactionTimeout(timeout);
// Bind reference to TM in JNDI
// Our TM also implement the tx importer and exporter
// interfaces, so we bind it under those names too.
// Other transaction managers may have seperate
// implementations of these objects, so they are
// accessed under seperate names.
bindRef(JNDI_NAME, "org.jboss.tm.TxManager");
bindRef(JNDI_IMPORTER, "org.jboss.tm.TransactionPropagationContextImporter");
bindRef(JNDI_EXPORTER, "org.jboss.tm.TransactionPropagationContextFactory");
}
protected void stopService()
{
try
{
// Remove TM, importer and exporter from JNDI
Context ctx = new InitialContext();
ctx.unbind(JNDI_NAME);
ctx.unbind(JNDI_IMPORTER);
ctx.unbind(JNDI_EXPORTER);
}
catch (Exception e)
{
log.error("Failed to clear JNDI bindings", e);
}
}
/**
* Describe getTransactionTimeout method here.
*
* @return an int value
* @jmx:managed-attribute
*/
public int getTransactionTimeout()
{
if (tm != null) // Get timeout value from TM (in case it was changed).
timeout = tm.getDefaultTransactionTimeout();
return timeout;
}
/**
* Describe setTransactionTimeout method here.
*
* @param timeout an int value
* @jmx:managed-attribute
*/
public void setTransactionTimeout(int timeout)
{
this.timeout = timeout;
if (tm != null) // Update TM default timeout
tm.setDefaultTransactionTimeout(timeout);
}
/**
* mbean get-set pair for field xidFactory
* Get the value of xidFactory
* @return value of xidFactory
*
* @jmx:managed-attribute
*/
public ObjectName getXidFactory()
{
return xidFactory;
}
/**
* Set the value of xidFactory
* @param xidFactory Value to assign to xidFactory
*
* @jmx:managed-attribute
*/
public void setXidFactory(ObjectName xidFactory)
{
this.xidFactory = xidFactory;
}
/**
* mbean get-set pair for field transactionManager
* Get the value of transactionManager
* @return value of transactionManager
*
* @jmx.managed-attribute description="Returns the TransactionManager managed by this service"
* access="read-only"
*/
public TransactionManager getTransactionManager()
{
return tm;
}
/**
* Counts the number of transactions
*
* @return the number of active transactions
*
* @jmx:managed-attribute
*/
public long getTransactionCount()
{
return tm.getTransactionCount();
}
/** The number of commits.
*
* @return the number of transactions that have been committed
*
* @jmx:managed-attribute
*/
public long getCommitCount()
{
return tm.getCommitCount();
}
/** The number of rollbacks.
*
* @return the number of transactions that have been rolled back
*
* @jmx:managed-attribute
*/
public long getRollbackCount()
{
return tm.getRollbackCount();
}
/**
* The registerXAExceptionFormatter method
*
* @param clazz a Class value
* @param formatter a XAExceptionFormatter value
*
* @jmx.managed-operation
*/
public void registerXAExceptionFormatter(Class clazz, XAExceptionFormatter formatter)
{
xaExceptionFormatters.put(clazz, formatter);
}
/**
* The unregisterXAExceptionFormatter method
*
* @param clazz a Class value
*
* @jmx.managed-operation
*/
public void unregisterXAExceptionFormatter(Class clazz)
{
xaExceptionFormatters.remove(clazz);
}
void formatXAException(XAException xae, Logger log)
{
Class clazz = xae.getClass();
while (clazz != XAException.class)
{
XAExceptionFormatter formatter = (XAExceptionFormatter) xaExceptionFormatters.get(clazz);
if (formatter != null)
{
formatter.formatXAException(xae, log);
return;
} // end of if ()
clazz = clazz.getSuperclass();
}
}
// ObjectFactory implementation ----------------------------------
public Object getObjectInstance(Object obj, Name name,
Context nameCtx, Hashtable environment)
throws Exception
{
// Return the transaction manager
return tm;
}
// Private -------------------------------------------------------
private void bindRef(String jndiName, String className)
throws Exception
{
Reference ref = new Reference(className, getClass().getName(), null);
new InitialContext().bind(jndiName, ref);
}
}