com.triactive.jdo
Class PersistenceManagerFactoryImpl

java.lang.Object
  extended bycom.triactive.jdo.PersistenceManagerFactoryImpl
All Implemented Interfaces:
javax.jdo.PersistenceManagerFactory, PersistenceManagerFactory, SchemaManagementOptions, java.io.Serializable

public class PersistenceManagerFactoryImpl
extends java.lang.Object
implements PersistenceManagerFactory

A factory used to obtain PersistenceManager instances.

Author:
Mike Martin
See Also:
Serialized Form

Constructor Summary
PersistenceManagerFactoryImpl()
          Constructs a new PersistenceManagerFactoryImpl.
PersistenceManagerFactoryImpl(java.util.Properties props)
          Constructs a new PersistenceManagerFactoryImpl using a set of properties.
 
Method Summary
 void close()
           
 boolean equals(java.lang.Object obj)
           
 boolean getAutoCreateTables()
          Returns whether or not to automatically create any missing database objects (tables, constraints, indexes, etc.).
 java.lang.String getConnectionDriverName()
          Get the driver name for the data store connection.
 java.lang.Object getConnectionFactory()
          Get the data store connection factory.
 java.lang.Object getConnectionFactory2()
          Get the second data store connection factory.
 java.lang.String getConnectionFactory2Name()
          Get the name for the second data store connection factory.
 java.lang.String getConnectionFactoryName()
          Get the name for the data store connection factory.
 java.lang.String getConnectionURL()
          Get the URL for the data store connection.
 java.lang.String getConnectionUserName()
          Get the user name for the data store connection.
 int getFetchSize()
          The default JDBC fetch size for all PersistenceManagers obtained from this factory.
 boolean getForceConnectionInit()
          The ForceConnectionInit setting for all PersistenceManagers obtained from this factory.
 boolean getIgnoreCache()
          Get the default IgnoreCache setting for all PersistenceManager instances obtained from this factory.
 java.lang.String getJdbcTrace()
          The JDBC trace options for all PersistenceManagers obtained from this factory.
 int getMaxPool()
          Get the MaxPool setting for the PersistenceManager pool for this factory.
 int getMinPool()
          Get the MinPool setting for the PersistenceManager pool for this factory.
 int getMsWait()
          Get the MsWait setting for the PersistenceManager pool for this factory.
 boolean getMultithreaded()
          Get the default Multithreaded setting for all PersistenceManager instances obtained from this factory.
 javax.sql.DataSource getNontransactionalDataSource()
          Returns the data source to be used for non-transactional access.
 boolean getNontransactionalRead()
          Get the default NontransactionalRead setting for all PersistenceManager instances obtained from this factory.
 boolean getNontransactionalWrite()
          Get the default NontransactionalWrite setting for all PersistenceManager instances obtained from this factory.
 boolean getOptimistic()
          Get the default Optimistic setting for all PersistenceManager instances obtained from this factory.
 javax.jdo.PersistenceManager getPersistenceManager()
          Get an instance of PersistenceManager from this factory.
 javax.jdo.PersistenceManager getPersistenceManager(java.lang.String userName, java.lang.String password)
          Get an instance of PersistenceManager from this factory.
