/**
* Copyright (C) 2000-2010 Atomikos <info@atomikos.com>
*
* This code ("Atomikos TransactionsEssentials"), by itself,
* is being distributed under the
* Apache License, Version 2.0 ("License"), a copy of which may be found at
* http://www.atomikos.com/licenses/apache-license-2.0.txt .
* You may not use this file except in compliance with the License.
*
* While the License grants certain patent license rights,
* those patent license rights only extend to the use of
* Atomikos TransactionsEssentials by itself.
*
* This code (Atomikos TransactionsEssentials) contains certain interfaces
* in package (namespace) com.atomikos.icatch
* (including com.atomikos.icatch.Participant) which, if implemented, may
* infringe one or more patents held by Atomikos.
* It should be appreciated that you may NOT implement such interfaces;
* licensing to implement these interfaces must be obtained separately from Atomikos.
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
*/
package com.atomikos.jdbc.nonxa;
import java.sql.Connection;
import java.sql.SQLException;
import com.atomikos.datasource.pool.ConnectionFactory;
import com.atomikos.icatch.HeuristicMessage;
import com.atomikos.jdbc.AbstractDataSourceBean;
import com.atomikos.logging.Logger;
import com.atomikos.logging.LoggerFactory;
import com.atomikos.util.DynamicProxy;
/**
*
* A Bean class for DataSource access to non-XA JDBC implementations.
* Instances are JTA transaction-aware and can rollback the work done
* over multiple connections (provided that all work was done in one and the same thread).
*
*
*/
public class AtomikosNonXADataSourceBean extends AbstractDataSourceBean
{
private static final Logger LOGGER = LoggerFactory.createLogger(AtomikosNonXADataSourceBean.class);
private static final long serialVersionUID = 1L;
private String url;
private String user;
private String password;
private String driverClassName;
private boolean readOnly;
/**
* Sets the URL to use for getting connections. Required.
*
* @param url
*/
public void setUrl ( String url )
{
this.url = url;
}
/**
* Gets the URL to connect.
*/
public String getUrl()
{
return url;
}
/**
* Marks this datasource as being used for read-only work. Optional.
*
* Setting this to true will avoid warnings/errors upon recovery. ReadOnly mode
* is intended to avoid XA configuration of databases where no updates are
* being done.
*
* @param readOnly Defaults to false.
*/
public void setReadOnly ( boolean readOnly )
{
this.readOnly = readOnly;
}
/**
* @return Whether or not this datasource is marked as readOnly.
*/
public boolean getReadOnly()
{
return readOnly;
}
/**
* @return The password.
*/
public String getPassword ()
{
return password;
}
/**
* Sets the password to use.
*
* @param string
*/
public void setPassword ( String string )
{
password = string;
}
/**
* Set the user name to get connections with.
*
* @param string
*/
public void setUser ( String string )
{
user = string;
}
/**
* @return The URL to connect with.
*/
public String getUser ()
{
return user;
}
/**
*
* @return The DriverManager class name.
*/
public String getDriverClassName ()
{
return driverClassName;
}
/**
* Sets the driver class name to be used by the DriverManager. Required.
*
* @param string
*/
public void setDriverClassName ( String string )
{
driverClassName = string;
}
protected void doClose()
{
//nothing to do
}
protected ConnectionFactory doInit() throws Exception
{
AtomikosNonXAConnectionFactory ret = null;
if ( LOGGER.isInfoEnabled() ) LOGGER.logInfo(
this + ": initializing with [" +
" uniqueResourceName=" + getUniqueResourceName() + "," +
" maxPoolSize=" + getMaxPoolSize() + "," +
" minPoolSize=" + getMinPoolSize() + "," +
" borrowConnectionTimeout=" + getBorrowConnectionTimeout() + "," +
" maxIdleTime=" + getMaxIdleTime() + "," +
" reapTimeout=" + getReapTimeout() + "," +
" maintenanceInterval=" + getMaintenanceInterval() + "," +
" testQuery=" + getTestQuery() + "," +
" driverClassName=" + getDriverClassName() + "," +
" user=" + getUser() + "," +
" url=" + getUrl() +
" loginTimeout=" + getLoginTimeout() +
"]"
);
ret = new com.atomikos.jdbc.nonxa.AtomikosNonXAConnectionFactory ( this , url , driverClassName , user , password , getLoginTimeout() , readOnly ) ;
ret.init();
return ret;
}
public synchronized Connection getConnection ( HeuristicMessage hmsg ) throws SQLException
{
if ( LOGGER.isInfoEnabled() ) LOGGER.logInfo ( this + ": getConnection ( " + hmsg + " )..." );
init();
//let pool take care of reusing an existing handle
Connection proxy = super.getConnection ( hmsg );
// here we are certain that proxy is not null -> increase the use count
DynamicProxy dproxy = ( DynamicProxy ) proxy;
com.atomikos.jdbc.nonxa.AtomikosThreadLocalConnection previous = (AtomikosThreadLocalConnection) dproxy.getInvocationHandler();
previous.incUseCount();
previous.addHeuristicMessage ( hmsg );
if ( LOGGER.isDebugEnabled() ) LOGGER.logDebug ( this + ": returning " + proxy );
return proxy;
}
public String toString()
{
String ret = "AtomikosNonXADataSourceBean";
String name = getUniqueResourceName();
if ( name != null ) {
ret = ret + " '" + name + "'";
}
return ret;
}
}