デフォルト Java Persistence API 設定
アプリケーションの移植性を高めるために、アプリケーション内のパーシスタンス・ユニットごとに <provider> エレメントを定義する代わりに、 このページを使用して、このサーバーで実行されているアプリケーションのデフォルト Java™ Persistence API (JPA) 設定を構成できます。
デフォルト JPA パーシスタンス・プロバイダー、Java Transaction API (JTA) トランザクションに参加するときにデフォルトで使用するデータ・ソース、 および、JTA トランザクションに参加するのを避けなければならない操作用に JPA パーシスタンス・プロバイダーが使用できるデータ・ソースを選択できます。これらのデータ・ソースは、 Java Naming and Directory Interface (JNDI) 名で識別されます。このページで定義した JPA 設定がアプリケーションのパーシスタンス・ユニットで使用されるのは、そのパーシスタンス・ユニットの JPA 設定がアプリケーションで定義されていないときに限られます。
トラブルの回避 (Avoid trouble): アプリケーション JPA 設定は、このページでの設定を常にオーバーライドします。gotchaこの管理コンソール・ページを表示するには、をクリックします。
JPA 仕様
デフォルト・プロバイダーに使用する JPA 仕様を指定します。サポートされている仕様レベルのリストから選択します。
- デフォルト
- 2.1
デフォルト・パーシスタンス・プロバイダー
アプリケーション・サーバー・コンテナーのデフォルト・パーシスタンス・プロバイダーを指定します。
製品に含まれるプロバイダーのリストからパーシスタンス・プロバイダーを選択するか、または、代替パーシスタンス・プロバイダーの完全パッケージ修飾 JPA 実装クラス名を指定します。
トラブルの回避 (Avoid trouble): 代替パーシスタンス・プロバイダーをデフォルトとして指定する場合は、その代替パーシスタンス・プロバイダーがサーバーに作成されていることを確認してください。サード・パーティーのパーシスタンス・プロバイダーの使用についての説明を参照してください。gotcha
- JPA 2.1 のデフォルト
- org.eclipse.persistence.jpa.PersistenceProvider
- JPA 2.0 のデフォルト
- com.ibm.websphere.persistence.PersistenceProviderImpl
トラブルの回避 (Avoid trouble): 代替パーシスタンス・プロバイダーをデフォルトとして指定する場合は、その代替パーシスタンス・プロバイダーがサーバーに作成されていることを確認してください。サード・パーティーのパーシスタンス・プロバイダーの使用についての説明を参照してください。gotchaデフォルト JTA データ・ソースの JNDI 名
アプリケーション・サーバー・コンテナーのパーシスタンス・ユニットが使用するデフォルト JTA データ・ソースを指定します。
データ・ソースの JNDI 名を、現在構成されていてアプリケーション・サーバーに可視である JTA データ・ソースのリストから選択します。
トラブルの回避 (Avoid trouble): デフォルト JTA データ・ソースを指定しない場合は、
パーシスタンス・ユニット内の <jta-data-source>
、または <properties> エレメントの接続プロパティー・フィールドに、
適切な JTA データ・ソースが必ず指定されるようにしてください。gotcha
- デフォルト
- なし
トラブルの回避 (Avoid trouble): デフォルト JTA データ・ソースを指定しない場合は、
パーシスタンス・ユニット内の <jta-data-source>
、または <properties> エレメントの接続プロパティー・フィールドに、
適切な JTA データ・ソースが必ず指定されるようにしてください。gotchaデフォルトの非 JTA データ・ソース JNDI 名
アプリケーション・サーバー・コンテナーのパーシスタンス・ユニットが使用するデフォルト 非 JTA データ・ソースを指定します。
データ・ソースの JNDI 名をリストから選択します。リストには、現在構成されていて、アプリケーション・サーバーに可視であり、non-transactional に設定されているデータ・ソースが含まれています。
トラブルの回避 (Avoid trouble): 一部の JPA エンティティー・フィーチャーでは、非 JTA データ・ソースが指定される必要があります。例えば、自動エンティティー ID 生成の場合がそうです。非 JTA データ・ソースがアプリケーションのニーズと一致するように構成されていることを確認してください。非 JTA データ・ソースの構成について詳しくは、パーシスタンス・ユニットとデータ・ソースの関連付けに関する説明を参照してください。gotcha
- デフォルト
- なし
トラブルの回避 (Avoid trouble): 一部の JPA エンティティー・フィーチャーでは、非 JTA データ・ソースが指定される必要があります。例えば、自動エンティティー ID 生成の場合がそうです。非 JTA データ・ソースがアプリケーションのニーズと一致するように構成されていることを確認してください。非 JTA データ・ソースの構成について詳しくは、パーシスタンス・ユニットとデータ・ソースの関連付けに関する説明を参照してください。gotcha
参照トピック