static javax.jdo.PersistenceManagerFactory getPersistenceManagerFactory(java.util.Properties props)
          Return a new PersistenceManagerFactoryImpl with options set according to the given Properties.
 java.util.Properties getProperties()
          Return non-configurable properties of this PersistenceManagerFactory.
 boolean getRestoreValues()
          Get the default RestoreValues setting for all PersistenceManager instances obtained from this factory.
 int getResultSetType()
          The default result set type for all PersistenceManagers obtained from this factory.
 boolean getRetainValues()
          Get the default RetainValues setting for all PersistenceManager instances obtained from this factory.
 javax.sql.DataSource getTransactionalDataSource()
          Returns the data source to be used for transactional access.
 int getTransactionIsolation()
          The default transaction isolation level for all PersistenceManagers obtained from this factory.
 boolean getValidateConstraints()
          Returns whether or not to automatically validate the existence of all appropriate foreign key constraints and indexes.
 boolean getValidateTables()
          Returns whether or not to automatically validate the structure of all database tables to ensure they're compatible with the Java classes.
 int hashCode()
           
 void setAutoCreateTables(boolean flag)
          Sets whether or not to automatically create any missing database objects (tables, constraints, indexes, etc.).
 void setConnectionDriverName(java.lang.String driverName)
          Set the driver name for the data store connection.
 void setConnectionFactory(java.lang.Object connectionFactory)
          Set the data store connection factory.
 void setConnectionFactory2(java.lang.Object connectionFactory2)
          Set the second data store connection factory.
 void setConnectionFactory2Name(java.lang.String connectionFactory2Name)
          Set the name for the second data store connection factory.
 void setConnectionFactoryName(java.lang.String connectionFactoryName)
          Set the name for the data store connection factory.
 void setConnectionPassword(java.lang.String password)
          Set the password for the data store connection.
 void setConnectionURL(java.lang.String databaseUrl)
          Set the URL for the data store connection.
 void setConnectionUserName(java.lang.String userName)
          Set the user name for the data store connection.
 void setFetchSize(int fetchSize)
          The default JDBC fetch size for all PersistenceManagers obtained from this factory.
 void setForceConnectionInit(boolean flag)
          The ForceConnectionInit setting for all PersistenceManagers obtained from this factory.
 void setIgnoreCache(boolean flag)
          Set the default IgnoreCache setting for all PersistenceManager instances obtained from this factory.
 void setJdbcTrace(java.lang.String jdbcTrace)
          The JDBC trace options for all PersistenceManagers obtained from this factory.
 void setMaxPool(int maxPool)
          Set the MaxPool setting for the PersistenceManager pool for this factory.
 void setMinPool(int minPool)
          Set the MinPool setting for the PersistenceManager pool for this factory.
 void setMsWait(int msWait)
          Set the MsWait setting for the PersistenceManager pool for this factory.
 void setMultithreaded(boolean flag)
          Set the default Multithreaded setting for all PersistenceManager instances obtained from this factory.
 void setNontransactionalRead(boolean flag)
          Set the default NontransactionalRead setting for all PersistenceManager instances obtained from this factory.
 void setNontransactionalWrite(boolean flag)
          Set the default NontransactionalWrite setting for all PersistenceManager instances obtained from this factory.
 void setOptimistic(boolean flag)
          Set the default Optimistic setting for all PersistenceManager instances obtained from this factory.
 void setRestoreValues(boolean flag)
          Set the default RestoreValues setting for all PersistenceManager instances obtained from this factory.
 void setResultSetType(int resultSetType)
          The default result set type for all PersistenceManagers obtained from this factory.
 void setResultSetType(java.lang.String resultSetTypeName)
          The default result set type for all PersistenceManagers obtained from this factory.
 void setRetainValues(boolean flag)
          Set the default RetainValues setting for all PersistenceManager instances obtained from this factory.
 void setTransactionIsolation(int isolationLevel)
          The default transaction isolation level for all PersistenceManagers obtained from this factory.
 void setTransactionIsolation(java.lang.String isolationLevelName)
          The default transaction isolation level for all PersistenceManagers obtained from this factory.
 void setValidateConstraints(boolean flag)
          Sets whether or not to automatically validate the existence of all appropriate foreign key constraints and indexes.
 void setValidateTables(boolean flag)
          Sets whether or not to automatically validate the structure of all database tables to ensure they're compatible with the Java classes.
 java.util.Collection supportedOptions()
          The application can determine from the results of this method which optional features, and which query languages are supported by the JDO implementation.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PersistenceManagerFactoryImpl

public PersistenceManagerFactoryImpl()
Constructs a new PersistenceManagerFactoryImpl.


