Oracle® Fusion Middleware Oracle WebLogic Server Enterprise JavaBeansバージョン3.0のプログラミング 11g リリース1(10.3.4) B61625-02 |
|
前 |
以下の節では、Kodo固有のデプロイメント記述子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
デプロイメント記述子ファイルには、Oracle Kodoに固有な要素を記述します。
Kodoのpersistence-configuration.xml
の最上位要素は次のとおりです。
persistence-configuration-unit
default-broker-factory | abstract-store-broker-factory | client-broker-factory | jdbc-broker-factory | custom-broker-factory
default-compatibility | compatibility | default-compatibility
default-data-cache-manager | kodo-data-cache-manager | data-cache-manager-impl | custom-data-cache-manager
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
default-lock-manager | pessimistic-lock-manager | none-lock-manager | single-jvm-exclusive-lock-manager | version-lock-manager | custom-lock-manager
commons-log-factory | log4j-log-factory | log-factory-impl | none-log-factory | custom-log
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
default-orphaned-key-action | log-orphaned-key-action | exception-orphaned-key-action | none-orphaned-key-action | custom-orphaned-key-action
default-proxy-manager | profiling-proxy-manager | proxy-manger-impl | custom-proxy-manager
default-query-compilation-cache | cache-map | concurrent-hash-map | custom-query-compilation-cache
jms-remote-commit-provider | single-jvm-remote-commit-provider | tcp-remote-commit-provider | cluster-remote-commit-provider | custom-remote-commit-provider
default-savepoint-manager | in-memory-savepoint-manager | jdbc3-savepoint-manager | oracle-savepoint-manager | custom-savepoint-manager
default-schema-factory | dynamic-schema-factory | file-schema-factory | lazy-schema-factory | table-schema-factory | custom-schema-factory
class-table-jdbc-seq | native-jdbc-seq | table-jdbc-seq | time-seeded-seq | value-table-jdbc-seq | custom-seq
default-update-manager | constraint-update-manager | batching-operation-order-update-manager | operation-order-update-manager | table-lock-update-manager | custom-update-manager
以下のpersistence-configuration.xml
要素のリストには、このリリースのKodoでサポートされているすべての要素が含まれています。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
使用するkodo.kernel.BrokerFactory
タイプを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、abstractstore)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.BrokerFactoryに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
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>
値の範囲: 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
に設定すると、アンロード・フィールドへのアクセス時に例外がスローされます。このオプションは、デタッチ状態マネージャを使用している場合にのみ利用できます。
デタッチ状態の詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。
値の範囲: warn
| exception
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit inverse-manager
インバース・マネージャによって双方向の関係に不整合が検出されたときに実行する処理を制御します。有効なオプションは次のとおりです。
warn
- 警告をログに記録します。
exception
- 例外をスローします。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの管理対象の逆数に関する項を参照してください。
値の範囲: 有効なIPアドレス
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
通知の送信先となるIPアドレスを、セミコロン区切りのリストで指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのTCPに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
すべての問合せで利用できる集約リスナーのリストを指定します。各リスナーは、org.apache.openjpa.kernel.exps.AggregateListener
インタフェースを実装する必要があります。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.AggregateListenersに関する項を参照してください。
値の範囲: 整数
デフォルト値: 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回のみデータベースにアクセスし、新しいシーケンス値を取得します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit
メタデータで宣言されている要素型に割り当てられない要素をコレクションやマップに追加しようとした際に、すぐに例外をスローするかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのカスタム・プロキシに関する項を参照してください。
値の範囲 :
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-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
) - トランザクション外の読取り時に、結果が返される前にインスタンスを自動的にデタッチします。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの自動デタッチに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
管理対象インスタンスが自動的にデタッチされるイベントのリストを指定します。1つまたは複数のauto-detach要素を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの自動デタッチに関する項を参照してください。
値の範囲: 文字列
デフォルト値: なし
親要素 :
profiling export-profiling
作成するエクスポート・データ・ファイルのベース名を定義します。Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのバッチ・プロセスによるプロファイル・データのディスクへのダンプに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
profiling
外部キーおよび表レベルのロックを無視し、アプリケーションがオブジェクトを変更した順序に基づいて最適化する、文のバッチ処理が可能な更新マネージャを定義します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.jdbc.UpdateManagerおよび文のパッチ処理に関する項を参照してください。
値の範囲: 整数
デフォルト値: 10
親要素 :
persistence-configuration persistence-configuration-unit cluster-remote-commit-provider
リモート・コミット・プロバイダのバッファ・サイズを指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのリモート・コミット・プロバイダの構成に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
問合せ文字列とその解析形式の関連付けに使用するキャッシュ・マップを定義します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの問合せコンパイルのキャッシュに関する項を参照してください。
値の範囲: 整数
デフォルト値: 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
データまたは問合せのキャッシュ・サイズを設定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデータ・キャッシュ・サイズの構成に関する項および問合せキャッシュに関する項を参照してください。
値の範囲: 文字列
デフォルト値: openjpa.Runtime
親要素 :
persistence-configuration persistence-configuration-unit
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
独自のカスタム・ジェネレータの作成に使用するkodo.kernel.Seq
インタフェースを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.jdbc.kernel.TableJDBCSeq
)。
TableJDBCSeq
は、特殊な単一行の表にグローバル・シーケンス番号を格納します。この表は、この表を必要とするクラスに対してマッピング・ツールを最初に実行したときに存在しない場合は作成されます。表の操作には、そのクラスのmain
メソッドやsequencetable
シェル/バッチ・スクリプトを使用することもできます(使用方法の詳細は、JavadocのTableJDBCSeq.main
メソッドを参照)。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
<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>
値の範囲: 有効なクラス名
デフォルト値: なし
親要素 :
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
値の範囲: 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メタデータ・ファイルがスキャンされます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのメタデータ・ファクトリに関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit tangosol-data-cache
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
使用するkodo.kernel.BrokerFactory
タイプを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、remote)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.BrokerFactoryに関する項を参照してください。
値の範囲: true
| false
デフォルト値: true
親要素 :
persistence-configuration persistence-configuration-unit compatibility
管理対象トランザクションのコミット後に、closeメソッドを呼び出したものと想定し、JDO PersistenceManagerを終了するかどうかを指定するフラグ。
false
に設定すると、PersistenceManager
は終了しません。つまり、同じJVMの処理層に渡されたオブジェクトは、所有しているPersistenceManager
が終了しないため、使用可能なままになります。この動作は、JDO仕様に厳密に準拠するわけではありませんが、こうした状況でPersistenceManager
を終了しないKodo 2.xに対してコーディングされたアプリケーションには便利です。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの互換性の構成に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
クラスタ内のpersistenceManagerFactory
間でコミット通知を共有するようKodoを構成します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのリモート・コミット・プロバイダの構成に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
ログ・メッセージの発行に使用するApache Jakarta Commons Loggingシン・ライブラリを指定します。Commons Loggingライブラリは、Jakarta Log4JプロジェクトやJDK 1.4のネイティブjava.util.logging package
など、よく利用されている多くのロギングAPIのラッパーとして機能します。これらのライブラリがどちらも利用できない場合は、単純なコンソールでのロギングが使用されます。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのApache共通ロギングに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
実行時の特定の動作について下位互換性の設定を構成します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの互換性の構成に関する項を参照してください。
<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>
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
問合せ文字列とその解析形式の関連付けに使用する同時ハッシュ・マップを定義します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの問合せコンパイルのキャッシュに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
接続ファクトリ上にインストールするorg.apache.openjpa.lib.jdbc.ConnectionDecorator
実装を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)。1つまたは複数のcustom-connection-decorator要素を指定します。
これらのデコレータは、基底のDataSource
から渡された接続をラップして機能性を高めることができます。Kodoでは、すべての接続が使用される前にデコレータのリストを介して渡されます。
注意: Kodo JPA/JDOでは、com.solarmetric.jdbc パッケージ内の組込みデコレータがデフォルトで使用されるため、この要素でデコレータを指定する必要はありません。 |
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.jdbc.ConnectionDecoratorsに関する項を参照してください。
値の範囲: 有効なクラス名
デフォルト値: なし
親要素 :
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
実装の完全修飾クラス名。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの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
値の範囲: local
| managed
デフォルト値: local
親要素 :
persistence-configuration persistence-configuration-unit
アプリケーション・サーバーの管理対象トランザクションとの統合時に使用する接続ファクトリのモード。有効なオプションは次のとおりです。
local
- Kodo制御下の標準データ・ソースを指定します。
managed
- アプリケーション・サーバーで管理され、グローバル・トランザクションに自動登録されるデータ・ソースを指定します。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの管理対象データ・ソースとXAデータ・ソースに関する項を参照してください。
値の範囲: JNDI名
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
データベースへの接続に使用するJDBCのjavax.sql.DataSource
実装のJNDIロケーション。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのJDBCに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
使用するjavax.sql.DataSource(http://java.sun.com/javase/6/docs/api/javax/sql/DataSource.html
で説明)の構成のプロパティを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのJDBCに関する項を参照してください。
値の範囲: JNDI名
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
データベースへの接続に使用する管理対象ではないjavax.sql.DataSource
のJNDIロケーション。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのXAトランザクションに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
非管理対象のConnectionFactoryとして使用するjavax.sql.DataSource
(http://java.sun.com/javase/6/docs/api/javax/sql/DataSource.html
で説明)の構成プロパティ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの管理対象データソースとXAデータソースに関する項を参照してください。
値の範囲: 有効なパスワード
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
connection-user-name
で指定されるユーザーのパスワード。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのJDBCに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
connection-driver-name
要素にリストされるドライバの構成プロパティをリストするプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)。これらのプロパティは、与えられたドライバ・クラスがDataSourceである場合、そのDataSourceのBeanプロパティの構成に使用されます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの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>
値の範囲: always
| on-demand
| persistence-manager
| transaction
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
データ・ストア接続の使用方法を制御します。有効な値は以下のとおりです。
always
- 各EntityManager
またはPersistenceManager
が単一の接続を取得し、EntityManager
またはPersistenceManager
が終了するまでその接続を使用します。
on-demand
- 接続は必要時にのみ取得されます。このオプションは、データ・ストア・トランザクションが使用されている場合、transaction
オプションと同じです。ただし、オプティミスティック・トランザクションの場合は、データ・ストアのフラッシュおよびコミット・プロセス中にのみ接続が保持されることになります。
persistence-manager
- 接続は永続性マネージャから取得されます。
transaction
- 接続は各トランザクション(オプティミスティックまたはデータ・ストア)の開始時に取得され、トランザクションの完了時にリリースされます。非トランザクション接続は、必要に応じて取得されます。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのJDBC接続の使用の構成に関する項を参照してください。
値の範囲: 有効な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。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの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
値の範囲: 有効なユーザー名
デフォルト値: なし
親要素 :
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で指定されているデータ・ソースへの接続に使用するユーザー名。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのJDBCに関する項を参照してください。
値の範囲: 有効なユーザー名
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
非管理対象データベースへの接続に使用するJDBCのjava.sql.Driver
またはjavax.sql.DataSource
実装の完全なクラス名。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの管理対象データソースとXAデータソースに関する項を参照してください。
値の範囲: 有効なパスワード
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
connection2-driver-name
で指定される非管理対象データ・ソースのプロパティ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの管理対象データ・ソースと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>
値の範囲: 有効なURL
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
非管理対象データ・ソースのJDBC URL。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの管理対象データ・ソースとXAデータ・ソースに関する項を参照してください。
値の範囲: 有効なユーザー名
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit table-jdor-mapping-factory
生成されるすべてのマッピングに一意制約や外部キーの名前を含めるかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピング・ファクトリに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
文のバッチ処理および外部キー制約の評価が可能な、標準の更新マネージャを定義します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.jdbc.UpdateManagerおよび文のバッチ処理に関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit compatibility
oid
オブジェクトが返される前にコピーするかどうかを指定するフラグ。3.0より前のバージョンのKodoでは、oid
オブジェクトが返される前に常にコピーされていました。これにより、oid
オブジェクトを参照で変更することによって生じるエラーを回避することができますが、oid
インスタンスを変更しない大多数のユーザーにとっては効率が良くありませんでした。したがって、3.0以上のKodoでは、oid
はデフォルトではコピーされません。このプロパティをtrue
に設定すると、oid
がコピーされます。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの互換性の構成に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit aggregate-listeners
カスタム集約リスナーを定義します。各リスナーは、org.apache.openjpa.kernel.exps.AggregateListener
インタフェースを実装する必要があります。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.AggregateListenersに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム・ブローカ・ファクトリを指定することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.BrokerFactoryに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム・ブローカ実装を定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.BrokerImplに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
クラス名を解決するためのカスタム・クラス・リゾルバを定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.ClassResolverに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
独自のカスタム互換性フラグを定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの互換性の構成に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit connection-decorators
すべての接続プール上にインストールするカスタムorg.apache.openjpa.lib.jdbc.ConnectionDecorator
実装を定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.jdbc.ConnectionDecoratorsに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit data-caches
カスタム・データ・キャッシュを定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.DataCacheに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム・データ・キャッシュ・マネージャを定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.DataCacheManagerに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム・デタッチ状態を定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.DetachStateに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム・ディクショナリを定義することができます。詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのカスタム・ディクショナリの構成に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム・データ・ソース・ドライバを定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.jdbc.DriverDataSourceに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit filter-listeners
カスタム・フィルタ・リスナーを定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.FilterListenersに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit jdbc-listeners
カスタムJDBCリスナーを定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.JDBCListenerに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム・ロック・マネージャを定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのロック・マネージャに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム・ログ・ファイルを定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのカスタム・ログに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
マッピングのカスタム・デフォルト設定を定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピング・ファクトリに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
マッピングのカスタム・ファクトリを指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピング・ファクトリに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム・メタデータ・ファクトリを指定することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのメタデータ・ファクトリに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム・メタデータ・リポジトリを指定することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのメタデータ・ファクトリに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
孤立キーのカスタム動作を定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの孤立キーに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム永続性サーバーを定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスタンドアロン永続性サーバーに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム・プロキシ・マネージャを定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのカスタム・プロキシに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム問合せコンパイルのキャッシュを定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの問合せコンパイルのキャッシュに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム・リモート・コミット・プロバイダを指定することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのJMSに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム・セーブポイント・マネージャを指定することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのセーブポイントに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム・スキーマ・ファクトリを指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスキーマ・ファクトリに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタム・ジェネレータを定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
カスタムSQLファクトリを定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.jdbc.SQLFactoryに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
永続オブジェクトの変更をデータストアへフラッシュするために使用する、カスタム更新マネージャを定義することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.jdbc.UpdateManagerに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
データストアからロードされたデータのキャッシュに使用するプラグインを指定します。org.apache.openjpa.datacache.DataCache
を実装する必要があります。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデータ・キャッシュに関する項を参照してください。
<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>
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
システム・データ・キャッシュを管理するkodo.datacache.DataCacheManager
を有効にします。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.DataCacheManagerに関する項を参照してください。
値の範囲: 整数
デフォルト値: -1
親要素 :
persistence-configuration persistence-configuration-unit
クラスのデータを有効に保つ時間をミリ秒単位で指定します。-1
を指定すると、期限が設定されません。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデータ・キャッシュ・タイムアウト値の設定に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
DB2ディクショナリの永続性プラグインの構成値を定義します。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのDB2ディクショナリの構成に関する項を参照してください。
値の範囲: 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」メソッドで取得およびロードします。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのフィールドとプロパティのメタデータに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
使用するkodo.kernel.BrokerFactory
タイプを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここではデフォルトのJDBC)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.BrokerFactoryに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
実行時に使用するkodo.kernel.Broker
タイプを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここではデフォルト)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.BrokerImplに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
クラス名の解決に使用するkodo.util.ClassResolver
実装を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルト)。特別なクラス・ロード・ニーズがある場合は、独自のリゾルバを設定することもできます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.ClassResolverに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit data-caches
デフォルトのデータ・キャッシュを定義します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデータ・キャッシュに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
デフォルトのデタッチ状態を指定します(ここでは、loaded
)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
システム・データ・キャッシュを管理するkodo.datacache.DataCacheManager
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここではデフォルト)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデータ・キャッシュに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
javax.sql.DataSource
インスタンスを使用したJDBCドライバ・クラスのラップに使用するデフォルトのkodo.jdbc.schema.DriverDataSource
実装を指定します。デフォルトの実装として提供されているkodo.jdbc.schema.KodoPoolingDataSource
は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのJDBCに関する項で説明するように、接続プーリングを実行します。
値の範囲: TRACE
| DEBUG
| INFO
| WARN
| ERROR
デフォルト値: INFO
親要素 :
persistence-configuration persistence-configuration-unit log-factory-impl
構成されていないチャネルのデフォルトのロギング・レベルを指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのKodoロギングに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
デフォルトのロック・マネージャを使用するように指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデフォルト・ロックの構成に関する項を参照してください。
値の範囲: 文字列
標準的な実装: jdo
およびjpa
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
デフォルトの列名、表名、および永続クラスの制約の定義に使用するkodo.jdbc.meta.MappingDefaults
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します。詳細と標準実装のリストについては、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピングのデフォルトに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
使用するkodo.meta.MetaDataFactory
タイプを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここではデフォルトのkodo.jdo.JDOMetaDataFactory
)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのメタデータ・ファクトリに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
永続クラスのメタデータの格納に使用するkodo.meta.MetaDataRepository
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここではデフォルト)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのメタデータ・ファクトリに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
孤立データストア・キーの検出時に呼び出すkodo.event.OrphanedKeyAction
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルトのkodo.event.LogOrphanedKeyAction
)。この場合、孤立キーごとにメッセージがロギングされます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの孤立キーに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
可変の別のクラス・オブジェクトのプロキシに使用するkodo.util.ProxyManager
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここではデフォルトのkodo.util.ProxyManagerImpl
)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのカスタム・プロキシに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
問合せ文字列とその解析形式の関連付けに使用するマップを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここではデフォルト)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの問合せコンパイルのキャッシュに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
トランザクションのセーブポイントの管理に使用するkodo.kernel.SavepointManager
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルトのkodo.kernel.InMemorySavepointManager
)。このプラグインは、フィールド値を含むすべての状態をメモリーに格納します。このため、設定される各セーブポイントは、トランザクション・オブジェクト数がそれほど多くない状況に対して設計されています。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのセーブポイントに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
データベース・スキーマに関する情報の格納および取得に使用するkodo.jdbc.schema.SchemaFactory
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルトのkodo.jdbc.schema.DynamicSchemaFactory
)。
DynamicSchemaFactory
は、データベースに対してマッピング情報を検証しないため、最もパフォーマンスの優れたスキーマ・ファクトリです。かわりに、すべてのオブジェクト・リレーショナル・マッピング情報が正しいと想定し、現在のマッピング・メタデータからスキーマのメモリー内表現を動的に構築します。このファクトリを使用するには、外部キー制約がSQL文で満たされるよう、マッピング・メタデータが現在のデータベースの外部キー制約を正しく表現している必要があります。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスキーマ・ファクトリに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
共通のSQLコンストラクトの抽出に使用するkodo.jdbc.SQLFactory
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここではデフォルト)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.jdbc.SQLFactoryに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
デフォルトの更新マネージャkodo.jdbc.kernel.ConstraintUpdateManager
を使用するように指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.jdbc.UpdateManagerに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
JDO 1.0のマッピングのデフォルト設定を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピングのデフォルトに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
使用するkodo.meta.MetaDataFactory
タイプを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここではkodo.jdo.DeprecatedJDOMetaDataFactory
)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのメタデータ・ファクトリに関する項を参照してください。
<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>
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
Derbyディクショナリを構成します。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのDerbyディクショナリの構成に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
デタッチ状態をall
に設定し、すべてのフィールドおよびリレーションをデタッチします。関連性の高いドメイン・モデルを使用している場合、データベース内のすべてのオブジェクトがメモリーに格納される恐れがあるため、このモードの使用には注意が必要です。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
デフォルトのフェッチ・グループ内、および現在のフェッチ構成に追加したその他のフェッチ・グループ内のすべてのフィールドおよびリレーションをデタッチするようにデタッチ状態を設定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのフェッチ・グループに関する項を参照してください。デタッチ状態の詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
ロード済のすべてのフィールドおよびリレーションをデタッチするようデタッチ状態を設定します。ただし、ロードされていないフィールドはデタッチ・グラフに含めません。これがデフォルトです。デタッチ状態の詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。
値の範囲: 1
| 2
| 3
デフォルト値: 1
親要素 :
persistence-configuration persistence-configuration-unit] kodo-broker
デタッチ状態を構成します。有効な値は以下のとおりです。
1
(loaded
): ロード済のすべてのフィールドおよびリレーションをデタッチします。ただし、ロードされていないフィールドはデタッチ・グラフに含めません。
2
(fetch-groups
) - 現在のフェッチ構成内のすべてのフィールドおよびリレーションをデタッチします。
3
(all
) - すべてのフィールドおよびリレーションをデタッチします。関連性の高いドメイン・モデルを使用している場合、データベース内のすべてのオブジェクトがメモリーに格納される恐れがあるため、このモードの使用には注意が必要です。
デタッチ・モードで特定されないフィールドはすべて、デタッチ・インスタンスのJavaデフォルト値に設定されます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。
値の範囲: 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
アタッチ・プロセスを効率化するため、デタッチ状態フィールドを利用するかどうかを指定するフラグ。このフィールドはエンハンサによって追加され、アプリケーションには表示されません。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのアタッチの動作に関する項を参照してください。
デタッチ状態の詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。
値の範囲: 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の動作に違和感がある場合や、デバッグを行う場合に役立つ場合があります。
デタッチ状態の詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。
値の範囲: 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に設定すると、シリアライズされないローカル・オブジェクトでデタッチ状態フィールドのメリットを利用でき、改善されていないバージョンのクラスへアクセスできないクライアント層のシリアライゼーションに関する互換性も維持されます。
デタッチ状態の詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。
値の範囲: true
| false
デフォルト値: true
親要素 :
persistence-configuration persistence-configuration-unit kodo-broker
シリアライゼーションに関する互換性がないオブジェクトでも効率的にアタッチできるよう、一時的でないデタッチ状態フィールドを使用するかどうかを指定するフラグ。ただし、この機能を利用するには、改善されたバージョンのクラスおよびKodoライブラリがクライアント層に存在する必要があります。
デタッチ状態の詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデタッチされたオブジェクト・グラフの定義に関する項を参照してください。
値の範囲: 文字列
デフォルト値: kodo.ID
プロパティ(設定している場合)
親要素 :
persistence-configuration persistence-configuration-unit log-factory-impl
すべてのログ・メッセージの先頭に付加する文字列。指定している場合、kodo.ID
プロパティがデフォルトで使用されます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのKodoロギングに関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit
永続データを保持するカスタマイズされた構造体を動的に生成するかどうかを指定するフラグ。Kodoのデータ・キャッシュとリモート・フレームワークはどちらも、データ構造体に基づき永続状態のキャッシュおよび転送を行います。Kodoでは、動的な構造体により、クラスごとにデータ・ストレージをカスタマイズでき、プリミティブ・ラッパー・オブジェクトを生成せずに済みます。これによってメモリーを節約し、特定の実行時処理を素早く完了することができます。
反面、カスタム・クラスの生成とJVMへのロードに時間がかかるため、アプリケーションのウォームアップ時間が長くなります。したがって、アプリケーションの実行時間が長くても、メモリーおよび処理時間の最適化により、クラスの初期生成コストが徐々に相殺される場合にのみ、このプロパティをtrue
に設定してください。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.DynamicDataStructsに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
データベース・スキーマに関する情報の格納および取得に使用するkodo.jdbc.schema.SchemaFactory
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルトのkodo.jdbc.schema.DynamicSchemaFactory
)。
DynamicSchemaFactory
は、データベースに対してマッピング情報を検証しないため、最もパフォーマンスの優れたスキーマ・ファクトリです。かわりに、すべてのオブジェクト・リレーショナル・マッピング情報が正しいと想定し、現在のマッピング・メタデータからスキーマのメモリー内表現を動的に構築します。このファクトリを使用するには、外部キー制約がSQL文で満たされるよう、マッピング・メタデータが現在のデータベースの外部キー制約を正しく表現している必要があります。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスキーマ・ファクトリに関する項を参照してください。
値の範囲: join
| multiple
| none
| parallel
| single
デフォルト値: parallel
親要素 :
persistence-configuration persistence-configuration-unit
イーガー・フェッチを構成します。イーガー・フェッチは、サブクラス・データと関連オブジェクトを、問合せ対象のベース・インスタンスとともに効率的にロードする機能です。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのイーガー・フェッチに関する項を参照してください。
このプロパティは、以下のいずれかの値に設定することができます。
join
- このモードに設定すると、構成されているフェッチ・グループの対1リレーションへの結合が行われます。単一インスタンスのデータをロードする場合は、構成されているフェッチ・グループのコレクション・フィールドへの結合も行われます。ただし、問合せの実行時など、複数インスタンスのデータをロードする場合は、コレクションへはデフォルトで結合されません。かわりに、次に説明するように、コレクションに対してはデフォルトでparallelモードになります。コレクション・フィールドに対してparallelモードではなくjoinモードを使用するように設定するには、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのイーガー・フェッチ・モードに関する項で説明されているメタデータ拡張を使用します。
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モードを使用するように設定するには、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのイーガー・フェッチ・モードで説明されているメタデータ拡張を使用します。
サブクラスのフェッチ・モードをparallelに設定すると、table-per-class階層および垂直継承階層に影響します。Kodoは、parallelモードの場合、joinモードでのすべてのサブクラス表のUNION演算ではなく、table-per-class継承階層のサブクラスごとに別個のSELECT文を発行します。これは、問合せ、IDによるルックアップ、リレーション・トラバースなど、table-per-classベース・クラスに対するあらゆる処理に適用されます。
一方、垂直にマップされた階層を処理する場合、parallelのサブクラス・フェッチ・モードが適用されるのは問合せのみです。Kodoは、サブクラス表への外部結合ではなく、サブクラスごとに問合せを別個に発行します。その他の状況下におけるparallelのサブクラス・フェッチ・モードの動作は、垂直にマップされたサブクラスに関してはjoinモードと同じです。
Kodoは、選択しているオブジェクトが1つしかない場合、parallelモードを使用しません。これは、追加のSELECT文を同じ効率で遅延実行できるためです。parallelモードがjoinモードより効率的なのは、イーガー・リレーションを持つ複数のオブジェクトがロードされる場合や、すべてのサブクラスへ結合するより複数のSELECT文を実行した方が速く処理が完了する場合のみです。
single
- join
と同じです。
値の範囲: なし
デフォルト値: なし
親要素 :
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>
値の範囲: true
| false
デフォルト値: なし
親要素 :
jmx local-jmx
LogMBean
を登録するかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの管理グループのオプションのパラメータに関する項を参照してください。
値の範囲: true
| false
デフォルト値: なし
親要素 :
jmx local-jmx
RuntimeMBean
を登録するかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの管理グループのオプションのパラメータに関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit kodo-broker
特定の間隔でデータ・キャッシュからデータをクリアするかどうかを指定するフラグ。クリア・スケジュールは、eviction-schedule要素で定義します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデータ・キャッシュに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
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つのトークンをホワイトスペース区切りでリストします。*
記号(アスタリスク)をあらゆる値に一致するワイルドカードとして使用することができます。以下に、これらのトークンを指定すべき順序で示します。
分
時
日
月
曜日
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの追出しスケジュールの構成に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
孤立データストア・キーの検出時に呼び出すkodo.event.OrphanedKeyAction
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.event.ExceptionOrphanedKeyAction
)。この場合、孤立キーごとに例外がスローされます。JPAでは、javax.persistence.EntityNotFoundException
の例外になります。JDOでは、javax.jdo.JDOObejctNotFoundException
の例外になります。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの孤立キーに関する項を参照してください。
値の範囲: 整数
デフォルト値: 0
親要素 :
persistence-configuration persistence-configuration-unit jms-remote-commit-provider
JMSシステムから重大な接続エラーが通知された場合の、再接続の試行回数を指定します。0(デフォルト値)を指定するとエラーはログに記録されますが、それ以外の値を指定すると、接続がまだ有効とみなされエラーが無視されます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのJMSに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素: なし
実行コンテキスト名プロバイダを構成します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの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>
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit profiling
エクスポート・プロファイリング・データを構成します。Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのバッチ処理によるプロファイリング・データのディスクへのダンプに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
永続クラスのオブジェクト・リレーショナル・マッピング情報の格納および取得に使用するkodo.meta.MetaDataFactory
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)。この設定はJDO 1.0で有効です。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピング・ファクトリに関する項を参照してください。
<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>
値の範囲: 整数
デフォルト値: -1
親要素 :
persistence-configuration persistence-configuration-unit
結果セットをスクロールする際に一度にフェッチする行数。フェッチ・サイズは、実行時にも設定することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの大きな結果セットに関する項を参照してください。
値の範囲: forward
| reverse
| unknown
デフォルト値: true
親要素 :
persistence-configuration persistence-configuration-unit
問合せ結果リストがアクセスされる順序。この値は、結果の格納に使用されるデータ構造のタイプに影響し、特定のアクセス・パターンで最適化が可能な場合はJDBCドライバに渡されます。この要素には、以下に示す値を指定できます。各値は、同じ名前のjava.sql.ResultSet FETCH
定数に対応しています。
forward
- 問合せ結果が順番にリストされます。これがデフォルトです。
reverse
- 問合せ結果が逆の順序でリストされます。
unknown
- 順序が指定されません。
このプロパティは、実行時にも変更することができます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの大きな結果セットに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit fetch-group
フェッチ・グループの名前。フェッチ・グループ名はグローバルで、クラス間で共有されます。たとえば、ショッピングWebサイトで、各製品クラスに詳細なフェッチ・グループを使用すると、各製品の「詳細な」ページの表示に必要なすべてのデータを効率的にロードすることができます。このWebサイトでは、検索結果などに製品表の表示に必要なフィールドのみが含まれる、スパース・リストのフェッチ・グループを定義することもできます。
jdo、ejb、kodoで始まる名前、およびdefault、values、all、noneはKodoで使用するため予約されています。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのカスタム・フェッチ・グループに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
1つまたは複数のカスタム・フェッチ・グループを定義します。
デフォルトでは、JPAメタデータ規則に基づきイーガー・ロードされるすべてのフィールドが、組込みのデフォルト・フェッチ・グループ内に配置されます。独自の名前のフェッチ・グループを定義し、それらを実行時にアクティブ化したり非アクティブ化することができます。すべてのアクティブなフェッチ・グループ内のフィールドは、データストアからのオブジェクトのロード時にイーガー・ロードされます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのカスタム・フェッチ・グループに関する項を参照してください。
値の範囲: true
| false
デフォルト値: true
親要素 :
persistence-configuration persistence-configuration-unit kodo-persistence-mapping-factory persistence-configuration persistence-configuration-unit kodo-persistence-meta-data-factory
値の範囲: 文字列
デフォルト値: 以下参照
親要素 :
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
という名前のリソースを検索します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスキーマ・ファクトリに関する項を参照してください。
親要素がlog-factory-implの場合は、メッセージのログが記録されるファイルの名前を指定します。stdout
またはstderr
を指定し、ログ・メッセージをそれぞれ標準出力または標準エラーに出力します。stderr
がデフォルトです。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのKodoロギングに関する項を参照してください。
値の範囲: 文字列
デフォルト値: package.schema
親要素 :
persistence-configuration persistence-configuration-unit file-schema-factory
XMLスキーマ・ファイルのリソース名を指定します。このファクトリはデフォルトで、CLASSPATH
の最上位レベルのディレクトリ内、またはCLASSPATH
のJARの最上位レベルにあるpackage.schema
という名前のリソースを検索します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスキーマ・ファクトリに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
データベース・スキーマに関する情報の格納および取得に使用するkodo.jdbc.schema.SchemaFactory
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.jdbc.schema.FileSchemaFactory
)。
このファクトリは、table-schema-factoryと多くの点で似ており、長所および短所も同じですが、XMLスキーマ定義をデータベース表ではなく、ファイルに格納する点が異なります。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスキーマ・ファクトリに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
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メタデータ・ファイルがスキャンされます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのメタデータ・ファクトリに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
リスナーの標準セットに加え、すべての問合せで利用可能にするカスタムkodo.FilterListeners
の1つまたは複数の完全なプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を定義します。個々の問合せには、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの問合せ言語の拡張機能に関する項で説明するように、フィルタ・リスナーを追加することもできます。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.FilterListenersに関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit lazy-schema-factory
スキーマの検証時に、外部キー情報を自動的に読み取るかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスキーマ・ファクトリに関する項を参照してください。
値の範囲: 文字列
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit native-jdbc-seq
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
FoxProディクショナリの永続性プラグインの構成値。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのFoxProディクショナリの構成に関する項を参照してください。
値の範囲: true
| false
| with-connection
デフォルト値: true
親要素 :
persistence-configuration persistence-configuration-unit
問合せを実行する前に、現在のトランザクションで行われた変更をデータ・ストアにフラッシュするかどうかを指定するフラグ。有効な値は以下のとおりです。
true
- メモリー内で問合せを実行せずに常にフラッシュします。現在のトランザクションが、オプティミスティック・トランザクションである場合、ロックされないデータ・ストア・トランザクションが開始されます。これがデフォルトです。
false
- 問合せの前にフラッシュしません。
with-connection
- EntityManager
またはPersistenceManager
がデータ・ストアとの専用接続を確立している場合にのみフラッシュします。確立していない場合は、メモリー内で問合せを実行します。
このオプションは、実行時間が長いオプティミスティック・トランザクションで、コミットするまでデータベース・リソースを消費しないようにする場合に役立ちます。Kodoのこのオプションの動作は、トランザクションのステータスやモードに加え、この節で説明したconnection-retain-modeの構成によって変わります。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのJDBC接続の使用の構成に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
HSQLディクショナリの永続性プラグインの構成値。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのHSQLディクショナリの構成に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit data-caches
GemStoneのGemFire v5.0.1キャッシュ・システムと統合します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのGemStoneのGemFireの統合に関する項を参照してください。
値の範囲: 有効なGemFire地域名
デフォルト値 :
データ・キャッシュ: root/kodo-data-cache
問合せキャッシュ: root/kodo-query-cache
親要素 :
persistence-configuration persistence-configuration-unit data-caches gem-fire-data-cache
GemFireの領域名。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのGemStoneのGemFireの統合に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
jmx
管理を有効にし、ローカルJVMでJMX管理コンソールを呼び出します。Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの管理グループのオプションのパラメータに関する項で説明するように、Management Group
のオプション・パラメータをサポートします。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit profiling
値の範囲: なし
デフォルト値: なし
親要素 :
jmx mx4j1-jmx
RMIレジストリ・ネーミング・サービスがリスニングするホスト名。localhost
がデフォルトです。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのリモート・グループのオプションのパラメータに関する項を参照してください。
値の範囲: 有効なホスト名
デフォルト値: localhost
親要素 :
persistence-configuration persistence-configuration-unit tcp-transport
サーバーのホスト名を指定します。この設定は、サーバーではなく、クライアントが使用します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスタンドアロンの永続性サーバーに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
リモート・サーバーのURLを指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのクライアント・マネージャに関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit kodo-broker
問合せの評価時に、現在のトランザクションで永続オブジェクトに対して行われた変更を考慮するかどうかを指定するフラグ。true
に設定すると、変更が無視され、データストアに対して直接問合せが実行されます。false
に設定すると、現在のトランザクションにおける変更が問合せに影響するかどうかが考慮され、影響する場合は、その問合せがメモリー内で評価されるか、実行前にデータストアにフラッシュされます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.IgnoreChangesに関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit class-table-jdbc-seq
マップされていないベース・クラスを無視するかわりに、最も派生の少ないマップされたクラスごとに1行を使用するかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
値の範囲: true
| false
デフォルト値: true
親要素 :
persistence-configuration persistence-configuration-unit class-table-jdbc-seq
仮想クラスを無視するかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
トランザクションのセーブポイントの管理に使用するkodo.kernel.SavepointManager
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.kernel.InMemorySavepointManager
)。このプラグインは、フィールド値を含むすべての状態をメモリーに格納します。このため、設定される各セーブポイントは、トランザクション・オブジェクト数がそれほど多くない状況に対して設計されています。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのセーブポイントに関する項を参照してください。
値の範囲: 整数
デフォルト値: 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
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit lazy-schema-factory
スキーマの検証時に、索引情報を自動的に読み取るかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスキーマ・ファクトリに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
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>
値の範囲: なし
デフォルト値: 1
親要素 :
persistence-configuration persistence-configuration-unit native-jdbc-seq
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit export-profiling profiling export-profiling
エクスポートの間隔(ミリ秒単位)。デフォルト値の-1は、終了時に1回、エクスポートされることを示します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのバッチ処理によるプロファイリング・データのディスクへのダンプに関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit
フラッシュ時に双方向のリレーションの管理に使用するkodo.kernel.InverseManager
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの管理対象の逆数に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
JDataStoreディクショナリの永続性プラグインの構成値。指定可能な各値の詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのJDataStoreディクショナリの構成に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
使用するkodo.kernel.BrokerFactory
タイプを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、JDBC)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.BrokerFactoryに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
リスナーの標準セットに加え、すべての問合せで利用可能にするカスタムkodo.jdbc.kernel.exps.JDBCFilterListeners
の1つまたは複数の完全なプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を定義します。個々の問合せには、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの問合せ言語の拡張機能に関する項で説明するように、フィルタ・リスナーを追加することもできます。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
トランザクションのセーブポイントの管理に使用するkodo.kernel.SavepointManager
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルトのkodo.jdbc.kernel.JDBCSavepointManager
)。このプラグインは、データベースへのフラッシュの発行によりセーブポイントを実装します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのセーブポイントに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
使用するkodo.meta.MetaDataFactory
タイプを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここではkodo.jdo.JDOMetaDataFactory
)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのメタデータ・ファクトリに関する項を参照してください。
<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>
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
JMSリモート・コミット・プロバイダを構成します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのJMSに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
jmx
JMX v.1.2実装を介してリモート管理できるようにします(リモート管理に関するJSR 160をサポート)。Management Group
およびJSR 160 Group
のオプション・パラメータをサポートします。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの管理グループのオプションのパラメータに関する項とJSR 160グループのオプションのパラメータに関する項をそれぞれ参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit JNDIName
リモートJMXアダプタの登録JNDI名。jrmp
がデフォルトです。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのリモート・グループのオプションのパラメータに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
kodo.BrokerImpl
を構成します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの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>
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit data-caches
基本の同時データ・キャッシュを有効にします。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデータ・キャッシュに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
システム・データ・キャッシュを管理するkodo.datacache.DataCacheManager
を有効にします。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.DataCacheManagerに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
使用するkodo.meta.MetaDataRepository
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインに関する項を参照)を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.MetaDataRepositoryに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
永続クラスのオブジェクト・リレーショナル・マッピング情報の格納および取得に使用するkodo.meta.MetaDataFactory
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)。この設定はJDO 1.0で有効です。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピング・ファクトリに関する項を参照してください。
<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>
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
使用するkodo.meta.MetaDataFactory
タイプを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここではorg.apache.openjpa.persistence.PersistenceMetaDataFactory
)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのメタデータ・ファクトリに関する項を参照してください。
<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>
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
デフォルトで接続プーリングを実行するkodo.jdbc.schema.KodoPoolingDataSourceを構成します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの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>
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
共通のSQLコンストラクトの抽出に使用するkodo.jdbc.SQLFactory
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.jdbc.SQLFactoryに関する項を参照してください。
値の範囲: true
| false
デフォルト値: true
親要素 :
persistence-configuration persistence-configuration-unit kodo-broker
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
データベース・スキーマに関する情報の格納および取得に使用するkodo.jdbc.schema.SchemaFactory
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.jdbc.schema.LazySchemaFactory
)。
アプリケーションで永続クラスがロードされる際に、永続クラスのメタデータおよびオブジェクト・リレーショナル・マッピング情報が読み取られます。このファクトリは、java.sql.DatabaseMetaData
インタフェースを使用してスキーマでの反映を行い、読取り対象のマッピング・データとの整合性を確保します。表定義に対する反映は、その表がマッピング情報で示されるまで行われないため、この処理は「遅延」と呼ばれています。このファクトリは、開発期間中に、マッピング・メタデータとデータベースの整合性を前もって検証する場合に使用します。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスキーマ・ファクトリに関する項を参照してください。
値の範囲: 1
| 2
| 3
| 4
| 5
デフォルト値: 4
親要素 :
persistence-configuration persistence-configuration-unit
ログのレベルを指定します。有効な値は、1
(TRACE
)、2
(DEBUG
)、3
(INFO
)、4
(WARN
)、5
(ERROR
)です。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの孤立キーに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
jmx
ローカル管理を有効にします。この設定は、ユーザー定義のメカニズム、あるいはMBeanServerで定義されるメカニズムで管理するため、すべてのMBeanをJMX MBeanServerに登録する必要があるJBossなどの環境で使用するのに適しています。Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの管理グループのオプションのパラメータに関する項で説明するように、Management Group
のオプション・パラメータをサポートします。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit profiling
エクスポートまたはGUIを使用しないプロファイリングを有効にします。プログラムでProfilingAgent
にアクセスする場合に役立ちます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプロファイリングに関する項を参照してください。
値の範囲: 整数
デフォルト値: -1
親要素 :
persistence-configuration persistence-configuration-unit
ロックを取得するまでのデフォルトの待機時間。値-1
を指定すると、制限なく待機します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデフォルトのロックの構成に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
デフォルトのロギング・システムを構成します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのKodoロギングに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
孤立データストア・キーの検出時に呼び出すkodo.event.OrphanedKeyAction
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.event.LogOrphanedKeyAction
)。この場合、孤立キーごとにメッセージがロギングされます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの孤立キーに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
ロギングにLog4Jを使用するように指定します。スタンドアロン・アプリケーションでは、Log4Jロギング・レベルは、log4j.properties
というリソースで制御されます。このリソースは、最上位リソース(jarファイルの最上位またはCLASSPATH
のいずれかのディレクトリのルートにある)として利用できます。WebまたはEJBアプリケーション・サーバーにデプロイする場合、Log4J構成は、プロパティ・ファイルではなくlog4j.xml
ファイルで実行される場合が多くなります。Log4Jの構成の詳細は、http://jakarta.apache.org/log4j/docs/manual.html
の「Log4J Manual」と、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのLog4Jに関する項を参照してください。
値の範囲: 有効なクラス名
デフォルト値 :
親要素 :
persistence-configuration persistence-configuration-unit kodo-pooling-data-source persistence-configuration persistence-configuration-unit simple-driver-data-source
ログイン・タイムアウトを指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのKodoデータソースの使用に関する項を参照してください。
値の範囲: query
| last
| unknown
デフォルト値: query
親要素 :
persistence-configuration persistence-configuration-unit
結果セットのサイズを指定します。このプロパティは、必要に応じて結果がロードされるよう、fetch-batch-sizeのデフォルト値 -1を変更した場合にのみ使用します。有効な値は以下のとおりです。
query
- 問合せ結果のサイズを最初に問い合わせたときに、予想される結果の数がSELECT COUNT(*)
問合せで特定されます。報告されるサイズは、トランザクションのステータスおよび設定に応じて、実際の結果の数と若干異なる場合がある点に注意する必要があります。これがデフォルトです。
last
- スクロール可能な結果セット・タイプを選択している場合、ResultSet.last
メソッドが使用され、結果セットの最後の要素に移動し、その索引を取得します。一部のJDBCドライバでは、最後の要素にアクセスするために、すべての結果がメモリーに格納されてしまいます。スクロール可能な結果セット・タイプを選択していない場合は、unknown
の動作と同じです。デフォルトの結果セット・タイプはforward-only
であるため、このlastを利用するには、結果セット・タイプを変更する必要があります。
unknown
- 必要に応じたロードを使用する問合せ結果のサイズとして、Integer.MAX_VALUE
が返されます。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの大きな結果セットに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit data-caches
最長時間未使用(LRU)のデータ・キャッシュ・オプションを設定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのLRUキャッシング・オプションの構成に関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit inverse-manager
大きな結果セットのフィールドを管理に含めるかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの管理対象の逆数に関する項を参照してください。
値の範囲: 文字列
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit persistence-configuration persistence-configuration-unit orm-filie-mapping-factory
子要素がpersistence-configuration-unitの場合、使用するオブジェクトとデータストアのマッピングの識別名を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピング・メタデータ(JPA)またはマッピング・メタデータの配置(JDO)に関する項を参照してください。
子要素がorm-file-jdor-mapping-factoryの場合、これらのマッピングの論理名を指定します。マッピング・ファイルには、接尾辞がlogicalname.orm
のように付きます。論理名を指定しない場合は、kodo.Mapping
構成プロパティが使用されます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピング・ファクトリに関する項を参照してください。
値の範囲: 文字列
デフォルト値: MAPPING_DEF
親要素 :
persistence-configuration persistence-configuration-unit table-deprecated-jdo-mapping-factory persistence-configuration persistence-configuration-unit table-jdor-mapping-factory
XMLマッピングを保持する列名を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピング・ファクトリに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
default-mapping-defaultsをjdo
に設定した場合のデフォルトのマッピング設定を構成します。指定可能な各値の詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピングのデフォルトに関する項を参照してください。
<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>
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
永続クラスのオブジェクト・リレーショナル・マッピング情報の格納および取得に使用するkodo.meta.MetaDataFactory
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)。この設定はJDO 1.0で有効です。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピング・ファクトリに関する項を参照してください。
<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>
値の範囲: 整数
デフォルト値: 2
親要素 :
persistence-configuration persistence-configuration-unit tcp-remote-commit-provider
クラスタ内の各ピア間で同時に開くTCPソケット(チャネル)の最大許容数を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのTCPに関する項を参照してください。
値の範囲: 整数
デフォルト値: 2
親要素 :
persistence-configuration persistence-configuration-unit tcp-remote-commit-provider
クラスタ内の各ピア間で同時に開くTCPソケット(チャネル)の最大許容数を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのTCPに関する項を参照してください。
値の範囲: 整数
デフォルト値: 2147483647
親要素 :
persistence-configuration persistence-configuration-unit
問合せ文字列とその解析形式の関連付けに使用する同時ハッシュ・マップの最大サイズを定義します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの問合せコンパイルのキャッシュに関する項を参照してください。
値の範囲: 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
文のバッチ処理が有効な場合に、バッチ・サイズを最適化するために文をソートするかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.jdbc.UpdateManagerに関する項を参照してください。
値の範囲: any-create
| create
| agentID:<agentID>
デフォルト値: any-create
親要素 :
jmx local-jmx
Kodoは、JMXベースの管理が有効な場合、以下のいずれかのオプションに基づいて、既存のMBeanServer
を特定するか、新たに作成する必要があります。
any-create
- 既存のMBeanServerを特定します。複数検出された場合は、最初のサーバーを使用します。何も検出されなかった場合は、新しいサーバーを作成します。これがデフォルトです。
create
- 新しいサーバーを作成します。既存のMBeanServerの検出は試行しません。
agentId:<agentID>
- 指定したエージェントIDを持つ既存のMBeanServerを特定します。何も検出されなかった場合は、新しいサーバーを作成します。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの管理グループのオプションのパラメータに関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit persistence-configuration persistence-configuration-unit kodo-broker
永続インスタンスおよびKodoコンポーネントが一度に複数のスレッドによってアクセスされるかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.Multithreadedに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
jmx
MX4J v.1.x実装を介したリモート管理を有効にします(1.2より前のバージョンのJMX仕様をサポート)。Management Group
およびRemote Group
のオプション・パラメータをサポートします。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの管理グループのオプションのパラメータに関する項とリモート・グループのオプションのパラメータに関する項をそれぞれ参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
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>
値の範囲: なし
デフォルト値: なし
親要素 :
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
親要素 :
persistence-configuration persistence-configuration-unit table-deprecated-jdo-mapping-factory persistence-configuration peristence-configuration-unit table-jdor-mapping-factory
マッピング名を保持する列の名前。クラスのマッピングの場合、マッピング名はクラス名です。名前が付けられた問合せおよびシーケンスの場合は、そのシーケンスまたは問合せの名前です。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピング・ファクトリに関する項を参照してください。
値の範囲: 有効なクラス名
デフォルト値: なし
親要素 :
jmx jmx2-jmx
RMIコネクタをJNDI名に登録するために開始するネーミング・サービス実装のクラス名。デフォルトのmx4j.tools.naming.NamingService
は、MX4J v. 2.xに適しています。空の文字列を指定すると、ネーミング・サービスが開始されません。この設定は、ネーミング・サービスが実行されているか、非RMIコネクタが使用されている場合に適しています。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのJSR 160グループのオプションのパラメータに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
独自のカスタム・ジェネレータの作成に使用するkodo.kernel.Seq
インタフェースを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここではkodo.jdbc.kernel.NativeJDBCSeq
)。
ほとんどのデータベースには、増分数を取得するための「ネイティブ・シーケンス」という概念のメカニズムが組み込まれています。Oracleの場合、CREATE SEQUENCE MYSEQUENCE
などの文でデータベース・シーケンスを作成することができます。シーケンス値は、SELECT MYSEQUENCE.NEXTVAL FROM DUAL
文で自動的に取得およびインクリメントすることができます。Kodoでは、この一般的なシーケンス生成メカニズムをNativeJDBCSeq
でサポートしています。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
ロックを行わないkodo.kernel.NoneLockManager
を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのロック・マネージャに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
孤立データストア・キーの検出時に呼び出すkodo.event.OrphanedKeyAction
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.event.NoneOrphanedKeyAction
)。この場合、孤立キーは無視されます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの孤立キーに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit profiling
コードのプロファイリングを無効にします。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプロファイリングに関する項を参照してください。
値の範囲: true
| false
デフォルト値 :
persistence-configuration: false
kodo-broker: true
親要素 :
persistence-configuration persistence-configuration-unit persistence-configuration persistence-configuration-unit kodo-broker
Kodoランタイムでトランザクション外のデータの読取りを可能にするかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.NontransacationalReadに関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit persistence-configuration persistence-configuration-unit kodo-broker
トランザクション外の永続性に関する処理および永続オブジェクトの変更を可能にするかどうかを指定するフラグ。変更は、次のトランザクションに反映されます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.NontransacationalWriteに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit tcp-remote-commit-provider
ピアにイベントを送信するために作成するスレッドの数を指定します。これは、同時トランザクション数の増加に伴い、大きな値にする必要があります。最大同時トランザクション数は、接続プールのサイズに依存します。Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのKodoデータソースの使用に関する項に示すkodo.ConnectionFactoryProperties
のMaxActive
プロパティの説明を参照してください。0に設定すると、commit
を呼び出すスレッドが直接ブロードキャストします。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのTCPに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
オブジェクトレベルの処理順序でSQLを記述する更新マネージャを定義します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.jdbc.UpdateManagerに関する項を参照してください。
値の範囲: true
| false
デフォルト値: true
親要素 :
persistence-configuration persistence-configuration-unit persistence-configuration persistence-configuration-unit kodo-broker
データストアのトランザクション・モードをオプティミスティックにするかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.Optimisticに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
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>
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
トランザクションのセーブポイントの管理に使用するkodo.kernel.SavepointManager
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、デフォルトのkodo.jdbc.sql.OracleSavepointManager
)。このプラグインの動作は、jdbc3-savepoint-managerと似ていますが、このプラグインではOracle固有の呼出しを使用します。このプラグインを使用するには、バージョン9.2以上のOracle JDBCドライバおよびデータベースを使用する必要があります。このプラグインは、データベースへのフラッシュの発行によりセーブポイントを実装します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのセーブポイントに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
.orm
ファイルにマッピング・メタデータを格納するkodo.jdo.jdbc.ORMFileJDORMappingFactory
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)。この設定はJDO 1.0で有効です。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピング・ファクトリに関する項を参照してください。
<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>
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit kodo-broker
値の範囲: なし
デフォルト値: なし
親要素 :
jmx wls81-jmx
WebLogic MBeanServerへのアクセスに使用されるパスワード。この要素は設定する必要があります。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのWebLogic 8.1グループのオプションのパラメータに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
ロックされているオブジェクトに対応するデータベース行をロックするSELECT FOR UPDATE
文(または同等のデータベース文)を使用するkodo.jdbc.kernel.PessimisticLockManager
を指定します。このロック・マネージャでは、読取りロックと書込みロックが区別されず、すべて書込みロックとなります。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのロック・マネージャに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
default-mapping-defaultsをjpa
に設定した場合のデフォルトのマッピング設定を構成します。指定可能な各値の詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピングのデフォルトに関する項を参照してください。
値の範囲: true
| false
デフォルト値: true
親要素 :
persistence-configuration persistence-configuration-unit kodo-broker
データ・キャッシュへ格納するかどうかを指定するフラグ。月に一度のみの包括的なレポートの実行など、他のトランザクションがアクセスすることがほとんどないと分かっているオブジェクトに現在のトランザクションがアクセスする場合、すぐにまたアクセスすることがないオブジェクトでデータ・キャッシュ全体が埋まらないよう、データ・キャッシュへの格納を無効にすることができます。
値の範囲: なし
デフォルト値: なし
親要素 :
jmx mx4j1-jmx
RMIレジストリ・ネーミング・サービスがリスニングするポート。1099がデフォルトです。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのリモート・グループのオプションのパラメータに関する項を参照してください。
値の範囲: 有効なポート
デフォルト値: 以下参照(親要素によって異なります)
親要素 :
persistence-configuration persistence-configuration-unit tcp-transport persistence-configuration persistence-configuration-unit tcp-remote-commit-provider
サーバーがリスニングするポートを指定します。この設定は、サーバーではなく、クライアントが使用します。
親要素がtcp-transportの場合、5637
がデフォルトです。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスタンドアロンの永続性サーバーに関する項を参照してください。
親要素がtcp-remote-commit-providerの場合、5636
がデフォルトです。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのTCPに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
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>
値の範囲: 文字列
デフォルト: 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
表の数字の主キー列の名前を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータまたはスキーマ・ファクトリに関する項を参照してください。
値の範囲: 文字列
デフォルト値: DEFAULT
親要素 :
persistence-configuration persistence-configuration-unit value-table-jdbc-seq
該当インスタンスで使用される主キーを指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit lazy-schema-factory
スキーマの検証時に、主キー情報を自動的に読み取るかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスキーマ・ファクトリに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素: なし
アプリケーション・コードのプロファイリングを構成できます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプロファイリングに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
プロファイリング・プロキシ・マネージャを構成します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのカスタム・プロキシに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
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
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit properties
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
デフォルトのプロキシ・マネージャを構成します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのカスタム・プロキシに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
データストアからロードされた問合せのキャッシュに使用するkodo.datacache.QueryCache実装を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの問合せキャッシュに関する項を参照してください。
<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>
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit compatibility
問合せ文字列内の引用符で囲まれた数値を、文字列ではなく数値として解釈するかどうかを指定するフラグ。true
に設定すると、3.1以前のKodoと同様、引用符で囲まれた数値が数値として処理されます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの互換性の構成に関する項を参照してください。
値の範囲: none
| read
| write
|ロック・マネージャ固有のロック・レベル(数値)
デフォルト値: read
親要素 :
persistence-configuration persistence-configuration-unit
非オプティミスティック・トランザクション中に所得されたオブジェクトをロックする際の、デフォルトの読取りレベルを設定します。有効な値は以下のとおりです。
none
- ロック・レベルなし。
read
- 読取りロック・レベル。
write
- 書込みロック・レベル。
ロック・マネージャ固有のロック・レベルの数値。
注意: デフォルトのJDBCロック・マネージャでは、read およびwrite の両ロック・レベルは同じです。 |
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのオブジェクトのロックに関する項を参照してください。
値の範囲: none
| clear
デフォルト値: none
親要素 :
persistence-configuration persistence-configuration-unit cluster-remote-commit-provider
リカバリ中に実行する処理を指定します。有効な値は以下のとおりです。
none
- 処理を実行しません。
clear
- 通知をクリアします。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのリモート・コミット・プロバイダの構成に関する項を参照してください。
値の範囲: 整数
デフォルト値: 15000
親要素 :
persistence-configuration persistence-configuration-unit tcp-remote-commit-provider
クラスタのピアへの接続が失われた場合に、そのピアへの再接続を試行するまでの待機時間をミリ秒単位で指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのTCPに関する項を参照してください。
値の範囲: 有効なリソース名
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit tangosol-data-cache
メタデータ・ファイルまたはjarアーカイブのリソースのパスを、セミコロン区切りのリストで指定します。各jarアーカイブでは、メタデータ・ファクトリに基づいて、アノテーションが付いたJPAエンティティまたはJDOメタデータ・ファイルがスキャンされます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのメタデータ・ファクトリに関する項を参照してください。
値の範囲: 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
と同じです。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの状態のリストアに関する項を参照してください。
値の範囲: forward--only
| scroll-sensitive
| scroll-insensitive
デフォルト値: forward-only
親要素 :
persistence-configuration persistence-configuration-unit
結果リストをフェッチする際に使用するJDBC結果セット・タイプを指定します。この設定は、実行時にも変更することができます。
有効な値は以下のとおりです。
forward-only
- カーソルが前方にのみ移動可能な結果セット。結果セットは更新されません。
scroll-sensitive
- 他のユーザーによる変更の影響を受けるスクロール可能な結果セット。結果セットは更新されます。
scroll-insenstive
- 他のユーザーによる変更の影響を受けないスクロール可能な結果セット。結果セットは更新されます。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの大きな結果セットに関する項を参照してください。
値の範囲: true
| false
デフォルト値: 以下参照(親によって異なります)
親要素 :
persistence-configuration persistence-configuration-unit persistence-configuration persistence-configuration-unit kodo-broker
トランザクションのコミット時に、永続フィールドが値を保持するかどうかを指定するフラグ。親要素がpersistence-configuration-unitの場合はtrue
、親要素がkodo-brokerの場合はfalse
がデフォルトです。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.RetainStateに関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit
永続クラスを完全に処理できない場合に、例外をスローせずに警告をログに記録し、登録を遅延させるかどうかを指定するフラグ。この要素は、セキュリティ上、登録されたクラスを読み取れないような複雑なクラス・ローダーの状況でのみ使用してください。無用にtrue
に設定すると、より重大な問題を把握しにくくなる可能性があります。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.RetryClassRegistrationに関する項を参照してください。
値の範囲: 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
が検索されます。このように、最終的にパッケージのルートまで検索されます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのメタデータ・ファクトリに関する項を参照してください。
値の範囲: 文字列
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
未修飾表名の先頭に付加されるデフォルトのスキーマ名を指定します。また、新しい表が作成されるスキーマを指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデフォルトのスキーマに関する項を参照してください。
値の範囲: 文字列
デフォルト値: SCHEMA_DEF
親要素 :
persistence-configuration persistence-configuration-unit table-schema-factory
スキーマ定義をXML文字列として格納する、表の文字列型の列の名前を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスキーマ・ファクトリに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
永続データに使用するスキーマまたは表、あるいはその両方を、カンマ区切りのリストで指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスキーマ・リストに関する項を参照してください。
値の範囲: なし
デフォルト値: OPENJPA_SEQUENCE
親要素 :
persistence-configuration persistence-configuration-unit native-jdbc-seq
データベース・シーケンスの名前を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
値の範囲: 文字列
デフォルト値: 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
現在のシーケンス値を保持する列名を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
値の範囲: 文字列
デフォルト値: OPENJPA_SEQUENCE
親要素 :
persistence-configuration persistence-configuration-unit native-jdbc-seq
データベース・シーケンスの名前を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
値の範囲: 有効なサービスURL
デフォルト値: service:jmx:rmi://localhost/jndi/jmxservice
親要素 :
jmx jmx2-jmx
JMXコネクタ・サーバーが登録される際のJMXサービスURL名。デフォルトのservice:jmx:rmi://localhost/jndi/jmxservice
は、RMIコネクタがJNDI名jmxsevice
で使用および登録されることを示しています。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのJSR 160グループのオプションのパラメータに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
Kodoデータ・ソース実装を構成します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの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>
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit mapping-file-deprecated-jdo-mapping-factory
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
kodo.kernel.SingleJVMExclusiveLockManager
を指定します。このロック・マネージャは、インメモリー・ミューテックスを使用して、オブジェクトIDの排他ロックを取得します。データベース・レベルのロックは行われません。また、読取りロックと書込みロックが区別されず、すべて書込みロックとなります。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのロック・マネージャに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
同じJVM内のpersistenceManagerFactories
間でコミット通知を共有するようにKodoを構成します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのリモート・コミット・プロバイダの構成に関する項を参照してください。
値の範囲: 整数
デフォルト値: -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に設定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのデータ・キャッシュ・サイズの構成に関する項と問合せキャッシュに関する項を参照してください。
値の範囲: 整数
デフォルト値: 0
親要素 :
persistence-configuration persistence-configuration-unit http-transport
ソケット読込みのタイムアウト時間をミリ秒単位で指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスタンドアロンの永続性サーバーに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
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>
値の範囲: なし
デフォルト値: なし
親要素 :
execution-context-name-provider
プロバイダが現在のスレッドのスタックを検査し、その情報に基づき実行コンテキスト名を作成します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの実行コンテキスト名プロバイダの構成に関する項を参照してください。
値の範囲: 整数
デフォルト値: なし
親要素 :
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
値の範囲: 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
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit compatibility
アプリケーションIDインスタンスの検索に使用するID値が、完全に正しい型でなければならないかどうかを指定するフラグ。デフォルトでは、文字列化されたID値が許容され、数値型間で変換が行われます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの互換性の構成に関する項を参照してください。
値の範囲: line
| partial
| full
デフォルト値: なし
親要素 :
execution-context-name-provider stack-execution-context-name-provider
プロバイダが現在のスレッドのスタックを検査し、その情報と以下の設定に基づき、実行コンテキスト名を作成します。
line
- 名前は、クラス名、メソッド名、行番号などを含む(存在する場合)、最初の非Kodoスタック行になります。
partial
- フル・スタック・トレースからKodoの行が引かれたものが使用されます。
full
- スタック・トレース全体が使用されます。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの実行コンテキスト名プロバイダの構成に関する項を参照してください。
値の範囲: join
| multiple
| none
| parallel
| single
デフォルト値: join
親要素 :
execution-context-name-provider stack-execution-context-name-provider
他の表にあるサブクラス・データの選択に使用する方法を指定します。有効な値については、「eager-fetch-mode」の説明を参照してください。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのイーガー・フェッチに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
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>
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit kodo-broker
管理対象トランザクションと同期するかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.BrokerImplに関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration
すべての永続クラスに対してマッピング・ツールを実行し、永続クラスのマッピングとスキーマを実行時に同期させるかどうかを制御します。この要素により、マッピング・ツールを手動で実行する手間が省かれ、テストやデバッグを短時間で完了することができます。詳細については、『Oracle Fusion Middleware Oracle Kodo Developer's Guide for JPA/JDO』の「Runtime Forward Mapping」を参照してください。
値の範囲: 文字列
デフォルト値: 以下参照
親要素 :
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
表の名前を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピング・ファクトリに関する項を参照してください。デフォルト値は、次に示すように親要素によって異なります。
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
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
データベース表にマッピング・メタデータをXML文字列として格納するkodo.jdo.jdbc.TableJDORMappingFactoryを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)。この設定はJDO 1.0で有効です。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピング・ファクトリに関する項を参照してください。
<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>
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
独自のカスタム・ジェネレータの作成に使用するkodo.kernel.Seq
インタフェースを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.jdbc.kernel.TableJDBCSeq
)。
TableJDBCSeq
は、特殊な単一行の表にグローバル・シーケンス番号を格納します。この表は、この表を必要とするクラスに対してマッピング・ツールを最初に実行したときに存在しない場合は作成されます。表の操作には、そのクラスのmainメソッドやsequencetable
シェル/バッチ・スクリプトを使用することもできます(使用方法の詳細は、JavadocのTableJDBCSeq.main
メソッドを参照)。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
データベース表にマッピング・メタデータをXML文字列として格納するkodo.jdo.jdbc.TableJDORMappingFactoryを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)。この設定はJDO 2.0で有効です。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピング・ファクトリに関する項を参照してください。
<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>
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
外部キーおよび自動インクリメントを無視し、表レベルのロックを最適化する、文のバッチ処理が可能な更新マネージャを定義します。これは、表レベルのロックを使用し、デッドロックの回避を試みる場合に役立ちます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのkodo.jdbc.UpdateManagerに関する項と文のバッチ処理に関する項を参照してください。
値の範囲: 文字列
デフォルト値: 以下参照
親要素 :
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
。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
native-jdbc-seq: DUAL
。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
table-deprecated-jdo-mapping-factory: JDO_MAPPING
。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピング・ファクトリに関する項を参照してください。
table-jdbc-seq: OPENJPA_SEQUENCE_TABLE
。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
table-schema-factory: OPENJPA_SCHEMA
。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスキーマ・ファクトリに関する項を参照してください。
value-table-jdbc-seq: OPENJPA_SEQUENCE_TABLE
。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
データベース・スキーマに関する情報の格納および取得に使用するkodo.jdbc.schema.SchemaFactory
を表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.jdbc.schema.TableSchemaFactory
)。
このスキーマ・ファクトリは、スキーマ情報をXMLドキュメントとしてデータベース表(スキーマ・ファクトリがこのために作成)に格納します。このファクトリは、現在のJDBCドライバでjava.sql.DatabaseMetaData
標準インタフェースがサポートされていないが、実行時に一定のスキーマ検証を実行したい場合などに使用することができます。ただし、このファクトリを使用すると、格納されているXMLスキーマ定義と実際のデータベースとの同期が困難になるため、無用に使用しないでください。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスキーマ・ファクトリに関する項を参照してください。
値の範囲: 文字列
デフォルト値: kodo
親要素 :
persistence-configuration persistence-configuration-unit tangosol-data-cache
使用するTangosol Coherenceキャッシュの名前。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのTangosol統合に関する項を参照してください。
値の範囲: 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
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのTangosol統合に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit data-caches
TangosolのCoherenceキャッシュ・システムと統合します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのTangosol統合に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
TCPリモート・コミット・プロバイダを構成します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのTCPに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
リモート通信用のトランスポート層を指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのスタンドアロンの永続性サーバーに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
独自のカスタム・ジェネレータの作成に使用するkodo.kernel.Seq
インタフェースを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.jdbc.kernel.TimeSeededSeq
)。
このタイプでは、現在時刻にミリ秒単位で初期化され、値がリクエストされるたびに一定の割合でインクリメントされる静的なインメモリー・カウンタが使用されます。これは単一のJVM環境にのみ適しています。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
値の範囲: 有効なトピック
デフォルト値: topic/KodoCommitProviderTopic
親要素 :
persistence-configuration persistence-configuration-unit jms-remote-commit-provider
リモート・コミット・プロバイダが通知をパブリッシュしたり、他のJVMから送信された通知をサブスクライブしたりするトピックを指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのJMSに関する項を参照してください。
値の範囲: 有効な接続ファクトリ
デフォルト値: java:/ConnectionFactory
親要素 :
persistence-configuration persistence-configuration-unit jms-remote-commit-provider
トピックの検索に使用するjavax.jms.TopicConnectionFactory
ファクトリのJNDI名を指定します。この設定は、使用しているアプリケーション・サーバーによって異なる場合があります。トピック・インスタンスのデフォルトのJNDI名の詳細は、使用しているアプリケーション・サーバーのドキュメントを参照してください。WebLogicの場合、TopicConnectionFactory
のJNDI名はjavax.jms.TopicConnectionFactory
です。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのJMSに関する項を参照してください。
値の範囲: true
| false
デフォルト値: true
親要素 :
persistence-configuration persistence-configuration-unit
スマート・プロキシを使用するかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのカスタム・プロキシに関する項を参照してください。
値の範囲: 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
- ダーティ・リード、反復不可能読み取り、ファントム読取りが阻止されます。
詳細については、『Oracle Fusion Middleware Oracle Kodo Developer's Guide for JPA/JDO』の「Setting the Transaction Isolation」を参照してください。
値の範囲: local
| managed
デフォルト値: local
親要素 :
persistence-configuration persistence-configuration-unit
使用するトランザクション・モードを指定します。この設定は、セッションごとにオーバーライドできます。
local
- トランザクション処理をローカルに実行します。これがデフォルトです。
managed
- アプリケーション・サーバーの管理対象グローバル・トランザクションと統合します。
詳細については、『Oracle Fusion Middleware Oracle Kodo Developer's Guide for JPA/JDO』の「Integrating with the Transaction Manager」を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
execution-context-name-provider
WebLogicトランザクション・ネーミング・セマンティクスの定義に基づき、プロバイダが現在のトランザクション名を返します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの実行コンテキスト名プロバイダの構成に関する項を参照してください。
値の範囲: なし
デフォルト値: 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
値の範囲: 0
| 1
| 2
| 3
デフォルト値: 0
親要素 :
persistence-configuration persistence-configuration-unit table-jdor-mapping-factory
マッピングのタイプを格納する列の名前を指定します。有効なタイプ定数は次のとおりです。
0
- クラス・マッピング
1
- 命名済シーケンス
2
- システム・レベルの命名済問合せ
3
- クラス・レベルの命名済み問合せ
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのマッピング・ファクトリに関する項を参照してください。
値の範囲:有効な永続性クラス名
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit tangosol-data-cache
永続クラスの完全修飾名を、セミコロン区切りのリストで指定します。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのメタデータ・ファクトリに関する項を参照してください。
値の範囲: 有効なURL
デフォルト値: t3://localhost:7001
親要素 :
jmx wls81-jmx
WebLogic MBeanServerにアクセスするために接続する必要があるURL。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのWebLogic 8.1グループのオプションのパラメータに関する項を参照してください。
値の範囲: 有効なURL
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit http-transport
リモート・サーバーへアクセスするために接続する必要のあるURL。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのクライアント・マネージャに関する項を参照してください。
値の範囲: 有効な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メタデータ・ファイルがスキャンされます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのメタデータ・ファクトリに関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit class-table-jdbc-seq
完全クラス名ではなく、各行の主キー値として各クラスのエンティティ名を使用するかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
値の範囲: 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
値の範囲: なし
デフォルト値: なし
親要素 :
execution-context-name-provider
com.solarmetric.profile.ExecutionContextNameProvider
がキーの、現在のEntityManager/PersistenceManagerに指定されたユーザー・オブジェクトをプロバイダが返します。ユーザー・オブジェクトは、OpenJPAEntityManager.putUserObject(Object,Object)
またはPersistenceManager.putUserObject(Object,Object)
を使用して設定できます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの実行コンテキスト名プロバイダの構成に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
jmx wsl81-jmx
WebLogic MBeanServerへのアクセスに使用するユーザー名を指定します。この要素は設定する必要があります。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのWebLogic 8.1グループのオプションのパラメータに関する項を参照してください。
値の範囲: true
| false
デフォルト値: true
親要素 :
persistence-configuration persistence-configuration-unit compatibility
PersistenceManager.getObjectById(oid, false)
の呼出しから、空のオブジェクト(状態がロードされていないオブジェクト)を返すかどうかを指定するフラグ。これは、4.0以上のKodoのデフォルト動作です。前のバージョンのKodoでは、オブジェクトはデータ・ストアから常にロードされていました。このプロパティをfalse
に設定すると、前のバージョンの動作になります。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの互換性の構成に関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit compatibility
データ・ストアに特定のoid
が存在することを確認するかどうかを指定するフラグ。4.0より前のKodoでは、PersistenceManager.getObjectById(oid, true)
を呼び出すと、対応するオブジェクトがキャッシュ済みであっても、データ・ストアに特定のoid
が存在することを常に確認していました。4.0以上のKodoでは、インスタンスがすでにキャッシュおよびロードされている場合は、データ・ストアがチェックされません。このプロパティをtrue
に設定すると、前のバージョンの動作になります。
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの互換性の構成に関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
独自のカスタム・ジェネレータの作成に使用するkodo.kernel.Seq
インタフェースを表すプラグイン文字列(Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのプラグインの構成に関する項を参照)を指定します(ここでは、kodo.jdbc.kernel.ValueTableJDBCSeq
)。
このシーケンスはtable-jdbc-seqと似ていますが、クラスごとに1行の固定パターンではなく、シーケンス値に任意の行数があります。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのジェネレータに関する項を参照してください。
<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>
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit pessimistic-lock-manager
読取り操作に対するペシミスティックなロック・マネージャのインクリメント動作とバージョン・チェックを有効にするかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのロック・マネージャに関する項を参照してください。
値の範囲: true
| false
デフォルト値: false
親要素 :
persistence-configuration persistence-configuration-unit pessimistic-lock-manager
書込み操作に対するペシミスティックなロック・マネージャのインクリメント動作とバージョン・チェックを有効にするかどうかを指定するフラグ。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのロック・マネージャに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
persistence-configuration persistence-configuration-unit
kodo.kernel.VersionLockManager
を指定します。このロック・マネージャは排他ロックを行わないかわりに、読取りロックされているすべてのインスタンスのバージョンがトランザクション終了時に変更されていないことを確認することによって、読取りの一貫性を確保します。さらに、書込みロックにより、オブジェクトが変更されていない場合でも、トランザクション終了時のバージョンがインクリメントされます。これにより、非ブロック動作と読取りの一貫性が確保されます。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのロック・マネージャに関する項を参照してください。
値の範囲: なし
デフォルト値: なし
親要素 :
jmx
管理を有効にして、ローカルJVMでJMX管理コンソールを呼び出します。Management Group
およびWebLogic 8.1 Group
のオプション・パラメータをサポートします。詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドの管理グループのオプションのパラメータに関する項とWebLogic 8.1グループのオプションのパラメータに関する項を参照してください。
値の範囲: none
| read
| write
|ロック・マネージャ固有のロック・レベル(数値)
デフォルト値: read
親要素 :
persistence-configuration persistence-configuration-unit
非オプティミスティック・トランザクション中に所得されたオブジェクトをロックする際の、デフォルトの書込みレベルを設定します。有効な値は以下のとおりです。
none
- ロック・レベルなし。
read
- 読取りロック・レベル。
write
- 書込みロック・レベル。
ロック・マネージャ固有のロック・レベルの数値。
注意: デフォルトのJDBCロック・マネージャでは、read およびwrite の両ロック・レベルは同じです。 |
詳細は、Oracle Fusion Middleware JPA/JDO Kodo 4.2.0開発者ガイドのオブジェクトのロックに関する項を参照してください。