JPA機能を使用する場合、以下に注意してください。
Java Persistence Entity間のrelationshipの一貫性は、自動的に管理されません。
例えば、双方向のrelationshipでは、一方でrelationshipフィールドを更新すると、もう一方のEntityのrelationshipフィールドもアプリケーションが更新する必要があります。
Entityは、Jakarta EEコンポーネントではないので、Entity内でDependency Injectionは使用できません。
永続性プロバイダが内部的に自動生成したSQL文を実行する場合、識別子には大文字/小文字を区別するダブルコーテーションなどは付与されません。
例えば、カラム名に"id"や"name"を指定した場合、以下のようなSQL文が実行されます。
select id, name from employee |
この場合、識別子が大文字/小文字のどちらで扱われるかについては、データベースの仕様により異なります。
このため、以下のように設定することをお勧めします。
Oracle、JavaDB、SQL Serverの場合、マッピング対象のテーブル名とカラム名を大文字に統一することを推奨します。(またはデフォルト設定を利用)
PostgreSQL ベースのデータベースの場合、マッピング対象のテーブル名とカラム名を小文字に統一することを推奨します。
以下の条件のどれかにあてはまる場合、アプリケーションの配備時にJPAがデータベースへ接続を行います。
以下の条件を満たす場合
deployment descriptor (persistence.xml)の<persistence-unit>に<jta-data-source>、または<non-jta-data-source>を指定している。かつ、
アプリケーション内で@PersistenceUnitを使用しEntityManagerFactoryインスタンスを取得している。
プライマリキー値の自動生成機能を使用している場合
データベーステーブル自動生成機能を使用している場合
上記条件を満たす場合、アプリケーションをGlassFish Serverクラスター、またはDASへ配備する前にJDBCドライバの環境設定を行ってください。
詳細は「5.8.1 JDBCドライバの環境設定」を参照してください。
アプリケーション内でJPAのEntityを引数にもつEJBのメソッド呼び出しを行っている場合、Java SEスタンドアロンアプリケーションおよびJakarta EEアプリケーションクライアントが通信する接続先サーバをIPアドレスで指定できません。
接続先サーバはIPアドレスではなくホスト名で指定してください。
サポートされるデータベースは「1.2.2 データベース関連」を参照してください。
Entityの永続化フィールドについては、Java Persistence API規約による使用可能なJava型以外は動作が保証できません。
Entity間の継続関係のマッピング方針については、SINGLE_TABLEオプションまたはJOINEDオプションは使用できますが、TABLE_PER_CLASSオプションは使用できません。
Native Queryでデータベースを検索する場合、永続性プロバイダが検索結果をオブジェクトとしてカプセル化する時に、エンティティクラスの属性とテーブルのカラム名の大文字/小文字が一致していないためエラーが発生する可能性があります。この場合、eclipselink.jpa.uppercase-column-namesをtrueに設定してください。
DBMSの制限により使用できない機能があります。使用できない機能を使おうとすると、DBMSの仕様による例外メッセージと発行されたSQL文が出力されます。DBMSのマニュアルを参照し、必要に応じてアプリケーションを修正してください。以下に、DBMSの制限により使用できない機能をいくつか記述します。
使用するDBMSがSQL Serverの場合、以下に注意してください。
TRIM関数の変換文字は指定できません。空白が使用されます。
Pessimistic Locking機能は使用できません。
