JDOConfFactory (Castor JavaDoc)

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 String mappingConf = 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), null);

Since:

0.9.9.1

Version:

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

Author:

Martin Fuchs, Ralf Joachim

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	Description
`static ClassMapping`	`createClassMapping(java.lang.String classname)`	Create an class mapping configurations for JDO from given class name.
`static Database`	`createDatabase(java.lang.String name, java.lang.String engine, DataSource ds)`	Create a database configuration with given name, engine and datasource configuration.
`static Database`	`createDatabase(java.lang.String name, java.lang.String engine, DataSource ds, java.lang.String mapping)`	Deprecated. create database w/o mapping.
`static Database`	`createDatabase(java.lang.String name, java.lang.String engine, DataSource ds, java.lang.String[] mappings)`	Deprecated. create database w/o mappings.
`static Database`	`createDatabase(java.lang.String name, java.lang.String engine, Driver driver)`	Create a database configuration with given name, engine and driver configuration.
`static Database`	`createDatabase(java.lang.String name, java.lang.String engine, Driver driver, java.lang.String mapping)`	Deprecated. create database w/o mapping.
`static Database`	`createDatabase(java.lang.String name, java.lang.String engine, Driver driver, java.lang.String[] mappings)`	Deprecated. create database w/o mappings.
`static Database`	`createDatabase(java.lang.String name, java.lang.String engine, Jndi jndi)`	Create a database configuration with given name, engine and JNDI configuration.
`static Database`	`createDatabase(java.lang.String name, java.lang.String engine, Jndi jndi, java.lang.String mapping)`	Deprecated. create database w/o mapping.
`static Database`	`createDatabase(java.lang.String name, java.lang.String engine, Jndi jndi, java.lang.String[] mappings)`	Deprecated. create database w/o mappings.
`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 TransactionDemarcation`	`createGlobalTransactionDemarcation(java.lang.String name, java.util.Properties props)`	Create a transaction demarcation configuration with global transaction handling for transaction manager with given name using given properties.
`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 Jndi`	`createJNDI(java.lang.String name)`	Create a JDO jndi configuration with the given name.
`static TransactionDemarcation`	`createLocalTransactionDemarcation()`	Create a transaction demarcation configuration with local transaction handling.
`static PackageMapping`	`createPackageMapping(java.lang.String packagename)`	Create an package mapping configurations for JDO from given package name.
`static Mapping`	`createXmlMapping(java.lang.String mapping)`	Create an XML mapping configurations for JDO from given URL.

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 - If failed to load the mconfiguration from source.
  - 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,
                                      java.lang.String mapping)
```
    Deprecated.
    create database w/o 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 URL.
    
    Returns:
    
    Database configuration.
  - createDatabase
```
public static Database createDatabase(java.lang.String name,
                                      java.lang.String engine,
                                      DataSource ds,
                                      java.lang.String[] mappings)
```
    Deprecated.
    create database w/o 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 URL's.
    
    Returns:
    
    Database configuration.
  - createDatabase
```
public static Database createDatabase(java.lang.String name,
                                      java.lang.String engine,
                                      DataSource ds)
```
    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.
    
    Returns:
    
    Database configuration.
    
    Since:
    
    1.3.2
  - createDatabase
```
public static Database createDatabase(java.lang.String name,
                                      java.lang.String engine,
                                      Driver driver,
                                      java.lang.String mapping)
```
    Deprecated.
    create database w/o 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 URL.
    
    Returns:
    
    Database configuration.
  - createDatabase
```
public static Database createDatabase(java.lang.String name,
                                      java.lang.String engine,
                                      Driver driver,
                                      java.lang.String[] mappings)
```
    Deprecated.
    create database w/o 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 URL's.
    
    Returns:
    
    Database configuration.
  - createDatabase
```
public static Database createDatabase(java.lang.String name,
                                      java.lang.String engine,
                                      Driver driver)
