B 永続性構成スキーマ・リファレンス

次の項では、Kodo固有のデプロイメント記述子persistence-configuration.xmlのネームスペース、スキーマの場所、ファイル構造、および要素について説明します。

• persistence-configuration.xmlのネームスペース宣言とスキーマの場所

• persistence-configuration.xmlデプロイメント記述子ファイルの構造

• persistence-configuration.xmlデプロイメント記述子の要素

persistence-configuration.xmlのネームスペース宣言とスキーマの場所

Kodoのpersistence-configuration.xmlファイルのネームスペース宣言とスキーマの場所を表す正確なテキストは次のとおりです。

<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デプロイメント記述子ファイルの構造

persistence-configuration.xmlデプロイメント記述子ファイルには、Oracle Kodoに固有な要素を記述します。

Kodoのpersistence-configuration.xmlの最上位要素は次のとおりです。

• persistence-configuration

  • persistence-configuration-unit

    • aggregate-listeners

    • auto-clear

    • auto-detaches

    • default-broker-factory | abstract-store-broker-factory | client-broker-factory | jdbc-broker-factory | custom-broker-factory

    • default-broker-impl | kodo-broker | custom-broker-impl

    • default-class-resolver | custom-class-resolver

    • default-compatibility | compatibility | default-compatibility

    • connection2-driver-name

    • connection2-password

    • connection2-properties

    • connection2-url

    • connection2-user-name

    • connection-decorators

    • connection-driver-name

    • connection-factory2-name

    • connection-factory2-properties

    • connection-factory-mode

    • connection-factory-name

    • connection-factory-properties

    • connection-password

    • connection-properties

    • connection-retain-mode

    • connection-url

    • connection-user-name

    • data-caches

    • default-data-cache-manager | kodo-data-cache-manager | data-cache-manager-impl | custom-data-cache-manager

    • data-cache-timeout

    • access-dictionary | db2-dictionary | derby-dictionary | empress-dictionary | foxpro-dictionary | hsql-dictionary | informix-dictionary | jdatastore-dictionary | mysql-dictionary | oracle-dictionary | postgres-dictionary | sql-server-dictionary | sybase-dictionary | custom-dictionary

    • default-detach-state | detach-options-loaded | detach-options-fetch-groups | detach-options-all | custom-detach-state

    • default-driver-data-source | kodo-pooling-data-source | simple-driver-data-source | custom-driver-data-source

    • stack-execution-context-name-provider | transaction-name-execution-context-name-provider | user-object-execution-context-name-provider

    • none-profiling | local-profiling | export-profiling | gui-profiling

    • none-jmx | local-jmx | gui-jmx | jmx2-jmx | mx4j1-jmx | wls81-jmx

    • dynamic-data-structs

    • eager-fetch-mode

    • fetch-batch-size

    • fetch-direction

    • fetch-groups

    • filter-listeners

    • flush-before-queries

    • ignore-changes

    • inverse-manager

    • jdbc-listeners

    • default-lock-manager | pessimistic-lock-manager | none-lock-manager | single-jvm-exclusive-lock-manager | version-lock-manager | custom-lock-manager

    • lock-timeout

    • commons-log-factory | log4j-log-factory | log-factory-impl | none-log-factory | custom-log

    • lrs-size

    • mapping

    • default-mapping-defaults | deprecated-jdo-mapping-defaults | mapping-defaults-impl | persistence-mapping-defaults | custom-mapping-defaults

    • extension-deprecated-jdo-mapping-factory | kodo-persistence-mapping-factory | mapping-file-deprecated-jdo-mapping-factory | orm-file-jdor-mapping-factory | table-deprecated-jdo-mapping-factory | table-jdor-mapping-factory | custom-mapping-factory

    • default-meta-data-factory | jdo-meta-data-factory | deprecated-jdo-meta-data-factory | kodo-persistence-meta-data-factory | custom-meta-data-factory

    • default-meta-data-repository | kodo-mapping-repository | custom-meta-data-repository

    • multithreaded

    • nontransactional-read

    • nontransactional-write

    • optimistic

    • default-orphaned-key-action | log-orphaned-key-action | exception-orphaned-key-action | none-orphaned-key-action | custom-orphaned-key-action

    • http-transport | tcp-transport | custom-persistence-server

    • default-proxy-manager | profiling-proxy-manager | proxy-manger-impl | custom-proxy-manager

    • query-caches

    • default-query-compilation-cache | cache-map | concurrent-hash-map | custom-query-compilation-cache

    • read-lock-level

    • jms-remote-commit-provider | single-jvm-remote-commit-provider | tcp-remote-commit-provider | cluster-remote-commit-provider | custom-remote-commit-provider

    • restore-state

    • result-set-type

    • retain-state

    • retry-class-registration

    • default-savepoint-manager | in-memory-savepoint-manager | jdbc3-savepoint-manager | oracle-savepoint-manager | custom-savepoint-manager

    • schema

    • default-schema-factory | dynamic-schema-factory | file-schema-factory | lazy-schema-factory | table-schema-factory | custom-schema-factory

    • schemas

    • class-table-jdbc-seq | native-jdbc-seq | table-jdbc-seq | time-seeded-seq | value-table-jdbc-seq | custom-seq

    • default-sql-factory | kodo-sql-factory | custom-sql-factory

    • subclass-fetch-mode

    • synchronize-mappings

    • transaction-isolation

    • transaction-mode

    • default-update-manager | constraint-update-manager | batching-operation-order-update-manager | operation-order-update-manager | table-lock-update-manager | custom-update-manager

    • write-lock-level

• profiling

  • none-profiling

  • local-profiling

  • export-profiling

  • gui-profiling

• execution-context-name-provider

  • stack-execution-context-name-provider

  • transaction-name-execution-context-name-provider

  • user-object-execution-context-name-provider

• jmx

  • none-jmx

  • local-jmx

  • gui-jmx

  • jmx2-jmx

  • mx4j1-jmx

  • wls81-jmx

persistence-configuration.xmlデプロイメント記述子の要素

次のpersistence-configuration.xml要素のリストには、このリリースのKodoでサポートされているすべての要素が含まれています。

abstract-store-broker-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

使用するkodo.kernel.BrokerFactoryタイプを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、abstract store)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.BrokerFactoryに関する項を参照してください。

例

<abstract-store-broker-factory/>

access-dictionary

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

Accessディクショナリの構成値を定義します。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・ヘルプのAccessディクショナリの構成に関する項を参照してください。

例

各構成値のデフォルト値を次の例に示します。

<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

値の範囲: true | false

デフォルト値: true

親要素 :

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

機能

デタッチされたオブジェクトのアンロード・フィールドへのアクセスを許可するかどうかを指定するフラグ。falseに設定すると、アンロード・フィールドへのアクセス時に例外がスローされます。このオプションは、デタッチ状態マネージャを使用している場合にのみ利用できます。

デタッチ状態の詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。

例

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

action

値の範囲: warn | exception

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit
    inverse-manager

機能

インバース・マネージャによって双方向の関係に不整合が検出されたときに実行する処理を制御します。有効なオプションは次のとおりです。

• warn - 警告をログに記録します。

• exception - 例外をスローします。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの管理対象の逆数に関する項を参照してください。

例

<action>warn</action>

addresses

値の範囲: 有効なIPアドレス

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

通知の送信先となるIPアドレスを、セミコロン区切りのリストで指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのTCPに関する項を参照してください。

例

<addresses>[]</addresses>

advanced-sql

値の範囲: 文字列

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

高度なSQL機能を構成します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.jdbc.SQLFactoryに関する項を参照してください。

aggregate-listeners

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

すべての問合せで利用できる集約リスナーのリストを指定します。各リスナーは、org.apache.openjpa.kernel.exps.AggregateListenerインタフェースを実装する必要があります。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.AggregateListenersに関する項を参照してください。

例

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

allocate

値の範囲: 整数

デフォルト値: 50

親要素 :

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

機能

各データベース・アクセス処理でメモリーに割り当てる値の数を指定します。50がデフォルト値です。これは、シーケンス表にアクセスするたびに次の50の値がクラスで除外されることを意味します。この場合、Kodoは、50のシーケンス値のリクエストにつき1回のみデータベースにアクセスし、新しいシーケンス値を取得します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

<allocate>50</allocate>

assert-allowed-type

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

メタデータで宣言されている要素型に割り当てられない要素をコレクションやマップに追加しようとした際に、すぐに例外をスローするかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのカスタム・プロキシに関する項を参照してください。

例

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

auto-clear

値の範囲 :

persistence-configuration-unit: datastore | all

kodo-broker: 0 | 1

デフォルト値: datastore (0)

親要素 :

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-broker

機能

トランザクションへの移行時にオブジェクトのフィールド値をクリアするかどうかを制御します。有効な値は次のとおりです:

• datastore (0) - データ・ストアのトランザクションに移行する際に、オブジェクトのフィールド値をクリアします。これがデフォルトです。

• all (1) - どのようなトランザクションに移行しても、オブジェクトのフィールド値をクリアします。

例

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

auto-detach

値の範囲 :

auto-detaches: close | commit | nontx-read

kodo-broker: 0 | 1 | 2

デフォルト値: close (0)

親要素 :

persistence-configuration
  persistence-configuration-unit
    auto-detaches

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

機能

管理対象インスタンスが自動的にデタッチされるイベントを指定します。auto-detaches要素の子として指定する場合、次のタイプのイベントを指定できます。

• close (0) - PersistenceManagerの終了時にすべてのオブジェクトをデタッチします。これがデフォルトです。

• commit (1) - トランザクションの終了時にすべてのオブジェクトをデタッチします。

• nontx-read (2) - トランザクション外の読取り時に、結果が返される前にインスタンスを自動的にデタッチします。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの自動デタッチに関する項を参照してください。

例

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

auto-detaches

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

管理対象インスタンスが自動的にデタッチされるイベントのリストを指定します。1つまたは複数のauto-detach要素を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの自動デタッチに関する項を参照してください。

例

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

base-name

値の範囲: 文字列

デフォルト値: なし

親要素 :

profiling
  export-profiling

機能

作成するエクスポート・データ・ファイルのベース名を定義します。Kodo 4.2.0 JPA/JDO開発者ガイドのバッチ・プロセスによるプロファイル・データのディスクへのダンプに関する項を参照してください。

例

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

batching-operation-order-update-manager

値の範囲: なし

デフォルト値: なし

親要素 :

profiling

機能

外部キーおよび表レベルのロックを無視し、アプリケーションがオブジェクトを変更した順序に基づいて最適化する、文のバッチ処理が可能な更新マネージャを定義します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデータ・キャッシュ・サイズの構成に関する項と問合せキャッシュに関する項を参照してください。

例

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

buffer-size

値の範囲: 整数

デフォルト値: 10

親要素 :

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

機能

リモート・コミット・プロバイダのバッファ・サイズを指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのリモート・コミット・プロバイダの構成に関する項を参照してください。

例

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

cache-map

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

問合せ文字列とその解析形式の関連付けに使用するキャッシュ・マップを定義します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの問合せコンパイルのキャッシュに関する項を参照してください。

例

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

cache-size

値の範囲: 整数

デフォルト値: 1000

親要素 :

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

機能

データまたは問合せのキャッシュ・サイズを設定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデータ・キャッシュ・サイズの構成に関する項と問合せキャッシュに関する項を参照してください。

例

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

channel

値の範囲: 文字列

デフォルト値: openjpa.Runtime

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

ログを記録するチャネルを指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの孤立キーに関する項を参照してください。

例

<channel>openjpa.Runtime</channel>

class-table-jdbc-seq

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

独自のカスタム・ジェネレータの作成に使用するkodo.kernel.Seqインタフェースを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.jdbc.kernel.TableJDBCSeq)。

TableJDBCSeqは、特殊な単一行の表にグローバル・シーケンス番号を格納します。この表は、この表を必要とするクラスに対してマッピング・ツールを最初に実行したときに存在しない場合は作成されます。表の操作には、そのクラスのmainメソッドやsequencetableシェル/バッチ・スクリプトを使用することもできます(使用方法の詳細は、JavadocのTableJDBCSeq.mainメソッドを参照)。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

<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

値の範囲: 有効なクラス名

デフォルト値: なし

親要素 :

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

機能

カスタム機能に関連付けられるクラスの名前。

classpath-scan

値の範囲: true | false

デフォルト値: true

親要素 :

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

機能

現在のクラスパスにリストされるディレクトリまたはjarアーカイブを、セミコロン区切りのリストで指定します。各ディレクトリおよびjarアーカイブでは、使用しているメタデータ・ファクトリに基づいて、アノテーションが付いたJPエンティティまたはJDOメタデータ・ファイルがスキャンされます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのメタデータ・ファクトリに関する項を参照してください。

例

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

clear-on-close

値の範囲: true | false

デフォルト値: false

親要素 :

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

機能

EntityManagerFactoryまたはPersistenceManagerFactoryの終了時に、Tangosol指定のキャッシュを完全にクリアするかどうかを指定するフラグ。

例

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

client-broker-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

使用するkodo.kernel.BrokerFactoryタイプを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、remote)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.BrokerFactoryに関する項を参照してください。

例

<client-broker-factory/>

close-on-managed-commit

値の範囲: true | false

デフォルト値: true

親要素 :

persistence-configuration
  persistence-configuration-unit
    compatibility

機能

