Skip Headers
Oracle® Fusion Middleware Programming Enterprise JavaBeans, Version 3.0, for Oracle WebLogic Server
11g Release 1 (10.3.6)

Part Number E13720-08
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
PDF · Mobi · ePub

B Persistence Configuration Schema Reference

The following sections describe the namespace, schema location, file structure, and elements in the Kodo-specific deployment descriptor, persistence-configuration.xml.

persistence-configuration.xml Namespace Declaration and Schema Location

The correct text for the namespace declaration and schema location for the Kodo persistence-configuration.xml file is as follows.

<persistence-configuration 
    xmlns="http://xmlns.oracle.com/weblogic/persistence-configuration" 
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://xmlns.oracle.com/weblogic/persistence-configuration 
    http://xmlns.oracle.com/weblogic/persistence-configuration/1.0/persistence-configuration.xsd">

...

</persistence-configuration>

persistence-configuration.xml Deployment Descriptor File Structure

The persistence-configuration.xml deployment descriptor file describes the elements that are unique to Oracle Kodo.

The top-level elements in the Kodo persistence-configuration.xml are as follows:

persistence-configuration.xml Deployment Descriptor Elements

The following list of the elements in persistence-configuration.xml includes all elements that are supported in this release of Kodo.

abstract-store-broker-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.kernel.BrokerFactory type to use, in this case abstract store. For more information, see "kodo.BrokerFactory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<abstract-store-broker-factory/>

access-dictionary

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Defines configuration values for the Access Dictionary. For a complete description of each of the values that you can specify, see "Access Dictionary Configuration" in the Oracle WebLogic Server Administration Console Help.

Example

The default values for each of the configuration values are shown in the example below.

<access-dictionary>
    <char-type-name>CHAR</char-type-name>
    <outer-join-clause>LEFT OUTER JOIN</outer-join-clause>
    <binary-type-name>BINARY</binary-type-name>
    <clob-type-name>CLOB</clob-type-name>
    <supports-locking-with-distinct-clause>true</supports-locking-with-distinct-clause>
    <simulate-locking>false</simulate-locking>
    <system-tables>true</system-tables>
    <concatenate-function>({0}||{1})</concatenate-function>
    <substring-function-name>SUBSTR</substring-function-name>
    <supports-query-timeout>true</supports-query-timeout>
    <use-set-bytes-for-blobs>true</use-set-bytes-for-blobs>
    <max-constraint-name-length>18</max-constraint-name-length>
    <search-string-escape>\\</search-string-escape>
    <supports-cascade-update-action>true</supports-cascade-update-action>
    <string-length-function>CHAR_LENGTH({0})</string-length-function>
    <long-varbinary-type-name>LONGVARBINARY</long-varbinary-type-name>
    <supports-unique-constraints>true</supports-unique-constraints>
    <supports-restrict-delete-action>true</supports-restrict-delete-action>
    <trim-leading-function>LTRIM(LEADING '{1}' from {0})</trim-leading-function>
    <supports-default-delete-action>false</supports-default-delete-action>
    <next-sequence-query></next-sequence-query>
    <long-varchar-type-name>LONGVARCHAR</long-varchar-type-name>
    <cross-join-clause>CROSS JOIN</cross-join-clause>
    <max-embedded-clob-size>-1</max-embedded-clob-size>
    <date-type-name>DATE</date-type-name>
    <supports-schema-for-get-tables>true</supports-schema-for-get-tables>
    <supports-alter-table-with-drop-column>true</supports-alter-table-with-drop-column>
    <current-time-function>CURRENT_TIME</current-time-function>
    <requires-condition-for-cross-join>false</requires-condition-for-cross-join>
    <ref-type-name>REF</ref-type-name>
    <concatenate-delimiter>'OPENJPATOKEN'</concatenate-delimiter>
    <catalog-separator>.</catalog-separator>
    <supports-mod-operator>false</supports-mod-operator>
    <schema-case>upper</schema-case>
    <java-object-type-name>JAVA_OBJECT</java-object-type-name>
    <driver-vendor></driver-vendor>
    <supports-locking-with-multiple-tables>true</supports-locking-with-multiple-tables>
    <max-column-name-length>128</max-column-name-length>
    <double-type-name>DOUBLE</double-type-name>
    <use-get-string-for-clobs>false</use-get-string-for-clobs>
    <decimal-type-name>DECIMAL</decimal-type-name>
    <smallint-type-name>SMALLINT</smallint-type-name>
    <date-precision>1000000</date-precision>
    <supports-alter-table-with-add-column>true</supports-alter-table-with-add-column>
    <bit-type-name>BIT</bit-type-name>
    <supports-null-table-for-get-columns>true</supports-null-table-for-get-columns>
    <to-upper-case-function>UPPER({0}))</to-upper-case-function>
    <supports-select-end-index>false</supprots-select-end-index>
    <supports-auto-assign>false</supports-auto-assign>
    <store-large-numbers-as-strings>false</store-large-numbers-as-strings>
    <constraint-name-mode>before</constraint-name-mode>
    <allows-alias-in-bulk-clause>true</allows-alias-in-bulk-clause>
    <supports-select-for-update>true</supports-select-for-update>
    <distinct-count-column-separator></distinct-count-column-separator>
    <supports-subselect>true</supports-subselect>
    <time-type-name>TIME</time-type-name>
    <auto-assign-type-name></auto-assign-type-name>
    <use-get-object-for-blobs>false</use-get-object-for-blobs>
    <max-auto-assign-name-length>31</max-auto-assign-name-length>
    <validation-sql></validation-sql>
    <struct-type-name>STRUCT</struct-type-name>
    <varchar-type-name>VARCHAR</varchar-type-name>
    <range-position>0</range-position>
    <supports-restrict-update-action>true</supports-restrict-update-action>
    <auto-assign-clause></auto-assign-clause>
    <supports-multiple-nontransactional-result-sets>true</supports-multiple-nontransactional-result-sets>
    <bit-length-function>(OCTET_LENGTH({0}) * 8)</bit-length-function>
    <create-primary-keys>true</create-primary-keys>
    <null-type-name>NULL</null-type-name>
    <float-type-name>FLOAT</float-type-name>
    <use-get-bytes-for-blobs>true</use-get-bytes-for-blobs>
    <table-types>TABLE</table-types>
    <numeric-type-name>NUMERIC</numeric-type-name>
    <table-for-update-clause></table-for-update-clause>
    <integer-type-name>INTEGER<integer-type-name>
    <blob-type-name>BLOB</blob-type-name>
    <for-update-clause>FOR UPDATE</for-update-clause>
    <boolean-type-name>BOOLEAN</boolean-type-name>
    <use-get-best-row-identifier-for-primary-keys>false</use-get-best-row-identifier-for-primary-keys>
    <supports-foreign-keys>true</supports-foreign-keys>
    <drop-table-sql>DROP TABLE {0}</drop-table-sql>
    <use-set-string-for-clobs>false</use-set-string-for-clobs>
    <supports-locking-with-order-clause>false</supports-locking-with-order-clause>
    <platform>Generic</platform>
    <fixed-size-type-names></fixed-size-type-names>
    <store-chars-as-numbers>true</store-chars-as-numbers>
    <max-indexes-per-table>2147483647</max-indexes-per-table>
    <requires-cast-for-comparisons>false</requires-cast-for-comparisons>
    <supports-having>true</supports-having>
    <supports-locking-with-outer-join>true</supports-locking-with-outer-join>
    <supports-correlated-subselect>true</supports-correlated-subselect>
    <supports-null-table-for-get-imported-keys>false</supports-null-table-for-get-imported-keys>
    <bigint-type-name>BIGINT</bigint-type-name>
    <last-generated-key-query></last-generated-key-query>
    <reserved-words></reserved-words>
    <supports-null-update-action>true</supports-null-update-action>
    <use-schema-name>true</use-schema-name>
    <supports-deferred-constraints>true</supports-deferred-constraints>
    <real-type-name>REAL</real-type-name>
    <requires-alias-for-subselect>false</requires-alias-for-subselect>
    <supports-null-table-for-get-index-info>false</supports-null-table-for-get-index-info>
    <trim-trailing-function>TRIM(TRAILING '{1}' FROM {0}))</trim-trailing-function>
    <supports-locking-with-select-range>true</supports-locking-with-select-range>
    <storage-limitations-fatal>false</storage-limitations-fatal>
    <supports-locking-with-inner-join>true</supports-locking-with-inner-join>
    <current-timestamp-function>CURRENT_TIMESTAMP</current-timestamp-funct    <cast-function>CAST({0} AS {1})</cast-function>
    <other-type-name>OTHER</other-type-name>
    <max-index-name-length>128</max-index-name-length>
    <distinct-type-name>DISTINCT</distinct-type-name>
    <character-column-size>255</character-column-size>
    <varbinary-type-name>VARBINARY</varbinary-type-name>
    <max-table-name-length>128</max-table-name-length>
    <close-pool-sql></close-pool-sql>
    <current-date-function>CURRENT_DATE</current-date-function>
    <join-syntax>sql92</join-syntax>
    <max-embedded-blob-size>-1</max-embedded-blob-size>
    <trim-both-function>TRIM(BOTH '{1}' FROM {0})</trim-both-function>
    <supports-select-start-index>false</supports-select-start-index>
    <to-lower-case-function>LOWER({0})</to-lower-case-function>
    <array-type-name>ARRAY</array-type-name>
    <inner-join-clause>INNER JOIN</inner-join-clause>
    <supports-default-update-action>true</supports-default-update-action>
    <supports-schema-for-get-columns>true</supports-schema-for-get-columns>
    <tinyint-type-name>TINYINT</tinyint-type-name>
    <supports-null-table-for-get-primary-keys>false</supports-null-table-for-get-primary-keys>
    <system-schemas></system-schemas>
    <requires-cast-for-math-functions>false</requires-cast-for-math-functions>
    <supports-null-delete-action>true</supports-null-delete-action>
    <requires-auto-commit-for-meta-data>false</requires-auto-commit-for-meta-data>
    <timestamp-type-name>TIMESTAMP</timestamp-type-name>
    <initialization-sql></initialization-sql>
    <supports-cascade-delete-action>true</supports-cascade-delete-action>
    <supports-timestamp-nanos>true</supports-timestamp-nanos>
</access-dictionary>

access-unloaded

Range of values: true | false

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit
    detach-options-all

persistence-configuration
  persistence-configuration-unit
    detach-options-fetch-groups

persistence-configuration
  persistence-configuration-unit
    detach-options-loaded

Function

Flag that specifies whether to allow access to unloaded fields of detached objects. Set to false to throw an exception whenever an unloaded field is accessed. This option is only available when you use detached state managers.

For more information about the detach state, see "Defining the Detached Object Graph" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<access-unloaded>true</access-unloaded>

action

Range of values: warn | exception

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    inverse-manager

Function

Controls the action taken when the inverse manager detects an inconsistent bidirectional relation. Valid options include:

  • warn—Log a warning.

  • exception—Throw an exception.

For more information, see "Managed Inverses" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<action>warn</action>

addresses

Range of values: Valid IP addresses

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a semicolon separated list of IP addresses to which notifications should be sent. For more information, see "TCP" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<addresses>[]</addresses>

advanced-sql

Range of values: String

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configures advanced SQL features. For more information, see "kodo.jdbc.SQLFactory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

aggregate-listeners

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a list of aggregate listeners to make available to all queries. Each listener must implement the org.apache.openjpa.kernel.exps.AggregateListener interface. For more information, see "kodo.AggregateListeners" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<aggregate-listeners>
    <custom-aggregate-listener>
        <classname>...</classname>
        <properties>...</properties>
    </custom-aggregate-listener>
</aggregate-listener>

allocate

Range of values: Integer

Default value: 50

Parent elements:

persistence-configuration
  persistence-configuration-unit
    class-table-jdbc-seq

persistence-configuration
  persistence-configuration-unit
    native-jdbc-seq

persistence-configuration
  persistence-configuration-unit
    table-jdbc-seq

persistence-configuration
  persistence-configuration-unit
    value-table-jdbc-seq

Function

Specifies the number of values to allocate on each database trip. Defaults to 50, meaning the class will set aside the next 50 numbers each time it accesses the sequence table. In this case, Kodo only accesses the database to get new sequence numbers once every 50 sequence number requests. For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<allocate>50</allocate>

assert-allowed-type

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Flag that specifies whether to immediately throw an exception if you attempt to add an element to a collection or map that is not assignable to the element type declared in metadata. For more information, see "Custom Proxies" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<assert-allowed-type>false</assert-allowed-type>

auto-clear

Range of values:

persistence-configuration-unit: datastore | all

kodo-broker: 0 | 1

Default value: datastore (0)

Parent elements:

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-broker

Function

Controls whether an object's field values are cleared when entering a transaction. Valid values include:

  • datastore (0)—Clear object field values when entering a datastore transaction. This is the default.

  • all (1)—Clear object field values when entering any transaction.

Example

<auto-clear>datastore</auto-clear>

auto-detach

Range of values:

auto-detaches: close | commit | nontx-read

kodo-broker: 0 | 1 | 2

Default value: close (0)

Parent elements:

persistence-configuration
  persistence-configuration-unit
    auto-detaches

persistence-configuration
  persistence-configuration-unit
    kodo-broker
      auto-detach

Function

Specifies the event on which the managed instances are automatically detached. When specified as a child of the auto-detaches element, valid event types include:

  • close (0)—Detach all objects when the PersistenceManager closes. This is the default.

  • commit (1)—Detach all objects when a transaction ends.

  • nontx-read (2)—Reads outside of a transactions will automatically detach instances before returning them.

For more information, see "Automatic Detachment" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<auto-detach>close</auto-detach>

auto-detaches

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a list of events on which the managed instances are automatically detached. Specifies one or more auto-detach elements. For more information, see "Automatic Detachment" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<auto-detaches>
    <auto-detach>close</auto-detach>
</auto-detaches>

base-name

Range of values: String

Default value: N/A

Parent elements:

profiling
  export-profiling

Function

Defines the basename of the exported data file to create. See "Dumping Profiling Data to Disk from a Batch Process" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<base-name>base</base-name>

batching-operation-order-update-manager

Range of values: N/A

Default value: N/A

Parent elements:

profiling

Function

Defines an update manager capable of statement batching, that ignores foreign keys and table-level locking, but optimizes based on the order in which the application has modified objects. For more information, see "kodo.jdbc.UpdateManager" and "Statement Batching" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<batching-operation-order-update-manager>
    <maximize-batch-size>true</maximize-batch-size>
</batching-operation-order-update-manager>

buffer-size

Range of values: Integer

Default value: 10

Parent elements:

persistence-configuration
  persistence-configuration-unit
    cluster-remote-commit-provider

Function

Specifies the buffer size of the remote commit provider. For more information, see "Remote Commit Provider Configuration" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<buffer-size>10</buffer-size>

cache-map

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Defines the cache map used to associate query strings and their parsed form. For more information, see "Query Compilation Cache" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<cache-map>
    <cache-size>1000</cache-size>
    <soft-reference-size>-1</soft-reference-size>
</cache-map>

cache-size

Range of values: Integer

Default value: 1000

Parent elements:

persistence-configuration
  persistence-configuration-unit
    kodo-concurrent-data-cache

persistence-configuration
  persistence-configuration-unit
    lru-data-cache

persistence-configuration
  persistence-configuration-unit
    kodo-query-cache

persistence-configuration
  persistence-configuration-unit
    lru-query-cache

Function

Set the data or query cache size. For more information, see "Configuring the Data Cache Size" and "Query Cache" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<cache-size>1000</cache-size>

channel

Range of values: String

Default value: openjpa.Runtime

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the channel to which you want to log. For more information, see "Orphaned Keys" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<channel>openjpa.Runtime</channel>

class-table-jdbc-seq

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.kernel.Seq interface to use to create your own custom generators, in this case kodo.jdbc.kernel.TableJDBCSeq.

The TableJDBCSeq uses a special single-row table to store a global sequence number. If the table does not already exist, it is created the first time you run the mapping tool on a class that requires it. You can also use the class' main method or the sequencetable shell/bat script to manipulate the table; see the TableJDBCSeq.main method Javadoc for usage details.

For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<class-table-jdbc-seq>
    <type>0</type>
    <allocate>50</allocate>
    <table-name>OPENJPA_SEQUENCES_TABLE</table-name>
    <ignore-virtual>false</ignore-virtual>
    <ignore-unmapped>false</ignore-unmapped>
    <table>OPENJPA_SEQUENCES_TABLE</table>
    <primary-key-column>ID</primary-key-column>
    <use-aliases>false</use-aliases>
    <sequence-column>SEQUENCE_VALUE</sequence-column>
    <increment>1</increment>
</class-table-jdbc-seq>

classname

Range of values: Valid classname

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
        aggregate-listener
            custom-aggregate-listener

persistence-configuration
  persistence-configuration-unit
    custom-broker-factory

persistence-configuration
  persistence-configuration-unit
    custom-broker-impl

persistence-configuration
  persistence-configuration-unit
    custom-class-resolver

persistence-configuration
  persistence-configuration-unit
    custom-compatibility

persistence-configuration
  persistence-configuration-unit
    custom-connection-decorator

persistence-configuration
  persistence-configuration-unit
    custom-data-cache

persistence-configuration
  persistence-configuration-unit
    custom-dictionary

Function

Name of the class associated with the custom feature.

classpath-scan

Range of values: true | false

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit
    deprecated-jdo-meta-data-factory

persistence-configuration
  persistence-configuration-unit
    extension-deprecated-jdo-mapping-factory