PersistenceManagerFactoryImpl

public PersistenceManagerFactoryImpl(java.util.Properties props)
Constructs a new PersistenceManagerFactoryImpl using a set of properties.

Parameters:
props - configuration properties for the new factory
Method Detail

getPersistenceManagerFactory

public static javax.jdo.PersistenceManagerFactory getPersistenceManagerFactory(java.util.Properties props)
Return a new PersistenceManagerFactoryImpl with options set according to the given Properties.

Parameters:
props - configuration properties for the new factory
Returns:
a new factory with options set according to the given properties
See Also:
JDOHelper.getPersistenceManagerFactory(java.util.Properties)

close

public void close()
Specified by:
close in interface javax.jdo.PersistenceManagerFactory

equals

public boolean equals(java.lang.Object obj)

hashCode

public int hashCode()

getTransactionalDataSource

public javax.sql.DataSource getTransactionalDataSource()
Returns the data source to be used for transactional access.

Returns:
The data source to be used for transactional access.

getNontransactionalDataSource

public javax.sql.DataSource getNontransactionalDataSource()
Returns the data source to be used for non-transactional access.

Returns:
The data source to be used for non-transactional access.

getPersistenceManager

public javax.jdo.PersistenceManager getPersistenceManager()
Get an instance of PersistenceManager from this factory. The instance has default values for options.

After the first use of getPersistenceManager, no "set" methods will succeed.

Specified by:
getPersistenceManager in interface javax.jdo.PersistenceManagerFactory
Returns:
a PersistenceManager instance with default options.

getPersistenceManager

public javax.jdo.PersistenceManager getPersistenceManager(java.lang.String userName,
                                                          java.lang.String password)
Get an instance of PersistenceManager from this factory. The instance has default values for options. The parameters userid and password are used when obtaining datastore connections from the connection pool.

After the first use of getPersistenceManager, no "set" methods will succeed.

Specified by:
getPersistenceManager in interface javax.jdo.PersistenceManagerFactory
Parameters:
userName - the user name for the connection
password - the password for the connection
Returns:
a PersistenceManager instance with default options.

getConnectionUserName

public java.lang.String getConnectionUserName()
Get the user name for the data store connection.

Specified by:
getConnectionUserName in interface javax.jdo.PersistenceManagerFactory
Returns:
the user name for the data store connection.

setConnectionUserName

public void setConnectionUserName(java.lang.String userName)
Set the user name for the data store connection.

Specified by:
setConnectionUserName in interface javax.jdo.PersistenceManagerFactory
Parameters:
userName - the user name for the data store connection.

setConnectionPassword

public void setConnectionPassword(java.lang.String password)
Set the password for the data store connection.

Specified by:
setConnectionPassword in interface javax.jdo.PersistenceManagerFactory
Parameters:
password - the password for the data store connection.

getConnectionURL

public java.lang.String getConnectionURL()
Get the URL for the data store connection.

Specified by:
getConnectionURL in interface javax.jdo.PersistenceManagerFactory
Returns:
the URL for the data store connection.

setConnectionURL

public void setConnectionURL(java.lang.String databaseUrl)
Set the URL for the data store connection.

Specified by:
setConnectionURL in interface javax.jdo.PersistenceManagerFactory
Parameters:
databaseUrl - the URL for the data store connection.

getConnectionDriverName

public java.lang.String getConnectionDriverName()
Get the driver name for the data store connection.

Specified by:
getConnectionDriverName in interface javax.jdo.PersistenceManagerFactory
Returns:
the driver name for the data store connection.

setConnectionDriverName

public void setConnectionDriverName(java.lang.String driverName)
Set the driver name for the data store connection.

Specified by:
setConnectionDriverName in interface javax.jdo.PersistenceManagerFactory
Parameters:
driverName - the driver name for the data store connection.

getConnectionFactoryName