管理対象トランザクションのコミット後に、closeメソッドを呼び出したものと想定し、JDO PersistenceManagerを終了するかどうかを指定するフラグ。

falseに設定すると、PersistenceManagerは終了しません。つまり、同じJVMの処理層に渡されたオブジェクトは、所有しているPersistenceManagerが終了しないため、使用可能なままになります。この動作は、JDO仕様に厳密に準拠するわけではありませんが、こうした状況でPersistenceManagerを終了しないKodo 2.xに対してコーディングされたアプリケーションには便利です。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの互換性の構成に関する項を参照してください。

例

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

cluster-remote-commit-provider

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

クラスタ内のpersistenceManagerFactories間でコミット通知を共有するようKodoを構成します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのリモート・コミット・プロバイダの構成に関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

ログ・メッセージの発行に使用するApache Jakarta Commons Loggingシン・ライブラリを指定します。Commons Loggingライブラリは、Jakarta Log4JプロジェクトやJDK 1.4のネイティブjava.util.logging packageなど、よく利用されている多くのロギングAPIのラッパーとして機能します。これらのライブラリがどちらも利用できない場合は、単純なコンソールでのロギングが使用されます。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのApache共通ロギングに関する項を参照してください。

例

<commons-log-factory/>

compatibility

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

実行時の特定の動作について後方互換性の設定を構成します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの互換性の構成に関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

問合せ文字列とその解析形式の関連付けに使用する同時ハッシュ・マップを定義します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの問合せコンパイルのキャッシュに関する項を参照してください。

例

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

connection-decorators

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

接続ファクトリ上にインストールするorg.apache.openjpa.lib.jdbc.ConnectionDecorator実装を表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)。1つまたは複数のcustom-connection-decorator要素を指定します。

これらのデコレータは、基底のDataSourceから渡された接続をラップして機能性を高めることができます。Kodoでは、すべての接続が使用される前にデコレータのリストを介して渡されます。

注意: Kodo JPA/JDOでは、com.solarmetric.jdbcパッケージ内の組込みデコレータがデフォルトで使用されるため、この要素でデコレータを指定する必要はありません。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.jdbc.ConnectionDecoratorsに関する項を参照してください。

例

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

connection-driver-name

値の範囲: 有効なクラス名

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

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

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

機能

データベースへの接続に使用するJDBCのjava.sql.Driverまたはjavax.sql.DataSource実装の完全修飾クラス名。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJDBCに関する項を参照してください。

以下にサンプルの値を示します。

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

例

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

connection-factory-mode

値の範囲: local | managed

デフォルト値: local

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

アプリケーション・サーバーの管理対象トランザクションとの統合時に使用する接続ファクトリのモード。有効なオプションは次のとおりです。

• local - Kodo制御下の標準データ・ソースを指定します。

• managed - アプリケーション・サーバーで管理され、グローバル・トランザクションに自動登録されるデータ・ソースを指定します。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの管理対象データソースとXAデータソースに関する項を参照してください。

例

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

connection-factory-name

値の範囲: JNDI名

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

データベースへの接続に使用するjavax.sql.DataSourceのJNDIロケーション。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJDBCに関する項を参照してください。

例

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

connection-factory-properties

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

使用されているjavax.sql.DataSource(http://docs.oracle.com/javase/6/docs/api/javax/sql/DataSource.htmlで説明しています)の構成用のプロパティをリストするプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJDBCに関する項を参照してください。

例

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

connection-factory2-name

値の範囲: JNDI名

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

データベースへの接続に使用する管理対象ではないjavax.sql.DataSourceのJNDIロケーション。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのXAトランザクションに関する項を参照してください。

例

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

connection-factory2-properties

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

非管理対象のConnectionFactoryとして使用するjavax.sql.DataSource(http://docs.oracle.com/javase/6/docs/api/javax/sql/DataSource.htmlで説明しています)を構成するために使用されるプロパティ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの管理対象データソースとXAデータソースに関する項を参照してください。

例

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

connection-password

値の範囲: 有効なパスワード

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

connection-user-nameで指定されるユーザーのパスワード。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJDBCに関する項を参照してください。

例

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

connection-properties

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

connection-driver-name要素にリストされるドライバの構成プロパティをリストするプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)。これらのプロパティは、与えられたドライバ・クラスがDataSourceである場合、そのDataSourceのBeanプロパティの構成に使用されます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJDBCに関する項を参照してください。

例

<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

値の範囲: always | on-demand | persistence-manager | transaction

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

データ・ストア接続の使用方法を制御します。有効な値は次のとおりです:

• always - 各EntityManagerまたはPersistenceManagerが単一の接続を取得し、EntityManagerまたはPersistenceManagerが終了するまでその接続を使用します。

• on-demand - 接続は必要時にのみ取得されます。このオプションは、データ・ストア・トランザクションが使用されている場合、transactionオプションと同じです。ただし、オプティミスティック・トランザクションの場合は、データ・ストアのフラッシュおよびコミット・プロセス中にのみ接続が保持されることになります。

• persistence-manager - 接続は永続性マネージャから取得されます。

• transaction - 接続は各トランザクション(オプティミスティックまたはデータ・ストア)の開始時に取得され、トランザクションの完了時にリリースされます。非トランザクション接続は、必要に応じて取得されます。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJDBC接続の使用の構成に関する項を参照してください。

例

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

connection-url

値の範囲: 有効なURL

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

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

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

機能

データベースのJDBC URL。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJDBCに関する項を参照してください。

次のような値を指定できます。

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

例

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

connection-user-name

値の範囲: 有効なユーザー名

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

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

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

機能

connection-urlで指定されているデータ・ソースへの接続に使用するユーザー名。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJDBCに関する項を参照してください。

例

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

connection2-driver-name

値の範囲: 有効なユーザー名

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

非管理対象データベースへの接続に使用するJDBCのjava.sql.Driverまたはjavax.sql.DataSource実装の完全なクラス名。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの管理対象データソースとXAデータソースに関する項を参照してください。

例

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

connection2-password

値の範囲: 有効なパスワード

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

connection2-urlで指定されている非管理対象データ・ソースのパスワード。

例

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

connection2-properties

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

connection2-driver-nameで指定される非管理対象データ・ソースのプロパティ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの管理対象データ・ソースとXAデータ・ソースに関する項を参照してください。

例

<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

値の範囲: 有効なURL

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

非管理対象データ・ソースのJDBC URL。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの管理対象データソースとXAデータソースに関する項を参照してください。

例

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

connection2-user-name

値の範囲: 有効なユーザー名

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

connection2-driver-nameで指定されているデータ・ソースへの接続に使用するユーザー名。

例

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

constraint-names

値の範囲: true | false

デフォルト値: false

親要素 :

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

機能

生成されるすべてのマッピングに一意制約や外部キーの名前を含めるかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピング・ファクトリに関する項を参照してください。

例

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

constraint-update-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

文のバッチ処理および外部キー制約の評価が可能な、標準の更新マネージャを定義します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデータ・キャッシュ・サイズの構成に関する項と問合せキャッシュに関する項を参照してください。

例

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

copy-object-ids

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit
    compatibility

機能

oidオブジェクトが返される前にコピーするかどうかを指定するフラグ。3.0より前のバージョンのKodoでは、oidオブジェクトが返される前に常にコピーされていました。これにより、oidオブジェクトを参照で変更することによって生じるエラーを回避することができますが、oidインスタンスを変更しない大多数のユーザーにとっては効率が良くありませんでした。したがって、3.0以上のKodoでは、oidはデフォルトではコピーされません。このプロパティをtrueに設定すると、oidがコピーされます。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの互換性の構成に関する項を参照してください。

例

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

custom-aggregate-listener

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit
    aggregate-listeners

機能

カスタム集約リスナーを定義します。各リスナーは、org.apache.openjpa.kernel.exps.AggregateListenerインタフェースを実装する必要があります。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.AggregateListenersに関する項を参照してください。

例

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

custom-broker-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム・ブローカ・ファクトリを指定することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.BrokerFactoryに関する項を参照してください。

例

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

custom-broker-impl

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム・ブローカ実装を定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.BrokerImplに関する項を参照してください。

例

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

custom-class-resolver

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

クラス名を解決するためのカスタム・クラス・リゾルバを定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.ClassResolverに関する項を参照してください。

例

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

custom-compatibility

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

独自のカスタム互換性フラグを定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの互換性の構成に関する項を参照してください。

例

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

custom-connection-decorator

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit
    connection-decorators

機能

すべての接続プール上にインストールするカスタムorg.apache.openjpa.lib.jdbc.ConnectionDecorator実装を定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.jdbc.ConnectionDecoratorsに関する項を参照してください。

例

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

custom-data-cache

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit
    data-caches

機能

カスタム・データ・キャッシュを定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.DataCacheに関する項を参照してください。

例

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

custom-data-cache-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム・データ・キャッシュ・マネージャを定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.DataCacheManagerに関する項を参照してください。

例

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

custom-detach-state

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム・デタッチ状態を定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.DetachStateに関する項を参照してください。

例

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

custom-dictionary

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム・ディクショナリを定義することができます。詳細は、Oracle WebLogic Server管理コンソール・ヘルプのカスタム・ディクショナリの構成に関する項を参照してください。

例

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

custom-driver-data-source

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム・データ・ソース・ドライバを定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.jdbc.DriverDataSourceに関する項を参照してください。

例

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

custom-filter-listener

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit
    filter-listeners

機能

カスタム・フィルタ・リスナーを定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.FilterListenersに関する項を参照してください。

例

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

custom-jdbc-listener

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit
    jdbc-listeners

機能

カスタムJDBCリスナーを定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.JDBCListenerに関する項を参照してください。

例

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

custom-lock-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム・ロック・マネージャを定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのロック・マネージャに関する項を参照してください。

例

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

custom-log

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム・ログ・ファイルを定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのカスタム・ログに関する項を参照してください。

例

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

custom-mapping-defaults

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

マッピングのカスタム・デフォルト設定を定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピング・ファクトリに関する項を参照してください。

例

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

custom-mapping-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

マッピングのカスタム・ファクトリを指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピング・ファクトリに関する項を参照してください。

例

<custom-mapping-factory/>

custom-meta-data-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム・メタデータ・ファクトリを指定することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのメタデータ・ファクトリに関する項を参照してください。

例

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

custom-meta-data-repository

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム・メタデータ・リポジトリを指定することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのメタデータ・ファクトリに関する項を参照してください。

例

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

custom-orphaned-key-action

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

孤立キーのカスタム動作を定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの孤立キーに関する項を参照してください。

例

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

custom-persistence-server

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム永続性サーバーを定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスタンドアロン永続性サーバーに関する項を参照してください。

例

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

custom-proxy-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム・プロキシ・マネージャを定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのカスタム・プロキシに関する項を参照してください。

例

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

custom-query-compilation-cache

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム問合せコンパイルのキャッシュを定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの問合せコンパイルのキャッシュに関する項を参照してください。

例

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

custom-remote-commit-provider

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム・リモート・コミット・プロバイダを指定することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJMSに関する項を参照してください。

例

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

custom-savepoint-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム・セーブポイント・マネージャを指定することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのセーブポイントに関する項を参照してください。

例

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

custom-schema-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム・スキーマ・ファクトリを指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスキーマ・ファクトリに関する項を参照してください。

例

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

custom-seq

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタム・ジェネレータを定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

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

custom-sql-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

カスタムSQLファクトリを定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.jdbc.SQLFactoryに関する項を参照してください。

例

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

custom-update-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

永続オブジェクトの変更をデータストアへフラッシュするために使用する、カスタム更新マネージャを定義することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.jdbc.UpdateManagerに関する項を参照してください。

例

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

data-caches

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

データストアからロードされたデータのキャッシュに使用するプラグインを指定します。org.apache.openjpa.datacache.DataCacheを実装する必要があります。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデータ・キャッシュに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

システム・データ・キャッシュを管理するkodo.datacache.DataCacheManagerを有効にします。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.DataCacheManagerに関する項を参照してください。

例

<data-cache-manager-impl/>

data-cache-timeout

値の範囲: 整数

デフォルト値: -1

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

クラスのデータを有効に保つ時間をミリ秒単位で指定します。-1を指定すると、期限が設定されません。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデータ・キャッシュ・タイムアウト値の設定に関する項を参照してください。

例

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

db2-dictionary

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

DB2ディクショナリの永続性プラグインの構成値を定義します。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・ヘルプのDB2ディクショナリの構成に関する項を参照してください。

例

db2-dictionary要素の下位要素は、access-dictionaryと同じです。

default-access-type

値の範囲: FIELD | PROPERTY

デフォルト値: FIELD

親要素 :

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

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

機能

デフォルトのアクセス・タイプを指定します。有効な値は次のとおりです:

• FIELD - 状態は永続フィールドに直接書き込まれ、変更時もフィールドから取得されます。

• PROPERTY - 状態は、JavaBeanの「getter」および「setter」メソッドで取得およびロードします。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのフィールドとプロパティのメタデータに関する項を参照してください。

例

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

default-broker-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

使用するkodo.kernel.BrokerFactoryタイプを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルトのJDBC)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.BrokerFactoryに関する項を参照してください。

例

<default-broker-factory/>

default-broker-impl

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

実行時に使用するkodo.kernel.Brokerタイプを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルト値)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.BrokerImplに関する項を参照してください。

