com.dpslink.base.jdbc

Class JDBCFactory

java.lang.Object

com.dpslink.base.jdbc.JDBCFactory

All Implemented Interfaces:

java.io.Serializable

public class JDBCFactory
extends java.lang.Object
implements java.io.Serializable

A factory for JDBC objects and JDBC object controllers.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private static long	serialVersionUID The class' serialization version id.

Constructor Summary

Constructors

Constructor and Description
JDBCFactory()

Method Summary

Modifier and Type	Method and Description
static <DBOBJCTLR extends JDBCObjectController<? extends JDBCObject<?>>> DBOBJCTLR	getController(java.lang.Class<DBOBJCTLR> ctlrcls) Returns the JDBC object controller for the given controller class.
static <DBOBJ extends JDBCObject<?>> DBOBJ	getObject(java.lang.Class<DBOBJ> objcls) Returns the JDBC object for the given object class.

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

The class' serialization version id.

See Also:

Constant Field Values

Constructor Detail

JDBCFactory

public JDBCFactory()

Method Detail

getController

public static <DBOBJCTLR extends JDBCObjectController<? extends JDBCObject<?>>> DBOBJCTLR getController(java.lang.Class<DBOBJCTLR> ctlrcls)

Returns the JDBC object controller for the given controller class. Allows for properties to be defined that indicate which class actually gets created for the class that is passed to the method.

Example:
dbctl.MyController.class=com.dpslink.somepackage.YourController
If MyController.class is passed to this method, the class actually created would be YourController. If no matching property exists for MyController.class, then MyController would be created.

CLASSES THAT HAVE ACCESS TO A SERVLET CONTEXT SHOULD LIKELY NOT INVOKE THIS METHOD BUT SHOULD INSTEAD INVOKE A METHOD CONTAINED WITHIN THE CONTEXT.

CLASSES THAT OBTAIN THEIR OWN DB CONNECTION OR USE AN EXISTING DB CONNECTION SHOULD NOT INVOKE THIS METHOD BUT SHOULD INSTEAD INVOKE THE getController() METHOD CONTAINED WITHIN THE JDBCConnectionInfo OBJECT. IF THE CLASS ALSO HAS ACCESS TO A SERVLET CONTEXT THEN USING THE CONTEXT AS DESCRIBED ABOVE IS PREFERRED.

Parameters:

ctlrcls - (Class) The class for the desired controller.

Returns:

JDBCObjectController - The JDBC object controller or null if unable to create the requested controller. If no controller class is defined in properties, the controller for the supplied class created.

getObject

public static <DBOBJ extends JDBCObject<?>> DBOBJ getObject(java.lang.Class<DBOBJ> objcls)

Returns the JDBC object for the given object class. Allows for properties to be defined that indicate which class actually gets created for the class that is passed to the method.

Example:
dbobj.MyObject.class=com.dpslink.somepackage.YourObject
If MyObject.class is passed to this method, the class actually created would be YourObject. If no matching property exists for MyObject.class, then MyObject would be created.

CLASSES THAT HAVE ACCESS TO A SERVLET CONTEXT SHOULD LIKELY NOT INVOKE THIS METHOD BUT SHOULD INSTEAD INVOKE A METHOD CONTAINED WITHIN THE CONTEXT.

CLASSES THAT OBTAIN THEIR OWN DB CONNECTION OR USE AN EXISTING DB CONNECTION SHOULD NOT INVOKE THIS METHOD BUT SHOULD INSTEAD INVOKE THE getObject() METHOD CONTAINED WITHIN THE JDBCConnectionInfo OBJECT. IF THE CLASS ALSO HAS ACCESS TO A SERVLET CONTEXT THEN USING THE CONTEXT AS DESCRIBED ABOVE IS PREFERRED.

Parameters:

objcls - (Class) The class for the desired object.

Returns:

JDBCObject - The JDBC object or null if unable to create the requested object. If no object class is defined in properties, the object for the supplied class is created.