DataSourceConnectionFactory (Castor JavaDoc)

java.lang.Object
- org.castor.cpa.persistence.sql.connection.DataSourceConnectionFactory

All Implemented Interfaces:

ConnectionFactory
```
public final class DataSourceConnectionFactory
extends java.lang.Object
implements ConnectionFactory
```
Since:

0.9.9

Version:

$Revision: 8111 $ $Date: 2006-04-12 15:13:08 -0600 (Wed, 12 Apr 2006) $

Author:

Werner Guttmann, Ralf Joachim

Constructor Summary

Constructors
Constructor	Description
`DataSourceConnectionFactory(DataSource dataSource, boolean useProxies, java.lang.ClassLoader loader)`	Constructs a new DataSourceConnectionFactory with given database and mapping.
`DataSourceConnectionFactory(javax.sql.DataSource datasource, boolean useProxies)`	Constructs a new DataSourceConnectionFactory with given name, engine, mapping and datasource.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`static java.lang.String`	`buildMethodName(java.lang.String name)`	Build the name of the method to set the parameter value of the given name.
`java.sql.Connection`	`createConnection()`	Creates a new JDBC Connection instance.
`void`	`initializeFactory()`	Initialize the concrete factory.
`static javax.sql.DataSource`	`loadDataSource(DataSource confDataSource, java.lang.ClassLoader loader)`	Initialize JDBC DataSource instance with the given database configuration instances and the given class loader.
`static void`	`setParameters(javax.sql.DataSource dataSource, Param[] params)`	Set all the parameters of the given array at the given datasource by calling one of the set methods of the datasource.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - DataSourceConnectionFactory
```
public DataSourceConnectionFactory(javax.sql.DataSource datasource,
                                   boolean useProxies)
```
    Constructs a new DataSourceConnectionFactory with given name, engine, mapping and datasource. Factory will be ready to use without calling initialize first.
    
    Parameters:
    
    datasource - The preconfigured datasource to use for creating connections.
    
    useProxies - Wrap JDBC connections by proxies?
  - DataSourceConnectionFactory
```
public DataSourceConnectionFactory(DataSource dataSource,
                                   boolean useProxies,
                                   java.lang.ClassLoader loader)
```
    Constructs a new DataSourceConnectionFactory with given database and mapping. Initialize needs to be called before using the factory to create connections.
    
    Parameters:
    
    dataSource - DataSouce configuration.
    
    useProxies - Wrap JDBC connections by proxies?
    
    loader - ClassLoader to use.
- Method Detail
  - loadDataSource
```
public static javax.sql.DataSource loadDataSource(DataSource confDataSource,
                                                  java.lang.ClassLoader loader)
                                           throws MappingException
```
    Initialize JDBC DataSource instance with the given database configuration instances and the given class loader.
    
    Parameters:
    
    confDataSource - DataSource configuration.
    
    loader - ClassLoader to use.
    
    Returns:
    
    The initialized DataSource.
    
    Throws:
    
    MappingException - Problem related to analysing the JDO configuration.
  - setParameters
```
public static void setParameters(javax.sql.DataSource dataSource,
                                 Param[] params)
                          throws MappingException
```
    Set all the parameters of the given array at the given datasource by calling one of the set methods of the datasource.
    
    Parameters:
    
    dataSource - The datasource to set the parameters on.
    
    params - The parameters to set on the datasource.
    
    Throws:
    
    MappingException - If one of the parameters could not be set.
  - buildMethodName
```
public static java.lang.String buildMethodName(java.lang.String name)
```
    Build the name of the method to set the parameter value of the given name. The name of the method is build by preceding given parameter name with 'set' followed by all letters of the name. In addition the first letter and all letters following a '-' sign are converted to upper case.
    
    Parameters:
    
    name - The name of the parameter.
    
    Returns:
    
    The name of the method to set the value of this parameter.
  - initializeFactory
```
public void initializeFactory()
                       throws MappingException
```
    Initialize the concrete factory.
    
    Specified by:
    
    initializeFactory in interface ConnectionFactory
    
    Throws:
    
    MappingException - If concrete factory could not be initialized.
  - createConnection
```
public java.sql.Connection createConnection()
                                     throws java.sql.SQLException
```
    Creates a new JDBC Connection instance.
    
    Specified by:
    
    createConnection in interface ConnectionFactory
    
    Returns:
    
    A JDBC Connection.
    
    Throws:
    
    java.sql.SQLException - If the JDBC connection cannot be created.

Class DataSourceConnectionFactory

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

DataSourceConnectionFactory

DataSourceConnectionFactory

Method Detail

loadDataSource

setParameters

buildMethodName

initializeFactory

createConnection