```
    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.
    
    Returns:
    
    Database configuration.
    
    Since:
    
    1.3.2
  - createDatabase
```
public static Database createDatabase(java.lang.String name,
                                      java.lang.String engine,
                                      Jndi jndi,
                                      java.lang.String mapping)
```
    Deprecated.
    create database w/o mapping.
    
    Create a database configuration with given name, engine and JNDI configuration.
    
    Parameters:
    
    name - Name of the database configuration.
    
    engine - Name of the database engine.
    
    jndi - JNDI configuration.
    
    mapping - Mapping URL.
    
    Returns:
    
    Database configuration.
  - createDatabase
```
public static Database createDatabase(java.lang.String name,
                                      java.lang.String engine,
                                      Jndi jndi,
                                      java.lang.String[] mappings)
```
    Deprecated.
    create database w/o mappings.
    
    Create a database configuration with given name, engine and JNDI configuration.
    
    Parameters:
    
    name - Name of the database configuration.
    
    engine - Name of the database engine.
    
    jndi - JNDI configuration.
    
    mappings - Array of mapping URL's.
    
    Returns:
    
    Database configuration.
  - createDatabase
```
public static Database createDatabase(java.lang.String name,
                                      java.lang.String engine,
                                      Jndi jndi)
```
    Create a database configuration with given name, engine and JNDI configuration.
    
    Parameters:
    
    name - Name of the database configuration.
    
    engine - Name of the database engine.
    
    jndi - JNDI configuration.
    
    Returns:
    
    Database configuration.
    
    Since:
    
    1.3.2
  - 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.
  - createJNDI
```
public static Jndi createJNDI(java.lang.String name)
```
    Create a JDO jndi configuration with the given name.
    
    Parameters:
    
    name - Name to lookup JDBC Datasource through JNDI.
    
    Returns:
    
    JDO JNDI configuration.
  - createXmlMapping
```
public static Mapping createXmlMapping(java.lang.String mapping)
```
    Create an XML mapping configurations for JDO from given URL.
    
    Parameters:
    
    mapping - URL to retrieve mapping configuration file.
    
    Returns:
    
    XML mapping configuration for JDO.
  - createClassMapping
```
public static ClassMapping createClassMapping(java.lang.String classname)
```
    Create an class mapping configurations for JDO from given class name.
    
    Parameters:
    
    classname - Class name to retrieve mapping information.
    
    Returns:
    
    Class mapping configuration for JDO.
  - createPackageMapping
```
public static PackageMapping createPackageMapping(java.lang.String packagename)
```
    Create an package mapping configurations for JDO from given package name.
    
    Parameters:
    
    packagename - Package name to retrieve mapping information.
    
    Returns:
    
    Package mapping configuration for JDO.
  - createLocalTransactionDemarcation
```
public static TransactionDemarcation createLocalTransactionDemarcation()
```
    Create a transaction demarcation configuration with local transaction handling.
    
    Returns:
    
    TransactionDemarcation configuration with local transaction handling.
  - createGlobalTransactionDemarcation
```
public static TransactionDemarcation createGlobalTransactionDemarcation(java.lang.String name,
                                                                        java.util.Properties props)
```
    Create a transaction demarcation configuration with global transaction handling for transaction manager with given name using given properties.
    
    Parameters:
    
    name - Name of the transaction manager.
    
    props - Properties to be used for the transaction manager.
    
    Returns:
    
    TransactionDemarcation configuration with global transaction handling.

Class JDOConfFactory

Method Summary

Methods inherited from class java.lang.Object

Method Detail

createJdoConf

createJdoConf

createJdoConf

createJdoConf

createJdoConf

createDatabase

createDatabase

createDatabase

createDatabase

createDatabase

createDatabase

createDatabase

createDatabase

createDatabase

createDriver

createDataSource

createJNDI

createXmlMapping

createClassMapping

createPackageMapping

createLocalTransactionDemarcation

createGlobalTransactionDemarcation