public java.lang.String getConnectionFactoryName()
Get the name for the data store connection factory.

Specified by:
getConnectionFactoryName in interface javax.jdo.PersistenceManagerFactory
Returns:
the name of the data store connection factory.

setConnectionFactoryName

public void setConnectionFactoryName(java.lang.String connectionFactoryName)
Set the name for the data store connection factory.

Specified by:
setConnectionFactoryName in interface javax.jdo.PersistenceManagerFactory
Parameters:
connectionFactoryName - the name of the data store connection factory.

getConnectionFactory

public java.lang.Object getConnectionFactory()
Get the data store connection factory.

Specified by:
getConnectionFactory in interface javax.jdo.PersistenceManagerFactory
Returns:
the data store connection factory.

setConnectionFactory

public void setConnectionFactory(java.lang.Object connectionFactory)
Set the data store connection factory. JDO implementations will support specific connection factories. The connection factory interfaces are not part of the JDO specification.

Specified by:
setConnectionFactory in interface javax.jdo.PersistenceManagerFactory
Parameters:
connectionFactory - the data store connection factory.

getConnectionFactory2Name

public java.lang.String getConnectionFactory2Name()
Get the name for the second data store connection factory. This is needed for managed environments to get non-transactional connections for optimistic transactions.

Specified by:
getConnectionFactory2Name in interface javax.jdo.PersistenceManagerFactory
Returns:
the name of the data store connection factory.

setConnectionFactory2Name

public void setConnectionFactory2Name(java.lang.String connectionFactory2Name)
Set the name for the second data store connection factory. This is needed for managed environments to get non-transactional connections for optimistic transactions.

Specified by:
setConnectionFactory2Name in interface javax.jdo.PersistenceManagerFactory
Parameters:
connectionFactory2Name - the name of the data store connection factory.

getConnectionFactory2

public java.lang.Object getConnectionFactory2()
Get the second data store connection factory. This is needed for managed environments to get non-transactional connections for optimistic transactions.

Specified by:
getConnectionFactory2 in interface javax.jdo.PersistenceManagerFactory
Returns:
the data store connection factory.

setConnectionFactory2

public void setConnectionFactory2(java.lang.Object connectionFactory2)
Set the second data store connection factory. This is needed for managed environments to get non-transactional connections for optimistic transactions. JDO implementations will support specific connection factories. The connection factory interfaces are not part of the JDO specification.

Specified by:
setConnectionFactory2 in interface javax.jdo.PersistenceManagerFactory
Parameters:
connectionFactory2 - the data store connection factory.

getMultithreaded

public boolean getMultithreaded()
Get the default Multithreaded setting for all PersistenceManager instances obtained from this factory.

Specified by:
getMultithreaded in interface javax.jdo.PersistenceManagerFactory
Returns:
the default Multithreaded setting.

setMultithreaded

public void setMultithreaded(boolean flag)
Set the default Multithreaded setting for all PersistenceManager instances obtained from this factory.

Specified by:
setMultithreaded in interface javax.jdo.PersistenceManagerFactory
Parameters:
flag - the default Multithreaded setting.

getOptimistic

public boolean getOptimistic()
Get the default Optimistic setting for all PersistenceManager instances obtained from this factory.

Specified by:
getOptimistic in interface javax.jdo.PersistenceManagerFactory
Returns:
the default Optimistic setting.

setOptimistic

public void setOptimistic(boolean flag)
Set the default Optimistic setting for all PersistenceManager instances obtained from this factory.

Specified by:
setOptimistic in interface javax.jdo.PersistenceManagerFactory
Parameters:
flag - the default Optimistic setting.

getRetainValues

public boolean getRetainValues()
Get the default RetainValues setting for all PersistenceManager instances obtained from this factory.

Specified by:
getRetainValues in interface javax.jdo.PersistenceManagerFactory
Returns:
the default RetainValues setting.

setRetainValues

