lucee.runtime.db.DataSourceManager Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of lucee Show documentation
Building the Lucee Loader JAR
There is a newer version: 6.2.0.164-RC
/**
 * Copyright (c) 2014, the Railo Company Ltd.
 * Copyright (c) 2015, Lucee Association Switzerland
 *
 * This library 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 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.
 * 
 * You should have received a copy of the GNU Lesser General Public 
 * License along with this library.  If not, see .
 * 
 */
package lucee.runtime.db;

import lucee.runtime.PageContext;
import lucee.runtime.exp.PageException;

public interface DataSourceManager {

	/**
	 * return a database connection matching to datasource name
	 * 
	 * @param pc page context
	 * @param datasource datasource name
	 * @param user username to datasource
	 * @param pass password to datasource
	 * @return return a Db Connection Object
	 * @throws PageException Page Exception
	 * @deprecated use instead
	 *             getConnection(PageContext pc,DataSource ds, String user, String pass)
	 */
	@Deprecated
	public DatasourceConnection getConnection(PageContext pc, String datasource, String user, String pass) throws PageException;

	/**
	 * return a database connection matching to datasource name
	 * 
	 * @param pc page context
	 * @param ds datasource name
	 * @param user username to datasource
	 * @param pass password to datasource
	 * @return return a Db Connection Object
	 * @throws PageException Page Exception
	 */
	public DatasourceConnection getConnection(PageContext pc, DataSource ds, String user, String pass) throws PageException;

	public abstract void releaseConnection(PageContext pc, DatasourceConnection dc) throws PageException;

	/**
	 * set state of transaction to begin
	 */
	public abstract void begin();

	/**
	 * set state of transaction to begin
	 * 
	 * @param isolation isolation level of the transaction
	 */
	public abstract void begin(String isolation);

	/**
	 * set state of transaction to begin
	 * 
	 * @param isolation isolation level of the transaction
	 */
	public abstract void begin(int isolation);

	/**
	 * rollback hanging transaction
	 * 
	 * @throws PageException Page Exception
	 */
	public abstract void rollback() throws PageException;

	public abstract void savepoint() throws PageException;

	/**
	 * commit hanging transaction
	 * 
	 * @throws PageException Page Exception
	 */
	public abstract void commit() throws PageException;

	/**
	 * @return return if manager is in autocommit mode or not
	 */
	public abstract boolean isAutoCommit();

	/**
	 * ends the manual commit state
	 */
	public abstract void end();

	/**
	 * @deprecated use instead remove(DataSource datasource)
	 * @param datasource datasource name
	 */
	@Deprecated
	public abstract void remove(String datasource);

	public abstract void remove(DataSource datasource);

	public abstract void release();

}