Add the FetchGroups to the set of active fetch groups. FetchGroups are made unmodifiable before being added. FetchGroups that match existing FetchGroups replace the corresponding FetchGroups. The replaced FetchGroups become unscoped. Match is based on identical class and equal name. The methods addFetchGroups, removeFetchGroups, getFetchGroups, and removeAllFetchGroups are internally serialized.

Add the parameter listener to the list of instance lifecycle event listeners set as the initial listeners for each PersistenceManager created by this PersistenceManagerFactory. The addInstanceLifecycleListener and removeInstanceLifecycleListener methods are considered to be configuration methods and can only be called when the PersistenceManagerFactory is configurable (before the first time getPersistenceManager is called).

The classes parameter identifies all of the classes of interest. If the classes parameter is specified as null, events for all persistent classes and interfaces will be sent to the listener.

The listener will be called for each event for which it implements the corresponding InstanceLifecycleListener interface.

Close this PersistenceManagerFactory. Check for JDOPermission("closePersistenceManagerFactory") and if not authorized, throw SecurityException.

If the authorization check succeeds, check to see that all PersistenceManager instances obtained from this PersistenceManagerFactory have no active transactions. If any PersistenceManager instances have an active transaction, throw a JDOUserException, with one nested JDOUserException for each PersistenceManager with an active Transaction.

If there are no active transactions, then close all PersistenceManager instances obtained from this PersistenceManagerFactory, mark this PersistenceManagerFactory as closed, disallow getPersistenceManager methods, and allow all other get methods. If a set method or getPersistenceManager method is called after close, then JDOUserException is thrown.

Get the driver name for the data store connection.

Get the data store connection factory.

Get the second data store connection factory. This is needed for managed environments to get nontransactional connections for optimistic transactions.

Get the name for the second data store connection factory. This is needed for managed environments to get nontransactional connections for optimistic transactions.

Get the name for the data store connection factory.

Get the URL for the data store connection.

Get the user name for the data store connection.

Gets the default copyOnAttach setting for all PersistenceManager instances obtained from this factory.

Return the DataStoreCache that this factory uses for controlling a second-level cache. If this factory does not use a second-level cache, the returned instance does nothing. This method never returns null.

Gets the detachAllOnCommit setting.

Create an unscoped, modifiable FetchGroup for the Class and name. If a corresponding FetchGroup already exists in PersistenceManagerFactory scope, copy its definition to a new FetchGroup. If the FetchGroup does not already exist, create it with no members. The FetchGroup does not become in scope until it is added to the current set via addFetchGroups.

Get a modifiable Set containing a mutable copy of all currently active (in scope) fetch groups. The methods addFetchGroups, removeFetchGroups, getFetchGroups, and removeAllFetchGroups are internally serialized.

Get the default IgnoreCache setting for all PersistenceManager instances obtained from this factory.

Get the Mapping setting for this factory. This is used to find the object-datastore mapping file(s).

Get the default Multithreaded setting for all PersistenceManager instances obtained from this factory.

Gets the name of this PersistenceManagerFactory.

Get the default NontransactionalRead setting for all PersistenceManager instances obtained from this factory.

Get the default NontransactionalWrite setting for all PersistenceManager instances obtained from this factory.

Get the default Optimistic setting for all PersistenceManager instances obtained from this factory.

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.

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.

Get a thread-safe instance of a proxy that dynamically binds on each method call to an instance of PersistenceManager.

When used with a PersistenceManagerFactory that uses TransactionType JTA, the proxy can be used in a server to dynamically bind to an instance from this factory associated with the thread's current transaction. In this case, the close method is ignored, as the PersistenceManager is automatically closed when the transaction completes.

When used with a PersistenceManagerFactory that uses TransactionType RESOURCE_LOCAL, the proxy uses an inheritable ThreadLocal to bind to an instance of PersistenceManager associated with the thread. In this case, the close method executed on the proxy closes the PersistenceManager and then clears the ThreadLocal. Use of this method does not affect the configurability of the PersistenceManagerFactory.

Gets the PersistenceUnitName for this PersistenceManagerFactory.

Return non-configurable properties of this PersistenceManagerFactory. Properties with keys VendorName and VersionNumber are required. Other keys are optional.

Gets the value for read-only for this PMF. Indicates whether the datastore is read-only or writable.

Get the default value for the RestoreValues property.

Get the default RetainValues setting for all PersistenceManager instances obtained from this factory.

Gets the TimeZone ID of the server associated with this PersistenceManagerFactory. If not set, assume that the server has the same TimeZone ID as the client.

Get the value for transaction isolation level for this PMF.

Gets the TransactionType for this PersistenceManagerFactory.

A PersistenceManagerFactory instance can be used until it is closed.

Remove all FetchGroups from the set of active FetchGroups. All removed FetchGroups become unscoped. The methods addFetchGroups, removeFetchGroups, getFetchGroups, and removeAllFetchGroups are internally serialized.