public void setRetainValues(boolean flag)
Set the default RetainValues setting for all PersistenceManager instances obtained from this factory.

Specified by:
setRetainValues in interface javax.jdo.PersistenceManagerFactory
Parameters:
flag - the default RetainValues setting.

getRestoreValues

public boolean getRestoreValues()
Get the default RestoreValues setting for all PersistenceManager instances obtained from this factory.

Specified by:
getRestoreValues in interface javax.jdo.PersistenceManagerFactory
Returns:
the default RestoreValues setting.

setRestoreValues

public void setRestoreValues(boolean flag)
Set the default RestoreValues setting for all PersistenceManager instances obtained from this factory.

Specified by:
setRestoreValues in interface javax.jdo.PersistenceManagerFactory
Parameters:
flag - the default RestoreValues setting.

getNontransactionalRead

public boolean getNontransactionalRead()
Get the default NontransactionalRead setting for all PersistenceManager instances obtained from this factory.

Specified by:
getNontransactionalRead in interface javax.jdo.PersistenceManagerFactory
Returns:
the default NontransactionalRead setting.

setNontransactionalRead

public void setNontransactionalRead(boolean flag)
Set the default NontransactionalRead setting for all PersistenceManager instances obtained from this factory.

Specified by:
setNontransactionalRead in interface javax.jdo.PersistenceManagerFactory
Parameters:
flag - the default NontransactionalRead setting.

getNontransactionalWrite

public boolean getNontransactionalWrite()
Get the default NontransactionalWrite setting for all PersistenceManager instances obtained from this factory.

Specified by:
getNontransactionalWrite in interface javax.jdo.PersistenceManagerFactory
Returns:
the default NontransactionalWrite setting.

setNontransactionalWrite

public void setNontransactionalWrite(boolean flag)
Set the default NontransactionalWrite setting for all PersistenceManager instances obtained from this factory.

Specified by:
setNontransactionalWrite in interface javax.jdo.PersistenceManagerFactory
Parameters:
flag - the default NontransactionalWrite setting.

getIgnoreCache

public boolean getIgnoreCache()
Get the default IgnoreCache setting for all PersistenceManager instances obtained from this factory.

Specified by:
getIgnoreCache in interface javax.jdo.PersistenceManagerFactory
Returns:
the default IngoreCache setting.

setIgnoreCache

public void setIgnoreCache(boolean flag)
Set the default IgnoreCache setting for all PersistenceManager instances obtained from this factory.

Specified by:
setIgnoreCache in interface javax.jdo.PersistenceManagerFactory
Parameters:
flag - the default IgnoreCache setting.

getMaxPool

public int getMaxPool()
Get the MaxPool setting for the PersistenceManager pool for this factory.

Returns:
the MaxPool setting.

setMaxPool

public void setMaxPool(int maxPool)
Set the MaxPool setting for the PersistenceManager pool for this factory.

Parameters:
maxPool - the MaxPool setting.

getMinPool

public int getMinPool()
Get the MinPool setting for the PersistenceManager pool for this factory.

Returns:
the MinPool setting.

setMinPool

public void setMinPool(int minPool)
Set the MinPool setting for the PersistenceManager pool for this factory.

Parameters:
minPool - the MinPool setting.

getMsWait

public int getMsWait()
Get the MsWait setting for the PersistenceManager pool for this factory.

Returns:
the MsWait setting.

setMsWait

public void setMsWait(int msWait)
Set the MsWait setting for the PersistenceManager pool for this factory.

Parameters:
msWait - the MsWait setting.

getValidateTables

public boolean getValidateTables()
Description copied from interface: SchemaManagementOptions
Returns whether or not to automatically validate the structure of all database tables to ensure they're compatible with the Java classes.

Specified by:
getValidateTables in interface SchemaManagementOptions
Returns:
true if tables should be validated.

setValidateTables

public void setValidateTables(boolean flag)
Description copied from interface: SchemaManagementOptions
Sets whether or not to automatically validate the structure of all database tables to ensure they're compatible with the Java classes.