例

<default-broker-impl/>

default-class-resolver

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

クラス名の解決に使用するkodo.util.ClassResolver実装を表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルト値)。特別なクラス・ローディングが必要な場合は、独自のリゾルバを設定することもできます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.ClassResolverに関する項を参照してください。

例

<default-class-resolver/>

default-compatibility

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

デフォルトの互換性設定を設定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの互換性の構成に関する項を参照してください。

例

<default-compatibility/>

default-data-cache

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit
    data-caches

機能

デフォルトのデータ・キャッシュを定義します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデータ・キャッシュに関する項を参照してください。

例

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

default-detach-state

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

デフォルトのデタッチ状態を指定します(ここでは、loaded)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。

例

<default-detach-state/> 

default-data-cache-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

システム・データ・キャッシュを管理するkodo.datacache.DataCacheManagerを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルト値)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデータ・キャッシュに関する項を参照してください。

例

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

default-driver-data-source

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

javax.sql.DataSourceインスタンスを使用したJDBCドライバ・クラスのラップに使用するデフォルトのkodo.jdbc.schema.DriverDataSource実装を指定します。デフォルトの実装として提供されているkodo.jdbc.schema.KodoPoolingDataSourceは、Kodo 4.2.0 JPA/JDO開発者ガイドのJDBCに関する項で説明するように、接続プーリングを実行します。

例

<default-driver-data-source/>

default-level

値の範囲: TRACE | DEBUG | INFO | WARN | ERROR

デフォルト値: INFO

親要素 :

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

機能

構成されていないチャネルのデフォルトのロギング・レベルを指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのKodoロギングに関する項を参照してください。

例

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

default-lock-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

デフォルトのロック・マネージャを使用するように指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデフォルト・ロックの構成に関する項を参照してください。

例

<default-lock-manager/>

default-mapping-defaults

値の範囲: 文字列

標準的な実装: jdoおよびjpa

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

デフォルトの列名、表名、および永続クラスの制約の定義に使用するkodo.jdbc.meta.MappingDefaultsを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します。詳細と標準実装のリストは、Kodo 4.2.0 JPA/JDO開発者ガイドのデフォルトのマッピングに関する項を参照してください。

例

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

default-meta-data-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

使用するkodo.meta.MetaDataFactoryタイプを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここではデフォルトのkodo.jdo.JDOMetaDataFactory)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのメタデータ・ファクトリに関する項を参照してください。

例

<default-meta-data-factory/>

default-meta-data-repository

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

永続クラスのメタデータの格納に使用するkodo.meta.MetaDataRepositoryを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルト値)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのメタデータ・ファクトリに関する項を参照してください。

例

<default-meta-data-repository/>

default-orphaned-key-action

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

孤立データストア・キーの検出時に呼び出すkodo.event.OrphanedKeyActionを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルトのkodo.event.LogOrphanedKeyAction)。この場合、孤立キーごとにメッセージがロギングされます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの孤立キーに関する項を参照してください。

例

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

default-proxy-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

可変の別のクラス・オブジェクトのプロキシに使用するkodo.util.ProxyManagerを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルトのkodo.util.ProxyManagerImpl)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのカスタム・プロキシに関する項を参照してください。

例

<default-proxy-manager/>

default-query-compilation-cache

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

問合せ文字列とその解析形式の関連付けに使用するマップを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルト値)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの問合せコンパイルのキャッシュに関する項を参照してください。

例

<default-query-compilation-cache/>

default-savepoint-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

トランザクションのセーブポイントの管理に使用するkodo.kernel.SavepointManagerを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルトのkodo.kernel.InMemorySavepointManager)。このプラグインは、フィールド値を含むすべての状態をメモリーに格納します。このため、設定される各セーブポイントは、トランザクション・オブジェクト数がそれほど多くない状況に対して設計されています。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのセーブポイントに関する項を参照してください。

例

<default-savepoint-manager/>

default-schema-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

データベース・スキーマに関する情報の格納および取得に使用するkodo.jdbc.schema.SchemaFactoryを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルトのkodo.jdbc.schema.DynamicSchemaFactory)。

DynamicSchemaFactoryは、データベースに対してマッピング情報を検証しないため、最もパフォーマンスの優れたスキーマ・ファクトリです。かわりに、すべてのオブジェクト・リレーショナル・マッピング情報が正しいと想定し、現在のマッピング・メタデータからスキーマのメモリー内表現を動的に構築します。このファクトリを使用するには、外部キー制約がSQL文で満たされるよう、マッピング・メタデータが現在のデータベースの外部キー制約を正しく表現している必要があります。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスキーマ・ファクトリに関する項を参照してください。

例

<default-schema-factory/>

default-sql-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

共通のSQLコンストラクトの抽出に使用するkodo.jdbc.SQLFactoryを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルト値)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.jdbc.SQLFactoryに関する項を参照してください。

例

<default-meta-data-factory/>

default-update-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

デフォルトの更新マネージャkodo.jdbc.kernel.ConstraintUpdateManagerを使用するように指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.jdbc.UpdateManagerに関する項を参照してください。

例

<default-update-manager/>

deprecated-jdo-mapping-defaults

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

JDO 1.0のマッピングのデフォルト設定を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピングのデフォルトに関する項を参照してください。

例

deprecated-jdo-mapping-defaults要素は、mapping-defaults-implと同じ下位要素を共有します。

deprecated-jdo-meta-data-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

使用するkodo.meta.MetaDataFactoryタイプを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.jdo.DeprecatedJDOMetaDataFactory)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのメタデータ・ファクトリに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

Derbyディクショナリを構成します。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・ヘルプのDerbyディクショナリの構成に関する項を参照してください。

例

derby-dictionary要素は、同じ下位要素を共有します。さらに、次の下位要素(デフォルト値を表示)も持ちます:

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

detach-options-all

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

デタッチ状態をallに設定し、すべてのフィールドおよびリレーションをデタッチします。関連性の高いドメイン・モデルを使用している場合、データベース内のすべてのオブジェクトがメモリーに格納される恐れがあるため、このモードの使用には注意が必要です。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

デフォルトのフェッチ・グループ内、および現在のフェッチ構成に追加したその他のフェッチ・グループ内のすべてのフィールドおよびリレーションをデタッチするようにデタッチ状態を設定します。カスタム・フェッチ・グループの詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのフェッチ・グループに関する項を参照してください。デタッチ状態の詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

ロード済のすべてのフィールドおよびリレーションをデタッチするようデタッチ状態を設定します。ただし、ロードされていないフィールドはデタッチ・グラフに含めません。これがデフォルトです。デタッチ状態の詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。

例

<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

値の範囲: 1 | 2 | 3

デフォルト値: 1

親要素 :

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

機能

デタッチ状態を構成します。有効な値は次のとおりです:

• 1 (loaded): ロード済のすべてのフィールドおよびリレーションをデタッチします。ただし、ロードされていないフィールドはデタッチ・グラフに含めません。

• 2 (fetch-groups) - 現在のフェッチ構成内のすべてのフィールドおよびリレーションをデタッチします。

• 3(all) - すべてのフィールドおよびリレーションをデタッチします。関連性の高いドメイン・モデルを使用している場合、データベース内のすべてのオブジェクトがメモリーに格納される恐れがあるため、このモードの使用には注意が必要です。

デタッチ・モードで特定されないフィールドはすべて、デタッチ・インスタンスのJavaデフォルト値に設定されます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。

例

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

detached-state-field

値の範囲: true | false

デフォルト値: true

親要素 :

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

機能

アタッチ・プロセスを効率化するため、デタッチ状態フィールドを利用するかどうかを指定するフラグ。このフィールドはエンハンサによって追加され、アプリケーションには表示されません。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのアタッチの動作に関する項を参照してください。

デタッチ状態の詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。

例

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

detached-state-manager

値の範囲: true | false

デフォルト値: true

親要素 :

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

機能

デタッチ状態マネージャを使用するかどうかを指定するフラグ。デタッチされた状態マネージャでアタッチがより効率よく行われます。しかし、デタッチ状態フィールドと同様に、改善されていないクラスが一時的でない場合、クラスとのシリアライゼーションに関する互換性を中断します。

この設定は、detached-state-field要素に依存します。デタッチ状態フィールドが一時的なものなら、デタッチ状態マネージャも一時的になります。デタッチ状態フィールドを無効にすると、デタッチ状態マネージャも無効化されます。通常はこの設定にします。

ただし、detach-state-field要素をtrueに設定(あるいは一時的に設定)し、このプロパティをfalseに設定すると、デタッチ状態マネージャを使用せずにデタッチ状態フィールドを使用することができます。この設定は、デタッチ状態マネージャを利用しないKodoの以前の動作に慣れていたユーザーが、デタッチ状態マネージャを利用するKodoの動作に違和感がある場合や、デバッグを行う場合に役立つ場合があります。

デタッチ状態の詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。

例

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

detached-state-transient

値の範囲: true | false

デフォルト値: true

親要素 :

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

機能

デタッチ状態フィールドを一時的に使用するかどうかを指定するフラグ。trueに設定すると、シリアライズされないローカル・オブジェクトでデタッチ状態フィールドのメリットを利用でき、改善されていないバージョンのクラスへアクセスできないクライアント層のシリアライゼーションに関する互換性も維持されます。

デタッチ状態の詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。

例

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

detached-new

値の範囲: true | false

デフォルト値: true

親要素 :

persistence-configuration
  persistence-configuration-unit
    kodo-broker

機能

シリアライゼーションに関する互換性がないオブジェクトでも効率的にアタッチできるよう、一時的でないデタッチ状態フィールドを使用するかどうかを指定するフラグ。ただし、この機能を利用するには、改善されたバージョンのクラスおよびKodoライブラリがクライアント層に存在する必要があります。

デタッチ状態の詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。

例

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

diagnostic-context

値の範囲: 文字列

デフォルト値: kodo.IDプロパティ(設定している場合)

親要素 :

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

機能

すべてのログ・メッセージの先頭に付加する文字列。指定している場合、kodo.IDプロパティがデフォルトで使用されます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのKodoロギングに関する項を参照してください。

例

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

dynamic-data-structs

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

永続データを保持するカスタマイズされた構造体を動的に生成するかどうかを指定するフラグ。Kodoのデータ・キャッシュとリモート・フレームワークはどちらも、データ構造体に基づき永続状態のキャッシュおよび転送を行います。Kodoでは、動的な構造体により、クラスごとにデータ・ストレージをカスタマイズでき、プリミティブ・ラッパー・オブジェクトを生成せずに済みます。これによってメモリーを節約し、特定の実行時処理を素早く完了することができます。

反面、カスタム・クラスの生成とJVMへのロードに時間がかかるため、アプリケーションのウォームアップ時間が長くなります。したがって、アプリケーションの実行時間が長くても、メモリーおよび処理時間の最適化により、クラスの初期生成コストが徐々に相殺される場合にのみ、このプロパティをtrueに設定してください。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.DynamicDataStructsに関する項を参照してください。

例

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

dynamic-schema-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

データベース・スキーマに関する情報の格納および取得に使用するkodo.jdbc.schema.SchemaFactoryを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルトのkodo.jdbc.schema.DynamicSchemaFactory)。

DynamicSchemaFactoryは、データベースに対してマッピング情報を検証しないため、最もパフォーマンスの優れたスキーマ・ファクトリです。かわりに、すべてのオブジェクト・リレーショナル・マッピング情報が正しいと想定し、現在のマッピング・メタデータからスキーマのメモリー内表現を動的に構築します。このファクトリを使用するには、外部キー制約がSQL文で満たされるよう、マッピング・メタデータが現在のデータベースの外部キー制約を正しく表現している必要があります。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスキーマ・ファクトリに関する項を参照してください。

例

<dynamic-schema-factory/>

eager-fetch-mode

値の範囲: join | multiple | none | parallel | single

デフォルト値: parallel

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

イーガー・フェッチを構成します。イーガー・フェッチは、サブクラス・データと関連オブジェクトを、問合せ対象のベース・インスタンスとともに効率的にロードする機能です。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのイーガー・フェッチに関する項を参照してください。

このプロパティは、次のいずれかの値に設定することができます。

• join - このモードに設定すると、構成されているフェッチ・グループの対1リレーションへの結合が行われます。単一インスタンスのデータをロードする場合は、構成されているフェッチ・グループのコレクション・フィールドへの結合も行われます。ただし、問合せの実行時など、複数インスタンスのデータをロードする場合は、コレクションへはデフォルトで結合されません。かわりに、次に説明するように、コレクションに対してはデフォルトでparallelモードになります。コレクション・フィールドに対してparallelモードではなくjoinモードを使用するように設定するには、Kodo 4.2.0 JPA/JDO開発者ガイドのイーガー・フェッチ・モードに関する項で説明されているメタデータ拡張を使用します。

  Kodoは、joinモードの場合、左外部結合(リレーションのフィールド・メタデータで、nullがそのリレーションで許可されないと宣言されている場合は内部結合)を使用して、関連データをターゲット・オブジェクトのデータとともに選択します。このプロセスは、対1結合に対して再帰的に機能するため、PersonがAddressを、AddressがTelephoneNumberを持ち、フェッチ・グループが適切に構成されている場合、Kodoはこれら3つのクラスの表間を結合する単一のSELECT文を発行することができます。対多結合により、他の対多結合が再帰的に生成されることはありませんが、再帰的な対1結合が生成される場合があります。

  joinのサブクラス・フェッチ・モードでは、問合せ対象タイプのすべてのサブクラス表への外部結合によって、結合表内のサブクラス・データが選択されます。結合されていないサブクラス・データは、利用可能であればSQL UNIONで選択されます。以下に示すように、サブクラス・データのフェッチは、リレーション・フェッチとは別に構成され、特定のクラスに対して無効化することができます。