Remove the FetchGroups from the set of active FetchGroups. Existing FetchGroups that match parameter FetchGroups are removed. Parameter FetchGroups that do not match any existing FetchGroup are ignored. Removed FetchGroups become unscoped. Match is based on identical class and equal name. The methods addFetchGroups, removeFetchGroups, getFetchGroups, and removeAllFetchGroups are internally serialized.

Remove the parameter listener instance from the list of instance lifecycle event listeners set as the initial listeners for each PersistenceManager created by this PersistenceManagerFactory. The addInstanceLifecycleListener and removeInstanceLifecycleListener methods are considered to be configuration methods and can only be called when the PersistenceManagerFactory is configurable (before the first time getPersistenceManager is called).

Set the driver name for the data store connection.

Set the data store connection factory. JDO implementations will support specific connection factories. The connection factory interfaces are not part of the JDO specification.

Set the second data store connection factory. This is needed for managed environments to get nontransactional connections for optimistic transactions. JDO implementations will support specific connection factories. The connection factory interfaces are not part of the JDO specification.

Set the name for the second data store connection factory. This is needed for managed environments to get nontransactional connections for optimistic transactions.

Set the name for the data store connection factory.

Set the password for the data store connection.

Set the URL for the data store connection.

Set the user name for the data store connection.

Sets the default copyOnAttach setting for all PersistenceManager instances obtained from this factory.

CopyOnAttach set to true specifies that during makePersistent, copies are made of detached parameter instances. With this flag set to false, detached parameter instances are attached directly and change their state from detached-clean to persistent-clean or from detached-dirty to persistent-dirty.

Sets the default detachAllOnCommit setting for all PersistenceManager instances obtained from this factory.

Set the default IgnoreCache setting for all PersistenceManager instances obtained from this factory.

Set the Mapping setting for this factory. This is used to find the object-datastore mapping file(s).

Set the default Multithreaded setting for all PersistenceManager instances obtained from this factory.

Sets the name of this PersistenceManagerFactory.

Set the default NontransactionalRead setting for all PersistenceManager instances obtained from this factory.

Set the default NontransactionalWrite setting for all PersistenceManager instances obtained from this factory.

Set the default Optimistic setting for all PersistenceManager instances obtained from this factory.

Sets the PersistenceUnitName for this PersistenceManagerFactory. This has the same semantics as the same-named property in JSR-220 PersistenceUnitInfo.

Sets the value for whether the datastore is to be considered read-only.

ReadOnly set to false specifies that no updates can be performed to the datastore, and if updates are attempted a JDOReadOnlyException is thrown.

Set the default value for the RestoreValues property. If true, at rollback, fields of newly persistent instances are restored to their values as of the beginning of the transaction, and the instances revert to transient. Additionally, fields of modified instances of primitive types and immutable reference types are restored to their values as of the beginning of the transaction.

If false, at rollback, the values of fields of newly persistent instances are unchanged and the instances revert to transient. Additionally, dirty instances transition to hollow. If an implementation does not support this option, a JDOUnsupportedOptionException is thrown.

Set the default RetainValues setting for all PersistenceManager instances obtained from this factory.

Sets the TimeZone ID of the server associated with this PersistenceManagerFactory. The parameter is a String suitable for use with TimeZone.getTimeZone(). The String must match an ID returned by TimeZone.getAvailableIDs(). If the ServerTimeZoneID is not set, or set to the null String, assume that the server has the same TimeZone ID as the client. If incorrectly set, the result of PersistenceManager.getServerDate() might be incorrect.

Set the value for transaction isolation level for this PMF. Transaction isolation levels are defined in javax.jdo.Constants. If the requested level is not available, but a higher level is available, the higher level is silently used. If the requested level is not available, and no higher level is available, then JDOUnsupportedOptionException is thrown. Standard values in order from low to high are:

• read-uncommitted
• read-committed
• repeatable-read
• snapshot
• serializable

Sets the TransactionType for this PersistenceManagerFactory. Permitted values are "JTA" and "RESOURCE_LOCAL". This has the same semantics as the same-named property in JSR-220 EntityManagerFactory.

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 feature is represented by a String with one of the following values:

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.NonDurableIdentity
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.option.ChangeApplicationIdentity
javax.jdo.option.BinaryCompatibility
javax.jdo.option.GetDataStoreConnection
javax.jdo.option.UnconstrainedQueryVariables
javax.jdo.option.TransactionIsolationLevel.read-uncommitted
javax.jdo.option.TransactionIsolationLevel.read-committed
javax.jdo.option.TransactionIsolationLevel.repeatable-read
javax.jdo.option.TransactionIsolationLevel.snapshot
javax.jdo.option.TransactionIsolationLevel.serializable
javax.jdo.query.SQL
javax.jdo.query.JDOQL

The standard JDO query language is represented by a String:

javax.jdo.query.JDOQL