com.solarmetric.kodo.impl.jdbc
Class JDBCPersistenceManagerFactory

java.lang.Object
  |
  +--com.solarmetric.kodo.runtime.PersistenceManagerFactoryImpl
        |
        +--com.solarmetric.kodo.impl.jdbc.JDBCPersistenceManagerFactory

All Implemented Interfaces:

PersistenceManagerFactory, Serializable

Direct Known Subclasses:

EEPersistenceManagerFactory

public class JDBCPersistenceManagerFactory

extends PersistenceManagerFactoryImpl

PersistenceManagerFactory type for use with the JDBC runtime.

Author:

Abe White, Marc Prud'hommeaux

See Also:

Serialized Form

Constructor Summary

JDBCPersistenceManagerFactory()
Default constructor.

JDBCPersistenceManagerFactory(InputStream propertyStream)
Create a factory that will access the data store with a Properties instantiated from the specified InputStream.

JDBCPersistenceManagerFactory(JDBCConfiguration conf)
Construct the factory with the given option settings.

JDBCPersistenceManagerFactory(Properties props)
Create a factory that will access the data store with the specified Properties.

JDBCPersistenceManagerFactory(String dbName)
Construct the factory with the given XML prefs key.

Method Summary

void	close() API extension.
static Object	createConnectionFactory(JDBCConfiguration conf)
static PersistenceManagerFactory	getPersistenceManagerFactory(Properties props) Factory method for constructing a PersistenceManagerFactory from properties.
String	getVersionInformation() Return a string describing this factory version, such as "JDBC Enterprise".
void	loadPersistentTypes(ClassLoader loader) Reload the persistent types list associated with this factory.
protected Object	newConnectionFactory() Instantiate a connection factory from the current configuration.
StoreManager	newStoreManager() Return a new StoreManager for this runtime.
protected void	removeUnsupportedOptions(Collection options) Remove the options not supported by this runtime from the given collection.
void	setLogWriter(PrintWriter out)
protected void	setup() Setup transient state used by this factory based on the current configuration, which will subsequenty be locked down.

Methods inherited from class com.solarmetric.kodo.runtime.PersistenceManagerFactoryImpl

configurePersistenceManager, findPersistenceManager, freeze, getConfiguration, getConnectionDriverName, getConnectionFactory, getConnectionFactory2, getConnectionFactory2Name, getConnectionFactoryName, getConnectionPassword, getConnectionURL, getConnectionUserName, getIgnoreCache, getLogWriter, getMaxPool, getMinPool, getMsWait, getMultithreaded, getNontransactionalRead, getNontransactionalWrite, getOptimistic, getPersistenceManager, getPersistenceManager, getProperties, getRestoreValues, getRetainValues, lock, newPersistenceManager, readObject, setConnectionDriverName, setConnectionFactory, setConnectionFactory2, setConnectionFactory2Name, setConnectionFactoryName, setConnectionPassword, setConnectionURL, setConnectionUserName, setIgnoreCache, setMaxPool, setMinPool, setMsWait, setMultithreaded, setNontransactionalRead, setNontransactionalWrite, setOptimistic, setRestoreValues, setRetainValues, supportedOptions, unlock

Methods inherited from class java.lang.Object

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

Constructor Detail

JDBCPersistenceManagerFactory

public JDBCPersistenceManagerFactory()

Default constructor.

JDBCPersistenceManagerFactory

public JDBCPersistenceManagerFactory(String dbName)

Construct the factory with the given XML prefs key.

JDBCPersistenceManagerFactory

public JDBCPersistenceManagerFactory(JDBCConfiguration conf)

Construct the factory with the given option settings.

JDBCPersistenceManagerFactory

public JDBCPersistenceManagerFactory(Properties props)
                              throws IOException

Create a factory that will access the data store with the specified Properties.

JDBCPersistenceManagerFactory

public JDBCPersistenceManagerFactory(InputStream propertyStream)
                              throws IOException

Create a factory that will access the data store with a Properties instantiated from the specified InputStream.

Method Detail

getPersistenceManagerFactory

public static PersistenceManagerFactory getPersistenceManagerFactory(Properties props)

Factory method for constructing a PersistenceManagerFactory from properties. Invoked from JDOHelper#getPersistenceManagerFactory.

loadPersistentTypes

public void loadPersistentTypes(ClassLoader loader)

Reload the persistent types list associated with this factory.

setLogWriter

public void setLogWriter(PrintWriter out)

Overrides:

setLogWriter in class PersistenceManagerFactoryImpl

getVersionInformation

public String getVersionInformation()

Description copied from class: PersistenceManagerFactoryImpl

Return a string describing this factory version, such as "JDBC Enterprise".

Overrides:

getVersionInformation in class PersistenceManagerFactoryImpl

newStoreManager

public StoreManager newStoreManager()

Description copied from class: PersistenceManagerFactoryImpl

Return a new StoreManager for this runtime. Note that the instance returned here may be wrapped before being passed to the PersistenceManagerFactoryImpl.newPersistenceManager(java.lang.String, java.lang.String, com.solarmetric.kodo.runtime.StoreManager) method. However, the PersistenceManagerImpl.getStoreManager() method will return the original native store manager.

Overrides:

newStoreManager in class PersistenceManagerFactoryImpl

newConnectionFactory

protected Object newConnectionFactory()

Description copied from class: PersistenceManagerFactoryImpl

Instantiate a connection factory from the current configuration. This method returns null by default.

Overrides:

newConnectionFactory in class PersistenceManagerFactoryImpl

createConnectionFactory

public static Object createConnectionFactory(JDBCConfiguration conf)

setup

protected void setup()

Description copied from class: PersistenceManagerFactoryImpl

Setup transient state used by this factory based on the current configuration, which will subsequenty be locked down. This method will be called before the first PersistenceManager is requested, and will be re-called each time the factory is deserialized into a JVM that has no configuration for this data store.

Overrides:

setup in class PersistenceManagerFactoryImpl

removeUnsupportedOptions

protected void removeUnsupportedOptions(Collection options)

Description copied from class: PersistenceManagerFactoryImpl

Remove the options not supported by this runtime from the given collection. The Collection will initially consist of the following options:

• javax.jdo.option.TransientTransactional
• javax.jdo.option.NontransactionalRead
• javax.jdo.option.NontransactionalWrite
• javax.jdo.option.RetainValues
• javax.jdo.option.RestoreValues
• javax.jdo.option.Optimistic
• javax.jdo.option.ApplicationIdentity
• javax.jdo.option.DatastoreIdentity
• javax.jdo.option.ArrayList
• javax.jdo.option.HashMap
• javax.jdo.option.Hashtable
• javax.jdo.option.LinkedList
• javax.jdo.option.TreeMap
• javax.jdo.option.TreeSet
• javax.jdo.option.Vector
• javax.jdo.option.Map
• javax.jdo.option.List
• javax.jdo.option.Array
• javax.jdo.option.NullCollection
• javax.jdo.query.JDOQL

Overrides:

removeUnsupportedOptions in class PersistenceManagerFactoryImpl

close

public void close()

Description copied from class: PersistenceManagerFactoryImpl

API extension. Closes the PersistenceManagerFactory, freeing any resources needed by this factory. After this method is invoked, the factory and associated PersistenceManagers should no longer be used.

Overrides:

close in class PersistenceManagerFactoryImpl