• multiple - parallelと同じです。

• none - イーガー・フェッチを実行しません。関連オブジェクトは常に、独立したSELECT文でロードされます。結合されたサブクラス・データは、問合せ対象の基本タイプの1つまたは複数の表内にないかぎりロードされません。結合されていないサブクラス・データは、SQL UNION演算ではなく、別個のSELECT文でロードされます。

• parallel - このモードに設定すると、Kodoは、joinモードの欄で説明したように、対1リレーションと結合コレクションに対してSELECTを実行します。ただし、結合されていないコレクション・フィールドは、コレクションごとに別個のSELECT文でイーガー・フェッチされ、これはターゲット・オブジェクトに対するSELECT文と並列的に実行されます。並列的に実行されるこれらのSELECT文では、プライマリSELECT文からWHERE条件を使用して選択しますが、関連データにアクセスするため独自の結合を追加します。たとえば、100個のCompanyオブジェクトを返す問合せを実行する際、各企業にEmployeeオブジェクト・リストおよびDepartmentオブジェクト・リストが存在する場合は、3つの問合せが実行されます。1つ目の問合せはCompanyオブジェクトを選択し、2つ目の問合せは選択された企業のEmployeeオブジェクトを選択し、3つ目の問合せはそれらの企業のDepartmentオブジェクトを選択します。このプロセスは、joinの場合と同様に、イーガー・フェッチ対象のリレーション内のオブジェクトに対して再帰的に適用されます。この例でいくと、ロード対象のいずれかのフェッチ・グループにEmployeeクラスのProjectsリストがあった場合、Kodoは、一致する企業の全従業員のプロジェクトのロードと並列的に、1つのSELECT文を追加実行します。

  追加のSELECT文を使用して各コレクションをロードすることにより、データベースからアプリケーションに必要以上のデータを転送せずに済みます。並列SELECT文のかわりにイーガー結合を使用すると、構成されているフェッチ・グループに追加される各コレクションによって、ネットワークがあっという間にダウンするほど大量のデータが転送されてしまう場合があります。

  クラスごとに1つの表(table-per-class)のマッピングへのポリモフィックな対1リレーションでは、適切な結合が不可能なため、並列のイーガー・フェッチが使用されます。他の対1リレーションで、joinモードのイーガー・フェッチではなくparallelモードを使用するように設定するには、Kodo 4.2.0 JPA/JDO開発者ガイドのイーガー・フェッチ・モードに関する項で説明されているメタデータ拡張を使用します。

  サブクラスのフェッチ・モードをparallelに設定すると、table-per-class階層および垂直継承階層に影響します。Kodoは、parallelモードの場合、joinモードでのすべてのサブクラス表のUNION演算ではなく、table-per-class継承階層のサブクラスごとに別個のSELECT文を発行します。これは、問合せ、IDによるルックアップ、リレーション・トラバースなど、table-per-classベース・クラスに対するあらゆる処理に適用されます。

  一方、垂直にマップされた階層を処理する場合、parallelのサブクラス・フェッチ・モードが適用されるのは問合せのみです。Kodoは、サブクラス表への外部結合ではなく、サブクラスごとに問合せを別個に発行します。その他の状況下におけるparallelのサブクラス・フェッチ・モードの動作は、垂直にマップされたサブクラスに関してはjoinモードと同じです。

  Kodoは、選択しているオブジェクトが1つしかない場合、parallelモードを使用しません。これは、追加のSELECT文を同じ効率で遅延実行できるためです。このモードがjoinモードより効率的なのは、イーガー・リレーションを持つ複数のオブジェクトがロードされる場合や、すべてのサブクラスへ結合するより複数のSELECT文を実行した方が速く処理が完了する場合のみです。

• single - joinと同じです。

例

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

empress-dictionary

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

Empressディクショナリを構成します。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・ヘルプのEmpressディクショナリの構成に関する項を参照してください。

例

empress-dictionary要素の下位要素は、access-dictionaryと同じです。さらに次の下位要素(デフォルト値を表示)も持ちます。

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

EnableLogMBean

値の範囲: true | false

デフォルト値: なし

親要素 :

jmx
  local-jmx

機能

LogMBeanを登録するかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの管理グループのオプションのパラメータに関する項を参照してください。

例

<EnableLogMBean>true</EnableLogMBean>

EnableRuntimeMBean

値の範囲: true | false

デフォルト値: なし

親要素 :

jmx
  local-jmx

機能

RuntimeMBeanを登録するかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの管理グループのオプションのパラメータに関する項を参照してください。

例

<EnableRuntimeMBean>true</EnableRuntimeMBean>

evict-from-data-cache

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit
    kodo-broker

機能

特定の間隔でデータ・キャッシュからデータをクリアするかどうかを指定するフラグ。クリア・スケジュールは、eviction-schedule要素で定義します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデータ・キャッシュに関する項を参照してください。

例

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

eviction-schedule

値の範囲: なし

デフォルト値: なし

親要素 :

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

機能

特定の間隔でデータ・キャッシュをクリアすることができます。Kodoのキャッシュ実装のEvictionScheduleプロパティでは、cronスタイルのクリア・スケジュールを指定できます。このプロパティの書式は、5つのトークンをホワイトスペース区切りでリストします。*記号(アスタリスク)をあらゆる値に一致するワイルドカードとして使用することができます。以下に、これらのトークンを指定すべき順序で示します。

• 分

• 時

• 日

• 月

• 曜日

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの追出しスケジュールの構成に関する項を参照してください。

例

次の設定では、日曜日の午後3時15分および3時45分にキャッシュからデータをクリアするようにデフォルトのキャッシュをスケジューリングしています。

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

exception-orphaned-key-action

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

孤立データストア・キーの検出時に呼び出すkodo.event.OrphanedKeyActionを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.event.ExceptionOrphanedKeyAction)。この場合、孤立キーごとに例外がスローされます。JPAでは、javax.persistence.EntityNotFoundExceptionの例外になります。JDOでは、javax.jdo.JDOObejctNotFoundExceptionの例外になります。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの孤立キーに関する項を参照してください。

例

<exception-orphaned-key-action/>

exception-reconnect-attempts

値の範囲: 整数

デフォルト値: 0

親要素 :

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

機能

JMSシステムから重大な接続エラーが通知された場合の、再接続の試行回数を指定します。0(デフォルト値)はKodoがエラーをログに記録することを示しますが、それ以外の場合は、接続がまだ有効であると想定してエラーを無視します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJMSに関する項を参照してください。

例

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

execution-context-name-provider

値の範囲: なし

デフォルト値: なし

親要素: なし

機能

実行コンテキスト名プロバイダを構成します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.ExecutionContextNameProviderに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

profiling

機能

エクスポート・プロファイリング・データを構成します。Kodo 4.2.0 JPA/JDO開発者ガイドのバッチ・プロセスによるプロファイル・データのディスクへのダンプに関する項を参照してください。

例

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

extension-deprecated-jdo-mapping-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

永続クラスのオブジェクト・リレーショナル・マッピング情報の格納および取得に使用するkodo.meta.MetaDataFactoryを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)。この設定はJDO 1.0で有効です。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピング・ファクトリに関する項を参照してください。

例

<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

値の範囲: 整数

デフォルト値: -1

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

結果セットをスクロールする際に一度にフェッチする行数。フェッチ・サイズは、実行時にも設定することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの大きな結果セットに関する項を参照してください。

例

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

fetch-direction

値の範囲: forward | reverse | unknown

デフォルト値: true

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

問合せ結果リストがアクセスされる順序。この値は、結果の格納に使用されるデータ構造のタイプに影響し、特定のアクセス・パターンで最適化が可能な場合はJDBCドライバに渡されます。この要素には、以下に示す値を指定できます。各値は、同じ名前のjava.sql.ResultSet FETCH定数に対応しています。

• forward - 問合せ結果が順番にリストされます。これがデフォルトです。

• reverse - 問合せ結果が逆の順序でリストされます。

• unknown - 順序が指定されません。

このプロパティは、実行時にも変更することができます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの大きな結果セットに関する項を参照してください。

例

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

fetch-group

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit
    fetch-group

機能

フェッチ・グループの名前。フェッチ・グループ名はグローバルで、クラス間で共有されます。たとえば、ショッピングWebサイトで、各製品クラスに詳細なフェッチ・グループを使用すると、各製品の「詳細な」ページの表示に必要なすべてのデータを効率的にロードすることができます。このWebサイトでは、検索結果などに製品表の表示に必要なフィールドのみが含まれる、スパース・リストのフェッチ・グループを定義することもできます。

jdo、ejb、kodoで始まる名前、およびdefault、values、all、noneはKodoで使用するため予約されています。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのカスタム・フェッチ・グループに関する項を参照してください。

例

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

fetch-groups

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

1つまたは複数のカスタム・フェッチ・グループを定義します。

デフォルトでは、JPAメタデータ規則に基づきイーガー・ロードされるすべてのフィールドが、組込みのデフォルト・フェッチ・グループ内に配置されます。独自の名前のフェッチ・グループを定義し、それらを実行時にアクティブ化したり非アクティブ化することができます。すべてのアクティブなフェッチ・グループ内のフィールドは、データストアからのオブジェクトのロード時にイーガー・ロードされます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのカスタム・フェッチ・グループに関する項を参照してください。

例

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

field-override

値の範囲: true | false

デフォルト値: true

親要素 :

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

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

機能

フィールドのオーバーライドを有効にするかどうかを指定するフラグ。

例

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

file

値の範囲: 文字列

デフォルト値: 以下参照

親要素 :

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

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

機能

親要素がfile-schema-factoryの場合、XMLスキーマ・ファイルのリソース名を指定します。このファクトリはデフォルトで、CLASSPATHの最上位レベルのディレクトリ内、またはCLASSPATHのJARの最上位レベルにあるpackage.schemaという名前のリソースを検索します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスキーマ・ファクトリに関する項を参照してください。

親要素がlog-factory-implの場合は、メッセージのログが記録されるファイルの名前を指定します。stdoutまたはstderrを指定し、ログ・メッセージをそれぞれ標準出力または標準エラーに出力します。stderrがデフォルトです。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのKodoロギングに関する項を参照してください。

例

<file>stdout</file>

file-name

値の範囲: 文字列

デフォルト値: package.schema

親要素 :

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

機能

XMLスキーマ・ファイルのリソース名を指定します。このファクトリはデフォルトで、CLASSPATHの最上位レベルのディレクトリ内、またはCLASSPATHのJARの最上位レベルにあるpackage.schemaという名前のリソースを検索します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスキーマ・ファクトリに関する項を参照してください。

例

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

file-schema-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

データベース・スキーマに関する情報の格納および取得に使用するkodo.jdbc.schema.SchemaFactoryを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.jdbc.schema.FileSchemaFactory)。

このファクトリはtable-schema-factoryと似ており、同じメリットとデメリットがあります。XMLスキーマ定義がデータベース表ではなく、ファイルに保存されます。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスキーマ・ファクトリに関する項を参照してください。

例

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

files

値の範囲: なし

デフォルト値: なし

親要素 :

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

機能

メタデータ・ファイルまたはJARアーカイブを、セミコロン区切りのリストで指定します。各jarアーカイブでは、使用しているメタデータ・ファクトリに基づいて、アノテーションが付いたJPAエンティティまたはJDOメタデータ・ファイルがスキャンされます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのメタデータ・ファクトリに関する項を参照してください。

例

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

filter-listeners

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

リスナーの標準セットに加え、すべての問合せで利用可能にするカスタムkodo.FilterListenersの1つまたは複数の完全なプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を定義します。Kodo 4.2.0 JPA/JDO開発者ガイドの問合せ言語の拡張機能で説明するように、個々の問合せにフィルタ・リスナーを追加することもできます。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.FilterListenersに関する項を参照してください。

例

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

foreign-keys

値の範囲: true | false

デフォルト値: false

親要素 :

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

機能

スキーマの検証時に、外部キー情報を自動的に読み取るかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスキーマ・ファクトリに関する項を参照してください。

例

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

format

値の範囲: 文字列

デフォルト値: なし

親要素 :

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

機能

形式を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

foxpro-dictionary

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

FoxProディクショナリの永続性プラグインの構成値。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・ヘルプのFoxProディクショナリの構成に関する項を参照してください。

例

foxpro-dictionary要素の下位要素は、access-dictionaryと同じです。

flush-before-queries

値の範囲: true | false | with-connection

デフォルト値: true

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

問合せを実行する前に、現在のトランザクションで行われた変更をデータ・ストアにフラッシュするかどうかを指定するフラグ。有効な値は次のとおりです:

• true - メモリー内で問合せを実行せずに常にフラッシュします。現在のトランザクションが、オプティミスティック・トランザクションである場合、ロックされないデータ・ストア・トランザクションが開始されます。これがデフォルトです。

• false - 問合せの前にフラッシュしません。

