org.castor.jdo.util

Class JDOConfFactory

java.lang.Object

org.castor.jdo.util.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));

Since:

0.9.9.1

Version:

$Revision: 6001 $ $Date: 2005-11-19 10:17:16 -0700 (Sat, 19 Nov 2005) $

Author:

Martin Fuchs, Ralf Joachim

Method Summary

Modifier and Type	Method and Description
static Database	createDatabase(java.lang.String name, java.lang.String engine, DataSource ds, Mapping mapping) Create a database configuration with given name, engine and datasource configuration.
static Database	createDatabase(java.lang.String name, java.lang.String engine, DataSource ds, Mapping[] mappings) Create a database configuration with given name, engine and datasource configuration.
static Database	createDatabase(java.lang.String name, java.lang.String engine, Driver driver, Mapping mapping) Create a database configuration with given name, engine and driver configuration.
static Database	createDatabase(java.lang.String name, java.lang.String engine, Driver driver, Mapping[] mappings) Create a database configuration with given name, engine and driver configuration.
static DataSource	createDataSource(java.lang.String datasource, java.util.Properties props) Create a JDO datasource configuration from a JDBC DataSource instance and apply the supplied property entries.
static Driver	createDriver(java.lang.String driver, java.lang.String connect, java.lang.String user, java.lang.String password) Create a JDO driver configuration from JDBC connection parameters.
static JdoConf	createJdoConf(Database database) Create a JDO configuration with local transaction demarcation and given database.
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 JdoConf	createJdoConf(Database database, TransactionDemarcation tx) Create a JDO configuration with given database and transaction demarcation.
static JdoConf	createJdoConf(org.xml.sax.InputSource source, org.xml.sax.EntityResolver resolver, java.lang.ClassLoader loader) Creates a JdoConf instance from a SAX InputSource, using a Castor XML Unmarshaller.
static Mapping	createMapping(java.lang.String mapping) Create a JDO mapping configuration from given URL.
static TransactionDemarcation	createTransactionDemarcation() Create a transaction demarcation configuration with local transaction handling.

Methods inherited from class java.lang.Object

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

Method Detail

createJdoConf

public static JdoConf createJdoConf(org.xml.sax.InputSource source,
                                    org.xml.sax.EntityResolver resolver,
                                    java.lang.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.

Throws:

MappingException

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[] 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 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,
                                    TransactionDemarcation tx)

Create a JDO configuration with given databases and transaction demarcation.

Parameters:

databases - Array of database configurations

tx - TransactionDemarcation configuration

Returns:

JDO configuration

createDatabase

public static Database createDatabase(java.lang.String name,
                                      java.lang.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(java.lang.String name,
                                      java.lang.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(java.lang.String name,
                                      java.lang.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(java.lang.String name,
                                      java.lang.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(java.lang.String driver,
                                  java.lang.String connect,
                                  java.lang.String user,
                                  java.lang.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

createDataSource

public static DataSource createDataSource(java.lang.String datasource,
                                          java.util.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

createMapping

public static Mapping createMapping(java.lang.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