persistence-configuration
  persistence-configuration-unit
    jdo-meta-data-factory

persistence-configuration
  persistence-configuration-unit
    jdor-mapping-factory

persistence-configuration
  persistence-configuration-unit
    kodo-persistence-mapping-factory

persistence-configuration
  persistence-configuration-unit
   kodo-persistence-meta-data-factory

persistence-configuration
  persistence-configuration-unit
    mapping-file-deprecated-jdo-mapping-factory

persistence-configuration
  persistence-configuration-unit
    orm-file-jdor-mapping-factory

persistence-configuration
  persistence-configuration-unit
    table-deprecated-jdo-mapping-factory

Function

Specifies a semicolon-separated list of directories or jar archives listed in your classpath. Each directory and jar archive is scanned for annotated JP entities or JDO metadata files based on your metadata factory. For more information, see "Metadata Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<classpath-scan>build</classpath-scan>

clear-on-close

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    tangosol-data-cache

Function

Flag that specifies whether the Tangosol named cache should be completely cleared when the EntityManagerFactory or PersistenceManagerFactory is closed.

Example

<clear-on-close>false</clear-on-close>

client-broker-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

A plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.kernel.BrokerFactory type to use, in this case remote. For more information, see "kodo.BrokerFactory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<client-broker-factory/>

close-on-managed-commit

Range of values: true | false

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit
    compatibility

Function

Flag that specifies whether the JDO PersistenceManager closes after a managed transaction commits, assuming you have invoked the close method.

If set to false, then the PersistenceManager will not close. This means that objects passed to a processing tier in the same JVM will still be usable, as their owning PersistenceManager will still be open. This behavior is not in strict compliance with the JDO specification, but is convenient for applications that were coded against Kodo 2.x, which did not close the PersistenceManager in these situations.

For more information, see "Compatibility Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<close-on-managed-commit>false</close-on-managed-commit>

cluster-remote-commit-provider

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configures Kodo to share commit notifications among persistenceManagerFactories in a cluster. For more information, see "Remote Commit Provider Configuration" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<cluster-remote-commit-provider>
    <name>kodo.RemoteCommitProvider</name>
    <buffer-size>10</buffer-size>
    <recover-action>none</recover-action>
</cluster-remote-commit-provider>

commons-log-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the Apache Jakarta Commons Logging thin library for issuing log messages. The Commons Logging libraries act as a wrapper around a number of popular logging APIs, including the Jakarta Log4J project, and the native java.util.logging package in JDK 1.4. If neither of these libraries are available, then logging will fall back to using simple console logging.

For more information, see "Apache Commons Logging" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<commons-log-factory/>

compatibility

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configure backwards compatibility settings for certain runtime behaviors. For more information, see "Compatibility Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<compatibility>
    <copy-object-ids>false</copy-object-ids>
    <close-on-managed-commit>true</close-on-managed-commit> 
    <validate-true-checks-store>false</validate-true-checks-store>
    <validate-false-returns-hollow>true</validate-false-returns-hollow>
    <strict-identity-values>false</strict-identity-values>
    <quoted-numbers-in-queries>false</quoted-numbers-in-queries>
</compatibility>

concurrent-hash-map

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Defines the concurrent hash map used to associate query strings and their parsed form. For more information, see "Query Compilation Cache" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<concurrent-hash-map>
    <max-size>2147483647</max-size>
</concurrent-hash-map>

connection-decorators

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

A plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing org.apache.openjpa.lib.jdbc.ConnectionDecorator implementations to install on the connection factory. Specify one or more custom-connection-decorator elements.

These decorators can wrap connections passed from the underlying DataSource to add functionality. Kodo will pass all connections through the list of decorators before using them.

Note:

By default Kodo JPA/JDO employs all of the built-in decorators in the com.solarmetric.jdbc package already; you do not need to list them here.

For more information, see "kodo.jdbc.ConnectionDecorators" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<connection-decorators>
    <custom-connection-decorator> 
        <classname>...</classname> 
        <properties>...</properties> 
    </custom-connection-decorator>
</connection-decorators>

connection-driver-name

Range of values: Valid classname

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-pooling-data-source

persistence-configuration
  persistence-configuration-unit
    simple-driver-data-source

Function

Full class name of either the JDBC java.sql.Driver or a javax.sql.DataSource implementation to use to connect to the database. For more information, see "JDBC" in Kodo 4.2.0 Developers Guide for JPA/JDO.

The following provides sample values:

COM.FirstSQL.Dbcp.DbcpDriver
COM.cloudscape.core.JDBCDriver
COM.ibm.db2.jdbc.app.DB2Driver
COM.ibm.db2.jdbc.net.DB2Driver
centura.java.sqlbase.SqlbaseDriver
com.ddtek.jdbc.db2.DB2Driver
com.ddtek.jdbc.oracle.OracleDriver|
com.ddtek.jdbc.sqlserver.SQLServerDriver
com.ddtek.jdbc.sybase.SybaseDriver
com.ibm.as400.access.AS400JDBCDriver
com.imaginary.sql.msql.MsqlDriver
com.inet.tds.TdsDriver
com.informix.jdbc.IfxDriver
com.internetcds.jdbc.tds.Driver
com.jnetdirect.jsql.JSQLDriver
com.mckoi.JDBCDriver
com.microsoft.jdbc.sqlserver.SQLServerDriver
com.mysql.jdbc.DatabaseMetaData
com.mysql.jdbc.Driver
com.pointbase.jdbc.jdbcUniversalDriver
com.sap.dbtech.jdbc.DriverSapDB
com.sybase.jdbc.SybDriver
com.sybase.jdbc2.jdbc.SybDriver
com.thinweb.tds.Driver
in.co.daffodil.db.jdbc.DaffodilDBDriver
interbase.interclient.Driver
intersolv.jdbc.sequelink.SequeLinkDriver
openlink.jdbc2.Driver
oracle.jdbc.driver.OracleDriver
oracle.jdbc.pool.OracleDataSource
org.axiondb.jdbc.AxionDriver
org.enhydra.instantdb.jdbc.idbDriver
org.gjt.mm.mysql.Driver
org.hsql.jdbcDriver
org.hsqldb.jdbcDriver
org.postgresql.Driver
org.sourceforge.jxdbcon.JXDBConDriver|
postgres95.PGDriver
postgresql.Driver
solid.jdbc.SolidDriver
sun.jdbc.odbc.JdbcOdbcDriver
weblogic.jdbc.mssqlserver4.Driver
weblogic.jdbc.pool.Driver

Example

<connection-driver-name>oracle.jdbc.driver.OracleDriver</connection-driver-name>

connection-factory-mode

Range of values: local | managed

Default value: local

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

The connection factory mode to use when integrating with the application server's managed transactions. Valid options include:

  • local—Specifies a standard data source under Kodo control.

  • managed—Specifies a data source managed by an application server and automatically enlisted in global transactions.

For more information, see "Managed and XA DataSources" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<connection-factory-mode>local</connection-factory-mode>

connection-factory-name

Range of values: JNDI name

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

The JNDI location of a javax.sql.DataSource to use to connect to the database. For more information, see "JDBC" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<connection-factory-name>java:/OracleSource</connection-factory-name>

connection-factory-properties

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

A plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) listing properties for configuration of the javax.sql.DataSource, described at http://docs.oracle.com/javase/6/docs/api/javax/sql/DataSource.html, in use. For more information, see "JDBC" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<connection-factory-properties>
    <property>
        <name>QueryTimeout</name>
        <value>5000</value>
        <name>MaxIdle</name>
        <value>1</value>
    </property>
</connection-factory-properties>

connection-factory2-name

Range of values: JNDI name

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

The JNDI location of an unmanaged javax.sql.DataSource to use to connect to the database. For more information, see "XA Transactions" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<connection-factory2-name>java:/OracleXASource</connection-factory2-name>

connection-factory2-properties

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Properties used to configure the javax.sql.DataSource, described at http://docs.oracle.com/javase/6/docs/api/javax/sql/DataSource.html, used as the unmanaged ConnectionFactory. For more information, see "Managed and XA DataSources" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<connection-factory2-properties>
    <property>
        <name>MaxActive</name>
        <value>20</value>
        <name>MaxIdle</name>
        <value>1</value>
    </property>
</connection-factory2-properties>

connection-password

Range of values: Valid password

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Password for the user specified by connection-user-name. For more information, see "JDBC" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<connection-password>tiger</connection-password>

connection-properties

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

A plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) listing properties to configure the driver listed in the connection-driver-name element. If the given driver class is a DataSource, these properties will be used to configure the bean properties of the DataSource. For more information, see "JDBC" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<connection-properties>
    <property>
        <name>PortNumber</name>
        <value>1521</value>
    </property>
    <property>
        <name>ServerName</name>
        <value>saturn</value>
    </property>
    <property>
        <name>DatabaseName</name>
        <value>solarisid</value>
    </property>
    <property>
        <name>DriverType</name>
        <value>thin</value>
    </property>
</connection-properties>

connection-retain-mode

Range of values: always | on-demand | persistence-manager | transaction

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Controls how Kodo uses datastore connections. Valid values include:

  • always—Each EntityManager or PersistenceManager obtains a single connection and uses it until the EntityManager or PersistenceManager closes.

  • on-demand—Connection is obtained only when needed. This option is equivalent to the transaction option when datastore transactions are used. For optimistic transactions, though, it means that a connection will be retained only for the duration of the datastore flush and commit process.

  • persistence-manager—Connection is obtained from the persistence manager.

  • transaction—Connection is obtained when each transaction begins (optimistic or datastore), and is released when the transaction completes. Non-transactional connections are obtained on-demand.

For more information, see "Configuring the Use of JDBC Connections" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<connection-retain-mode>on-demand</connection-retain-mode>

connection-url

Range of values: Valid URL

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-pooling-data-source

persistence-configuration
  persistence-configuration-unit
    simple-driver-data-source

Function

The JDBC URL for the database. For more information, see "JDBC" in Kodo 4.2.0 Developers Guide for JPA/JDO.

The following provides possible values:

jdbc:JSQLConnect://<hostname>/database=<database>
jdbc:cloudscape:<database>;create=true
jdbc:daffodilDB_embedded:<database>;create=true
jdbc:datadirect:db2://<hostname>:50000;databaseName=<database>
jdbc:datadirect:oracle://<hostname>:1521;SID=<database>;MaxPooledStatements=0
jdbc:datadirect:sqlserver://<hostname>:1433;SelectMethod=cursor;DatabaseName=<database>
jdbc:datadirect:sybase://<hostname>:5000 
jdbc:db2://<hostname>/<database>
jdbc:dbaw://<hostname>:8889/<database>
jdbc:hsqldb:<database>
jdbc:idb:<database>.properties
jdbc:inetdae:<hostname>:1433
jdbc:informix-sqli://<hostname>:1526/<database>:INFORMIXSERVER=<database>
jdbc:interbase://<hostname>//<database>.gdb
jdbc:microsoft:sqlserver://<hostname>:1433;DatabaseName=<database>;SelectMethod=cursor
jdbc:mysql://<hostname>/<database>?autoReconnect=true
jdbc:odbc:<database>
jdbc:openlink://<hostname>/DSN=SQLServerDB/UID=sa/PWD=
jdbc:oracle:thin:@<hostname>:1521:<database>
jdbc:postgresql://<hostname>:5432/<database>
jdbc:postgresql:net//<hostname>/<database>
jdbc:sequelink://<hostname>:4003/[Oracle]
jdbc:sequelink://<hostname>:4004/[Informix];Database=<database>
jdbc:sequelink://<hostname>:4005/[Sybase];Database=<database>
jdbc:sequelink://<hostname>:4006/[SQLServer];Database=<database>
jdbc:sequelink://<hostname>:4011/[ODBC MS Access];Database=<database>
jdbc:solid://<hostname>:<port>/<UID>/<PWD>
jdbc:sybase:Tds:<hostname>:4100/<database>?ServiceName=<database>
jdbc:twtds:sqlserver://<hostname>/<database>
jdbc:weblogic:mssqlserver4:<database>@<hostname>:1433

Example

<connection-url>
jdbc:oracle:thin:@<hostname>:1521:<database>
</connection-url>

connection-user-name

Range of values: Valid username

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-pooling-data-source

persistence-configuration
  persistence-configuration-unit
    simple-driver-data-source

Function

Username to use when connecting to the data source specified by connection-url. For more information, see "JDBC" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<connection-user-name>scott</connection-user-name>

connection2-driver-name

Range of values: Valid username

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Full class name of either the JDBC java.sql.Driver or a javax.sql.DataSource implementation to use to connect to the unmanaged database. For more information, see "Managed and XA DataSources" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<connection2-driver-name>oracle.jdbc.driver.OracleDriver</connection2-driver-name>

connection2-password

Range of values: Valid password

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Password for the unmanaged data source specified by connection2-url.

Example

<connection2-password>tiger</connection2-password>

connection2-properties

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Properties for the unmanaged data source specified by connection2-driver-name For more information, see "Managed and XA DataSources" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<connection2-properties>
    <property>
        <name>PortNumber</name>
        <value>1521</value>
    </property>
    <property>
        <name>ServerName</name>
        <value>saturn</value>
    </property>
    <property>
        <name>DatabaseName</name>
        <value>solarisid</value>
    </property>
    <property>
        <name>DriverType</name>
        <value>thin</value>
    </property>
</connection2-properties>

connection2-url

Range of values: Valid URL

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

The JDBC URL for the unmanaged datasource. For more information, see "Managed and XA DataSources" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<connection2-url>jdbc:oracle:thin:@CROM:1521:KodoDB</connection2-url>

connection2-user-name

Range of values: Valid username

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Username to use when connecting to the data source specified by connection2-driver-name.

Example

<connection2-user-name>scott</connection2-user-name>

constraint-names

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    table-jdor-mapping-factory

Function

Flag that specifies whether to include the names of foreign key and unique constraints in all generated mappings. For more information, see "Mapping Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<constraint-names>false</constraint-names>

constraint-update-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Defines the standard update manager, capable of statement batching and foreign key constraint evaluation. For more information, see "kodo.jdbc.UpdateManager" and "Statement Batching" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<constraint-update-manager>
    <maximize-batch-size>true</maximize-batch-size>
</constraint-update-manager>

copy-object-ids

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    compatibility

Function

Flag that specifies whether to copy oid objects before returning them to you. Kodo versions prior to 3.0 always copied oid objects before returning them to you. This prevents possible errors resulting from you mutating the oid object by reference, but was not very efficient for the majority of users who do not modify oid instances. Thus Kodo 3.0 and higher does not copy oids by default. Set this property to true to force Kodo to copy the oids.

For more information, see "Compatibility Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<copy-object-ids>false</copy-object-ids>

custom-aggregate-listener

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    aggregate-listeners

Function

Defines a custom aggregate listener. Each listener must implement the org.apache.openjpa.kernel.exps.AggregateListener interface. For more information, see "kodo.AggregateListeners" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<aggregate-listeners>
    <custom-aggregate-listener>
        <classname>...</classname>
        <properties>...</properties>
    </custom-aggregate-listener>
</aggregate-listener>

custom-broker-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to specify a custom broker factory. For more information, see "kodo.BrokerFactory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-broker-factory>
    <classname>...</classname>
    <properties>...</properties>
</custom-broker-factory>

custom-broker-impl

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define a custom broker implementation. For more information, see "kodo.BrokerImpl" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-broker-impl>
    <classname>...</classname>
    <properties>...</properties>
</custom-broker-impl> 

custom-class-resolver

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define a custom class resolver for class name resolution. For more information, see "kodo.ClassResolver" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-class-resolver>
    <classname>...</classname>
    <properties>...</properties>
</custom-class-resolver> 

custom-compatibility

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define your own custom compatibility flag. For more information, see "Compatibility Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-compatibility>
    <classname>...</classname>
    <properties>...</properties>
</custom-compatibility> 

custom-connection-decorator

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    connection-decorators

Function

Enables you to define a custom org.apache.openjpa.lib.jdbc.ConnectionDecorator implementation to install on all connection pools. For more information, see "kodo.jdbc.ConnectionDecorators" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<connection-decorators>
    <custom-connection-decorator> 
        <classname>...</classname> 
        <properties>...</properties> 
    </custom-connection-decorator>
</connection-decorators>

custom-data-cache

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    data-caches

Function

Enables you to define a custom data cache. For more information, see "kodo.DataCache" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<data-caches>
    <custom-data-cache>
        <name>...</name>
        <classname>...</classname>
        <properties>...</properties>
    </custom-data-cache>
</data-caches>

custom-data-cache-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define a custom data cache manager. For more information, see "kodo.DataCacheManager" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-data-cache-manager>
    <classname>...</classname>
    <properties>...</properties>
</custom-data-cache-manager>

custom-detach-state

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define a custom detach state. For more information, see "kodo.DetachState" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-detach-state> 
    <classname>...</classname
    <properties>...</properties>
</custom-detach-state>

custom-dictionary

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define a custom dictionary. For more information, see "Custom Dictionary Configuration" in the Oracle WebLogic Server Administration Console Help.

Example

<custom-dictionary>
   <name>custom-dictionary</name
   <classname>..</classname>
   <properties>...</properties>
</custom-dictionary>

custom-driver-data-source

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define a custom datasource driver. For more information, see "kodo.jdbc.DriverDataSource" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-driver-data-source> 
    <classname>...</classname
    <properties>...</properties>
</custom-driver-data-source>

custom-filter-listener

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    filter-listeners

Function