• with-connection - EntityManagerまたはPersistenceManagerがデータ・ストアとの専用接続を確立している場合にのみフラッシュし、そうでない場合は、インメモリーで問合せを実行します。

  このオプションは、実行時間が長いオプティミスティック・トランザクションで、コミットするまでデータベース・リソースを消費しないようにする場合に役立ちます。Kodoのこのオプションの動作は、トランザクションのステータスやモードに加え、この項で説明したconnection-retain-modeの構成によって変わります。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJDBC接続の使用の構成に関する項を参照してください。

例

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

hsql-dictionary

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

HSQLディクショナリの永続性プラグインの構成値。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・ヘルプのHSQLディクショナリの構成に関する項を参照してください。

例

hsql-dictionary要素の下位要素は、access-dictionaryと同じです。

gem-fire-data-cache

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit
    data-caches

機能

GemStoneのGemFire v5.0.1キャッシュ・システムと統合します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのGemStoneのGemFireの統合に関する項を参照してください。

例

<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

値の範囲: 有効なGemFire地域名

デフォルト値 :

データ・キャッシュ: root/kodo-data-cache

問合せキャッシュ: root/kodo-query-cache

親要素 :

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

機能

GemFireの領域名。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのGemStoneのGemFireの統合に関する項を参照してください。

例

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

gui-jmx

値の範囲: なし

デフォルト値: なし

親要素 :

jmx

機能

管理を有効にし、ローカルJVMでJMX管理コンソールを呼び出します。Kodo 4.2.0 JPA/JDO開発者ガイドの管理グループのオプションのパラメータに関する項で説明するように、Management Groupのオプション・パラメータをサポートします。

例

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

gui-profiling

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

profiling

機能

ローカルのプロファイリングGUIを起動します。詳細については、『Kodo Developer's Guide』の「Profiling in an Embedded GUI」を参照してください。

例

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

Host

値の範囲: なし

デフォルト値: なし

親要素 :

jmx
    mx4j1-jmx

機能

RMIレジストリ・ネーミング・サービスがリスニングするホスト名。localhostがデフォルトです。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのリモート・グループのオプションのパラメータに関する項を参照してください。

例

<Host>localhost</Host>

host

値の範囲: 有効なホスト名

デフォルト値: localhost

親要素 :

persistence-configuration
  persistence-configuration-unit
    tcp-transport

機能

サーバーのホスト名を指定します。この設定は、サーバーではなく、クライアントが使用します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスタンドアロンの永続性サーバーに関する項を参照してください。

例

<host>localhost</host>

http-transport

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

リモート・サーバーのURLを指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのクライアント・マネージャに関する項を参照してください。

例

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

ignore-changes

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit
    kodo-broker

機能

問合せの評価時に、現在のトランザクションで永続オブジェクトに対して行われた変更を考慮するかどうかを指定するフラグ。trueに設定すると、変更が無視され、データストアに対して直接問合せが実行されます。falseに設定すると、現在のトランザクションにおける変更が問合せに影響するかどうかが考慮され、影響する場合は、その問合せがメモリー内で評価されるか、実行前にデータストアにフラッシュされます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.IgnoreChangesに関する項を参照してください。

例

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

ignore-unmapped

値の範囲: true | false

デフォルト値: false

親要素 :

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

機能

マップされていないベース・クラスを無視するかわりに、最も派生の少ないマップされたクラスごとに1行を使用するかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

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

ignore-virtual

値の範囲: true | false

デフォルト値: true

親要素 :

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

機能

仮想クラスを無視するかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

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

in-memory-savepoint-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

トランザクションのセーブポイントの管理に使用するkodo.kernel.SavepointManagerを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.kernel.InMemorySavepointManager)。このプラグインは、フィールド値を含むすべての状態をメモリーに格納します。このため、設定される各セーブポイントは、トランザクション・オブジェクト数がそれほど多くない状況に対して設計されています。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのセーブポイントに関する項を参照してください。

例

<in-memory-savepoint-manager/>

increment

値の範囲: 整数

デフォルト値: 1

親要素 :

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

機能

シーケンス増分の量を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

<increment>1</increment>

indexes

値の範囲: true | false

デフォルト値: false

親要素 :

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

機能

スキーマの検証時に、索引情報を自動的に読み取るかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスキーマ・ファクトリに関する項を参照してください。

例

<indexes>false</indexes>

informix-dictionary

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

Informixディクショナリの永続性プラグインの構成値。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・ヘルプのInformixディクショナリの構成に関する項を参照してください。

例

informix-dictionary要素の下位要素は、access-dictionaryと同じです。さらに次の下位要素(デフォルト値を表示)も持ちます。

<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

値の範囲: なし

デフォルト値: 1

親要素 :

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

機能

シーケンスの初期値を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

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

interval-millis

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit
    export-profiling

profiling
    export-profiling

機能

エクスポートの間隔(ミリ秒単位)。デフォルト値の-1は、終了時に1回、エクスポートされることを示します。Kodo 4.2.0 JPA/JDO開発者ガイドのバッチ・プロセスによるプロファイル・データのディスクへのダンプに関する項を参照してください。

例

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

inverse-manager

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

フラッシュ時に双方向のリレーションの管理に使用するkodo.kernel.InverseManagerを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの管理対象の逆数に関する項を参照してください。

例

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

jdatastore-dictionary

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

JDataStoreディクショナリの永続性プラグインの構成値。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・ヘルプのJDataStoreディクショナリの構成に関する項を参照してください。

例

jdatastore-dictionary要素の下位要素は、access-dictionaryと同じです。

jdbc-broker-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

使用するkodo.kernel.BrokerFactoryタイプを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、JDBC)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.BrokerFactoryに関する項を参照してください。

例

<jdbc-broker-factory/>

jdbc-listeners

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

リスナーの標準セットに加え、すべての問合せで利用可能にするカスタムkodo.jdbc.kernel.exps.JDBCFilterListenersの1つまたは複数の完全なプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を定義します。Kodo 4.2.0 JPA/JDO開発者ガイドの問合せ言語の拡張機能で説明するように、個々の問合せにフィルタ・リスナーを追加することもできます。

例

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

jdbc3-savepoint-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

トランザクションのセーブポイントの管理に使用するkodo.kernel.SavepointManagerを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルトのkodo.jdbc.kernel.JDBCSavepointManager)。このプラグインは、データベースへのフラッシュの発行によりセーブポイントを実装します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのセーブポイントに関する項を参照してください。

例

<jdbc3-savepoint-manager/>

jdo-meta-data-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

使用するkodo.meta.MetaDataFactoryタイプを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.jdo.JDOMetaDataFactory)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのメタデータ・ファクトリに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

JMSリモート・コミット・プロバイダを構成します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJMSに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

機能

管理機能を構成できるようにします。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの管理と監視に関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

jmx

機能

JMX v.1.2実装を介してリモート管理できるようにします(リモート管理に関するJSR 160をサポート)。Management GroupおよびJSR 160 Groupのオプション・パラメータをサポートします。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの管理グループのオプションのパラメータに関する項とJSR 160グループのオプションのパラメータに関する項をそれぞれ参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit
    JNDIName

機能

リモートJMXアダプタの登録JNDI名。jrmpがデフォルトです。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのリモート・グループのオプションのパラメータに関する項を参照してください。

例

<JNDIName>jrmp</JNDIName>

kodo-broker

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

kodo.BrokerImplを構成します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.BrokerImplに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit
    data-caches

機能

基本の同時データ・キャッシュを有効にします。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデータ・キャッシュに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

システム・データ・キャッシュを管理するkodo.datacache.DataCacheManagerを有効にします。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.DataCacheManagerに関する項を参照してください。

例

<kodo-data-cache-manager/>

kodo-mapping-repository

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

使用するkodo.meta.MetaDataRepositoryを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.MetaDataRepositoryに関する項を参照してください。

例

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

kodo-persistence-mapping-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

永続クラスのオブジェクト・リレーショナル・マッピング情報の格納および取得に使用するkodo.meta.MetaDataFactoryを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)。この設定はJPA 1.0で有効です。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピング・ファクトリに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

使用するkodo.meta.MetaDataFactoryタイプを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、org.apache.openjpa.persistence.PersistenceMetaDataFactory)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのメタデータ・ファクトリに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

デフォルトで接続プーリングを実行するkodo.jdbc.schema.KodoPoolingDataSourceを構成します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJDBCに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

共通のSQLコンストラクトの抽出に使用するkodo.jdbc.SQLFactoryを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.jdbc.SQLFactoryに関する項を参照してください。

例

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

large-transaction

値の範囲: true | false

デフォルト値: true

親要素 :

persistence-configuration
  persistence-configuration-unit
    kodo-broker

機能

トランザクションで多数のオブジェクトを生成するかどうかを指定するフラグ。

例

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

lazy-schema-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

データベース・スキーマに関する情報の格納および取得に使用するkodo.jdbc.schema.SchemaFactoryを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.jdbc.schema.LazySchemaFactory)。

アプリケーションで永続クラスがロードされる際に、永続クラスのメタデータおよびオブジェクト・リレーショナル・マッピング情報が読み取られます。このファクトリは、java.sql.DatabaseMetaDataインタフェースを使用してスキーマでの反映を行い、読取り対象のマッピング・データとの整合性を確保します。ファクトリによる表定義への反映は、その表がマッピング情報で記述されるまで行われないので、それはレイジーと呼ばれます。このファクトリは、開発期間中に、マッピング・メタデータとデータベースの整合性を前もって検証する場合に使用します。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスキーマ・ファクトリに関する項を参照してください。

例

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

level

値の範囲: 1 | 2 | 3 | 4 | 5

デフォルト値: 4

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

ログのレベルを指定します。有効な値は、1(TRACE)、2(DEBUG)、3(INFO)、4(WARN)、5(ERROR)です。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの孤立キーに関する項を参照してください。

例

<level>4</level>

local-jmx

値の範囲: なし

デフォルト値: なし

親要素 :

jmx

機能

ローカル管理を有効にします。この設定は、ユーザー定義のメカニズム、あるいはMBeanServerで定義されるメカニズムで管理するため、すべてのMBeanをJMX MBeanServerに登録する必要があるJBossなどの環境で使用するのに適しています。Kodo 4.2.0 JPA/JDO開発者ガイドの管理グループのオプションのパラメータに関する項で説明するように、Management Groupのオプション・パラメータをサポートします。

例

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

local-profiling

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

profiling

機能

エクスポートまたはGUIを使用しないプロファイリングを有効にします。プログラムでProfilingAgentにアクセスする場合に役立ちます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのプロファイリングに関する項を参照してください。

例

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

lock-timeout

値の範囲: 整数

デフォルト値: -1

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

ロックを取得するまでのデフォルトの待機時間。値-1を指定すると、制限なく待機します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデフォルト・ロックの構成に関する項を参照してください。

例

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

log-factory-impl

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

デフォルトのロギング・システムを構成します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのKodoロギングに関する項を参照してください。

例

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

log-orphaned-key-action

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

孤立データストア・キーの検出時に呼び出すkodo.event.OrphanedKeyActionを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.event.LogOrphanedKeyAction)。この場合、孤立キーごとにメッセージがロギングされます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの孤立キーに関する項を参照してください。

例

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

log4j-log-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

ロギングにLog4Jを使用するように指定します。スタンドアロン・アプリケーションの場合、Log4Jロギング・レベルは、log4j.propertiesという名前のリソースによって制御されます。このリソースは、最上位レベルの(jarファイルの最上位レベルにあるか、いずれかのCLASSPATHディレクトリのルートにある)リソースとして利用できる必要があります。WebまたはEJBアアプリケーション・サーバーにデプロイするとき、Log4J構成は、多くの場合プロパティ・ファイルではなくlog4j.xmlファイルで行われます。Log4Jの構成に関する詳細については、Log4Jマニュアル(http://logging.apache.org/)を参照してください。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのLog4Jに関する項を参照してください。

例

<log4j-log-factory/>

login-timeout

値の範囲: 有効なクラス名

デフォルト値 :

kodo-pooling-data-source: 10

simple-driver-data-source: 0

親要素 :

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

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

機能

ログイン・タイムアウトを指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのKodoデータ・ソースの使用に関する項を参照してください。

例

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

lrs-size

値の範囲: query | last | unknown

デフォルト値: query

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

結果セットのサイズを指定します。このプロパティは、必要に応じて結果がロードされるよう、fetch-batch-sizeのデフォルト値 -1を変更した場合にのみ使用します。有効な値は次のとおりです:

• query - 問合せ結果のサイズを最初に問い合せたときに、予想される結果の数がSELECT COUNT(*)問合せで特定されます。報告されるサイズは、トランザクションのステータスおよび設定に応じて、実際の結果の数と若干異なる場合がある点に注意する必要があります。これがデフォルトです。

• last - スクロール可能な結果セット・タイプを選択している場合、ResultSet.lastメソッドが使用され、結果セットの最後の要素に移動し、その索引を取得します。一部のJDBCドライバでは、最後の要素にアクセスするために、すべての結果がメモリーに格納されてしまいます。スクロール可能な結果セット・タイプを選択していない場合は、unknownの動作と同じです。デフォルトの結果セット・タイプはforward-onlyであるため、このプロパティを利用するには、結果セット・タイプを変更する必要があります。

• unknown - 必要に応じたロードを使用する問合せ結果のサイズとして、Integer.MAX_VALUEが返されます。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの大きな結果セットに関する項を参照してください。

例

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

lru-data-cache

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit
    data-caches

機能

最長時間未使用(LRU)のデータ・キャッシュ・オプションを設定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのLRUキャッシング・オプションの構成に関する項を参照してください。

例

<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

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit
    inverse-manager

機能

大きな結果セットのフィールドを管理に含めるかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの管理対象の逆数に関する項を参照してください。

例

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

mapping

値の範囲: 文字列

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

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

機能

子要素がpersistence-configuration-unitの場合、使用するオブジェクトとデータストアのマッピングの識別名を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピング・メタデータ(JPA)またはマッピング・メタデータの配置(JDO)に関する項を参照してください。

子要素がorm-file-jdor-mapping-factoryの場合、これらのマッピングの論理名を指定します。マッピング・ファイルには、接尾辞がlogicalname.ormのように付きます。論理名を指定しない場合は、kodo.Mapping構成プロパティが使用されます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピング・ファクトリに関する項を参照してください。

例

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

mapping-column

値の範囲: 文字列

デフォルト値: MAPPING_DEF

親要素 :

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

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

機能

XMLマッピングを保持する列名を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピング・ファクトリに関する項を参照してください。

例

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

mapping-defaults-impl

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

default-mapping-defaultsをjdoに設定した場合のデフォルトのマッピング設定を構成します。指定可能な各値の詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピングのデフォルトに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

永続クラスのオブジェクト・リレーショナル・マッピング情報の格納および取得に使用するkodo.meta.MetaDataFactoryを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)。この設定はJDO 1.0で有効です。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピング・ファクトリに関する項を参照してください。

