org.castor.jdo.util

Class JDOConfFactory


public final class JDOConfFactory
extends java.lang.Object

Factory to create JDO configurations without the need of a database configuration XML file.

This is an example for setting up a JDO configuration using JDOConfFactory: // create driver configuration org.castor.jdo.conf.Driver driverConf = JDOConfFactory.createDriver(DRIVER, CONNECT, USERNAME, PASSWORD); // create mapping configuration org.castor.jdo.conf.Mapping mappingConf = JDOConfFactory.createMapping(getClass().getResource(MAPPING).toString()); // create database configuration org.castor.jdo.conf.Database dbConf = JDOConfFactory.createDatabase(DATABASE, ENGINE, driverConf, mappingConf); // create and load jdo configuration JDOManager.loadConfiguration(JDOConfFactory.createJdoConf(dbConf));

Version:
$Revision: 6001 $ $Date: 2005-11-19 10:17:16 -0700 (Sat, 19 Nov 2005) $
Authors:
Martin Fuchs
Ralf Joachim
Since:
0.9.9.1

Method Summary

static DataSource
createDataSource(String datasource, Properties props)
Create a JDO datasource configuration from a JDBC DataSource instance and apply the supplied property entries.
static Database
createDatabase(String name, String engine, DataSource ds, Mapping mapping)
Create a database configuration with given name, engine and datasource configuration.
static Database
createDatabase(String name, String engine, DataSource ds, Mapping[] mappings)
Create a database configuration with given name, engine and datasource configuration.
static Database
createDatabase(String name, String engine, Driver driver, Mapping mapping)
Create a database configuration with given name, engine and driver configuration.
static Database
createDatabase(String name, String engine, Driver driver, Mapping[] mappings)
Create a database configuration with given name, engine and driver configuration.
static Driver
createDriver(String driver, String connect, String user, String password)
Create a JDO driver configuration from JDBC connection parameters.
static JdoConf
createJdoConf(InputSource source, EntityResolver resolver, ClassLoader loader)
Creates a JdoConf instance from a SAX InputSource, using a Castor XML Unmarshaller.
static JdoConf
createJdoConf(Database database)
Create a JDO configuration with local transaction demarcation and given database.
static JdoConf
createJdoConf(Database database, TransactionDemarcation tx)
Create a JDO configuration with given database and transaction demarcation.
static JdoConf
createJdoConf(Database[] databases)
Create a JDO configuration with local transaction demarcation and given databases.
static JdoConf
createJdoConf(Database[] databases, TransactionDemarcation tx)
Create a JDO configuration with given databases and transaction demarcation.
static Mapping
createMapping(String mapping)
Create a JDO mapping configuration from given URL.
static TransactionDemarcation
createTransactionDemarcation()
Create a transaction demarcation configuration with local transaction handling.

Method Details

createDataSource

public static DataSource createDataSource(String datasource,
                                          Properties props)
Create a JDO datasource configuration from a JDBC DataSource instance and apply the supplied property entries.
Parameters:
datasource - JDBC DataSource class name
props - Properties to be used for the DataSource
Returns:
JDO Datasource configuration

createDatabase

public static Database createDatabase(String name,
                                      String engine,
                                      DataSource ds,
                                      Mapping mapping)
Create a database configuration with given name, engine and datasource configuration.
Parameters:
name - Name of the database configuration
engine - Name of the database engine
ds - Datasource configuration
mapping - Mapping configurations
Returns:
Database configuration

createDatabase

public static Database createDatabase(String name,
                                      String engine,
                                      DataSource ds,
                                      Mapping[] mappings)
Create a database configuration with given name, engine and datasource configuration.
Parameters:
name - Name of the database configuration
engine - Name of the database engine
ds - Datasource configuration
mappings - Array of mapping configurations
Returns:
Database configuration

createDatabase

public static Database createDatabase(String name,
                                      String engine,
                                      Driver driver,
                                      Mapping mapping)
Create a database configuration with given name, engine and driver configuration.
Parameters:
name - Name of the database configuration
engine - Name of the database engine
driver - Driver configuration
mapping - Mapping configurations
Returns:
Database configuration

createDatabase

public static Database createDatabase(String name,
                                      String engine,
                                      Driver driver,
                                      Mapping[] mappings)
Create a database configuration with given name, engine and driver configuration.
Parameters:
name - Name of the database configuration
engine - Name of the database engine
driver - Driver configuration
mappings - Array of mapping configurations
Returns:
Database configuration

createDriver

public static Driver createDriver(String driver,
                                  String connect,
                                  String user,
                                  String password)
Create a JDO driver configuration from JDBC connection parameters.
Parameters:
driver - JDBC driver name
connect - JDBC connect string
user - User name for the DB login
password - Password for the DB login
Returns:
JDO driver configuration

createJdoConf

public static JdoConf createJdoConf(InputSource source,
                                    EntityResolver resolver,
                                    ClassLoader loader)
            throws MappingException
Creates a JdoConf instance from a SAX InputSource, using a Castor XML Unmarshaller.
Parameters:
source - SAX input source representing the JDO configuration.
resolver - SAX entity resolver
loader - Class loader
Returns:
The unmarshalled JdoConf instance.

createJdoConf

public static JdoConf createJdoConf(Database database)
Create a JDO configuration with local transaction demarcation and given database.
Parameters:
database - Database configuration
Returns:
JDO configuration

createJdoConf

public static JdoConf createJdoConf(Database database,
                                    TransactionDemarcation tx)
Create a JDO configuration with given database and transaction demarcation.
Parameters:
database - Database configuration
tx - TransactionDemarcation configuration
Returns:
JDO configuration

createJdoConf

public static JdoConf createJdoConf(Database[] databases)
Create a JDO configuration with local transaction demarcation and given databases.
Parameters:
databases - Array of database configurations
Returns:
JDO configuration

createJdoConf

public static JdoConf createJdoConf(Database[] databases,
                                    TransactionDemarcation tx)
Create a JDO configuration with given databases and transaction demarcation.
Parameters:
databases - Array of database configurations
tx - TransactionDemarcation configuration
Returns:
JDO configuration

createMapping

public static Mapping createMapping(String mapping)
Create a JDO mapping configuration from given URL.
Parameters:
mapping - URL to retrieve mapping configuration file
Returns:
JDO Mapping configuration

createTransactionDemarcation

public static TransactionDemarcation createTransactionDemarcation()
Create a transaction demarcation configuration with local transaction handling.
Returns:
TransactionDemarcation configuration with local transaction handling

Intalio Inc. (C) 1999-2006. All rights reserved http://www.intalio.com