Enables you to define a custom filter listener. For more information, see "kodo.FilterListeners" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<filter-listeners>
    <custom-filter-listener> 
        <classname>...</classname> 
        <properties>...</properties> 
    </custom-filter-listener>
</filter-listeners>

custom-jdbc-listener

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    jdbc-listeners

Function

Enables you to define a custom JDBC listener. For more information, see "kodo.JDBCListeners" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<jdbc-listeners>
    <custom-jdbc-listener> 
        <classname>...</classname> 
        <properties>...</properties> 
    </custom-jdbc-listener>
</jdbc-listeners>

custom-lock-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define a custom lock manager. For more information, see "Lock Manager" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-lock-manager>
    <classname>...</classname>
    <properties>...</properties>
</custom-lock-manager>

custom-log

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define a custom log file. For more information, see "Custom Log" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-log>
    <classname>...</classname>
    <properties>...</properties>
</custom-log>

custom-mapping-defaults

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define custom mapping defaults. For more information, see "Mapping Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-mapping-defaults> 
    <classname>...</classname
    <properties>...</properties>
</custom-mapping-defaults>

custom-mapping-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a custom mapping factory. For more information, see "Mapping Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-mapping-factory/>

custom-meta-data-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to specify a custom metadata factory. For more information, see "Metadata Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-meta-data-factory>
    <classname>...</classname>
    <properties>...</properties>
</custom-meta-data-factory>

custom-meta-data-repository

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to specify a custom metadata repository. For more information, see "Metadata Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-meta-data-repository>
    <classname>...</classname>
    <properties>...</properties>
</custom-meta-data-repository>

custom-orphaned-key-action

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define a custom orphaned key action. For more information, see "Orphaned Keys" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-orphaned-key-action>
    <channel>openjpa.Runtime</channel>
    <level>4</level>
    <classname>...</classname>
    <properties>...</properties>
</custom-orphaned-key-action>

custom-persistence-server

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define a custom persistence server. For more information, see "Standalone Persistence Server" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-persistence-server>
    <classname>...</classname>
    <properties>...</properties>
</custom-persistence-server>

custom-proxy-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define a custom proxy manager. For more information, see "Custom Proxies" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-proxy-manager> 
    <classname>...</classname
    <properties>...</properties>
</custom-proxy-manager>

custom-query-compilation-cache

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define a custom query compilation cache. For more information, see "Query Compilation Cache" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-query-compilation-cache> 
    <classname>...</classname
    <properties>...</properties>
</custom-query-compilation-cache>

custom-remote-commit-provider

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to specify a custom remote commit provider. For more information, see "JMS" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-remote-commit-provider>
    <name>kodo.RemoteCommitProvider</name>
    <classname>...</classname>
    <properties>...</properties>
</custom-remote-commit-provider>

custom-savepoint-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to specify a custom savepoint manager. For more information, see "Savepoints" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-savepoint-manager>
    <classname>...</classname>
    <properties>...</properties>
</custom-savepoint-manager>

custom-schema-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a custom schema factory. For more information, see "Schema Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-schema-factory>
    <classname>...</classname>
    <properties>...</properties>
</custom-schema-factory>

custom-seq

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define a custom generator. For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-seq> 
    <classname>...</classname
    <properties>...</properties>
</custom-seq>

custom-sql-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define a custom SQL factory. For more information, see "kodo.jdbc.SQLFactory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-sql-factory>
    <classname>...</classname>
    <properties>...</properties>
</custom-sql-factory>

custom-update-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables you to define a custom update manager to use to flush persistent object changes to the datastore. For more information, see "kodo.jdbc.UpdateManager" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<custom-update-manager>
   <classname>..</classname>
   <properties>...</properties>
</custom-update-manager>

data-caches

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies plugins used to cache data loaded from the data store. Must implement org.apache.openjpa.datacache.DataCache. For more information, see "Data Cache" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<data-caches>
    <default-data-cache>...</default-data-cache>
    <kodo-concurrent-data-cache>...</kodo-concurrent-data-cache>
    <gem-fire-data-cache>...</gem-fire-data-cache>
    <lru-data-cache>...</lru-data-cache>
    <tangosol-data-cache>...</tangosol-data-cache>
    <custom-data-cache>...</custom-data-cache>
</data-caches>

data-cache-manager-impl

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables the kodo.datacache.DataCacheManager that manages the system data caches. For more information, see "kodo.DataCacheManager" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<data-cache-manager-impl/>

data-cache-timeout

Range of values: Integer

Default value: -1

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the amount of time in milliseconds that a class' data is valid. A value of -1 specifies no expiration. See "Setting the Data Cache Timeout Value" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<data-cache-timeout>-1</data-cache-timeout>

db2-dictionary

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Defines the configuration values for the DB2 Dictionary persistence plugin. For a complete description of each of the values that you can specify, see "DB2 Dictionary Configuration" in the Oracle WebLogic Server Administration Console Help

Example

The db2-dictionary element shares the same subelements as "access-dictionary".

default-access-type

Range of values: FIELD | PROPERTY

Default value: FIELD

Parent elements:

persistence-configuration
  persistence-configuration-unit
    kodo-persistence-mapping-factory

persistence-configuration
  persistence-configuration-unit
    kodo-persistence-meta-data-factory

Function

Specifies the default access type. Valid values include:

  • FIELD—Injects state directly into your persistent fields, and retrieves changed state from your fields as well.

  • PROPERTY—Retrieves and loads state through JavaBean "getter" and "setter" methods.

For more information, see "Field and Property Metadata" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-access-type>FIELD</default-access-type>

default-broker-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.kernel.BrokerFactory type to use, in this case the default, which is JDBC. For more information, see "kodo.BrokerFactory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-broker-factory/>

default-broker-impl

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.kernel.Broker type to use at runtime, in this case the default. For more information, see "kodo.BrokerImpl" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-broker-impl/>

default-class-resolver

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.util.ClassResolver implementation to use for class name resolution, in this case the default. You may wish to plug in your own resolver if you have special class loading needs. For more information, see "kodo.ClassResolver" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-class-resolver/>

default-compatibility

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Sets the default compatibility settings. For more information, see "Compatibility Configuration"" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-compatibility/>

default-data-cache

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    data-caches

Function

Defines the default data cache. For more information, see "Data Cache" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<data-caches>
    <default-data-cache> 
        <name>kodo.DataCache</name> 
    </default-data-cache>
</data-caches>

default-detach-state

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the default detached state, in this case loaded. For more information, see "Defining the Detached Object Graph" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-detach-state/> 

default-data-cache-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.datacache.DataCacheManager that manages the system data caches, in this case the default. For more information, see "Data Cache" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-data-cache-manager>...</default-data-cache-manager>

default-driver-data-source

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the default kodo.jdbc.schema.DriverDataSource implementation to use to wrap JDBC Driver classes with javax.sql.DataSource instances. The provided default implementation, kodo.jdbc.schema.KodoPoolingDataSource, will perform connection pooling as described at "JDBC" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-driver-data-source/>

default-level

Range of values: TRACE | DEBUG | INFO | WARN | ERROR

Default value: INFO

Parent elements:

persistence-configuration
  persistence-configuration-unit
    log-factory-impl

Function

Specifies the default logging level of unconfigured channels. For more information, see "Kodo Logging" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-level>INFO</default-level>

default-lock-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies to use the default lock manager. For more information, see "Configuring Default Locking" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-lock-manager/>

default-mapping-defaults

Range of values: String

Standard implementations include: jdo and jpa

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.jdbc.meta.MappingDefaults to use to define default column names, table names, and constraints for your persistent classes. For more information and a list of standard implementations, see "Mapping Defaults" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-mapping-defaults>jpa</default-mapping-defaults>

default-meta-data-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.meta.MetaDataFactory type to use, in this case the default, which is kodo.jdo.JDOMetaDataFactory. For more information, see "Metadata Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-meta-data-factory/>

default-meta-data-repository

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.meta.MetaDataRepository to use to store the metadata for your persistent classes, in this case the default,. For more information, see "Metadata Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-meta-data-repository/>

default-orphaned-key-action

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.event.OrphanedKeyAction to invoke when Kodo discovers an orphaned datastore key, in this case the default which is kodo.event.LogOrphanedKeyAction. In this case, Kodo logs a message for each orphaned key. For more information, see "Orphaned Keys" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-orphaned-key-action>
    <channel>openjpa.Runtime</channel>
    <level>4</level>
</default-orphaned-key-action>

default-proxy-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.util.ProxyManager to use for proxying mutable second class objects, in this case the default, which is kodo.util.ProxyManagerImpl. For more information, see "Custom Proxies" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-proxy-manager/>

default-query-compilation-cache

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the Map used to associate query strings and their parsed form, in this case the default. For more information, see "Query Compilation Cache" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-query-compilation-cache/>

default-savepoint-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.kernel.SavepointManager to use for managing transaction savepoints, in this case the default which is kodo.kernel.InMemorySavepointManager. This plugin stores all state, including field values, in memory. Because of this behavior, each set savepoint is designed for small to medium transactional object counts. For more information, see "Savepoints" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-savepoint-manager/>

default-schema-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.jdbc.schema.SchemaFactory to use to store and retrieve information about the database schema, in this case the default which is kodo.jdbc.schema.DynamicSchemaFactory.

The DynamicSchemaFactory is the most performant schema factory, because it does not validate mapping information against the database. Instead, it assumes all object-relational mapping information is correct, and dynamically builds an in-memory representation of the schema from your mapping metadata. When using this factory, it is important that your mapping metadata correctly represent your database's foreign key constraints so that Kodo can order its SQL statements to meet them.

For more information, see "Schema Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-schema-factory/>

default-sql-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.jdbc.SQLFactory to use to abstract common SQL constructs, in this case the default. For more information, see "kodo.jdbc.SQLFactory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-meta-data-factory/>

default-update-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies to use the default update manager, kodo.jdbc.kernel.ConstraintUpdateManager. For more information, see "kodo.jdbc.UpdateManager" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<default-update-manager/>

deprecated-jdo-mapping-defaults

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the mapping defaults for JDO 1.0. For more information, see "Mapping Defaults" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

The deprecated-jdo-mapping-defaults element shares the same subelements as mapping-defaults-impl.

deprecated-jdo-meta-data-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.meta.MetaDataFactory type to use, in this case kodo.jdo.DeprecatedJDOMetaDataFactory. For more information, see ""Metadata Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<deprecated-jdo-meta-data-factory>
    <use-schema-validation>false</use-schema-validation>
    <urls>t3://localhost:7001/metadata.jar</urls>
    <files>com/file1;com/file2</files>
    <classpath-scan>build</classpath-scan>
    <types>classname1;classname2</types>
    <store-mode>1</store-mode>
    <strict>false</strict>
    <resources>com/aaa/package.jdo;com/bbb/package.jdo</resources>
    <scan-top-down>false</scan-top-down>
</deprecated-jdo-meta-data-factory>

derby-dictionary

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configures the Derby Dictionary. For a complete description of each of the values that you can specify, see "Derby Dictionary Configuration" in the Oracle WebLogic Server Administration Console Help.

Example

The derby-dictionary element shares the same subelements as, plus the following subelement (default shown):

<derby-dictionary>
...
   <shutdown-on-close>true</shutdown-on-close>
</derby-dictionary>

detach-options-all

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Sets the detach state to all to detach all fields and relations. Be very careful when using this mode; if you have a highly-connected domain model, you could end up bringing every object in the database into memory. For more information, see "Defining the Detached Object Graph" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<detach-options-all> 
    <detached-state-manager>true</detached-state-manager>
    <detached-state-transient>false</detached-state-transient>
    <access-unloaded>true</access-unloaded>
    <detached-state-field>true</detached-state-field>
</detach-options-all>

detach-options-fetch-groups

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Sets the detach state to detach all fields and relations in the default fetch group, and any other fetch groups that you have added to the current fetch configuration. For more information on custom fetch groups, see "Fetch Groups" in Kodo 4.2.0 Developers Guide for JPA/JDO. For more information about the detach state, see "Defining the Detached Object Graph" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<detach-options-fetch-groups> 
    <detached-state-manager>true</detached-state-manager>
    <detached-state-transient>false</detached-state-transient>
    <access-unloaded>true</access-unloaded>
    <detached-state-field>true</detached-state-field>
</detach-options-fetch-groups>

detach-options-loaded

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Sets the detach state to detach all fields and relations that are already loaded, but do not include unloaded fields in the detached graph. This is the default. For more information about the detach state, see "Defining the Detached Object Graph" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<detach-options-loaded> 
    <detached-state-manager>true</detached-state-manager>
    <detached-state-transient>false</detached-state-transient>
    <access-unloaded>true</access-unloaded>
    <detached-state-field>true</detached-state-field>
</detach-options-loaded>

detach-state

Range of values: 1 | 2 | 3

Default value: 1

Parent elements:

persistence-configuration
  persistence-configuration-unit]
    kodo-broker

Function

Configures the detach state. Valid values include:

  • 1—(loaded) Detach all fields and relations that are already loaded, but do not include unloaded fields in the detached graph.

  • 2—(fetch-groups) Detach all fields and relations in the current fetch configuration.

  • 3—(all) Detach all fields and relations. Be very careful when using this mode; if you have a highly-connected domain model, you could end up bringing every object in the database into memory.

Any field that is not included in the set determined by the detach mode is set to its Java default value in the detached instance. For more information, see "Defining the Detached Object Graph" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<detach-state>1</detach-state>

detached-state-field

Range of values: true | false

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit
    detach-options-all

persistence-configuration
  persistence-configuration-unit
    detach-options-fetch-groups

persistence-configuration
  persistence-configuration-unit
    detach-options-loaded

Function

Flag that specifies whether Kodo should take advantage of a detached state field to make the attach process more efficient. This field is added by the enhancer and is not visible to your application. For more information, see "Attach Behavior" in Kodo 4.2.0 Developers Guide for JPA/JDO.

For more information about the detach state, see "Defining the Detached Object Graph" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<detached-state-field>true</detached-state-field>

detached-state-manager

Range of values: true | false

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit
    detach-options-all

persistence-configuration
  persistence-configuration-unit
    detach-options-fetch-groups

persistence-configuration
  persistence-configuration-unit
    detach-options-loaded

Function

Flag that specifies whether to use a detached state manager. A detached state manager makes attachment much more efficient. Like a detached state field, however, it breaks serialization compatibility with the unenhanced class if it is not transient.

This setting piggybacks on the detached-state-field element. If your detached state field is transient, the detached state manager will also be transient. If the detached state field is disabled, the detached state manager will also be disabled. This is typically what you want.

By setting the detach-state-field element to true (or transient) and setting this property to false, however, you can use a detached state field without using a detached state manager. This may be useful for debugging or for legacy Kodo users who find differences between Kodo's behavior with a detached state manager and Kodo's older behavior without one.

For more information about the detach state, see "Defining the Detached Object Graph" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<detached-state-manager>true</detached-state-manager>

detached-state-transient

Range of values: true | false

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit
    detach-options-all

persistence-configuration
  persistence-configuration-unit
    detach-options-fetch-groups

persistence-configuration
  persistence-configuration-unit
    detach-options-loaded

Function

Flag that specifies whether to use a transient detached state field. Setting this to true provides the benefits of a detached state field to local objects that are never serialized, but retains serialization compatibility for client tiers without access to the enhanced versions of your classes.

For more information about the detach state, see "Defining the Detached Object Graph" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<detached-state-transient>false</detached-state-transient>

detached-new

Range of values: true | false

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit
    kodo-broker

Function

Flag that specifies whether to use a non-transient detached state field so that objects crossing serialization barriers can still be attached efficiently. This requires, however, that your client tier have the enhanced versions of your classes and the Kodo libraries.

For more information about the detach state, see "Defining the Detached Object Graph" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<detached-new>true</detached-new>

diagnostic-context

Range of values: String

Default value: kodo.ID property, if set

Parent elements:

persistence-configuration
  persistence-configuration-unit
    log-factory-impl

Function

String that is prepended to all log messages. The kodo.ID property is used by default, if specified. For more information, see "Kodo Logging" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<diagnostic-context>KodoID</diagnostic-context>

dynamic-data-structs

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Flag that specifies whether to dynamically generate customized structs to hold persistent data. Both the Kodo data cache and the remote framework rely on data structs to cache and transfer persistent state. With dynamic structs, Kodo can customize data storage for each class, eliminating the need to generate primitive wrapper objects. This saves memory and speeds up certain runtime operations.

The cost is a longer warm-up time for the application—generating and loading custom classes into the JVM takes time. Therefore, only set this property to true if you have a long-running application where the initial cost of class generation is offset by memory and speed optimization over time.

For more information, see "kodo.DynamicDataStructs" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<dynamic-data-structs>false</dynamic-data-structs>

dynamic-schema-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.jdbc.schema.SchemaFactory to use to store and retrieve information about the database schema, in this case the default which is kodo.jdbc.schema.DynamicSchemaFactory.

The DynamicSchemaFactory is the most performant schema factory, because it does not validate mapping information against the database. Instead, it assumes all object-relational mapping information is correct, and dynamically builds an in-memory representation of the schema from your mapping metadata. When using this factory, it is important that your mapping metadata correctly represent your database's foreign key constraints so that Kodo can order its SQL statements to meet them.

For more information, see "Schema Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<dynamic-schema-factory/>

eager-fetch-mode

Range of values: join | multiple | none | parallel | single

Default value: parallel

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configures eager fetching. Eager fetching is the ability to efficiently load subclass data and related objects along with the base instances being queried. For complete details, see "Eager Fetching" in Kodo 4.2.0 Developers Guide for JPA/JDO.

