Package org.apache.commons.dbcp

Class BasicDataSourceFactory

java.lang.Object

org.apache.commons.dbcp.BasicDataSourceFactory

All Implemented Interfaces:

javax.naming.spi.ObjectFactory

public class BasicDataSourceFactory
extends java.lang.Object
implements javax.naming.spi.ObjectFactory

JNDI object factory that creates an instance of BasicDataSource that has been configured based on the RefAddr values of the specified Reference, which must match the names and data types of the BasicDataSource bean properties.

Version:

$Revision: 828639 $ $Date: 2009-10-22 06:27:43 -0400 (Thu, 22 Oct 2009) $

Author:

Craig R. McClanahan, Dirk Verbeeck

Constructor Summary

Constructors

Constructor	Description
BasicDataSourceFactory()

Method Summary

Modifier and Type	Method	Description
static javax.sql.DataSource	createDataSource(java.util.Properties properties)	Creates and configures a BasicDataSource instance based on the given properties.
java.lang.Object	getObjectInstance(java.lang.Object obj, javax.naming.Name name, javax.naming.Context nameCtx, java.util.Hashtable environment)	Create and return a new BasicDataSource instance.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BasicDataSourceFactory

public BasicDataSourceFactory()

Method Detail

createDataSource

public static javax.sql.DataSource createDataSource(java.util.Properties properties)
                                             throws java.lang.Exception

Creates and configures a BasicDataSource instance based on the given properties.

Parameters:

properties - the datasource configuration properties

Throws:

java.lang.Exception - if an error occurs creating the data source

getObjectInstance

public java.lang.Object getObjectInstance(java.lang.Object obj,
                                          javax.naming.Name name,
                                          javax.naming.Context nameCtx,
                                          java.util.Hashtable environment)
                                   throws java.lang.Exception

Create and return a new BasicDataSource instance. If no instance can be created, return null instead.

Specified by:

getObjectInstance in interface javax.naming.spi.ObjectFactory

Parameters:

obj - The possibly null object containing location or reference information that can be used in creating an object

name - The name of this object relative to nameCtx

nameCtx - The context relative to which the name parameter is specified, or null if name is relative to the default initial context

environment - The possibly null environment that is used in creating this object

Throws:

java.lang.Exception - if an exception occurs creating the instance