例

<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

値の範囲: 整数

デフォルト値: 2

親要素 :

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

機能

クラスタ内の各ピア間で同時に開くTCPソケット(チャネル)の最大許容数を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのTCPに関する項を参照してください。

例

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

max-idle

値の範囲: 整数

デフォルト値: 2

親要素 :

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

機能

クラスタ内の各ピア間で同時に開くTCPソケット(チャネル)の最大許容数を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのTCPに関する項を参照してください。

例

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

max-size

値の範囲: 整数

デフォルト値: 2147483647

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

問合せ文字列とその解析形式の関連付けに使用する同時ハッシュ・マップの最大サイズを定義します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの問合せコンパイルのキャッシュに関する項を参照してください。

例

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

maximize-batch-size

値の範囲: true | false

デフォルト値: true

親要素 :

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

機能

文のバッチ処理が有効な場合に、バッチ・サイズを最適化するために文をソートするかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.jdbc.UpdateManagerに関する項を参照してください。

例

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

MBeanServerStrategy

値の範囲: any-create | create | agentID:<agentID>

デフォルト値: any-create

親要素 :

jmx
    local-jmx

機能

Kodoは、JMXベースの管理が有効な場合、次のいずれかのオプションに基づいて、既存のMBeanServerを特定するか、新たに作成する必要があります。

• any-create - 既存のMBeanServerを特定します。複数検出された場合は、最初のサーバーを使用します。何も検出されなかった場合は、新しいサーバーを作成します。これがデフォルトです。

• create - 新しいサーバーを作成します。既存のMBeanServerの検出は試行しません。

• agentId:<agentID> - 指定したエージェントIDを持つ既存のMBeanServerを特定します。何も検出されなかった場合は、新しいサーバーを作成します。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの管理グループのオプションのパラメータに関する項を参照してください。

例

<MBeanServerStrategy>any-create</MBeanServerStrategy>

multithreaded

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-broker

機能

永続インスタンスおよびKodoコンポーネントが一度に複数のスレッドによってアクセスされるかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.Multithreadedに関する項を参照してください。

例

<multithreaded>false</multithreaded>

mx4j1-jmx

値の範囲: なし

デフォルト値: なし

親要素 :

jmx

機能

MX4J v.1.x実装を介したリモート管理を有効にします(1.2より前のバージョンのJMX仕様をサポート)。Management GroupおよびRemote Groupのオプション・パラメータをサポートします。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの管理グループのオプションのパラメータに関する項とリモート・グループのオプションのパラメータに関する項をそれぞれ参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

MySQLディクショナリの永続性プラグインの構成値。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・ヘルプのMySQLディクショナリの構成に関する項を参照してください。

例

mysql-dictionary要素の下位要素は、access-dictionaryと同じです。さらに次の下位要素(デフォルト値を表示)も持ちます。

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

name

値の範囲: なし

デフォルト値: なし

親要素 :

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

機能

対応する要素の名前を指定します。

name-column

値の範囲: 文字列

デフォルト値: Name

親要素 :

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

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

機能

マッピング名を保持する列の名前。クラスのマッピングの場合、マッピング名はクラス名です。名前が付けられた問合せおよびシーケンスの場合は、そのシーケンスまたは問合せの名前です。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピング・ファクトリに関する項を参照してください。

例

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

NamingImpl

値の範囲: 有効なクラス名

デフォルト値: なし

親要素 :

jmx
    jmx2-jmx

機能

RMIコネクタをJNDI名に登録するために開始するネーミング・サービス実装のクラス名。デフォルトのmx4j.tools.naming.NamingServiceは、MX4J v. 2.xに適しています。空の文字列を指定すると、ネーミング・サービスが開始されません。この設定は、ネーミング・サービスが実行されているか、非RMIコネクタが使用されている場合に適しています。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJSR 160グループのオプションのパラメータに関する項を参照してください。

例

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

native-jdbc-seq

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

独自のカスタム・ジェネレータの作成に使用するkodo.kernel.Seqインタフェースを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここではkodo.jdbc.kernel.NativeJDBCSeq)。

ほとんどのデータベースには、増分数を取得するための「ネイティブ・シーケンス」という概念のメカニズムが組み込まれています。Oracleの場合、CREATE SEQUENCE MYSEQUENCEなどの文でデータベース・シーケンスを作成することができます。シーケンス値は、SELECT MYSEQUENCE.NEXTVAL FROM DUAL文で自動的に取得およびインクリメントすることができます。Kodoでは、この一般的なシーケンス生成メカニズムをNativeJDBCSeqでサポートしています。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

jmx

機能

管理は有効になりません。これがデフォルトです。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの構成に関する項を参照してください。

例

<none-jmx/>

none-lock-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

ロックを行わないkodo.kernel.NoneLockManagerを指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのロック・マネージャに関する項を参照してください。

例

<none-lock-manager/>

none-log-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

ロギングを無効にします。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのロギングの無効化に関する項を参照してください。

例

<none-log-factory/>

none-orphaned-key-action

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

孤立データストア・キーの検出時に呼び出すkodo.event.OrphanedKeyActionを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.event.NoneOrphanedKeyAction)。この場合、孤立キーは無視されます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの孤立キーに関する項を参照してください。

例

<none-orphaned-key-action/>

none-profiling

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

profiling

機能

コードのプロファイリングを無効にします。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのプロファイリングに関する項を参照してください。

例

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

nontransactional-read

値の範囲: true | false

デフォルト値 :

persistence-configuration: false

kodo-broker: true

親要素 :

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-broker

機能

Kodoランタイムでトランザクション外のデータの読取りを可能にするかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.NontransacationalReadに関する項を参照してください。

例

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

nontransactional-write

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-broker

機能

トランザクション外の永続性に関する処理および永続オブジェクトの変更を可能にするかどうかを指定するフラグ。変更は、次のトランザクションに反映されます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.NontransacationalWriteに関する項を参照してください。

例

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

num-broadcast-threads

値の範囲: なし

デフォルト値: なし

親要素 :

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

機能

ピアにイベントを送信するために作成するスレッドの数を指定します。これは、同時トランザクション数の増加に伴い、大きな値にする必要があります。最大同時トランザクション数は、接続プールのサイズに依存します。Kodo 4.2.0 JPA/JDO開発者ガイドのKodoデータ・ソースの使用に示すkodo.ConnectionFactoryPropertiesのMaxActiveプロパティの説明を参照してください。0に設定すると、commitを呼び出すスレッドが直接ブロードキャストします。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのTCPに関する項を参照してください。

例

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

operation-order-update-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

オブジェクトレベルの処理順序でSQLを記述する更新マネージャを定義します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.jdbc.UpdateManagerに関する項を参照してください。

例

<operation-order-update-manager/>

optimistic

値の範囲: true | false

デフォルト値: true

親要素 :

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-broker

機能

データストアのトランザクション・モードをオプティミスティックにするかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.Optimisticに関する項を参照してください。

例

<optimistic>true</optimistic>

oracle-dictionary

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

Oracleディクショナリの永続性プラグインの構成値。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・ヘルプのOracleディクショナリの構成に関する項を参照してください。

例

oracle-dictionary要素の下位要素は、access-dictionaryと同じです。さらに次の下位要素(デフォルト値を表示)も持ちます。

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

トランザクションのセーブポイントの管理に使用するkodo.kernel.SavepointManagerを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルトのkodo.jdbc.sql.OracleSavepointManager)。このプラグインの動作は、jdbc3-savepoint-managerと似ていますが、このプラグインではOracle固有の呼出しを使用します。このプラグインを使用するには、バージョン9.2以上のOracle JDBCドライバおよびデータベースを使用する必要があります。このプラグインは、データベースへのフラッシュの発行によりセーブポイントを実装します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのセーブポイントに関する項を参照してください。

例

<oracle-savepoint-manager/>

orm-file-jdor-mapping-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

.ormファイルにマッピング・メタデータを格納するkodo.jdo.jdbc.ORMFileJDORMappingFactoryを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)。この設定はJDO 1.0で有効です。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピング・ファクトリに関する項を参照してください。

例

<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

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit
    kodo-broker

機能

ダーティ・オブジェクトに対して行われた変更をデータベースに書き戻す際に、その変更の順序を維持するかどうかを指定するフラグ。

例

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

Password

値の範囲: なし

デフォルト値: なし

親要素 :

jmx
  wls81-jmx

機能

WebLogic MBeanServerへのアクセスに使用されるパスワード。この要素は設定する必要があります。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのWebLogic 8.1グループのオプションのパラメータに関する項を参照してください。

例

<Password>admin</Password>

persistence-configuration

値の範囲: なし

デフォルト値: なし

親要素: なし

機能

永続デプロイメント記述子のルート要素。

persistence-configuration-unit

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration

機能

WebLogic Serverで利用可能な永続性ユニットのデプロイメント情報を格納します。

pessimistic-lock-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

ロックされているオブジェクトに対応するデータベース行をロックするSELECT FOR UPDATE文(または同等のデータベース文)を使用するkodo.jdbc.kernel.PessimisticLockManagerを指定します。このロック・マネージャでは、読取りロックと書込みロックが区別されず、すべて書込みロックとなります。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのロック・マネージャに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

default-mapping-defaultsをjpaに設定した場合のデフォルトのマッピング設定を構成します。指定可能な各値の詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピングのデフォルトに関する項を参照してください。

例

persistence-mapping-defaults要素の下位要素は、mapping-defaults-implと同じです。

populate-data-cache

値の範囲: true | false

デフォルト値: true

親要素 :

persistence-configuration
  persistence-configuration-unit
    kodo-broker

機能

データ・キャッシュへ格納するかどうかを指定するフラグ。月に一度のみの包括的なレポートの実行など、他のトランザクションがアクセスすることがほとんどないと分かっているオブジェクトに現在のトランザクションがアクセスする場合、すぐにまたアクセスすることがないオブジェクトでデータ・キャッシュ全体が埋まらないよう、データ・キャッシュへの格納を無効にすることができます。

例

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

Port

値の範囲: なし

デフォルト値: なし

親要素 :

jmx
  mx4j1-jmx

機能

RMIレジストリ・ネーミング・サービスがリスニングするポート。1099がデフォルトです。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのリモート・グループのオプションのパラメータに関する項を参照してください。

例

<Port>1099</Port>

port

値の範囲: 有効なポート

デフォルト値: 以下参照(親要素によって異なります)

親要素 :

persistence-configuration
  persistence-configuration-unit
    tcp-transport

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

機能

サーバーがリスニングするポートを指定します。この設定は、サーバーではなく、クライアントが使用します。

親要素がtcp-transportの場合、5637がデフォルトです。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスタンドアロンの永続性サーバーに関する項を参照してください。

親要素がtcp-remote-commit-providerの場合、5636がデフォルトです。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのTCPに関する項を参照してください。

例

<port>5637</port>

postgres-dictionary

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

Postgresディクショナリの永続性プラグインの構成値。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・ヘルプのPostgresディクショナリの構成に関する項を参照してください。

例

postgres-dictionary要素の下位要素は、access-dictionaryと同じです。さらに次の下位要素(デフォルト値を表示)も持ちます。

<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

値の範囲: 文字列

デフォルト: ID

親要素 :

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

機能

表の数字の主キー列の名前を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項またはスキーマ・ファクトリに関する項を参照してください。

例

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

primary-key-value

値の範囲: 文字列

デフォルト値: DEFAULT

親要素 :

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

機能

該当インスタンスで使用される主キーを指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

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

primary-keys

値の範囲: true | false

デフォルト値: false

親要素 :

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

機能

スキーマの検証時に、主キー情報を自動的に読み取るかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスキーマ・ファクトリに関する項を参照してください。

