2.5. JDO Standard Properties

2.5.1. javax.jdo.PersistenceManagerFactoryClass
2.5.2. javax.jdo.option.ConnectionDriverName
2.5.3. javax.jdo.option.ConnectionFactoryName
2.5.4. javax.jdo.option.ConnectionFactory2Name
2.5.5. javax.jdo.option.ConnectionPassword
2.5.6. javax.jdo.option.ConnectionURL
2.5.7. javax.jdo.option.ConnectionUserName
2.5.8. javax.jdo.option.IgnoreCache
2.5.9. javax.jdo.option.Multithreaded
2.5.10. javax.jdo.option.NontransactionalRead
2.5.11. javax.jdo.option.NontransactionalWrite
2.5.12. javax.jdo.option.Optimistic
2.5.13. javax.jdo.option.RestoreValues
2.5.14. javax.jdo.option.RetainValues

JDO recognizes many standard runtime properties, all of which Kodo JDO supports (these properties are also covered in Section 7.2, “PersistenceManagerFactory Properties” of the JDO Overview).

2.5.1. javax.jdo.PersistenceManagerFactoryClass

Property name: javax.jdo.PersistenceManagerFactoryClass

Configuration API: kodo.conf.JDOConfiguration.getPersistenceManagerFactoryClass

Resource adaptor config-property: PersistenceManagerFactoryClass

Default: -

Description: The name of the concrete implementation of the javax.jdo.PersistenceManagerFactory that javax.jdo.JDOHelper.getPersistenceManagerFactory should create. For Kodo JDO, this should be kodo.jdbc.runtime.JDBCPersistenceManagerFactory or a custom extension of this type.

2.5.2. javax.jdo.option.ConnectionDriverName

Property name: javax.jdo.option.ConnectionDriverName

Configuration API: kodo.conf.JDOConfiguration.getConnectionDriverName

Resource adaptor config-property: ConnectionDriverName

Default: -

Description: The full class name of either the JDBC java.sql.Driver, or a javax.sql.DataSource implementation to use to connect to the database. See Chapter 4, JDBC for details.

2.5.3. javax.jdo.option.ConnectionFactoryName

Property name: javax.jdo.option.ConnectionFactoryName

Configuration API: kodo.conf.JDOConfiguration.getConnectionFactoryName

Resource adaptor config-property: ConnectionFactoryName

Default: -

Description: The JNDI location of a javax.sql.DataSource to use to connect to the database. See Chapter 4, JDBC for details.

2.5.4. javax.jdo.option.ConnectionFactory2Name

Property name: kodo.ConnectionFactory2Name

Configuration API: kodo.conf.JDOConfiguration.getConnectionFactory2Name

Resource adaptor config-property: ConnectionFactory2Name

Default: -

Description: The JNDI location of a non-XA javax.sql.DataSource to use to connect to the database. See Section 13.2, “XA Transactions” for details.

2.5.5. javax.jdo.option.ConnectionPassword

Property name: javax.jdo.option.ConnectionPassword

Configuration API: kodo.conf.JDOConfiguration.getConnectionPassword

Resource adaptor config-property: ConnectionPassword

Default: -

Description: The password for the user specified in the ConnectionUserName property. See Chapter 4, JDBC for details.

2.5.6. javax.jdo.option.ConnectionURL

Property name: javax.jdo.option.ConnectionURL

Configuration API: kodo.conf.JDOConfiguration.getConnectionURL

Resource adaptor config-property: ConnectionURL

Default: -

Description: The JDBC URL for the database. See Chapter 4, JDBC for details.

2.5.7. javax.jdo.option.ConnectionUserName

Property name: javax.jdo.option.ConnectionUserName

Configuration API: kodo.conf.JDOConfiguration.getConnectionUserName

Resource adaptor config-property: ConnectionUserName

Default: -

Description: The user name to use when connecting to the database. See the Chapter 4, JDBC for details.

2.5.8. javax.jdo.option.IgnoreCache

Property name: javax.jdo.option.IgnoreCache

Configuration API: kodo.conf.JDOConfiguration.getIgnoreCache

Resource adaptor config-property: IgnoreCache

Default: true

Description: Whether to consider modifications to persistent objects made in the current transaction when evaluating queries. See Section 7.2, “PersistenceManagerFactory Properties” of the JDO Overview for details.

2.5.9. javax.jdo.option.Multithreaded

Property name: javax.jdo.option.Multithreaded

Configuration API: kodo.conf.JDOConfiguration.getMultithreaded

Resource adaptor config-property: Multithreaded

Default: false

Description: Whether persistent instances and JDO components will be accessed by multiple threads at once. See Section 7.2, “PersistenceManagerFactory Properties” in the JDO Overview for details.

2.5.10. javax.jdo.option.NontransactionalRead

Property name: javax.jdo.option.NontransactionalRead

Configuration API: kodo.conf.JDOConfiguration.getNontransactionalRead

Resource adaptor config-property: NontransactionalRead

Default: true

Description: Whether the JDO runtime will allow you to read data outside of a transaction. See Section 7.2, “PersistenceManagerFactory Properties” in the JDO Overview for details.

2.5.11. javax.jdo.option.NontransactionalWrite

Property name: javax.jdo.option.NontransactionalWrite

Configuration API: kodo.conf.JDOConfiguration.getNontransactionalWrite

Resource adaptor config-property: NontransactionalWrite

Default: false

Description: Whether you can modify persistent fields outside of a transaction. See Section 7.2, “PersistenceManagerFactory Properties” in the JDO Overview for details.

2.5.12. javax.jdo.option.Optimistic

Property name: javax.jdo.option.Optimistic

Configuration API: kodo.conf.JDOConfiguration.getOptimistic

Resource adaptor config-property: Optimistic

Default: true

Description: Selects between optimistic and pessimistic (data store) transactional modes. See Section 7.2, “PersistenceManagerFactory Properties” in the JDO Overview for details.

2.5.13. javax.jdo.option.RestoreValues

Property name: javax.jdo.option.RestoreValues

Configuration API: kodo.conf.JDOConfiguration.getRestoreValues

Resource adaptor config-property: RestoreValues

Default: true

Description: Whether to restore managed fields to their pre-transaction values when a rollback occurs. See Section 7.2, “PersistenceManagerFactory Properties” in the JDO Overview for details.

2.5.14. javax.jdo.option.RetainValues

Property name: javax.jdo.option.RetainValues

Configuration API: kodo.conf.JDOConfiguration.getRetainValues

Resource adaptor config-property: RetainValues

Default: true

Description: Whether persistent fields retain their values on transaction commit. See Section 7.2, “PersistenceManagerFactory Properties” in the JDO Overview for details.