You can set this value to one of the following:

  • join—In this mode, Kodo joins to-one relations in the configured fetch groups. If Kodo is loading data for a single instance, then Kodo will also join to any collection field in the configured fetch groups. When loading data for multiple instances, though, (such as when executing a Query) Kodo will not join to collections by default. Instead, Kodo defaults to parallel mode for collections, as described below. You can force Kodo to use a join rather than parallel mode for a collection field using the metadata extension described in "Eager Fetch Mode" in Kodo 4.2.0 Developers Guide for JPA/JDO.

    Under join mode, Kodo uses a left outer join (or inner join, if the relations' field metadata declares the relation non-nullable) to select the related data along with the data for the target objects. This process works recursively for to-one joins, so that if Person has an Address, and Address has a TelephoneNumber, and the fetch groups are configured correctly, Kodo might issue a single select that joins across the tables for all three classes. To-many joins can not recursively spawn other to-many joins, but they can spawn recursive to-one joins.

    Under the join subclass fetch mode, subclass data in joined tables is selected by outer joining to all possible subclass tables of the type being queried. Unjoined subclass data is selected with a SQL UNION where possible. As you'll see below, subclass data fetching is configured separately from relation fetching, and can be disabled for specific classes.

  • multiple—Same as parallel.

  • none—No eager fetching is performed. Related objects are always loaded in an independent select statement. No joined subclass data is loaded unless it is in the table(s) for the base type being queried. Unjoined subclass data is loaded using separate select statements rather than an SQL UNION operation.

  • parallel—Under this mode, Kodo selects to-one relations and joined collections as outlined in the join mode description above. Unjoined collection fields, however, are eagerly fetched using a separate select statement for each collection, executed in parallel with the select statement for the target objects. The parallel selects use the WHERE conditions from the primary select, but add their own joins to reach the related data. Thus, if you perform a query that returns 100 Company objects, where each company has a list of Employee objects and Department objects, Kodo will make three queries. The first will select the company objects, the second will select the employees for those companies, and the third will select the departments for the same companies. Just as for joins, this process can be recursively applied to the objects in the relations being eagerly fetched. Continuing our example, if the Employee class had a list of Projects in one of the fetch groups being loaded, Kodo would execute a single additional select in parallel to load the projects of all employees of the matching companies.

    Using an additional select to load each collection avoids transferring more data than necessary from the database to the application. If eager joins were used instead of parallel select statements, each collection added to the configured fetch groups would cause the amount of data being transferred to rise dangerously, to the point that you could easily overwhelm the network.

    Polymorphic to-one relations to table-per-class mappings use parallel eager fetching because proper joins are impossible. You can force other to-one relations to use parallel rather than join mode eager fetching using the metadata extension described in "Eager Fetch Mode" in Kodo 4.2.0 Developers Guide for JPA/JDO.

    Setting your subclass fetch mode to parallel affects table-per-class and vertical inheritance hierarchies. Under parallel mode, Kodo issues separate selects for each subclass in a table-per-class inheritance hierarchy, rather than UNIONing all subclass tables together as in join mode. This applies to any operation on a table-per-class base class: query, by-id lookup, or relation traversal.

    When dealing with a vertically-mapped hierarchy, on the other hand, parallel subclass fetch mode only applies to queries. Rather than outer-joining to subclass tables, Kodo will issue the query separately for each subclass. In all other situations, parallel subclass fetch mode acts just like join mode in regards to vertically-mapped subclasses.

    When Kodo knows that it is selecting for a single object only, it never uses parallel mode, because the additional selects can be made lazily just as efficiently. This mode only increases efficiency over join mode when multiple objects with eager relations are being loaded, or when multiple selects might be faster than joining to all possible subclasses.

  • single—Same as join.

Example

<eager-fetch-mode>parallel</eager-fetch-mode>

empress-dictionary

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configures the Empress Dictionary. For a complete description of each of the values that you can specify, see "Empress Dictionary Configuration" in the Oracle WebLogic Server Administration Console Help.

Example

The empress-dictionary element shares the same subelements as access-dictionary, plus the following subelement (default shown):

<empress-dictionary>
...
   <allow-concurrent-read>false</allow-concurrent-read>
</empress-dictionary>

EnableLogMBean

Range of values: true | false

Default value: N/A

Parent elements:

jmx
  local-jmx

Function

Flag that specifies whether the LogMBean should be registered. For more information, see "Optional Parameters in Management Group" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<EnableLogMBean>true</EnableLogMBean>

EnableRuntimeMBean

Range of values: true | false

Default value: N/A

Parent elements:

jmx
  local-jmx

Function

Flag that specifies whether the RuntimeMBean should be registered. For more information, see "Optional Parameters in Management Group" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<EnableRuntimeMBean>true</EnableRuntimeMBean>

evict-from-data-cache

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    kodo-broker

Function

Flag that specifies whether to evict data from the data cache at specific times. You defined the eviction schedule using the eviction-schedule element. For more information, see "Data Cache" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<evict-from-data-cache>true</evict-from-data-cache>

eviction-schedule

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    data-caches
      gem-fire-data-cache

persistence-configuration
  persistence-configuration-unit
    data-caches
        kodo-current-data-cache

persistence-configuration
  persistence-configuration-unit
    data-caches
      lru-data-cache

persistence-configuration
  peristence-configuration-unit
    data-caches
      tangosol-data-cache

Function

You can clear a data cache at specific times. The EvictionSchedule property of Kodo's cache implementation accepts a cron style eviction schedule. The format of this property is a whitespace-separated list of five tokens. You can use the * symbol (asterisk) as a wildcard to match all values. The following lists the tokens in the order that they must be specified:

  • Minute

  • Hour of Day

  • Day of Month

  • Month

  • Day of Week

For more information, see "Configuring the Eviction Schedule" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

The following setting schedules the default cache to evict values from the cache at 15 and 45 minutes past 3:00 pm on Sunday.

<eviction-schedule>15,45 15 * * 1</eviction-schedule>

exception-orphaned-key-action

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.event.OrphanedKeyAction to invoke when Kodo discovers an orphaned datastore key, in this case kodo.event.ExceptionOrphanedKeyAction. In this case, Kodo throws an exception for each orphaned key. In JPA, the exception will be javax.persistence.EntityNotFoundException. In JDO, the exception type will be javax.jdo.JDOObejctNotFoundException. For more information, see "Orphaned Keys" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<exception-orphaned-key-action/>

exception-reconnect-attempts

Range of values: Integer

Default value: 0

Parent elements:

persistence-configuration
  persistence-configuration-unit
    jms-remote-commit-provider

Function

Specifies the number of time to attempt to reconnect if the JMS system notifies Kodo of a serious connection error. A value of 0 (the default) indicates that Kodo will log the error but otherwise ignore it, hoping the connection is still valid. For more information, see "JMS" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<exception-reconnect-attempts>0<exception-reconnect-attempts>

execution-context-name-provider

Range of values: N/A

Default value: N/A

Parent elements: N/A

Function

Configure the execution context name provider. For more information, see "kodo.ExecutionContextNameProvider" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<execution-context-name-provider>
    <stack-execution-context-name-provider>...
    </stack-execution-context-name-provider>
    <transaction-name-execution-context-name-provider>...
    </transaction-name-execution-context-name-provider>
    <user-object-execution-context-name-provider>...
    </user-object-execution-context-name-provider>
</execution-context-name-provider>

export-profiling

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

profiling

Function

Configure export profiling data. See "Dumping Profiling Data to Disk from a Batch Process" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<profiling>
    <export-profiling>
        <interval-millis>-1</interval-millis>
        <base-name>name</base-name>
    </export-profiling>
</profiling>

extension-deprecated-jdo-mapping-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

A plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.meta.MetaDataFactory to use to store and retrieve object-relational mapping information for your persistent classes. This setting is valid for JDO 1.0. For more information, see "Mapping Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<extension-deprecated-jdo-mapping-factory>
    <use-schema-validation>true</use-schema-validation>
    <urls>t3://localhost:7001/metadata.jar</urls>
    <files>com/file1;com/file2</files>
    <classpath-scan>build</classpath-scan>
    <types>classname1;classname2</types>
    <store-mode>1</store-mode>
    <strict>false</strict>
    <resources>com/aaa/package.jdo;com/bbb/package.jdo</resources>
    <scan-top-down>false</scan-top-down>
</extension-deprecated-jdo-mapping-factory>

fetch-batch-size

Range of values: Integer

Default value: -1

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

The number of rows to fetch at one time when scrolling through a result set. The fetch size can also be set at runtime, as described in "Large Result Sets" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<fetch-batch-size>-1</fetch-batch-size>

fetch-direction

Range of values: forward | reverse | unknown

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

The expected order in which query result lists are accessed. This value affects the type of data structure Kodo uses to store the results, and is passed to the JDBC driver in case it can optimize for certain access patterns. This element accepts the following values, each of which corresponds exactly to the same-named java.sql.ResultSet FETCH constant:

  • forward—Query results are listed in order. This is the default.

  • reverse—Query results are listed in reverse order.

  • unknown—The order is not specified.

This property can also be varied at runtime, as described in "Large Result Sets" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<fetch-direction>forward</fetch-direction>

fetch-group

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    fetch-group

Function

Name of a fetch group. Fetch group names are global, and are expected to be shared among classes. For example, a shopping website may use a detail fetch group in each product class to efficiently load all the data needed to display a product's "detail" page. The website might also define a sparse list fetch group containing only the fields needed to display a table of products, as in a search result.

The following names are reserved for use by Kodo: default, values, all, none, and any name beginning with jdo, ejb, or kodo.

For more information, see "Custom Fetch Groups" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<fetch-groups>
    <fetch-group>detail</fetch-group>
</fetch-groups>

fetch-groups

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Define one or more custom fetch groups.

By default, Kodo places any field that is eagerly loaded according to the JPA metadata rules into the built-in default fetch group. You may define your own named fetch groups and activate or deactivate them at runtime. Kodo will eagerly-load the fields in all active fetch groups when loading objects from the datastore. For more information, see "Custom Fetch Groups" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<fetch-groups>
    <fetch-group>detail</fetch-group>
</fetch-groups>

field-override

Range of values: true | false

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit
    kodo-persistence-mapping-factory

persistence-configuration
  persistence-configuration-unit
    kodo-persistence-meta-data-factory

Function

Flag that specifies whether to enable field override.

Example

<field-override>true</field-override>

file

Range of values: String

Default value: Described below

Parent elements:

persistence-configuration
  persistence-configuration-unit
    file-schema-factory

persistence-configuration
  persistence-configuration-unit
    log-factory-impl

Function

If the parent element is file-schema-factory, specifies the resource name of the XML schema file. By default, the factory looks for a resource called package.schema located in any top-level directory of the CLASSPATH or in the top level of any JAR in your CLASSPATH. For more information, see "Schema Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

If the parent element is log-factory-impl, specifies the name of the file to which messages are logged. Specify stdout or stderr to log messages to standard out and standard error, respectively. The default is stderr. For more information, see "Kodo Logging" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<file>stdout</file>

file-name

Range of values: String

Default value: package.schema

Parent elements:

persistence-configuration
  persistence-configuration-unit
    file-schema-factory

Function

Specifies the resource name of the XML schema file. By default, the factory looks for a resource called package.schema located in any top-level directory of the CLASSPATH or in the top level of any JAR in your CLASSPATH. For more information, see "Schema Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<file-name>package.schema</file-name>

file-schema-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.jdbc.schema.SchemaFactory to use to store and retrieve information about the database schema, in this case kodo.jdbc.schema.FileSchemaFactory.

This factory is a lot like the table-schema-factory, and has the same advantages and disadvantages. Instead of storing its XML schema definition in a database table, though, it stores it in a file.

For more information, see "Schema Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<file-schema-factory>
    <file-name>package.schema</file-name>
    <file>package.schema</file>
</file-schema-factory>

files

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    deprecated-jdo-meta-data-factory

persistence-configuration
  persistence-configuration-unit
    extension-deprecated-jdo-mapping-factory

persistence-configuration
  persistence-configuration-unit
    jdo-meta-data-factory

persistence-configuration
  persistence-configuration-unit
    jdor-mapping-factory

persistence-configuration
  persistence-configuration-unit
    kodo-persistence-mapping-factory

persistence-configuration
  persistence-configuration-unit
    kodo-persistence-meta-data-factory

persistence-configuration
  persistence-configuration-unit
    mapping-file-deprecated-jdo-mapping-factory

persistence-configuration
  persistence-configuration-unit
    orm-file-jdor-mapping-factory

persistence-configuration
  persistence-configuration-unit
    table-deprecated-jdo-mapping-factory

Function

Specifies a semicolon-separated list of metadata files or JAR archives. Each jar archive will be scanned for annotated JPA entities or JDO metadata files based on your metadata factory. For more information, see "Metadata Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<files>com/file1;com/file2</files>

filter-listeners

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Defines one or more full plugin strings (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) for custom kodo.FilterListeners to make available to all queries, in addition to the standard set of listeners. You can also add filter listeners to individual queries, as described in "Query Language Extensions" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

For more information, see "kodo.FilterListeners" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<filter-listeners>
    <custom-filter-listener>detail</custom-filter-listener>
</filter-listeners>

foreign-keys

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    lazy-schema-factory

Function

Flag that specifies whether to read automatically foreign key information during schema validation. For more information, see "Schema Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<foreign-keys>false</foreign-keys>

format

Range of values: String

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    native-jdbc-seq

Function

Specifies the format. For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

foxpro-dictionary

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configuration values for the FoxPro Dictionary persistence plugin. For a complete description of each of the values that you can specify, see "FoxPro Dictionary Configuration" in the Oracle WebLogic Server Administration Console Help.

Example

The foxpro-dictionary element shares the same subelements as access-dictionary.

flush-before-queries

Range of values: true | false | with-connection

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Flag that specifies whether to flush any changes made in the current transaction to the datastore before executing a query. Valid values include:

  • true—Always flush rather than executing the query in-memory. If the current transaction is optimistic, Kodo will begin a non-locking datastore transaction. This is the default.

  • false—Never flush before a query.

  • with-connection—Flush only if the EntityManager or PersistenceManager has already established a dedicated connection to the datastore, otherwise execute the query in-memory.

    This option is useful if you use long-running optimistic transactions and want to ensure that these transactions do not consume database resources until commit. Kodo's behavior with this option is dependent on the transaction status and mode, as well as the configured connection retain mode described earlier in this section.

For more information, see "Configuring the Use of JDBC Connections" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<flush-before-queries>true</flush-before-queries>

hsql-dictionary

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configuration values for the HSQL Dictionary persistence plugin. For a complete description of each of the values that you can specify, see "HSQL Dictionary Configuration" in the Oracle WebLogic Server Administration Console Help.

Example

The hsql-dictionary element shares the same subelements as access-dictionary.

gem-fire-data-cache

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    data-caches

Function

Integrates with GemStone's GemFire v5.0.1 caching system. For more information, see "GemStone GemFire Integration" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<data-caches>
    <gem-fire-data-cache>
        <name>kodo.DataCache</name>
        <gem-fire-cache-name>root/kodo-data-cache</gem-fire-cache-name>
        <eviction-schedule>15, 45 15 * * 1</eviction-schedule>
    </gem-fire-data-cache>
</data-caches>

gem-fire-data-cache-name

Range of values: Valid GemFire region name

Default value:

Data cache: root/kodo-data-cache

Query cache: root/kodo-query-cache

Parent elements:

persistence-configuration
  persistence-configuration-unit
    data-caches
      gem-fire-data-cache

Function

GemFire region name. For more information, see "GemStone GemFire Integration" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<gem-fire-data-cache-name>root/kodo-data-cache</gem-fire-data-cache-name>

gui-jmx

Range of values: N/A

Default value: N/A

Parent elements:

jmx

Function

Enable management and invoke the JMX management console in the local JVM. Supports optional parameters in the Management Group, as described in "Optional Parameters in Management Group" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<gui-jmx>
    <MBeanServerStrategy>any-create</MBeanServerStrategy>
    <EnableLogMBean>true</EnableLogMBean>
    <EnableRuntimeMBean>true</EnableRuntimeMBean>
</gui-jmx>

gui-profiling

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

profiling

Function

Turns on the local profiling GUI. See "Profiling in an Embedded GUI" in the Kodo Developer's Guide for more information.

Example

<profiling>
  <gui-profiling/>
</profiling>

Host

Range of values: N/A

Default value: N/A

Parent elements:

jmx
    mx4j1-jmx

Function

Hostname on which the RMI registry naming service listens. Defaults to localhost. For more information, see "Optional Parameters in Remote Group" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<Host>localhost</Host>

host

Range of values: Valid hostname

Default value: localhost

Parent elements:

persistence-configuration
  persistence-configuration-unit
    tcp-transport

Function

Specifies the host name of the server. This setting is used by clients, not by the server. For more information, see "Standalone Persistence Server" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<host>localhost</host>

http-transport

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the URL of the remote server. For more information, see "Client Managers" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<http-transport>
    <url>servlet-url</url>
</http-transport>

ignore-changes

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    kodo-broker

Function

Flag that specifies whether to consider modifications to persistent objects made in the current transaction when evaluating queries. Setting this to true allows Kodo to ignore changes and execute the query directly against the datastore. A value of false forces Kodo to consider whether the changes in the current transaction affect the query, and if so to either evaluate the query inmemory or flush before running it against the datastore. For more information, see "kodo.IgnoreChanges" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<ignore-changes>false</ignore-changes>

ignore-unmapped

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    class-table-jdbc-seq

Function

Flag that specifies whether to ignore unmapped base classes and instead use one row per least-derived mapped class. For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<ignore-unmapped>false</ignore-unmapped>

ignore-virtual

Range of values: true | false

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit
    class-table-jdbc-seq

Function

Flag that specifies whether to ignore virtual classes. For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<ignore-virtual>false</ignore-virtual>

in-memory-savepoint-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.kernel.SavepointManager to use for managing transaction savepoints, in this case kodo.kernel.InMemorySavepointManager. This plugin stores all state, including field values, in memory. Because of this behavior, each set savepoint is designed for small to medium transactional object counts. For more information, see "Savepoints" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<in-memory-savepoint-manager/>

increment

Range of values: Integer

Default value: 1

Parent elements:

persistence-configuration
  persistence-configuration-unit
    class-table-jdbc-seq

persistence-configuration
  persistence-configuration-unit
    native-jdbc-seq

persistence-configuration
  persistence-configuration-unit
    table-jdbc-seq

persistence-configuration
  persistence-configuration-unit
    time-seeded-seq

persistence-configuration
  persistence-configuration-unit
    value-table-jdbc-seq

Function

Specifies the amount of sequence increments. For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<increment>1</increment>

indexes

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    lazy-schema-factory

Function

Flag that specifies whether to read automatically index information during schema validation. For more information, see "Schema Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<indexes>false</indexes>

informix-dictionary

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configuration values for the Informix Dictionary persistence plugin. For a complete description of each of the values that you can specify, see "Informix Dictionary Configuration" in the Oracle WebLogic Server Administration Console Help.

Example

The informix-dictionary element shares the same subelements as access-dictionary, plus the following subelements (defaults shown):

<informix-dictionary>
...
   <lock-mode-enabled>false</lock-mode-enabled>
   <lock-wait-seconds>30</lock-wait-seconds>
   <swap-schema-and-catalog>true</swap-schema-and-catalog>
</informix-dictionary>

initial-value

Range of values: N/A

Default value: 1

Parent elements:

persistence-configuration
  persistence-configuration-unit
    native-jdbc-seq

Function

Specifies the initial sequence value. For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<initial-value>1</intial-value>

interval-millis

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    export-profiling

profiling
    export-profiling

Function

Number of milliseconds between exports. This value defaults to -1, indicating that there will be a single export upon exit. See "Dumping Profiling Data to Disk from a Batch Process" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<interval-millis>-1</interval-millis>

inverse-manager

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

A plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing a kodo.kernel.InverseManager to use for managing bidirectional relations upon a flush. For more information, see "Managed Inverses" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<inverse-manager>
    <action>warn</action>
    <manage-lrs>false</manage-lrs>
</inverse-manager>

jdatastore-dictionary

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configuration values for the JDataStore Dictionary persistence plugin. For a complete description of each of the values that you can specify, see "JDataStore Dictionary Configuration" in the Oracle WebLogic Server Administration Console Help.

Example

The jdatastore-dictionary element shares the same subelements as access-dictionary.

jdbc-broker-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

A plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.kernel.BrokerFactory type to use, in this case JDBC. For more information, see "kodo.BrokerFactory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<jdbc-broker-factory/>

jdbc-listeners

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Defines one or more full plugin strings (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) for custom kodo.jdbc.kernel.exps.JDBCFilterListeners to make available to all queries, in addition to the standard set of listeners. You can also add filter listeners to individual queries, as described in "Query Language Extensions" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<jdbc-listeners>detail</jdbc-listeners>

jdbc3-savepoint-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.kernel.SavepointManager to use for managing transaction savepoints, in this case the default which is kodo.jdbc.kernel.JDBCSavepointManager. This plugin implements savepoints by issuing a flush to the database. For more information, see "Savepoints" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<jdbc3-savepoint-manager/>

jdo-meta-data-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.meta.MetaDataFactory type to use, in this case kodo.jdo.JDOMetaDataFactory. For more information, see "Metadata Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<jdo-meta-data-factory>
    <use-schema-validation>false</use-schema-validation>
    <urls>t3://localhost:7001/metadata.jar</urls>
    <files>com/file1;com/file2</files>
    <classpath-scan>build</classpath-scan>
    <constraint-names>false</constraint-names>
    <types>classname1;classname2</types>
    <store-mode>1</store-mode>
    <strict>false</strict>
    <resources>com/aaa/package.jdo;com/bbb/package.jdo</resources>
    <scan-top-down>false</scan-top-down>
</jdo-meta-data-factory>

jms-remote-commit-provider

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configures the JMS remote commit provider. For more information, see "JMS" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<jms-remote-commit-provider>
    <name>kodo.RemoteCommitProvider</name>
    <topic>topic/KodoCommitProviderTopic</topic>
    <exception-reconnect-attempts>0<exception-reconnect-attempts>
    <topic-connection-factory>java:/ConnectionFactory</topic-connection-factory>
</jms-remote-commit-provider>

jmx

Range of values: N/A

Default value: N/A

Parent elements:

Function

Enables for the configuration of management capabilities. For more information, see "Management and Monitoring" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<jmx>
    <none-jmx/>
    <local-jmx>...</local-jmx>
    <gui-jmx>...</gui-jmx>
    <jmx2-jmx>...</jmx2-jmx>
    <mx4j1-jmx>...</mx4j1-jmx>
    <wls81-jmx>...</wls81jmx>
</jmx>

jmx2-jmx

Range of values: N/A

Default value: N/A

Parent elements:

jmx

Function

Enable remote management via JMX v.1.2 implementations (supporting JSR 160 for remote management). Supports optional parameters in the Management Group and the JSR 160 Group, as described in "Optional Parameters in Management Group" and "Optional Parameters in JSR 160 Group" in the Kodo 4.2.0 Developers Guide for JPA/JDO, respectively.

Example

<jmx2-jmx>
    <MBeanServerStrategy>any-create</MBeanServerStrategy>
    <EnableLogMBean>true</EnableLogMBean>
    <EnableRuntimeMBean>true</EnableRuntimeMBean>
    <NamingImpl>mx4j.tools.naming.NamingService</NamingImpl>
    <ServiceURL>service:jmx:rmi://localhost/jndi/jmxservice</ServiceURL>
</jmx2-jmx>

JNDIName

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    JNDIName

Function

JNDI name under which to register the remote JMX adaptor. Defaults to jrmp. For more information, see "Optional Parameters in Remote Group" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<JNDIName>jrmp</JNDIName>

kodo-broker

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configures the kodo.BrokerImpl. For more information, see "kodo.BrokerImpl" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<kodo-broker>
    <large-transaction>false</large-transaction>
    <auto-clear>datastore</auto-clear>
    <detach-state>1</detach-stage>
    <nontransactional-read>true</nontransactional-read>
    <retain-state>false</retain-state>
    <evict-from-data-cache>false</evict-from-data-cache>
    <detached-new>true</detached-new>
    <optimistic>true</optimistic>
    <nontransactional-write>flase</nontransactional-write>
    <sync-with-managed-transacations>false</sync-with-managed-transactions>
    <multithreaded>false</multithreaded>
    <populate-data-cache>true</populate-data-cache>
    <ignore-changes>false</ignore-changes>
    <auto-detach>0</auto-detach>
    <restore-state>1</restore-state>
    <order-dirty-objects>false</other-dirty-objects>
</kodo-broker>

kodo-concurrent-data-cache

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    data-caches

Function

Enables the basic concurrent data cache. For more information, see "Data Cache" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<data-caches>
    <kodo-concurrent-data-cache>
        <name>default</name>
        <cache-size>1000</cache-size>
        <soft-reference-size>0</soft-reference-size>
        <eviction-schedule>15,45 15 * * 1</eviction-schedule>
    </kodo-concurrent-data-cache>
</data-caches>

kodo-data-cache-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Enables the kodo.datacache.DataCacheManager that manages the system data caches. For more information, see "kodo.DataCacheManager" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<kodo-data-cache-manager/>

kodo-mapping-repository

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.meta.MetaDataRepository to use. For more information, see "kodo.MetaDataRepository" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<kodo-mapping-repository>
    <resolve>3</resolve>
    <validate>7</validate>
    <source-mode>7</source-mode>
</kodo-mapping-repository>

kodo-persistence-mapping-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

A plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.meta.MetaDataFactory to use to store and retrieve object-relational mapping information for your persistent classes. This setting is valid for JPA 1.0. For more information, see "Mapping Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<kodo-persistence-mapping-factory>
    <urls>t3://localhost:7001/metadata.jar</urls>
    <files>com/file1;com/file2</files>
    <classpath-scan>build</classpath-scan>
    <default-access-type>FIELD</default-access-type>
    <field-override>true</field-override>
    <types>classname1;classname2</types>
    <store-mode>1</store-mode>
    <strict>false</strict>
    <resources>com/aaa/package.jdo;com/bbb/package.jdo</resources>
</kodo-persistence-mapping-factory>

kodo-persistence-meta-data-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.meta.MetaDataFactory type to use, in this case org.apache.openjpa.persistence.PersistenceMetaDataFactory. For more information, see "Metadata Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<kodo-persistence-meta-data-factory>
    <urls>t3://localhost:7001/metadata.jar</urls>
    <files>com/file1;com/file2</files>
    <classpath-scan>build</classpath-scan>
    <default-access-type>FIELD</default-access-type>
    <field-override>true</field-override>
    <types>classname1;classname2</types>
    <store-mode>1</store-mode>
    <strict>false</strict>
    <resources>com/aaa/package.jdo;com/bbb/package.jdo</resources>
</kodo-persistence-meta-data-factory>

kodo-pooling-data-source

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configures the kodo.jdbc.schema.KodoPoolingDataSource which by default performs connection pooling. For more information, see "JDBC" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<kodo-pooling-data-source>
    <connection-user-name>KodoPool</connection-user-name>
    <login-timeout>10</login-timeout>
    <connection-password>password</connection-password>
    <connection-url>jdbc:hsqldb:db-hypersonic</connection-url>
    <connection-driver-name>org.hsqldb.jdbcDrier</connection-driver-name>
</kodo-pooling-data-source>

kodo-sql-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.jdbc.SQLFactory to use to abstract common SQL constructs. For more information, see "kodo.jdbc.SQLFactory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<kodo-sql-factory>
    <advanced-sql>...</advanced-sql>
</kodo-sql-factory>

large-transaction

Range of values: true | false

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit
    kodo-broker

Function

Flag that specifies whether the transaction will generate a large number of objects.

Example

<large-transaction>false</large-transaction>

lazy-schema-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.jdbc.schema.SchemaFactory to use to store and retrieve information about the database schema, in this case kodo.jdbc.schema.LazySchemaFactory.

As persistent classes are loaded by the application, Kodo reads their metadata and object-relational mapping information. This factory uses the java.sql.DatabaseMetaData interface to reflect on the schema and ensure that it is consistent with the mapping data being read. Because the factory does not reflect on a table definition until that table is mentioned by the mapping information, it is referred to as lazy. Use this factory if you want up-front validation that your mapping metadata is consistent with the database during development.

For more information, see "Schema Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<lazy-schema-factory>
    <foreign-keys>false</foreign-keys>
    <indexes>false</indexes>
    <primary-keys>false</primary-keys>
</lazy-schema-factory>

level

Range of values: 1 | 2 | 3 | 4 | 5

Default value: 4

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the level at which to log. Valid values include: 1 (TRACE), 2 (DEBUG), 3 (INFO), 4 (WARN), and 5 (ERROR). For more information, see "Orphaned Keys" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<level>4</level>

local-jmx

Range of values: N/A

Default value: N/A

Parent elements:

jmx

Function

Enabled local management. This setting is suitable for use in JBoss and other environments where all MBeans should be registered with a JMX MBeanServer for either management via a user defined mechanism, or via a mechanism defined by the MBeanServer. Supports optional parameters in the Management Group, as described in "Optional Parameters in Management Group" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<local-jmx>
    <MBeanServerStrategy>any-create</MBeanServerStrategy>
    <EnableLogMBean>true</EnableLogMBean>
    <EnableRuntimeMBean>true</EnableRuntimeMBean>
</local-jmx>

local-profiling

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

profiling

Function

Enable profiling without export or GUI. Useful when trying to access the ProfilingAgent programmatically. For more information, see "Profiling" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<profiling>
  <local-profiling/>
</profiling>

lock-timeout

Range of values: Integer

Default value: -1

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Default amount of time that Kodo waits when trying to obtain a lock. A value of -1 specifies that there is no limit. For more information, see "Configuring Default Locking" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<lock-timeout>-1</lock-timeout>

log-factory-impl

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configures the default logging system. For more information, see "Kodo Logging" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<log-factory-impl>
    <diagnostic-context>ID</diagnostic-context>
    <default-level>INFO</default-level>
    <file>stdout</file>
</log-factory-impl>

log-orphaned-key-action

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.event.OrphanedKeyAction to invoke when Kodo discovers an orphaned datastore key, in this case kodo.event.LogOrphanedKeyAction. In this case, Kodo logs a message for each orphaned key. For more information, see "Orphaned Keys" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<log-orphaned-key-action>
    <channel>openjpa.Runtime</channel>
    <level>4</level>
</log-orphaned-key-action>

log4j-log-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies to use Log4J for logging. In a standalone application, Log4J logging levels are controlled by a resource named log4j.properties, which should be available as a top-level resource (either at the top level of a jar file, or in the root of one of the CLASSPATH directories). When deploying to a web or EJB application server, Log4J configuration is often performed in a log4j.xml file instead of a properties file. For further details on configuring Log4J, please see the Log4J Manual at http://logging.apache.org/. For more information, see "Log4J" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<log4j-log-factory/>

login-timeout

Range of values: Valid classname

Default value:

kodo-pooling-data-source: 10

simple-driver-data-source: 0

Parent elements:

persistence-configuration
  persistence-configuration-unit
    kodo-pooling-data-source

persistence-configuration
  persistence-configuration-unit
    simple-driver-data-source

Function

Specifies the login timeout. For more information, see "Using the Kodo Data Source" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<login-timeout>0</login-timeout>

lrs-size

Range of values: query | last | unknown

Default value: query

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the size of results sets. This property is only used if you change the fetch batch size from its default of -1 so that Kodo uses the on-demand results loading. Valid values include:

  • query—The first time you ask for the size of a query result, Kodo will perform a SELECT COUNT(*) query to determine the number of expected results. Note that depending on transaction status and settings, this can mean that the reported size is slightly different than the actual number of results available. This is the default.

  • last—If you have chosen a scrollable result set type, this setting will use the ResultSet.last method to move to the last element in the result set and get its index. Unfortunately, some JDBC drivers will bring all results into memory in order to access the last one. Note that if you do not choose a scrollable result set type, then this will behave exactly like unknown. The default result set type is forward-only, so you must change the result set type in order for this property to have an effect.

  • unknown—Kodo returns Integer.MAX_VALUE as the size for any query result that uses on-demand loading.

For more information, see "Large Result Sets" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<lrs-size>query</lrs-size>

lru-data-cache

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    data-caches

Function

Sets the least-recently-used (LRU) data caching option. For more information, see "Configuring the LRU Caching Option" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<data-caches>
    <lru-data-cache>
        <name>kodo.DataCache</name>
        <cache-size>1000</cache-size>
        <soft-reference-size>0</soft-reference-size>
        <eviction-schedule>15,45 15 * * 1</eviction-schedule>
    </lru-data-cache>
</data-caches>

manage-lru

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    inverse-manager

Function

Flag that specifies whether large result set fields are included from management. For more information, see "Managed Inverses" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<manage-lrs>false</manage-lrs>

mapping

Range of values: String

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    orm-filie-mapping-factory

Function

When a child element of persistence-configuration-unit, specifies the symbolic name of the object-to-datastore mapping to use. For more information, see "Mapping Metadata" (JPA) or "Mapping Metadata Placement" (JDO) in Kodo 4.2.0 Developers Guide for JPA/JDO.

When a child element of orm-file-jdor-mapping-factory, specifies the logical name of these mappings. Mapping files are suffixed with logicalname.orm. If not specified, the kodo.Mapping configuration property is used. For more information, see "Mapping Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<mapping>org/mag/Magazine-hsql.orm</mapping>

mapping-column

Range of values: String

Default value: MAPPING_DEF

Parent elements:

persistence-configuration
  persistence-configuration-unit
    table-deprecated-jdo-mapping-factory

persistence-configuration
  persistence-configuration-unit
    table-jdor-mapping-factory

Function

Specifies the name of the column that holds the XML mapping. For more information, see "Mapping Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<mapping-column>MAPPING_DEF</mapping-column>

mapping-defaults-impl

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configures the mapping defaults if you set default-mapping-defaults to jdo. For a complete description of each of the values that you can specify, see "Mapping Defaults" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<mapping-defaults-impl>
    <use-class-criteria>false</use-class-criteria>
    <base-class-strategy>ColumnPerLockGroupVersionStrategy</base-class-strategy>
    <version-strategy>version-number</version-strategy>
    <discriminator-column-name>test</discriminator-column-name>
    <subclass-strategy>vertical</subclass-strategy>
    <index-version>false</index-version>
    <index-logical-foreign-keys>true</index-logical-foreign-keys>
    <null-indicator-column-name>null</null-indicator-column-name>
    <foreign-key-delete-action></foreign-key-delete-action>
    <join-foreign-key-delete-action>1</join-foreign-key-delete-action>
    <discriminator-strategy>final</discriminator-strategy>
    <defer-constraints>false</defer-constraints>
    <field-strategies>none</field-strategies>
    <version-column-name>version</version-column-name>
    <data-store-id-column-name>ID</data-store-id-column-name>
    <index-discriminator>true</index-discriminator>
    <store-enum-ordinal>false</store-enum-ordinal>
    <order-lists>true</order-lists>
    <order-column-name>false</order-column-name>
    <add-null-indicator>false</add-null-indicator>
    <store-unmapped-object-id-string>false</store-unmapped-object-id-string>
</mapping-defaults-impl>

mapping-file-deprecated-jdo-mapping-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

A plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.meta.MetaDataFactory to use to store and retrieve object-relational mapping information for your persistent classes. This setting is valid for JDO 1.0. For more information, see "Mapping Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<mapping-file-deprecated-jdo-mapping-factory>
    <use-schema-validation>true</use-schema-validation>
    <urls>t3://localhost:7001/metadata.jar</urls>
    <files>com/file1;com/file2</files>
    <classpath-scan>build</classpath-scan>
    <single-file>false</single-file>
    <types>classname1;classname2</types>
    <store-mode>1</store-mode>
    <strict></strict>
    <resources>com/aaa/package.jdo;com/bbb/package.jdo</resources>
    <scan-top-down>false</scan-top-down>
</mapping-file-deprecated-jdo-mapping-factory>

max-active

Range of values: Integer

Default value: 2

Parent elements:

persistence-configuration
  persistence-configuration-unit
    tcp-remote-commit-provider

Function

Specifies the maximum allowed number of TCP sockets (channels) to open simultaneously between each peer in the cluster. For more information, see "TCP" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<max-active>2</max-active>

max-idle

Range of values: Integer

Default value: 2

Parent elements:

persistence-configuration
  persistence-configuration-unit
    tcp-remote-commit-provider

Function

Specifies the maximum allowed number of TCP sockets (channels) to open simultaneously between each peer in the cluster. For more information, see "TCP" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<max-idle>2</max-idle>

max-size

Range of values: Integer

Default value: 2147483647

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Defines the maximum size of the concurrent hash map used to associate query strings and their parsed form. For more information, see "Query Compilation Cache" in the Kodo 4.2.0 Developers Guide for JPA/JDOv.

Example

<max-size>2147483647</max-size>

maximize-batch-size

Range of values: true | false

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit
    constraint-update-manager

persistence-configuration
  persistence-configuration-unit
    batching-operation-order-update-manager

persistence-configuration
  persistence-configuration-unit
    table-lock-update-manager

Function

Flag that specifies whether to sort statements in order to optimize batch size when statement batching is on. For more information, see "kodo.jdbc.UpdateManager" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<maximize-batch-size>true</maximize-batch-size>

MBeanServerStrategy

Range of values: any-create | create | agentID:<agentID>

Default value: any-create

Parent elements:

jmx
    local-jmx

Function

If JMX-based management is enabled, Kodo needs to locate an existing MBeanServer or create a new one, based on one of the following options:

  • any-create—Locate an existing MBeanServer. If multiple are found, use the first one. If none are found, create a new server. This is the default.

  • create—Create a new server. Do not attempt to find an existing MBeanServer.

  • agentId:<agentID>—Locate an existing MBeanServer with the given agent id. If not found, create a new server.

For more information, see "Optional Parameters in Management Group" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<MBeanServerStrategy>any-create</MBeanServerStrategy>

multithreaded

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-broker

Function

Flag that specifies whether persistent instances and Kodo components are accessed by multiple threads at once. For more information, see "kodo.Multithreaded" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<multithreaded>false</multithreaded>

mx4j1-jmx

Range of values: N/A

Default value: N/A

Parent elements:

jmx

Function

Enable remote management via MX4J v.1.x implementations (supporting versions of the JMX specification prior to 1.2). Supports optional parameters in the Management Group and the Remote Group, as described in "Optional Parameters in Management Group" and "Optional Parameters in Remote Group" in the Kodo 4.2.0 Developers Guide for JPA/JDO, respectively.

Example

<mx4j1-jmx>
    <MBeanServerStrategy>any-create</MBeanServerStrategy>
    <EnableLogMBean>true</EnableLogMBean>
    <EnableRuntimeMBean>true</EnableRuntimeMBean>
    <Host>localhost</Host>
    <Port>1099</Port>
    <JNDIName>jrmp</JNDIName>
</mx4j1-jmx>

mysql-dictionary

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configuration values for the MySQL Dictionary persistence plugin. For a complete description of each of the values that you can specify, see "MySQL Dictionary Configuration" in the Oracle WebLogic Server Administration Console Help.

Example

The mysql-dictionary element shares the same subelements as access-dictionary, plus the following subelements (defaults shown):

<mysql-dictionary>
...
   <table-type>innodb</table-type>
   <use-clobs>true</use-clobs>
   <driver-deserializes-blobs>true</driver-deserializes-blobs>
</mysql-dictionary>

name

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    data-cache

persistence-configuration
  persistence-configuration-unit
    db-dictionary

persistence-configuration
  persistence-configuration-unit
    jms-remote-commit-provider

persistence-configuration
  persistence-configuration-unit
    property-type

persistence-configuration
  persistence-configuration-unit
    query-cache

persistence-configuration
  persistence-configuration-unit
    single-jvm-remote-commit-provider

persistence-configuration
  persistence-configuration-unit
    tcp-remote-commit-provider

persistence-configuration
  persistence-configuration-unit
    cluster-remote-commit-provider

Function

Specifies the name of the corresponding element.

name-column

Range of values: String

Default value: Name

Parent elements:

persistence-configuration
  persistence-configuration-unit
    table-deprecated-jdo-mapping-factory

persistence-configuration
  peristence-configuration-unit
    table-jdor-mapping-factory

Function

Name of the column that holds the mapping name. For class mappings, the mapping name is the class name. For named queries and sequences, it is the sequence or query name. For more information, see "Mapping Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<name-column>NAME</name-column>

NamingImpl

Range of values: Valid classname

Default value: N/A

Parent elements:

jmx
    jmx2-jmx

Function

Classname of the naming service implementation to start in order to register the RMI connector with a JNDI name. Defaults to mx4j.tools.naming.NamingService, which is appropriate for MX4J v. 2.x. If set to the empty string, no naming service will be started. This setting is appropriate if a naming service is already running, or if a non-RMI connector is used. For more information, see "Optional Parameters in JSR 160 Group" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<NamingImpl>mx4j.tools.naming.NamingService</NamingImpl>

native-jdbc-seq

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.kernel.Seq interface to use to create your own custom generators, in this case kodo.jdbc.kernel.NativeJDBCSeq.

Many databases have a concept of native sequences—a built-in mechanism for obtaining incrementing numbers. For example, in Oracle, you can create a database sequence with a statement like CREATE SEQUENCE MYSEQUENCE. Sequence values can then be atomically obtained and incremented with the statement SELECT MYSEQUENCE.NEXTVAL FROM DUAL. Kodo provides support for this common mechanism of sequence generation with the NativeJDBCSeq.

For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<native-jdbc-seq>
    <type>0</type>
    <allocate>50</allocate>
    <table-name>DUAL</table-name>
    <initial-value>1</intial-value>
    <sequence>OPENJPA_SEQUENCE</sequence>
    <sequence-name>OPENJPA_SEQUENCE</sequence-name>
    <format>format</format>
    <increment>1</increment>
</native-jdbc-seq>

none-jmx

Range of values: N/A

Default value: N/A

Parent elements:

jmx

Function

No management is turned on. This is the default. For more information, see "Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<none-jmx/>

none-lock-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the kodo.kernel.NoneLockManager which does not perform any locking. For more information, see "Lock Manager" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<none-lock-manager/>

none-log-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Disable logging. For more information, see "Disable Logging" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<none-log-factory/>

none-orphaned-key-action

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.event.OrphanedKeyAction to invoke when Kodo discovers an orphaned datastore key, in this case kodo.event.NoneOrphanedKeyAction. In this case, Kodo ignores orphaned keys. For more information, see "Orphaned Keys" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<none-orphaned-key-action/>

none-profiling

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

profiling

Function

Turns off profiling of your code. For more information, see "Profiling" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<profiling>
  <none-profiling/>
</profiling>

nontransactional-read

Range of values: true | false

Default value:

persistence-configuration: false

kodo-broker: true

Parent elements:

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-broker

Function

Flag that specifies whether the Kodo runtime allows you to read data outside of a transaction. For more information, see "kodo.NontransacationalRead" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<nontransactional-read>true</nontransactional-read>

nontransactional-write

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-broker

Function

Flag that specifies whether the you can modify persistent objects and perform persistence operations outside of a transaction. Changes will take effect in the next transaction. For more information, see "kodo.NontransacationalWrite" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<nontransactional-write>false</nontransactional-write>

num-broadcast-threads

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    tcp-remote-commit-provider

Function

Specifies the number of threads to create for the purpose of transmitting events to peers. You should increase this value as the number of concurrent transactions increases. The maximum number of concurrent transactions is a function of the size of the connection pool. See the MaxActive property of kodo.ConnectionFactoryProperties in "Using the Kodo Data Source" in Kodo 4.2.0 Developers Guide for JPA/JDO. Setting a value of 0 will result in behavior where the thread invoking commit will perform the broadcast directly. For more information, see "TCP" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<num-broadcast-threads>2<num-broadcast-threads>

operation-order-update-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Defines an update manager that writes SQL in object-level operation order. For more information, see "kodo.jdbc.UpdateManager" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<operation-order-update-manager/>

optimistic

Range of values: true | false

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-broker

Function

Flag that specifies whether the datastore transactional mode is optimistic. For more information, see "kodo.Optimistic" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<optimistic>true</optimistic>

oracle-dictionary

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configuration values for the Oracle Dictionary persistence plugin. For a complete description of each of the values that you can specify, see "Oracle Dictionary Configuration" in the Oracle WebLogic Server Administration Console Help.

Example

The oracle-dictionary element shares the same subelements as access-dictionary, plus the following subelements (defaults shown):

<oracle-dictionary>
...
   <use-triggers-for-auto-assign>false</use-triggers-for-auto-assign>
   <auto-assign-sequence-name>false</auto-assign-sequence-name>
   <use-set-form-of-use-for-unicode>true</use-set-form-of-use-for-unicode>
</oracle-dictionary>

oracle-savepoint-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.kernel.SavepointManager to use for managing transaction savepoints, in this case the default which is kodo.jdbc.sql.OracleSavepointManager. This plugin operates similarly to jdbc3-savepoint-manager, but it uses Oracle-specific calls. This plugin requires using the Oracle JDBC driver and database, versions 9.2 or higher. This plugin implements savepoints by issuing a flush to the database. For more information, see "Savepoints" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<oracle-savepoint-manager/>

orm-file-jdor-mapping-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

A plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.jdo.jdbc.ORMFileJDORMappingFactory that stores mapping metadata in .orm files. This setting is valid for JDO 1.0. For more information, see "Mapping Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<orm-file-jdor-mapping-factory>
    <use-schema-validation>true</use-schema-validation>
    <mapping>mapping</mapping>
    <urls>t3://localhost:7001/metadata.jar</urls>
    <files>com/file1;com/file2</files>
    <classpath-scan>build</classpath-scan>
    <types>classname1;classname2</types>
    <store-mode>1</store-mode>
    <strict>false</strict>
    <resources>com/aaa/package.jdo;com/bbb/package.jdo</resources>
    <scan-top-down>false</scan-top-down>
</orm-file-jdor-mapping-factory>

order-dirty-objects

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    kodo-broker

Function

Flag that specifies whether Kodo maintains the order that changes were made to dirty objects when writing the changes back to the database.

Example

<order-dirty-objects>false</order-dirty-objects>

Password

Range of values: N/A

Default value: N/A

Parent elements:

jmx
  wls81-jmx

Function

Password that Kodo should use to access the WebLogic MBeanServer. This must be set. For more information, see "Optional Parameters in WebLogic 8.1 Group" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<Password>admin</Password>

persistence-configuration

Range of values: N/A

Default value: N/A

Parent elements: N/A

Function

Root element of the persistence deployment descriptor.

persistence-configuration-unit

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration

Function

Contains the deployment information for a persistence unit that is available in WebLogic Server.

pessimistic-lock-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the kodo.jdbc.kernel.PessimisticLockManager, which uses SELECT FOR UPDATE statements (or the database's equivalent) to lock the database rows corresponding to locked objects. This lock manager does not distinguish between read locks and write locks; all locks are write locks. For more information, see "Lock Manager" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<pessimistic-lock-manager>
    <version-check-on-read-lock>false</version-check-on-read-lock>
    <version-update-on-write-lock>false</version-update-on-write-lock>
</pessimistic-lock-manager>

persistence-mapping-defaults

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configures the mapping defaults if you set default-mapping-defaults to jpa. For a complete description of each of the values that you can specify, see "Mapping Defaults" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

The persistence-mapping-defaults element shares the same subelements as mapping-defaults-impl.

populate-data-cache

Range of values: true | false

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit
    kodo-broker

Function

Flag that specifies whether to populate the data cache. If your transaction will visit objects that you know are very unlikely to be accessed by other transactions, for example an exhaustive report run only once a month, you can turn off population of the datacache so that the transaction does not fill the entire data cache with objects that will not be accessed again.

Example

<populate-data-cache>true</populate-data-cache>

Port

Range of values: N/A

Default value: N/A

Parent elements:

jmx
  mx4j1-jmx

Function

Port on which the RMI registry naming service listens. Defaults to 1099. For more information, see "Optional Parameters in Remote Group" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<Port>1099</Port>

port

Range of values: Valid port

Default value: See below (depends on parent element)

Parent elements:

persistence-configuration
  persistence-configuration-unit
    tcp-transport

persistence-configuration
  persistence-configuration-unit
    tcp-remote-commit-provider

Function

Specifies the port on which the server will listen. This setting is used by clients, not by the server.

If the parent element is tcp-transport, the element defaults to 5637. For more information, see "Standalone Persistence Server" in Kodo 4.2.0 Developers Guide for JPA/JDO.

If the parent element is tcp-remote-commit-provider, the element defaults to 5636. For more information, see "TCP" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<port>5637</port>

postgres-dictionary

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configuration values for the Postgres Dictionary persistence plugin. For a complete description of each of the values that you can specify, see "Postgres Dictionary Configuration" in the Oracle WebLogic Server Administration Console Help.

Example

The postgres-dictionary element shares the same subelements as access-dictionary, plus the following subelements (defaults shown):

<postgres-dictionary>
...
   <all-sequences-sql>SELECT NULL AS SEQUENCE_SCHEMA, relname AS SEQUENCE_NAME FROM pg_class WHERE relkind='S'</all-sequence-sql>
   <named-sequences-from-all-schemas-sql>SELECT NULL AS SEQUENCE_SCHEMA, relname AS SEQUENCE_NAME FROM pg_class WHERE relkind='S' AND relname = ?"</named-sequences-from-all-schemas-sql>
   <all-sequences-from-one-schema-sql>SELECT NULL AS SEQUENCE_SCHEMA, relname AS SEQUENCE_NAME FROM pg_class, pg_namespace WHERE relkind='S' AND pg_class.relnamespace = pg_namespace.oid AND nspname = ?</all-sequences-from-one-schema-sql>
   <named-sequences-from-one-schema-sql>SELECT NULL AS SEQUENCE_SCHEMA, relname AS SEQUENCE_NAME FROM pg_class, pg_namespace WHERE relkind='S' AND pg_class.relnamespace = ?</named-sequences-from-one-schema-sql>
   <supports-set-fetch-size>true</supports-set-fetch-size>
</postgres-dictionary>

primary-key-column

Range of values: String

Default value: ID

Parent elements:

persistence-configuration
  persistence-configuration-unit
    class-table-jdbc-seq

persistence-configuration
  persistence-configuration-unit
    table-jdbc-seq

persistence-configuration
  persistence-configuration-unit
    table-schema-factory

persistence-configuration
  persistence-configuration-unit
    value-table-jdbc-seq

Function

Specifies the name of the table's numeric primary key column. For more information, see "Generators" or "Schema Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<primary-key-column>ID</primary-key-column>

primary-key-value

Range of values: String

Default value: DEFAULT

Parent elements:

persistence-configuration
  persistence-configuration-unit
    value-table-jdbc-seq

Function

Specifies the primary key that is used by this instance. For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<primary-key-value>DEFAULT</primary-key-value>

primary-keys

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    lazy-schema-factory

Function

Flag that specifies whether to read automatically primary key information during schema validation. For more information, see "Schema Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<primary-keys>false</primary-keys>

profiling

Range of values: N/A

Default value: N/A

Parent elements: N/A

Function

Enables you to configure profiling of your application code. For more information, see "Profiling" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<profiling>
    <export-profiling>
        <interval-millis>-1</interval-millis>
        <base-name>name</base-name>
    </export-profiling>
</profiling>
<profiling>
    <gui-profiling/>
</profiling>
<profiling>
    <local-profiling/>
</profiling>
<profiling>
    <none-profiling/>
</profiling>

profiling-proxy-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configures the profiling proxy manager. For more information, see "Custom Proxies" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<profiling-proxy-manager>
    <assert-allowed-type>false</assert-allowed-type>
    <track-changes>true</track-changes>
</profiling-proxy-manager>

properties

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
        aggregate-listener
            custom-aggregate-listener

persistence-configuration
  persistence-configuration-unit
    custom-broker-factory

persistence-configuration
  persistence-configuration-unit
    custom-broker-impl

persistence-configuration
  persistence-configuration-unit
    custom-class-resolver

persistence-configuration
  persistence-configuration-unit
    custom-compatibility

persistence-configuration
  persistence-configuration-unit
    custom-connection-decorator

persistence-configuration
  persistence-configuration-unit
    custom-data-cache

persistence-configuration
  persistence-configuration-unit
    custom-dictionary

persistence-configuration
  persistence-configuration-unit
    custom-driver-data-source

persistence-configuration
  persistence-configuration-unit
    custom-filter-listener

persistence-configuration
  persistence-configuration-unit
    custom-jdbc-listener

persistence-configuration
  persistence-configuration-unit
    custom-lock-manager

persistence-configuration
  persistence-configuration-unit
    custom-logType

persistence-configuration
  persistence-configuration-unit
    custom-mapping-defaults

persistence-configuration
  persistence-configuration-unit
    custom-meta-data-respository

persistence-configuration
  persistence-configuration-unit
    custom-orphaned-key-action

persistence-configuration
  persistence-configuration-unit
    custom-persistence-server

persistence-configuration
  persistence-configuration-unit
    custom-proxy-manager

persistence-configuration
  persistence-configuration-unit
    custom-query-cache

persistence-configuration
  persistence-configuration-unit
    custom-query-compilation

persistence-configuration
  persistence-configuration-unit
    custom-remote-commit-provider

persistence-configuration
  persistence-configuration-unit
    custom-savepoint-manager

persistence-configuration
  persistence-configuration-unit
    custom-seq

persistence-configuration
  persistence-configuration-unit
    custom-sql-factory

persistence-configuration
  persistence-configuration-unit
    custom-update-manager

Function

Specifies one or more property elements.

property

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    properties

Function

Enables you to specify the name and value of a property.

Example

<property>
   <name>timeout</name>
   <value>1000</value>
</property>

proxy-manger-impl

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configures the default proxy manager. For more information, see "Custom Proxies" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<proxy-manager-impl>
    <assert-allowed-type>false</assert-allowed-type>
    <track-changes>true</track-changes>
</proxy-manager-impl>

query-caches

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

A plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.datacache.QueryCache implementation to use for caching of queries loaded from the data store. For more information, see "Query Cache" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<query-caches>
    <default-query-cache>...</default-query-cache>
</query-caches>
<query-caches>
    <kodo-concurrent-query-cache>...</kodo-concurrent-query-cache>
</query-caches>
<query-caches>
    <gem-fire-query-cache>...</gem-fire-query-cache>
</query-caches>
<query-caches>
    <lru-query-cache>...</lru-query-cache>
</query-caches>
<query-caches>
    <tangosol-query-cache>...</tangosol-query-cache>
</query-caches>
<query-caches>
    <disabled-query-cache>...</disabled-query-cache>
</query-caches>
<query-caches>
    <custom-query-cache>...</custom-query-cache>
</query-caches>

quoted-numbers-in-queries

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    compatibility

Function

Flag that specifies whether to interpret quoted numbers in query strings as numbers, as opposed to strings. Set to true to mimic the behavior of Kodo 3.1 and earlier and treat quoted numbers as numbers. For more information, see "Compatibility Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<quoted-numbers-in-queries>false</quoted-numbers-in-queries>

read-lock-level

Range of values: none | read | write | numeric values for lock manager- specific lock levels

Default value: read

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Sets the default read level at which to lock objects retrieved during a non-optimistic transaction. Valid values include:

  • none—No lock level.

  • read—Read lock level.

  • write—Write lock level.

  • Numeric values for lock-manager specific lock levels.

    Note:

    For the default JDBC lock manager, the read and write lock levels are equivalent.

For more information, see "Object Locking" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<read-lock-level>read</read-lock-level>

recover-action

Range of values: none | clear

Default value: none

Parent elements:

persistence-configuration
  persistence-configuration-unit
    cluster-remote-commit-provider

Function

Specifies the action to take during recovery. Valid values include:

  • none—No action is performed.

  • clear—Clears the notifications.

For more information, see "Remote Commit Provider Configuration" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<recover-action>none</recover-action>

recovery-time-millis

Range of values: Integer

Default value: 15000

Parent elements:

persistence-configuration
  persistence-configuration-unit
    tcp-remote-commit-provider

Function

Specifies the amount of time to wait in milliseconds before attempting to reconnect to a peer of the cluster when connectivity to the peer is lost. For more information, see "TCP" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<recovery-time-millis>15000</recovery-time-millis>

resources

Range of values: Valid resource path

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    tangosol-data-cache

Function

Specifies a semicolon-separated list of resource paths to metadata files or jar archives. Each jar archive will be scanned for annotated JPA entities or JDO metadata files based on your metadata factory. For more information, see "Metadata Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<resources>com/aaa/package.jdo;com/bbb/package.jdo</resources>

restore-state

Range of values: true

persistence-configuration-unit: all | immutable | none | true | false

kodo-broker: 1 | 2 | 3 | 4 | 5

Default value: none

Parent elements:

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-broker

Function

Flag that specifies whether to restore managed fields to their pre-transaction values when a rollback occurs.

Valid values include:

  • all (1)—Restores all managed values.

  • none (2)—Do not roll back state. The object becomes hollow and will reload its state the next time it is accessed.

  • immutable (3)—Restores immutable values (primitives, primitive wrappers, strings) and clears mutable values so that they are reloaded on next access.

  • true (4)—Same as all.

  • false (5)—Same as none.

For more information, see "Restoring State" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<restore-state>none</restore-state>

result-set-type

Range of values: forward--only | scroll-sensitive | scroll-insensitive

Default value: forward-only

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the JDBC result set type to use when fetching return lists. This setting can also be varied at runtime.

Valid values include:

  • forward-only—Result set whose cursor may move only forward. The result set is not updatable.

  • scroll-sensitive—Scrollable result set that is sensitive to changes made by others. The result set is updatable.

  • scroll-insenstive—Scrollable result set that is not sensitive to changes made by others. The result set is updatable.

For more information, see "Large Result Sets" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<result-set-type>forward-only</result-set-type>

retain-state

Range of values: true | false

Default value: See below (depends on parent)

Parent elements:

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-broker

Function

Flag that specifies whether persistent fields retain their values on transaction commit. This element defaults to true when a child element of the persistence-configuration-unit and false when a child element of the kodo-broker element.

For more information, see "kodo.RetainState" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<retain-state>true</retain-state>

retry-class-registration

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Flag that specifies whether to log a warning and defer registration instead of throwing an exception when a persistent class cannot be fully processed. This element should only be used in complex classloader situations where security is preventing Kodo from reading registered classes. Setting this to true unnecessarily may obscure more serious problems. For more information, see "kodo.RetryClassRegistration" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<retry-class-registration>false</retry-class-registration>

scan-top-down

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    deprecated-jdo-meta-data-factory
 
persistence-configuration
  persistence-configuration-unit
    extension-deprecated-jdo-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    jdo-meta-data-factory
 
persistence-configuration
  persistence-configuration-unit
    jdor-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    mapping-file-deprecated-jdo-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    orm-file-jdor-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    table-deprecated-jdo-mapping-factory

Function

Flag that specifies whether to search for metadata files top-down in the package tree. Kodo defaults to bottom-up scanning. For example, when scanning metadata for class C, Kodo looks first for C.jdo, then package.jdo in C's package, then package.jdo in the parent package, and so on to the package root. For more information, see "Metadata Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<scan-top-down>false</scan-top-down>

schema

Range of values: String

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the default schema name to prepend to unqualified table names. In addition, specifies the schema in which Kodo creates new tables. For more information, see "Default Schema" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<schema>SCHEMA</schema>

schema-column

Range of values: String

Default value: SCHEMA_DEF

Parent elements:

persistence-configuration
  persistence-configuration-unit
    table-schema-factory

Function

Specifies the name of the table's string column for holding the schema definition as an XML string. For more information, see "Schema Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<schema-column>SCHEMA_DEF</schema-column>

schemas

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a comma-separated list of the schemas and/or tables used for your persistent data. For more information, see "Schemas List" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<schemas>BUSOBJS,GENERAL.ADDRESS,.SYSTEM_INFO </schemas>

sequence

Range of values: N/A

Default value: OPENJPA_SEQUENCE

Parent elements:

persistence-configuration
  persistence-configuration-unit
    native-jdbc-seq

Function

Specifies the name of the database sequence. For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<sequence>OPENJPA_SEQUENCE</sequence>

sequence-column

Range of values: String

Default value: SEQUENCE_VALUE

Parent elements:

persistence-configuration
  persistence-configuration-unit
    class-table-jdbc-seq

persistence-configuration
  persistence-configuration-unit
    table-jdbc-seq

persistence-configuration
  persistence-configuration-unit
    value-table-jdbc-seq

Function

Specifies the name of the column that holds the current sequence value. For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<sequence-column>SEQUENCE_VALUE</sequence-column>

sequence-name

Range of values: String

Default value: OPENJPA_SEQUENCE

Parent elements:

persistence-configuration
  persistence-configuration-unit
    native-jdbc-seq

Function

Specifies the name of the database sequence. For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<sequence-name>OPENJPA_SEQUENCE</sequence-name>

ServiceURL

Range of values: Valid service URL

Default value: service:jmx:rmi://localhost/jndi/jmxservice

Parent elements:

jmx
  jmx2-jmx

Function

JMX service URL name under which to register the JMX Connector Server. This value defaults to service:jmx:rmi://localhost/jndi/jmxservice, indicating that the RMI connector will be used and registered under the JNDI name jmxsevice. For more information, see "Optional Parameters in JSR 160 Group" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<ServiceURL>service:jmx:rmi://localhost/jndi/jmxservice</ServiceURL>

simple-driver-data-source

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configures the Kodo datasource implementation. For more information, see "Using the Kodo DataSource" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<simple-driver-data-source>
    <connection-user-name>user</connection-user-name>
    <login-timeout>10</login-timeout>
    <connection-password>password</connection-password>
    <connection-url>jdbc:hsqldb:db-hypersonic</connection-url>
    <connection-driver-name>org.hsqldb.jdbcDrier</connection-driver-name>
</simple-driver-data-source>

single-file

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    mapping-file-deprecated-jdo-mapping-factory

Function

Flag specifying whether or not to use a single file.

Example

<single-file>false</single-file>

single-jvm-exclusive-lock-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the kodo.kernel.SingleJVMExclusiveLockManager. This lock manager uses in-memory mutexes to obtain exclusive locks on object ids. It does not perform any database-level locking. Also, it does not distinguish between read and write locks; all locks are write locks. For more information, see "Lock Manager" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<single-jvm-exclusive-lock-manager>
    <version-check-on-read-lock>false</version-check-on-read-lock>
    <version-check-on-write-lock>false</version-check-on-write-lock>
</single-jvm-exclusive-lock-manager>

single-jvm-remote-commit-provider

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configures Kodo to share commit notifications among persistenceManagerFactories in the same JVM. For more information, see "Remote Commit Provider Configuration" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<single-jvm-remote-commit-provider>
    <name>kodo.RemoteCommitProvider</name>
</single-jvm-remote-commit-provider>

soft-reference-size

Range of values: Integer

Default value: -1

Parent elements:

persistence-configuration
  persistence-configuration-unit
    kodo-concurrent-data-cache
 
persistence-configuration
  persistence-configuration-unit
    kodo-concurrent-query-cache
 
persistence-configuration
  persistence-configuration-unit
    lru-data-cache
 
persistence-configuration
  persistence-configuration-unit
    lru-query-cache
 
persistence-configuration
  persistence-configuration-unit
    query-compilation-cache

Function

Sets the number of soft references that Kodo maintains. When the maximum cache or query size is reached, random entries are moved to a soft reference map so that they are maintained for awhile longer. By default, this value is set to -1 which specifies that an unlimited number of soft references are maintained. Set the property to 0 to disable soft references. For more information, see "Configuring the Data Cache Size" and "Query Cache" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<soft-reference-size>-1</soft-reference-size>

so-timeout

Range of values: Integer

Default value: 0

Parent elements:

persistence-configuration
  persistence-configuration-unit
    http-transport

Function

Specifies the socket read timeout in milliseconds. For more information, see "Standalone Persistence Server" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<so-timeout>0</so-timeout>

sql-server-dictionary

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configuration values for the SQLServer Dictionary persistence plugin. For a complete description of each of the values that you can specify, see "SQLServer Dictionary Configuration" in the Oracle WebLogic Server Administration Console Help.

Example

The sql-server-dictionary element shares the same subelements as access-dictionary, plus the following subelements (defaults shown):

<sql-server-dictionary>
...
   <unique-identifier-as-varbinary>true</unique-identifier-as-varbinary>
</sql-server-dictionary>

stack-execution-context-name-provider

Range of values: N/A

Default value: N/A

Parent elements:

execution-context-name-provider

Function

Provider examines the current thread's stack and builds an execution context name based on that information. For more information, see "Configuring the Execution Context Name Provider" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<stack-execution-context-name-provider> 
    <style>full</style>
</stack-execution-context-name-provider>

store-mode

Range of values: Integer

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    deprecated-jdo-meta-data-factory
 
persistence-configuration
  persistence-configuration-unit
    extension-deprecated-jdo-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    jdo-meta-data-factory
 
persistence-configuration
  persistence-configuration-unit
    jdor-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    kodo-persistence-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    kodo-persistence-meta-data-factory
 
persistence-configuration
  persistence-configuration-unit
    mapping-file-deprecated-jdo-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    orm-file-jdor-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    table-deprecated-jdo-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    table-jdor-mapping-factory

Function

Specifies the data store mode.

Example

<store-mode>1</store-mode>

strict

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    deprecated-jdo-meta-data-factory
 
persistence-configuration
  persistence-configuration-unit
    extension-deprecated-jdo-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    jdo-meta-data-factory
 
persistence-configuration
  persistence-configuration-unit
    jdor-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    kodo-persistence-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    kodo-persistence-meta-data-factory
 
persistence-configuration
  persistence-configuration-unit
    mapping-file-deprecated-jdo-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    orm-file-jdor-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    table-deprecated-jdo-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    table-jdor-mapping-factory

Function

Flag that specifies whether strict mode is enabled.

Example

<strict>true</strict>

strict-identity-values

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    compatibility

Function

Flag that specifies whether to require identity values used for finding application identity instances to be of the exact right type. By default, Kodo allows stringified identity values, and performs conversions between numeric types. For more information, see "Compatibility Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<strict-identity-values>false</strict-identity-values>

style

Range of values: line | partial | full

Default value: N/A

Parent elements:

execution-context-name-provider
  stack-execution-context-name-provider

Function

Provider examines the current thread's stack and builds an execution context name based on that information and the following setting:

  • line—Name will be the first non-Kodo stack line, including class name, method name, and line number, if available.

  • partial—Full stack trace minus the Kodo lines will be used.

  • full—Entire stack trace will be used.

For more information, see "Configuring the Execution Context Name Provider" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<style>full</style>

subclass-fetch-mode

Range of values: join | multiple | none | parallel | single

Default value: join

Parent elements:

execution-context-name-provider
  stack-execution-context-name-provider

Function

Specifies the method to use to select subclass data when it is in other tables. For a description of the valid values, see under eager-fetch-mode. For complete details, see "Eager Fetching" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<subclass-fetch-mode>join</subclass-fetch-mode>

sybase-dictionary

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configuration values for the Sybase Dictionary persistence plugin. For a complete description of each of the values that you can specify, see "Sybase Dictionary Configuration" in the Oracle WebLogic Server Administration Console Help.

Example

The sybase-dictionary element shares the same subelements as access-dictionary, plus the following subelements (defaults shown):

<sybase-dictionary>
...
   <create-identity-column>true</create-identity-column>
   <identity-column-name>UNQ_INDEX</identity-column-name>
</sybase-dictionary>

sync-with-managed-transactions

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    kodo-broker

Function

Flag that specifies whether to sync with managed transactions. For more information, see "kodo.BrokerImpl" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<sync-with-managed-transactions>false</sync-with-managed-transactions>

synchronize-mappings

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration

Function

Controls whether Kodo attempts to run the mapping tool on all persistent classes to synchronize their mappings and schema at runtime. This element save you the trouble of running the mapping tool manually, and is useful for rapid test and debug cycles. For more information, see "Runtime Forward Mapping" in Kodo Developer's Guide.

Example

<synchronize-mappings>false</synchronize-mappings>

table

Range of values: String

Default value: See below

Parent elements:

persistence-configuration
  persistence-configuration-unit
    class-table-jdbc-seq
 
persistence-configuration
  persistence-configuration-unit
    table-jdbc-seq
 
persistence-configuration
  persistence-configuration-unit
    table-jdor-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    table-schema-factory
 
persistence-configuration
  persistence-configuration-unit
    value-table-jdbc-seq

Function

Specifies the name of the table. For more information, see "Mapping Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO. The default value depends on the parent element:

  • class-table-jdbc-seq: OPENJPA_SEQUENCE_TABLE

  • table-jdbc-seq: OPENJPA_SEQUENCE_TABLE

  • table-jdor-mapping-factory: KODO_JDO_MAPPINGS

  • table-schema-factory: OPENJPA_SCHEMA

  • value-table-jdbc-seq: OPENJPA_SEQUENCES_TABLE

Example

<table>KODO_JDO_MAPPING</table>

table-deprecated-jdo-mapping-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

A plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.jdo.jdbc.TableJDORMappingFactory that stores mapping metadata as XML strings in a database table. This setting is valid for JDO 1.0. For more information, see "Mapping Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<table-deprecated-jdo-mapping-factory>
    <table-name>JDO_MAPPING</table-name>
    <urls>t3://localhost:7001/metadata.jar</urls>
    <classpath-scan>build</classpath-scan>
    <types>classname1;classname2</types>
    <mapping-column>MAPPING_DEF</mapping-column>
    <store-mode></store-mode>
    <strict>false</strict>
    <name-column>NAME</name-column>
    <use-schema-validation>false</use-schema-validation>
    <single-row>false</single-row>
    <files>com/file1;com/file2</files>
    <scan-top-down>false</scan-top-down>
    <resources>com/aaa/package.jdo;com/bbb/package.jdo</resources>
</table-deprecated-jdo-mapping-factory>

table-jdbc-seq

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.kernel.Seq interface to use to create your own custom generators, in this case kodo.jdbc.kernel.TableJDBCSeq.

The TableJDBCSeq uses a special single-row table to store a global sequence number. If the table does not already exist, it is created the first time you run the mapping tool's on a class that requires it. You can also use the class' main method or the sequencetable shell/bat script to manipulate the table; see the TableJDBCSeq.main method Javadoc for usage details. For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<table-jdbc-seq>
    <type>0</type>
    <allocate>50</allocate>
    <table-name>OPENJPA_SEQUENCE_TABLE</table-name>
    <table>OPENJPA_SEQUENCE_TABLE</table>
    <primary-key-column>ID</primary-key-column>
    <sequence-column>SEQUENCE_VALUE</sequence-column>
    <increment>1</increment>
</table-jdbc-seq>

table-jdor-mapping-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

A plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.jdo.jdbc.TableJDORMappingFactory that stores mapping metadata as XML strings in a database table. This setting is valid for JDO 2.0. For more information, see "Mapping Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<table-jdor-mapping-factory>
    <use-schema-validation>false</use-schema-validation>
    <type-column>0</type-column>
    <constraint-names>false</constraint-names>
    <table>KODO_JDO_MAPPINGS</table>
    <types>classname1;classname2</types>
    <store-mode></store-mode>
    <mapping-column>false</mapping-column>
    <strict>false</strict>
    <name-column>NAME</name-column>
</table-jdor-mapping-factory>

table-lock-update-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Defines an update manager capable of statement batching, that ignores foreign keys and autoincrement, but optimizes for table level locking. This is useful when using table-level locking and trying to avoid deadlocks. For more information, see "kodo.jdbc.UpdateManager" and "Statement Batching" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<table-lock-update-manager>
    <maximize-batch-size>true</maximize-batch-size>
</table-lock-update-manager>

table-name

Range of values: String

Default value: See below

Parent elements:

persistence-configuration
  persistence-configuration-unit
    class-table-jdbc-seq
 
persistence-configuration
  persistence-configuration-unit
    native-jdbc-seq
 
persistence-configuration
  persistence-configuration-unit
    table-deprecated-jdo-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    table-jdbc-seq
 
persistence-configuration
  persistence-configuration-unit
    table-schema-factory
 
persistence-configuration
  persistence-configuration-unit
    value-table-jdbc-seq

Function

Specifies the name of the table.

The default varies based on the parent element, as follows:

Example

<table-name>JDO_MAPPING</table-name>

table-schema-factory

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.jdbc.schema.SchemaFactory to use to store and retrieve information about the database schema, in this case kodo.jdbc.schema.TableSchemaFactory.

This schema factory stores schema information as an XML document in a database table it creates for this purpose. If your JDBC driver doesn't support the java.sql.DatabaseMetaData standard interface, but you still want some schema validation to occur at runtime, you might use this factory. It is not recommended for most users, though, because it is easy for the stored XML schema definition to get out-of-sync with the actual database.

For more information, see "Schema Factory" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<table-schema-factory>
    <schema-column>SCHEMA_DEF</schema-column
    <table-name>OPENJPA_SCHEMA</table-name>
    <table>OPENJPA_SCHEMA</table>
    <primary-key-column>ID</primary-key-column>
</table-schema-factory>

tangosol-cache-name

Range of values: String

Default value: kodo

Parent elements:

persistence-configuration
  persistence-configuration-unit
    tangosol-data-cache

Function

Name of the Tangosol Coherence cache to use. For more information, see "Tangosol Integration" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<tangosol-cache-name>kodo</tangosol-cache-name>

tangosol-cache-type

Range of values: named | distributed | replicated

Default value: named

Parent elements:

persistence-configuration
  persistence-configuration-unit
    tangosol-data-cache

persistence-configuration
  persistence-configuration-unit
    tangosol-query-cache

Function

Type of Tangosol Coherence cache to use. Valid values include:

  • named—Cache is looked up via the com.tangosol.net.CacheFactory.getCache(String) method. This method looks up the cache by the name as defined in the Coherence configuration.

  • distributed

  • replicated

For more information, see "Tangosol Integration" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<tangosol-cache-type>name</tangosol-cache-type>

tangosol-data-cache

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    data-caches

Function

Integrates with Tangosol's Coherence caching system. For more information, see "Tangosol Integration" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<data-caches>
    <tangosol-data-cache>
        <name>kodo.dataCache</name>
        <clear-on-close>false</clear-on-close>
        <tangosol-cache-type>name</tangosol-cache-type>
        <tangosol-cache-name>kodo</tangosol-cache-name>
        <eviction-schedule>15,45 15 * * 1</eviction-schedule>
    </tangosol-data-cache>
</data-caches>

tcp-remote-commit-provider

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Configures the TCP remote commit provider. For more information, see "TCP" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<tcp-remote-commit-provider>
    <name>kodo.RemoteCommitProvider</name>
    <max-idle>2</max-idle>
    <num-broadcast-threads>2<num-broadcast-threads>
    <recovery-time-millis>15000</recovery-time-millis>
    <max-active>2</max-active>
    <port>5636</port>
    <addresses>[]</addresses>
</tcp-remote-commit-provider>

tcp-transport

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the transport layer for the remote communication. For more information, see "Standalone Persistence Server" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<tcp-transport>
    <so-timeout>0</so-timeout>
    <host>localhost</host>
    <port>5637</port>
</tcp-transport>

time-seeded-seq

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.kernel.Seq interface to use to create your own custom generators, in this case kodo.jdbc.kernel.TimeSeededSeq.

This type uses an in-memory static counter, initialized to the current time in milliseconds and monotonically incremented for each value requested. It is only suitable for single-JVM environments. For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<time-seeded-seq>
    <type>0</type>
    <increment>1</increment>
</time-seeded-seq>

topic

Range of values: Valid topic

Default value: topic/KodoCommitProviderTopic

Parent elements:

persistence-configuration
  persistence-configuration-unit
    jms-remote-commit-provider

Function

Specifies the topic to which the remote commit provider should publish notifications and subscribe for notifications sent from other JVMs. For more information, see "JMS" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<topic>topic/KodoCommitProviderTopic</topic>

topic-connection-factory

Range of values: Valid connection factory

Default value: java:/ConnectionFactory

Parent elements:

persistence-configuration
  persistence-configuration-unit
    jms-remote-commit-provider

Function

Specifies the JNDI name of a javax.jms.TopicConnectionFactory factory to use for finding topics. This setting may vary depending on the application server in use; consult the application server's documentation for details about the default JNDI name for the topic instance. For WebLogic, the JNDI name for the TopicConnectionFactory is javax.jms.TopicConnectionFactory. For more information, see "JMS" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<topic-connection-factory>java:/ConnectionFactory</topic-connection-factory>

track-changes

Range of values: true | false

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Flag that specifies whether to use smart proxies. For more information, see "Custom Proxies" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<track-changes>true</track-changes>

transaction-isolation

Range of values: default | none | read-committed | read-uncommitted | repeatable-read | serializable

Default value: default

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the JDBC transaction isolation level to use.

  • default—JDBC driver's default level. This is the default.

  • none—No transaction isolation.

  • read-committed—Dirty reads are prevented; non-repeatable reads and phantom reads can occur.

  • read-uncommitted—Dirty reads, non-reputable reads, and phantom reads can occur.

  • repeatable-read—Dirty reads and non-repeatable reads are prevented; phantom reads can occur.

  • serializable—Dirty reads, non-reputable reads, and phantom reads are prevented.

For more information, see "Setting the Transaction Isolation" in Kodo Developer's Guide.

Example

<transaction-isolation>default</transaction-isolation>

transaction-mode

Range of values: local | managed

Default value: local

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the transaction mode to use. You can override this setting per session.

  • local—Perform transaction operations locally. This is the default.

  • managed—Integrate with the application server's managed global transactions.

For more information, see "Integrating with the Transaction Manager" in Kodo Developer's Guide.

Example

<transaction-mode>local</transaction-mode>

transaction-name-execution-context-name-provider

Range of values: N/A

Default value: N/A

Parent elements:

execution-context-name-provider

Function

Provider returns the current transaction's name, as defined by WebLogic transaction naming semantics. For more information, see "Configuring the Execution Context Name Provider" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<transacation-name-execution-context-name-provider/>

type

Range of values: N/A

Default value: 0

Parent elements:

persistence-configuration
  persistence-configuration-unit
    class-table-jdbc-seq
 
persistence-configuration
  persistence-configuration-unit
    native-jdbc-seq
 
persistence-configuration
  persistence-configuration-unit
    table-jdbc-seq
 
persistence-configuration
  persistence-configuration-unit
    time-seeded-seq
 
persistence-configuration
  persistence-configuration-unit
    value-table-jdbc-seq

Function

Specifies the type of generator. For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<type>0</type>

type-column

Range of values: 0 | 1 | 2 | 3

Default value: 0

Parent elements:

persistence-configuration
  persistence-configuration-unit
    table-jdor-mapping-factory

Function

Specifies the name of the column that holds the mapping type. Valid types constants include:

  • 0—Class mapping.

  • 1—Named sequence.

  • 2—System-level named query.

  • 3—Class-level named query.

For more information, see "Mapping Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<type-column>0</type-column>

types

Range of values: Valid persistent class names

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    tangosol-data-cache

Function

Specifies a semicolon-separated list of fully-qualified persistent class names. For more information, see "Metadata Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<types>classname1; classname2</types>

URL

Range of values: Valid URL

Default value: t3://localhost:7001

Parent elements:

jmx
  wls81-jmx

Function

URL to which Kodo should connect to access the WebLogic MBeanServer. For more information, see "Optional Parameters in WebLogic 8.1 Group" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<URL>t3://localhost:7001</URL>

url

Range of values: Valid URL

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    http-transport

Function

URL to which Kodo should connect to access the remote server. For more information, see "Client Managers" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<url>t3://localhost:7001/remote-server</url>

urls

Range of values: Valid URL

Default value: t3://localhost:7001

Parent elements:

persistence-configuration
  persistence-configuration-unit
    deprecated-jdo-meta-data-factory
 
persistence-configuration
  persistence-configuration-unit
    extension-deprecated-jdo-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    jdo-meta-data-factory
 
persistence-configuration
  persistence-configuration-unit
    jdor-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    kodo-persistence-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    kodo-persistence-meta-data-factory
 
persistence-configuration
  persistence-configuration-unit
    mapping-file-deprecated-jdo-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    orm-file-jdor-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    table-deprecated-jdo-mapping-factory

Function

Specifies a semicolon-separated list of URLs of metadata files or jar archives. Each jar archive will be scanned for annotated JPA entities or JDO metadata files based on your metadata factory. For more information, see "Metadata Factory" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<urls>t3://localhost:7001/metadata.jar</urls>

use-aliases

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    class-table-jdbc-seq

Function

Flag that specifies whether to use each class' entity name as the primary key value of each row rather than the full classname. For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<use-aliases>false</use-aliases>

use-schema-validation

Range of values: true | false

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit
    deprecated-jdo-meta-data-factory
 
persistence-configuration
  persistence-configuration-unit
    extension-deprecated-jdo-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    jdo-meta-data-factory
 
persistence-configuration
  persistence-configuration-unit
    jdor-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    mapping-file-deprecated-jdo-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    orm-file-jdor-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    table-deprecated-jdo-mapping-factory
 
persistence-configuration
  persistence-configuration-unit
    table-jdor-mapping-factory

Function

Flag that specifies whether to use schema validation.

Example

<use-schema-validation>true</use-schema-validation>

user-object-execution-context-name-provider

Range of values: N/A

Default value: N/A

Parent elements:

execution-context-name-provider

Function

Provider returns the user object specified in the current EntityManager/PersistenceManager whose key is com.solarmetric.profile.ExecutionContextNameProvider. User objects can be set using the OpenJPAEntityManager.putUserObject(Object,Object) or PersistenceManager.putUserObject(Object,Object). For more information, see "Configuring the Execution Context Name Provider" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<user-object-execution-context-name-provider/>

UserName

Range of values: N/A

Default value: N/A

Parent elements:

jmx
  wsl81-jmx

Function

Specifies the username that Kodo should use to access the WebLogic MBeanServer. This must be set. For more information, see "Optional Parameters in WebLogic 8.1 Group" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<wls81-jmx>
    <MBeanServerStrategy>any-create</MBeanServerStrategy>
    <EnableLogMBean>true</EnableLogMBean>
    <EnableRuntimeMBean>true</EnableRuntimeMBean>
    <URL>t3://localhost:7001</URL>
    <UserName>admin</UserName>
    <Password>admin</Password>
</wls81-jmx>

validate-false-returns-hollow

Range of values: true | false

Default value: true

Parent elements:

persistence-configuration
  persistence-configuration-unit
    compatibility

Function

Flag that specifies whether to return hollow objects (objects for which no state has been loaded) from calls to PersistenceManager.getObjectById(oid, false). This is the default behavior of Kodo 4.0 and above. Previous Kodo versions, however, always loaded the object from the datastore. Set this property to false to get the old behavior.

For more information, see "Compatibility Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<validate-false-returns-hollow>true</validate-false-returns-hollow>

validate-true-checks-store

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    compatibility

Function

Flag that specifies whether to check the datastore to be sure the given oid exists. Prior to Kodo 4.0, calling PersistenceManager.getObjectById(oid, true) always checked the datastore to be sure the given oid existed, even when the corresponding object was already cached. Kodo 4.0 and above does not check the datastore when the instance is already cached and loaded. Set this property to true to mimic previous behavior.

For more information, see "Compatibility Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<validate-true-checks-store>false</validate-true-checks-store>

value-table-jdbc-seq

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies a plugin string (see "Plugin Configuration" in Kodo 4.2.0 Developers Guide for JPA/JDO) describing the kodo.kernel.Seq interface to use to create your own custom generators, in this case kodo.jdbc.kernel.ValueTableJDBCSeq.

This Seq is like the table-jdbc-seq, but has an arbitrary number of rows for sequence values, rather than a fixed pattern of one row per class. For more information, see "Generators" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<value-table-jdbc-seq>
    <type>0</type>
    <allocate>50</allocate>
    <table-name>OPENJPA_SEQUENCE_TABLE</table-name>
    <primary-key-value>DEFAULT</primary-key-value>
    <table>OPENJPA_SEQUENCE_TABLE</table>
    <primary-key-column>ID</primary-key-column>
    <sequence-column>SEQUENCE_VALUE</sequence-column>
    <increment>1</increment>
</value-table-jdbc-seq>

version-check-on-read-lock

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    pessimistic-lock-manager

Function

Specifies whether to perform version checking and incrementing behavior of the pessimistic lock manager on read operations. For more information, see "Lock Manager" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<version-check-on-read-lock>false</version-check-on-read-lock>

version-check-on-write-lock

Range of values: true | false

Default value: false

Parent elements:

persistence-configuration
  persistence-configuration-unit
    pessimistic-lock-manager

Function

Specifies whether to perform version checking and incrementing behavior of the pessimistic lock manager on write operations. For more information, see "Lock Manager" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<version-check-on-write-lock>false</version-check-on-write-lock>

version-lock-manager

Range of values: N/A

Default value: N/A

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Specifies the kodo.kernel.VersionLockManager. This lock manager does not perform any exclusive locking, but instead ensures read consistency by verifying that the version of all read-locked instances is unchanged at the end of the transaction. Furthermore, a write lock will force an increment to the version at the end of the transaction, even if the object is not otherwise modified. This ensures read consistency with non-blocking behavior. For more information, see "Lock Manager" in Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<version-lock-manager>
    <version-check-on-read-lock>false</version-check-on-read-lock>
    <version-check-on-write-lock>false</version-check-on-write-lock>
</version-lock-manager>

wls81-jmx

Range of values: N/A

Default value: N/A

Parent elements:

jmx

Function

Enable management and invoke the JMX management console in the local JVM. Supports optional parameters in the Management Group and WebLogic 8.1 Group, as described in "Optional Parameters in Management Group" and "Optional Parameters in WebLogic 8.1 Group" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<wls81-jmx>
    <MBeanServerStrategy>any-create</MBeanServerStrategy>
    <EnableLogMBean>true</EnableLogMBean>
    <EnableRuntimeMBean>true</EnableRuntimeMBean>
    <URL>t3://localhost:7001</URL>
    <UserName>admin</UserName>
    <Password>admin</Password>
</wls81-jmx>

write-lock-level

Range of values: none | read | write | numeric values for lock-manager specific lock leves

Default value: read

Parent elements:

persistence-configuration
  persistence-configuration-unit

Function

Sets the default write level at which to lock objects retrieved during a non-optimistic transaction. Valid values include:

  • none—No lock level.

  • read—Read lock level.

  • write—Write lock level.

  • Numeric values for lock-manager specific lock levels.

    Note:

    For the default JDBC lock manager, the read and write lock levels are equivalent.

For more information, see "Object Locking" in the Kodo 4.2.0 Developers Guide for JPA/JDO.

Example

<write-lock-level>read</write-lock-level>