Specified by:
setValidateTables in interface SchemaManagementOptions
Parameters:
flag - true if tables should be validated.

getValidateConstraints

public boolean getValidateConstraints()
Description copied from interface: SchemaManagementOptions
Returns whether or not to automatically validate the existence of all appropriate foreign key constraints and indexes.

Specified by:
getValidateConstraints in interface SchemaManagementOptions
Returns:
true if constraints should be validated.

setValidateConstraints

public void setValidateConstraints(boolean flag)
Description copied from interface: SchemaManagementOptions
Sets whether or not to automatically validate the existence of all appropriate foreign key constraints and indexes.

Specified by:
setValidateConstraints in interface SchemaManagementOptions
Parameters:
flag - true if constraints should be validated.

getAutoCreateTables

public boolean getAutoCreateTables()
Description copied from interface: SchemaManagementOptions
Returns whether or not to automatically create any missing database objects (tables, constraints, indexes, etc.). Only applicable if either table and/or constraint validation is enabled.

Specified by:
getAutoCreateTables in interface SchemaManagementOptions
Returns:
true if missing objects should be auto-created.

setAutoCreateTables

public void setAutoCreateTables(boolean flag)
Description copied from interface: SchemaManagementOptions
Sets whether or not to automatically create any missing database objects (tables, constraints, indexes, etc.). Only applicable if either table and/or constraint validation is enabled.

Specified by:
setAutoCreateTables in interface SchemaManagementOptions
Parameters:
flag - true if missing objects should be auto-created.

getTransactionIsolation

public int getTransactionIsolation()
Description copied from interface: PersistenceManagerFactory
The default transaction isolation level for all PersistenceManagers obtained from this factory.

Specified by:
getTransactionIsolation in interface PersistenceManagerFactory
Returns:
the default transaction isolation level.

setTransactionIsolation

public void setTransactionIsolation(java.lang.String isolationLevelName)
Description copied from interface: PersistenceManagerFactory
The default transaction isolation level for all PersistenceManagers obtained from this factory.

Specified by:
setTransactionIsolation in interface PersistenceManagerFactory
Parameters:
isolationLevelName - One of the values "read uncommitted", "read committed", "repeatable read", or "serializable". The name is case-insensitive, and spaces and underscores are equivalent.

setTransactionIsolation

public void setTransactionIsolation(int isolationLevel)
Description copied from interface: PersistenceManagerFactory
The default transaction isolation level for all PersistenceManagers obtained from this factory.

Specified by:
setTransactionIsolation in interface PersistenceManagerFactory
Parameters:
isolationLevel - the default transaction isolation level.

getResultSetType

public int getResultSetType()
Description copied from interface: PersistenceManagerFactory
The default result set type for all PersistenceManagers obtained from this factory.

Specified by:
getResultSetType in interface PersistenceManagerFactory
Returns:
the default transaction isolation level.

setResultSetType

public void setResultSetType(java.lang.String resultSetTypeName)
Description copied from interface: PersistenceManagerFactory
The default result set type for all PersistenceManagers obtained from this factory.

Specified by:
setResultSetType in interface PersistenceManagerFactory
Parameters:
resultSetTypeName - One of the values "forward only", "scroll insensitive", or "scroll sensitive". The name is case-insensitive, and spaces and underscores are equivalent.

setResultSetType

public void setResultSetType(int resultSetType)
Description copied from interface: PersistenceManagerFactory
The default result set type for all PersistenceManagers obtained from this factory.

Specified by:
setResultSetType in interface PersistenceManagerFactory
Parameters:
resultSetType - the default result set type.

getFetchSize

public int getFetchSize()
Description copied from interface: PersistenceManagerFactory
The default JDBC fetch size for all PersistenceManagers obtained from this factory.

Specified by:
getFetchSize in interface PersistenceManagerFactory
Returns:
the default fetch size.

