org.milyn.db.AbstractDataSource Maven / Gradle / Ivy
/*
Milyn - Copyright (C) 2006 - 2010
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License (version 2.1) as published by the Free Software
Foundation.
This library 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:
http://www.gnu.org/licenses/lgpl.txt
*/
package org.milyn.db;
import org.milyn.SmooksException;
import org.milyn.delivery.Fragment;
import org.milyn.util.CollectionsUtil;
import org.milyn.container.ExecutionContext;
import org.milyn.delivery.dom.DOMVisitBefore;
import org.milyn.delivery.sax.SAXElement;
import org.milyn.delivery.sax.SAXVisitBefore;
import org.milyn.delivery.ExecutionLifecycleCleanable;
import org.milyn.delivery.VisitLifecycleCleanable;
import org.milyn.delivery.ordering.Producer;
import org.w3c.dom.Element;
import java.io.IOException;
import java.sql.Connection;
import java.sql.SQLException;
import java.util.Set;
/**
* DataSource management resource.
*
* @author [email protected]
*/
public abstract class AbstractDataSource implements SAXVisitBefore, DOMVisitBefore, Producer, VisitLifecycleCleanable, ExecutionLifecycleCleanable {
private static final String DS_CONTEXT_KEY_PREFIX = AbstractDataSource.class.getName() + "#datasource:";
private static final String CONNECTION_CONTEXT_KEY_PREFIX = AbstractDataSource.class.getName() + "#connection:";
private static final String TRANSACTION_MANAGER_CONTEXT_KEY_PREFIX = AbstractDataSource.class.getName() + "#transactionManager:";
public final void visitBefore(SAXElement element, ExecutionContext executionContext) throws SmooksException, IOException {
bind(executionContext);
}
public final void visitBefore(Element element, ExecutionContext executionContext) throws SmooksException {
bind(executionContext);
}
public final void executeVisitLifecycleCleanup(Fragment fragment, ExecutionContext executionContext) {
unbind(executionContext);
}
public final void executeExecutionLifecycleCleanup(ExecutionContext executionContext) {
// This guarantees Datasource resource cleanup (at the end of an ExecutionContext lifecycle) in
// situations where the Smooks filter operation has terminated prematurely i.e. where the
// executeVisitLifecycleCleanup event method was not called...
unbind(executionContext);
}
protected void bind(ExecutionContext executionContext) {
executionContext.setAttribute(DS_CONTEXT_KEY_PREFIX + getName(), this);
}
protected void unbind(ExecutionContext executionContext) {
try {
Connection connection = (Connection) executionContext.getAttribute(CONNECTION_CONTEXT_KEY_PREFIX + getName());
if(connection != null) {
TransactionManager transactionManager = (TransactionManager) executionContext.getAttribute(TRANSACTION_MANAGER_CONTEXT_KEY_PREFIX + getName());
if(transactionManager == null) {
throw new SmooksException("No TransactionManager is set for the datasource '" + getName() + "'");
}
try {
if(!isAutoCommit()) {
// If there's no termination error on the context, commit, otherwise rollback...
if(executionContext.getTerminationError() == null) {
transactionManager.commit();
} else {
transactionManager.rollback();
}
}
} finally {
executionContext.removeAttribute(CONNECTION_CONTEXT_KEY_PREFIX + getName());
connection.close();
}
}
} catch (SQLException e) {
throw new SmooksException("Unable to unbind DataSource '" + getName() + "'.", e);
} finally {
executionContext.removeAttribute(DS_CONTEXT_KEY_PREFIX + getName());
executionContext.removeAttribute(TRANSACTION_MANAGER_CONTEXT_KEY_PREFIX + getName());
}
}
public static Connection getConnection(String dataSourceName, ExecutionContext executionContext) throws SmooksException {
Connection connection = (Connection) executionContext.getAttribute(CONNECTION_CONTEXT_KEY_PREFIX + dataSourceName);
if(connection == null) {
AbstractDataSource datasource = (AbstractDataSource) executionContext.getAttribute(DS_CONTEXT_KEY_PREFIX + dataSourceName);
if(datasource == null) {
throw new SmooksException("DataSource '" + dataSourceName + "' not bound to context. Configure an '" + AbstractDataSource.class.getName() + "' implementation and target it at '#document'.");
}
try {
connection = datasource.getConnection();
TransactionManager transactionManager = datasource.createTransactionManager(connection);
transactionManager.begin();
executionContext.setAttribute(CONNECTION_CONTEXT_KEY_PREFIX + dataSourceName, connection);
executionContext.setAttribute(TRANSACTION_MANAGER_CONTEXT_KEY_PREFIX + dataSourceName, transactionManager);
} catch (SQLException e) {
throw new SmooksException("Unable to open connection to dataSource '" + dataSourceName + "'.", e);
}
}
return connection;
}
public Set getProducts() {
return CollectionsUtil.toSet(getName());
}
public abstract String getName();
public abstract Connection getConnection() throws SQLException;
public abstract boolean isAutoCommit();
public TransactionManager createTransactionManager(Connection connection) {
return new JdbcTransactionManager(connection, isAutoCommit());
}
}