/*
* JBoss, Home of Professional Open Source.
* Copyright 2008-2009, Red Hat Middleware LLC, and individual contributors
* as indicated by the @author tags. See the copyright.txt file in the
* distribution for a full listing of individual contributors.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.jboss.jca.core.connectionmanager;
import org.jboss.jca.core.connectionmanager.ccm.CachedConnectionManager;
import org.jboss.jca.core.connectionmanager.notx.NoTxConnectionManagerImpl;
import org.jboss.jca.core.connectionmanager.pool.api.Pool;
import org.jboss.jca.core.connectionmanager.transaction.TransactionSynchronizer;
import org.jboss.jca.core.connectionmanager.tx.TxConnectionManagerImpl;
import javax.resource.spi.TransactionSupport.TransactionSupportLevel;
import javax.transaction.TransactionManager;
/**
* The connection manager factory.
* @author <a href="mailto:jesper.pedersen@jboss.org">Jesper Pedersen</a>
*/
public class ConnectionManagerFactory
{
/**
* Constructor
*/
public ConnectionManagerFactory()
{
}
/**
* Create a connection manager
* @param tsl The transaction support level
* @param pool The pool for the connection manager
* @param allocationRetry The allocation retry value
* @param allocationRetryWaitMillis The allocation retry millis value
* @return The connection manager instance
*/
public NoTxConnectionManager createNonTransactional(final TransactionSupportLevel tsl,
final Pool pool,
final Integer allocationRetry,
final Long allocationRetryWaitMillis)
{
if (tsl == null)
throw new IllegalArgumentException("TransactionSupportLevel is null");
if (pool == null)
throw new IllegalArgumentException("Pool is null");
NoTxConnectionManagerImpl cm = null;
switch (tsl)
{
case NoTransaction:
cm = new NoTxConnectionManagerImpl();
break;
case LocalTransaction:
throw new IllegalArgumentException("Transactional connection manager not supported");
case XATransaction:
throw new IllegalArgumentException("Transactional connection manager not supported");
default:
throw new IllegalArgumentException("Unknown transaction support level " + tsl);
}
setProperties(cm, pool, allocationRetry, allocationRetryWaitMillis, null);
setNoTxProperties(cm);
return cm;
}
/**
* Create a transactional connection manager
* @param tsl The transaction support level
* @param pool The pool for the connection manager
* @param allocationRetry The allocation retry value
* @param allocationRetryWaitMillis The allocation retry millis value
* @param tm The transaction manager
* @param interleaving Enable interleaving
* @param xaResourceTimeout The transaction timeout for XAResource
* @param isSameRMOverride Should isSameRM be overridden
* @param wrapXAResource Should XAResource be wrapped
* @param padXid Should Xids be padded
* @return The connection manager instance
*/
public TxConnectionManager createTransactional(final TransactionSupportLevel tsl,
final Pool pool,
final Integer allocationRetry,
final Long allocationRetryWaitMillis,
final TransactionManager tm,
final Boolean interleaving,
final Integer xaResourceTimeout,
final Boolean isSameRMOverride,
final Boolean wrapXAResource,
final Boolean padXid)
{
if (tsl == null)
throw new IllegalArgumentException("TransactionSupportLevel is null");
if (pool == null)
throw new IllegalArgumentException("Pool is null");
if (tm == null)
throw new IllegalArgumentException("TransactionManager is null");
TxConnectionManagerImpl cm = null;
switch (tsl)
{
case NoTransaction:
throw new IllegalArgumentException("Non transactional connection manager not supported");
case LocalTransaction:
cm = new TxConnectionManagerImpl(tm, true);
break;
case XATransaction:
cm = new TxConnectionManagerImpl(tm, false);
break;
default:
throw new IllegalArgumentException("Unknown transaction support level " + tsl);
}
setProperties(cm, pool, allocationRetry, allocationRetryWaitMillis, tm);
setTxProperties(cm, interleaving, xaResourceTimeout, isSameRMOverride, wrapXAResource, padXid);
handleTxIntegration(tm);
return cm;
}
/**
* Common properties
* @param cm The connection manager
* @param pool The pool
* @param allocationRetry The allocation retry value
* @param allocationRetryWaitMillis The allocation retry millis value
* @param tm The transaction manager
*/
private void setProperties(AbstractConnectionManager cm,
Pool pool,
Integer allocationRetry,
Long allocationRetryWaitMillis,
TransactionManager tm)
{
pool.setConnectionListenerFactory(cm);
cm.setPool(pool);
if (allocationRetry != null)
cm.setAllocationRetry(allocationRetry.intValue());
if (allocationRetryWaitMillis != null)
cm.setAllocationRetryWaitMillis(allocationRetryWaitMillis.longValue());
CachedConnectionManager ccm = new CachedConnectionManager(tm);
cm.setCachedConnectionManager(ccm);
}
/**
* NoTxConnectionManager properties
* @param cm The connection manager
*/
private void setNoTxProperties(NoTxConnectionManagerImpl cm)
{
}
/**
* TxConnectionManager properties
* @param cm The connection manager
* @param interleaving Enable interleaving
* @param xaResourceTimeout The transaction timeout for XAResource
* @param isSameRMOverride Should isSameRM be overridden
* @param wrapXAResource Should XAResource be wrapped
* @param padXid Should Xids be padded
*/
private void setTxProperties(TxConnectionManagerImpl cm,
Boolean interleaving,
Integer xaResourceTimeout,
Boolean isSameRMOverride,
Boolean wrapXAResource,
Boolean padXid)
{
if (interleaving != null)
cm.setInterleaving(interleaving.booleanValue());
if (xaResourceTimeout != null)
cm.setXAResourceTimeout(xaResourceTimeout.intValue());
if (isSameRMOverride != null)
cm.setIsSameRMOverride(isSameRMOverride.booleanValue());
if (wrapXAResource != null)
cm.setWrapXAResource(wrapXAResource.booleanValue());
if (padXid != null)
cm.setPadXid(padXid.booleanValue());
}
/**
* Associate the transaction synchronizer with the transaction
* manager.
*
* @param tm TransactionManager
*/
public void handleTxIntegration(final TransactionManager tm)
{
TransactionSynchronizer.setTransactionManager(tm);
}
}