例

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

profiling

値の範囲: なし

デフォルト値: なし

親要素: なし

機能

アプリケーション・コードのプロファイリングを構成できます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのプロファイリングに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

プロファイリング・プロキシ・マネージャを構成します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのカスタム・プロキシに関する項を参照してください。

例

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

properties

値の範囲: なし

デフォルト値: なし

親要素 :

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

機能

1つまたは複数のproperty要素を指定します。

property

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit
    properties

機能

プロパティの名前と値を指定できます。

例

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

proxy-manger-impl

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

デフォルトのプロキシ・マネージャを構成します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのカスタム・プロキシに関する項を参照してください。

例

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

query-caches

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

データストアからロードされた問合せのキャッシュに使用するkodo.datacache.QueryCache実装を表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの問合せキャッシュに関する項を参照してください。

例

<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

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit
    compatibility

機能

問合せ文字列内の引用符で囲まれた数値を、文字列ではなく数値として解釈するかどうかを指定するフラグ。trueに設定すると、3.1以前のKodoと同様、引用符で囲まれた数値が数値として処理されます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの互換性の構成に関する項を参照してください。

例

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

read-lock-level

値の範囲: none | read | write |ロック・マネージャ固有のロック・レベル(数値)

デフォルト値: read

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

非オプティミスティック・トランザクション中に所得されたオブジェクトをロックする際の、デフォルトの読取りレベルを設定します。有効な値は次のとおりです:

• none - ロック・レベルなし。

• read - 読取りロック・レベル。

• write - 書込みロック・レベル。

• ロック・マネージャ固有のロック・レベルの数値。

  
  

  注意: デフォルトのJDBCロック・マネージャでは、readおよびwriteの両ロック・レベルは同じです。

  
  

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのオブジェクトのロックに関する項を参照してください。

例

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

recover-action

値の範囲: none | clear

デフォルト値: none

親要素 :

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

機能

リカバリ中に実行する処理を指定します。有効な値は次のとおりです:

• none - 処理を実行しません。

• clear - 通知をクリアします。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのリモート・コミット・プロバイダの構成に関する項を参照してください。

例

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

recovery-time-millis

値の範囲: 整数

デフォルト値: 15000

親要素 :

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

機能

クラスタのピアへの接続が失われた場合に、そのピアへの再接続を試行するまでの待機時間をミリ秒単位で指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのTCPに関する項を参照してください。

例

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

resources

値の範囲: 有効なリソース名

デフォルト値: なし

親要素 :

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

機能

メタデータ・ファイルまたはjarアーカイブのリソースのパスを、セミコロン区切りのリストで指定します。各jarアーカイブでは、使用しているメタデータ・ファクトリに基づいて、アノテーションが付いたJPAエンティティまたはJDOメタデータ・ファイルがスキャンされます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのメタデータ・ファクトリに関する項を参照してください。

例

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

restore-state

値の範囲: true

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

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

デフォルト値: none

親要素 :

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-broker

機能

ロールバック時に、管理対象フィールドをトランザクション前の値にリストアするかどうかを指定するフラグ。

有効な値は次のとおりです:

• all (1) - すべての管理対象値をリストアします。

• none (2) - 状態をロールバックしません。オブジェクトは空になり、次にアクセスされたときに元の状態を再ロードします。

• immutable (3) - 不変の値(プリミティブ、プリミティブ・ラッパー、文字列)をリストアし、次のアクセス時に再ロードされるよう可変値をクリアします。

• true (4) - allと同じです。

• false (5) - noneと同じです。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの状態のリストアに関する項を参照してください。

例

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

result-set-type

値の範囲: forward--only | scroll-sensitive | scroll-insensitive

デフォルト値: forward-only

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

結果リストをフェッチする際に使用するJDBC結果セット・タイプを指定します。この設定は、実行時にも変更することができます。

有効な値は次のとおりです:

• forward-only - カーソルが前方にのみ移動可能な結果セット。結果セットは更新されません。

• scroll-sensitive - 他のユーザーによる変更の影響を受けるスクロール可能な結果セット。結果セットは更新されます。

• scroll-insenstive - 他のユーザーによる変更の影響を受けないスクロール可能な結果セット。結果セットは更新されます。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの大きな結果セットに関する項を参照してください。

例

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

retain-state

値の範囲: true | false

デフォルト値: 以下参照(親によって異なります)

親要素 :

persistence-configuration
  persistence-configuration-unit

persistence-configuration
  persistence-configuration-unit
    kodo-broker

機能

トランザクションのコミット時に、永続フィールドが値を保持するかどうかを指定するフラグ。親要素がpersistence-configuration-unitの場合はtrue、親要素がkodo-brokerの場合はfalseがデフォルトです。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.RetainStateに関する項を参照してください。

例

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

retry-class-registration

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

永続クラスを完全に処理できない場合に、例外をスローせずに警告をログに記録し、登録を遅延させるかどうかを指定するフラグ。この要素は、セキュリティ上、登録されたクラスを読み取れないような複雑なクラスローダーの状況でのみ使用してください。無用にtrueに設定すると、より重大な問題を把握しにくくなる可能性があります。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.RetryClassRegistrationに関する項を参照してください。

例

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

scan-top-down

値の範囲: true | false

デフォルト値: false

親要素 :

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

機能

パッケージ・ツリーの上位レベルから下位レベルへメタデータ・ファイルを検索するかどうかを指定するフラグ。デフォルトでは、下位レベルから上位レベルへスキャンされます。たとえば、クラスCのメタデータのスキャンでは、最初にC.jdo、package.jdoの順にCのパッケージ内で検索され、次に親パッケージ内のpackage.jdoが検索されます。このように、最終的にパッケージのルートまで検索されます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのメタデータ・ファクトリに関する項を参照してください。

例

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

schema

値の範囲: 文字列

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

未修飾表名の先頭に付加されるデフォルトのスキーマ名を指定します。また、新しい表が作成されるスキーマを指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデフォルトのスキーマに関する項を参照してください。

例

<schema>SCHEMA</schema>

schema-column

値の範囲: 文字列

デフォルト値: SCHEMA_DEF

親要素 :

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

機能

スキーマ定義をXML文字列として格納する、表の文字列型の列の名前を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスキーマ・ファクトリに関する項を参照してください。

例

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

schemas

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

永続データに使用するスキーマまたは表、あるいはその両方を、カンマ区切りのリストで指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスキーマ・リストに関する項を参照してください。

例

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

sequence

値の範囲: なし

デフォルト値: OPENJPA_SEQUENCE

親要素 :

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

機能

データベース・シーケンスの名前を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

<sequence>OPENJPA_SEQUENCE</sequence>

sequence-column

値の範囲: 文字列

デフォルト値: SEQUENCE_VALUE

親要素 :

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

機能

現在のシーケンス値を保持する列名を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

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

sequence-name

値の範囲: 文字列

デフォルト値: OPENJPA_SEQUENCE

親要素 :

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

機能

データベース・シーケンスの名前を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

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

ServiceURL

値の範囲: 有効なサービスURL

デフォルト値: service:jmx:rmi://localhost/jndi/jmxservice

親要素 :

jmx
  jmx2-jmx

機能

JMXコネクタ・サーバーが登録される際のJMXサービスURL名。デフォルトのservice:jmx:rmi://localhost/jndi/jmxserviceは、RMIコネクタがJNDI名jmxseviceで使用および登録されることを示しています。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJSR 160グループのオプションのパラメータに関する項を参照してください。

例

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

simple-driver-data-source

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

Kodoデータ・ソース実装を構成します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのKodoデータ・ソースの使用に関する項を参照してください。

例

<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

値の範囲: true | false

デフォルト値: false

親要素 :

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

機能

単一のファイルを使用するかどうかを指定するフラグ。

例

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

single-jvm-exclusive-lock-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

kodo.kernel.SingleJVMExclusiveLockManagerを指定します。このロック・マネージャは、インメモリー・ミューテックスを使用して、オブジェクトIDの排他ロックを取得します。データベース・レベルのロックは行われません。また、読取りロックと書込みロックが区別されず、すべて書込みロックとなります。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのロック・マネージャに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

同じJVM内のpersistenceManagerFactories間でコミット通知を共有するようにKodoを構成します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのリモート・コミット・プロバイダの構成に関する項を参照してください。

例

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

soft-reference-size

値の範囲: 整数

デフォルト値: -1

親要素 :

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

機能

維持されるソフト参照の数を設定します。キャッシュまたは問合せの最大サイズに達すると、ランダム・エントリはソフト参照マップに移され、もうしばらく維持されます。デフォルト値の-1では、無限数のソフト参照が維持されます。ソフト参照を無効にするには、このプロパティを0に設定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデータ・キャッシュ・サイズの構成に関する項と問合せキャッシュに関する項を参照してください。

例

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

so-timeout

値の範囲: 整数

デフォルト値: 0

親要素 :

persistence-configuration
  persistence-configuration-unit
    http-transport

機能

ソケット読込みのタイムアウト時間をミリ秒単位で指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスタンドアロンの永続性サーバーに関する項を参照してください。

例

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

sql-server-dictionary

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

SQLServerディクショナリの永続性プラグインの構成値。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・ヘルプのSQLServerディクショナリの構成に関する項を参照してください。

例

sql-server-dictionary要素の下位要素は、access-dictionaryと同じです。さらに次の下位要素(デフォルト値を表示)も持ちます。

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

stack-execution-context-name-provider

値の範囲: なし

デフォルト値: なし

親要素 :

execution-context-name-provider

機能

プロバイダが現在のスレッドのスタックを検査し、その情報に基づき実行コンテキスト名を作成します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの実行コンテキスト名プロバイダの構成に関する項を参照してください。

例

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

store-mode

値の範囲: 整数

デフォルト値: なし

親要素 :

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

機能

データ・ストアのモードを指定します。

例

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

strict

値の範囲: true | false

デフォルト値: false

親要素 :

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

機能

厳密なモードを有効にするかどうかを指定するフラグ。

例

<strict>true</strict>

strict-identity-values

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit
    compatibility

機能

アプリケーションIDインスタンスの検索に使用するID値が、完全に正しい型でなければならないかどうかを指定するフラグ。デフォルトでは、文字列化されたID値が許容され、数値型間で変換が行われます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの互換性の構成に関する項を参照してください。

例

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

style

値の範囲: line | partial | full

デフォルト値: なし

親要素 :

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

機能

プロバイダが現在のスレッドのスタックを検査し、その情報と次の設定に基づき、実行コンテキスト名を作成します。

• line - 名前は、クラス名、メソッド名、行番号などを含む(存在する場合)、最初の非Kodoスタック行になります。

• partial - フル・スタック・トレースからKodoの行が引かれたものが使用されます。

• full - スタック・トレース全体が使用されます。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの実行コンテキスト名プロバイダの構成に関する項を参照してください。

例

<style>full</style>

subclass-fetch-mode

値の範囲: join | multiple | none | parallel | single

デフォルト値: join

親要素 :

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

機能

他の表にあるサブクラス・データの選択に使用する方法を指定します。有効な値については、「eager-fetch-mode」を参照してください。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドののイーガー・フェッチに関する項を参照してください。

例

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

sybase-dictionary

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

Sybaseディクショナリの永続性プラグインの構成値。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・ヘルプのSybaseディクショナリの構成に関する項を参照してください。

例

sybase-dictionary要素の下位要素は、access-dictionaryと同じです。さらに次の下位要素(デフォルト値を表示)も持ちます。

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

sync-with-managed-transactions

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit
    kodo-broker

機能

管理対象トランザクションと同期するかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのkodo.BrokerImplに関する項を参照してください。

例

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

synchronize-mappings

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration

機能

すべての永続クラスに対してマッピング・ツールを実行し、永続クラスのマッピングとスキーマを実行時に同期させるかどうかを制御します。この要素により、マッピング・ツールを手動で実行する手間が省かれ、テストやデバッグを短時間で完了することができます。詳細については、Kodo開発者ガイドのランタイム転送マッピングに関する項を参照してください。

例

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

table

値の範囲: 文字列

デフォルト値: 以下参照

親要素 :

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

機能

表の名前を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピング・ファクトリに関する項を参照してください。デフォルト値は、次に示すように親要素によって異なります。

• 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

例

<table>KODO_JDO_MAPPING</table>

table-deprecated-jdo-mapping-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

データベース表にマッピング・メタデータをXML文字列として格納するkodo.jdo.jdbc.TableJDORMappingFactoryを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)。この設定はJDO 1.0で有効です。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピング・ファクトリに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

独自のカスタム・ジェネレータの作成に使用するkodo.kernel.Seqインタフェースを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.jdbc.kernel.TableJDBCSeq)。

TableJDBCSeqは、特殊な単一行の表にグローバル・シーケンス番号を格納します。この表は、この表を必要とするクラスに対してマッピング・ツールを最初に実行したときに存在しない場合は作成されます。表の操作には、そのクラスのmainメソッドやsequencetableシェル/バッチ・スクリプトを使用することもできます(使用方法の詳細は、JavadocのTableJDBCSeq.mainメソッドを参照)。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

データベース表にマッピング・メタデータをXML文字列として格納するkodo.jdo.jdbc.TableJDORMappingFactoryを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)。この設定はJDO 2.0で有効です。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピング・ファクトリに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