setFetchSize

public void setFetchSize(int fetchSize)
Description copied from interface: PersistenceManagerFactory
The default JDBC fetch size for all PersistenceManagers obtained from this factory.

Specified by:
setFetchSize in interface PersistenceManagerFactory
Parameters:
fetchSize - The default fetch size. Zero indicates no specific size.

getForceConnectionInit

public boolean getForceConnectionInit()
Description copied from interface: PersistenceManagerFactory
The ForceConnectionInit setting for all PersistenceManagers obtained from this factory. If enabled, setAutoCommit() and setTransactionIsolationLevel() are called for every connection before use. Otherwise, they're called only if the requested setting differs from the connection's default setting.

Specified by:
getForceConnectionInit in interface PersistenceManagerFactory
Returns:
the ForceConnectionInit setting.

setForceConnectionInit

public void setForceConnectionInit(boolean flag)
Description copied from interface: PersistenceManagerFactory
The ForceConnectionInit setting for all PersistenceManagers obtained from this factory. If enabled, setAutoCommit() and setTransactionIsolationLevel() are called for every connection before use. Otherwise, they're called only if the requested setting differs from the connection's default setting.

Specified by:
setForceConnectionInit in interface PersistenceManagerFactory
Parameters:
flag - the ForceConnectionInit setting.

getJdbcTrace

public java.lang.String getJdbcTrace()
Description copied from interface: PersistenceManagerFactory
The JDBC trace options for all PersistenceManagers obtained from this factory.

Specified by:
getJdbcTrace in interface PersistenceManagerFactory
Returns:
A comma-separated list of trace option keywords, or null if tracing is disabled.
See Also:
PersistenceManagerFactory.setJdbcTrace(java.lang.String)

setJdbcTrace

public void setJdbcTrace(java.lang.String jdbcTrace)
Description copied from interface: PersistenceManagerFactory
The JDBC trace options for all PersistenceManagers obtained from this factory.

Each trace option is enabled by including its keyword.

Option keyword Description
LogExecutionTimes Logs every executed SQL statement and its execution time in milliseconds
LogExecutionFailures Logs every SQL statement whose execution throws a SQLException
LogWarnings Logs every SQLWarning produced by a Connection, Statement, or ResultSet
When tracing is enabled low-overhead wrappers are placed around certain JDBC objects to perform the tracing. The wrappers are only used when tracing so zero overhead is imposed if tracing is disabled.

Specified by:
setJdbcTrace in interface PersistenceManagerFactory
Parameters:
jdbcTrace - A comma-separated list of trace option keywords, or null to disable tracing entirely.
See Also:
InitializedConnectionFactory.setTraceOptions(java.lang.String)

getProperties

public java.util.Properties getProperties()
Return non-configurable properties of this PersistenceManagerFactory. Properties with keys VendorName and VersionNumber are required. Other keys are optional.

Specified by:
getProperties in interface javax.jdo.PersistenceManagerFactory
Returns:
the non-configurable properties of this PersistenceManagerFactory.

supportedOptions

public java.util.Collection supportedOptions()
The application can determine from the results of this method which optional features, and which query languages are supported by the JDO implementation.

Each supported JDO optional feature is represented by a String with one of the following values. Features supported by TJDO are shown in bold.

javax.jdo.option.TransientTransactional javax.jdo.option.NontransactionalRead javax.jdo.option.NontransactionalWrite javax.jdo.option.RetainValues javax.jdo.option.Optimistic javax.jdo.option.ApplicationIdentity javax.jdo.option.DatastoreIdentity javax.jdo.option.NonDatastoreIdentity 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

In addition, TJDO's direct SQL query language is represented by a String:

javax.jdo.query.TJDOQL

Specified by:
supportedOptions in interface javax.jdo.PersistenceManagerFactory
Returns:
A Collection of String representing the supported options.


Copyright 2001-2007 The TJDO Project All Rights Reserved.