/*
* Distributed as part of c3p0 v.0.9.1.2
*
* Copyright (C) 2005 Machinery For Change, Inc.
*
* Author: Steve Waldman <swaldman@mchange.com>
*
* 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 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; see the file LICENSE. If not, write to the
* Free Software Foundation, Inc., 59 Temple Place, Suite 330,
* Boston, MA 02111-1307, USA.
*/
package com.mchange.v2.c3p0;
import java.beans.PropertyChangeEvent;
import java.sql.SQLException;
import java.util.Properties;
import javax.sql.DataSource;
/**
* <P>A static factory that creates DataSources which simply forward
* calls to java.sql.DriverManager without any pooling or other fanciness.</P>
*
* <P>The DataSources returned are Refereneable and Serializable; they should
* be suitable for placement in a wide variety of JNDI Naming Services.</P>
*
* @deprecated Use the new factories in {@link com.mchange.v2.c3p0.DataSources}. See examples.
*/
public final class DriverManagerDataSourceFactory
{
/**
* Creates an unpooled DataSource that users <TT>java.sql.DriverManager</TT>
* behind the scenes to acquire Connections.
*
* @param driverClass a jdbc driver class that can resolve <TT>jdbcUrl</TT>.
* @param jdbcUrl the jdbcUrl of the RDBMS that Connections should be made to.
* @param dfltUser a username (may be null) for authentication to the RDBMS
* @param dfltPassword a password (may be null) for authentication to the RDBMS
* @param refFactoryLoc a codebase url where JNDI clients can find the
* c3p0 libraries. Use null if clients will be expected to have the
* libraries available locally.
*/
public static DataSource create(String driverClass,
String jdbcUrl,
String dfltUser,
String dfltPassword,
String refFactoryLoc)
throws SQLException
{
DriverManagerDataSource out = new DriverManagerDataSource();
out.setDriverClass( driverClass );
out.setJdbcUrl( jdbcUrl );
out.setUser( dfltUser );
out.setPassword( dfltPassword );
out.setFactoryClassLocation( refFactoryLoc );
return out;
}
/**
* Creates an unpooled DataSource that users <TT>java.sql.DriverManager</TT>
* behind the scenes to acquire Connections.
*
* @param driverClass a jdbc driver class that can resolve <TT>jdbcUrl</TT>.
* @param jdbcUrl the jdbcUrl of the RDBMS that Connections should be made to.
* @param props propertis object that should be passed to DriverManager.getConnection()
* @param refFactoryLoc a codebase url where JNDI clients can find the
* c3p0 libraries. Use null if clients will be expected to have the
* libraries available locally.
*/
public static DataSource create(String driverClass,
String jdbcUrl,
Properties props,
String refFactoryLoc)
throws SQLException
{
DriverManagerDataSource out = new DriverManagerDataSource();
out.setDriverClass( driverClass );
out.setJdbcUrl( jdbcUrl );
out.setProperties( props );
out.setFactoryClassLocation( refFactoryLoc );
return out;
}
/**
* Creates an unpooled DataSource that users <TT>java.sql.DriverManager</TT>
* behind the scenes to acquire Connections.
*
* @param driverClass a jdbc driver class that can resolve <TT>jdbcUrl</TT>.
* @param jdbcUrl the jdbcUrl of the RDBMS that Connections should be made to.
* @param dfltUser a username (may be null) for authentication to the RDBMS
* @param dfltPassword a password (may be null) for authentication to the RDBMS
*/
public static DataSource create(String driverClass,
String jdbcUrl,
String dfltUser,
String dfltPassword)
throws SQLException
{ return create( driverClass, jdbcUrl, dfltUser, dfltPassword, null ); }
/**
* Creates an unpooled DataSource that users <TT>java.sql.DriverManager</TT>
* behind the scenes to acquire Connections.
*
* @param driverClass a jdbc driver class that can resolve <TT>jdbcUrl</TT>.
* @param jdbcUrl the jdbcUrl of the RDBMS that Connections should be made to.
*/
public static DataSource create(String driverClass, String jdbcUrl)
throws SQLException
{ return DriverManagerDataSourceFactory.create( driverClass, jdbcUrl, (String) null, null); }
/**
* Creates an unpooled DataSource that users <TT>java.sql.DriverManager</TT>
* behind the scenes to acquire Connections.
*
* <P>Warning: since you do not set the driver class, the resulting DataSource
* will be less suitable for use via JNDI: JNDI clients will have to
* know the driver class and make sure themselves that it is preloaded!!!
*
* @param jdbcUrl the jdbcUrl of the RDBMS that Connections should be made to.
* @param dfltUser a username (may be null) for authentication to the RDBMS
* @param dfltPassword a password (may be null) for authentication to the RDBMS
*/
public static DataSource create(String jdbcUrl, String dfltUser, String dfltPassword)
throws SQLException
{ return DriverManagerDataSourceFactory.create( null, jdbcUrl, dfltUser, dfltPassword ); }
/**
* Creates an unpooled DataSource that users <TT>java.sql.DriverManager</TT>
* behind the scenes to acquire Connections.
*
* <P>Warning: since you do not set the driver class, the resulting DataSource
* will be less suitable for use via JNDI: JNDI clients will have to
* know the driver class and make sure themselves that it is preloaded!!!
*
* @param jdbcUrl the jdbcUrl of the RDBMS that Connections should be made to.
*/
public static DataSource create(String jdbcUrl)
throws SQLException
{ return DriverManagerDataSourceFactory.create( null, jdbcUrl, (String) null, null ); }
private DriverManagerDataSourceFactory()
{}
}
|