外部キーおよび自動インクリメントを無視し、表レベルのロックを最適化する、文のバッチ処理が可能な更新マネージャを定義します。これは、表レベルのロックを使用し、デッドロックの回避を試みる場合に役立ちます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのデータ・キャッシュ・サイズの構成に関する項と問合せキャッシュに関する項を参照してください。

例

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

table-name

値の範囲: 文字列

デフォルト値: 以下参照

親要素 :

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

機能

表の名前を指定します。

デフォルト値は、以下に示すように親要素によって異なります。

• class-table-jdbc-seq: OPENJPA_SEQUENCES_TABLE。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

• native-jdbc-seq: DUAL。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

• table-deprecated-jdo-mapping-factory: JDO_MAPPING。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピング・ファクトリに関する項を参照してください。

• table-jdbc-seq: OPENJPA_SEQUENCE_TABLE。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

• table-schema-factory: OPENJPA_SCHEMA。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスキーマ・ファクトリに関する項を参照してください。

• value-table-jdbc-seq: OPENJPA_SEQUENCE_TABLE。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

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

table-schema-factory

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

データベース・スキーマに関する情報の格納および取得に使用するkodo.jdbc.schema.SchemaFactoryを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.jdbc.schema.TableSchemaFactory)。

このスキーマ・ファクトリは、スキーマ情報をXMLドキュメントとしてデータベース表(スキーマ・ファクトリがこのために作成)に格納します。このファクトリは、現在のJDBCドライバでjava.sql.DatabaseMetaData標準インタフェースがサポートされていないが、実行時に一定のスキーマ検証を実行したい場合などに使用することができます。ただし、このファクトリを使用すると、格納されているXMLスキーマ定義と実際のデータベースとの同期が困難になるため、無用に使用しないでください。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスキーマ・ファクトリに関する項を参照してください。

例

<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

値の範囲: 文字列

デフォルト値: kodo

親要素 :

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

機能

使用するTangosol Coherenceキャッシュの名前。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのTangosol統合に関する項を参照してください。

例

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

tangosol-cache-type

値の範囲: named | distributed | replicated

デフォルト値: named

親要素 :

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

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

機能

使用するTangosol Coherenceキャッシュのタイプ。有効な値は次のとおりです:

• named - com.tangosol.net.CacheFactory.getCache(String)メソッドでキャッシュをルックアップします。このメソッドは、Coherence構成で定義した名前に基づいてキャッシュをルックアップします。

• distributed

• replicated

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのTangosol統合に関する項を参照してください。

例

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

tangosol-data-cache

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit
    data-caches

機能

TangosolのCoherenceキャッシュ・システムと統合します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのTangosol統合に関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

TCPリモート・コミット・プロバイダを構成します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのTCPに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

リモート通信用のトランスポート層を指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのスタンドアロンの永続性サーバーに関する項を参照してください。

例

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

time-seeded-seq

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

独自のカスタム・ジェネレータの作成に使用するkodo.kernel.Seqインタフェースを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.jdbc.kernel.TimeSeededSeq)。

このタイプでは、現在時刻にミリ秒単位で初期化され、値がリクエストされるたびに一定の割合でインクリメントされる静的なインメモリー・カウンタが使用されます。これは単一のJVM環境にのみ適しています。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

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

topic

値の範囲: 有効なトピック

デフォルト値: topic/KodoCommitProviderTopic

親要素 :

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

機能

リモート・コミット・プロバイダが通知をパブリッシュしたり、他のJVMから送信された通知をサブスクライブしたりするトピックを指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJMSに関する項を参照してください。

例

<topic>topic/KodoCommitProviderTopic</topic>

topic-connection-factory

値の範囲: 有効な接続ファクトリ

デフォルト値: java:/ConnectionFactory

親要素 :

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

機能

トピックの検索に使用するjavax.jms.TopicConnectionFactoryファクトリのJNDI名を指定します。この設定は、使用しているアプリケーション・サーバーによって異なる場合があります。トピック・インスタンスのデフォルトのJNDI名の詳細は、使用しているアプリケーション・サーバーのマニュアルを参照してください。WebLogicの場合、TopicConnectionFactoryのJNDI名はjavax.jms.TopicConnectionFactoryです。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのJMSに関する項を参照してください。

例

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

track-changes

値の範囲: true | false

デフォルト値: true

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

スマート・プロキシを使用するかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのカスタム・プロキシに関する項を参照してください。

例

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

transaction-isolation

値の範囲: default | none | read-committed | read-uncommitted | repeatable-read | serializable

デフォルト値: default

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

使用するJDBCトランザクションの分離レベルを指定します。

• default - JDBCドライバのデフォルトのレベル。これがデフォルトです。

• none - トランザクションのアイソレーションが設定されません。

• read-committed - ダーティ・リードは阻止され、反復不可能読取りおよびファントム読取りが可能です。

• read-uncommitted - ダーティ・リード、反復不可能読み取り、ファントム読取りが可能です。

• repeatable-read - ダーティ・リードおよび反復不可能読取りは阻止され、ファントム読取りが可能です。

• serializable - ダーティ・リード、反復不可能読み取り、ファントム読取りが阻止されます。

詳細については、Kodo開発者ガイドのトランザクション・アイソレーションの設定に関する項を参照してください。

例

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

transaction-mode

値の範囲: local | managed

デフォルト値: local

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

使用するトランザクション・モードを指定します。この設定は、セッションごとにオーバーライドできます。

• local - トランザクション処理をローカルに実行します。これがデフォルトです。

• managed - アプリケーション・サーバーの管理対象グローバル・トランザクションと統合します。

詳細については、Kodo開発者ガイドのトランザクション・マネージャとの統合に関する項を参照してください。

例

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

transaction-name-execution-context-name-provider

値の範囲: なし

デフォルト値: なし

親要素 :

execution-context-name-provider

機能

WebLogicトランザクション・ネーミング・セマンティクスの定義に基づき、プロバイダが現在のトランザクション名を返します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの実行コンテキスト名プロバイダの構成に関する項を参照してください。

例

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

type

値の範囲: なし

デフォルト値: 0

親要素 :

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

機能

ジェネレータのタイプを指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

<type>0</type>

type-column

値の範囲: 0 | 1 | 2 | 3

デフォルト値: 0

親要素 :

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

機能

マッピングのタイプを格納する列の名前を指定します。有効なタイプ定数は次のとおりです。

• 0 - クラス・マッピング

• 1 - 命名済シーケンス

• 2 - システム・レベルの命名済問合せ

• 3 - クラス・レベルの命名済問合せ

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのマッピング・ファクトリに関する項を参照してください。

例

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

types

値の範囲:有効な永続性クラス名

デフォルト値: なし

親要素 :

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

機能

永続クラスの完全修飾名を、セミコロン区切りのリストで指定します。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのメタデータ・ファクトリに関する項を参照してください。

例

<types>classname1; classname2</types>

URL

値の範囲: 有効なURL

デフォルト値: t3://localhost:7001

親要素 :

jmx
  wls81-jmx

機能

WebLogic MBeanServerにアクセスするために接続する必要があるURL。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのWebLogic 8.1グループのオプションのパラメータに関する項を参照してください。

例

<URL>t3://localhost:7001</URL>

url

値の範囲: 有効なURL

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit
    http-transport

機能

リモート・サーバーへアクセスするために接続する必要のあるURL。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのクライアント・マネージャに関する項を参照してください。

例

<url>t3://localhost:7001/remote-server</url>

urls

値の範囲: 有効なURL

デフォルト値: t3://localhost:7001

親要素 :

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

機能

メタデータ・ファイルまたはjarアーカイブのURLのリストを、セミコロン区切りのリストで指定します。各jarアーカイブでは、使用しているメタデータ・ファクトリに基づいて、アノテーションが付いたJPAエンティティまたはJDOメタデータ・ファイルがスキャンされます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのメタデータ・ファクトリに関する項を参照してください。

例

<urls>t3://localhost:7001/metadata.jar</urls>

use-aliases

値の範囲: true | false

デフォルト値: false

親要素 :

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

機能

完全クラス名ではなく、各行の主キー値として各クラスのエンティティ名を使用するかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

<use-aliases>false</use-aliases>

use-schema-validation

値の範囲: true | false

デフォルト値: なし

親要素 :

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

機能

スキーマ検証を使用するかどうかを指定するフラグ。

例

<use-schema-validation>true</use-schema-validation>

user-object-execution-context-name-provider

値の範囲: なし

デフォルト値: なし

親要素 :

execution-context-name-provider

機能

com.solarmetric.profile.ExecutionContextNameProviderがキーの、現在のEntityManager/PersistenceManagerに指定されたユーザー・オブジェクトをプロバイダが返します。ユーザー・オブジェクトは、OpenJPAEntityManager.putUserObject(Object,Object)またはPersistenceManager.putUserObject(Object,Object)を使用して設定できます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの実行コンテキスト名プロバイダの構成に関する項を参照してください。

例

<user-object-execution-context-name-provider/>

UserName

値の範囲: なし

デフォルト値: なし

親要素 :

jmx
  wsl81-jmx

機能

WebLogic MBeanServerへのアクセスに使用するユーザー名を指定します。この要素は設定する必要があります。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのWebLogic 8.1グループのオプションのパラメータに関する項を参照してください。

例

<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

値の範囲: true | false

デフォルト値: true

親要素 :

persistence-configuration
  persistence-configuration-unit
    compatibility

機能

PersistenceManager.getObjectById(oid, false)の呼出しから、空のオブジェクト(状態がロードされていないオブジェクト)を返すかどうかを指定するフラグ。これは、4.0以上のKodoのデフォルト動作です。前のバージョンのKodoでは、オブジェクトはデータ・ストアから常にロードされていました。このプロパティをfalseに設定すると、前のバージョンの動作になります。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの互換性の構成に関する項を参照してください。

例

<validate-false-returns-hollow>true</validate-false-returns-hollow>

validate-true-checks-store

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit
    compatibility

機能

データ・ストアに特定のoidが存在することを確認するかどうかを指定するフラグ。4.0より前のKodoでは、PersistenceManager.getObjectById(oid, true)を呼び出すと、対応するオブジェクトがキャッシュ済であっても、データ・ストアに特定のoidが存在することを常に確認していました。4.0以上のKodoでは、インスタンスがすでにキャッシュおよびロードされている場合は、データ・ストアがチェックされません。このプロパティをtrueに設定すると、前のバージョンの動作になります。

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの互換性の構成に関する項を参照してください。

例

<validate-true-checks-store>false</validate-true-checks-store>

value-table-jdbc-seq

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

独自のカスタム・ジェネレータの作成に使用するkodo.kernel.Seqインタフェースを表すプラグイン文字列(Kodo 4.2.0 JPA/JDO開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.jdbc.kernel.ValueTableJDBCSeq)。

このシーケンスはtable-jdbc-seqと似ていますが、クラスごとに1行の固定パターンではなく、シーケンス値に任意の行数があります。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのジェネレータに関する項を参照してください。

例

<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

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit
    pessimistic-lock-manager

機能

読取り操作に対するペシミスティックなロック・マネージャのインクリメント動作とバージョン・チェックを有効にするかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのロック・マネージャに関する項を参照してください。

例

<version-check-on-read-lock>false</version-check-on-read-lock>

version-check-on-write-lock

値の範囲: true | false

デフォルト値: false

親要素 :

persistence-configuration
  persistence-configuration-unit
    pessimistic-lock-manager

機能

書込み操作に対するペシミスティックなロック・マネージャのインクリメント動作とバージョン・チェックを有効にするかどうかを指定するフラグ。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのロック・マネージャに関する項を参照してください。

例

<version-check-on-write-lock>false</version-check-on-write-lock>

version-lock-manager

値の範囲: なし

デフォルト値: なし

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

kodo.kernel.VersionLockManagerを指定します。このロック・マネージャは排他ロックを行わないかわりに、読取りロックされているすべてのインスタンスのバージョンがトランザクション終了時に変更されていないことを確認することによって、読取りの一貫性を確保します。さらに、オブジェクトが変更されなくても、書込みロックにより、トランザクション終了時にバージョンが強制的にインクリメントされます。これにより、非ブロック動作と読取りの一貫性が確保されます。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのロック・マネージャに関する項を参照してください。

例

<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

値の範囲: なし

デフォルト値: なし

親要素 :

jmx

機能

管理を有効にし、ローカルJVMでJMX管理コンソールを呼び出します。Management GroupおよびWebLogic 8.1 Groupのオプション・パラメータをサポートします。詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドの管理グループのオプションのパラメータに関する項とWebLogic 8.1グループのオプションのパラメータに関する項を参照してください。

例

<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

値の範囲: none | read | write |ロック・マネージャ固有のロック・レベル(数値)

デフォルト値: read

親要素 :

persistence-configuration
  persistence-configuration-unit

機能

非オプティミスティック・トランザクション中に所得されたオブジェクトをロックする際の、デフォルトの書込みレベルを設定します。有効な値は次のとおりです:

• none - ロック・レベルなし。

• read - 読取りロック・レベル。

• write - 書込みロック・レベル。

• ロック・マネージャ固有のロック・レベルの数値。

  
  

  注意: デフォルトのJDBCロック・マネージャでは、readおよびwriteの両ロック・レベルは同じです。

  
  

詳細は、Kodo 4.2.0 JPA/JDO開発者ガイドのオブジェクトのロックに関する項を参照してください。

例

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