llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

Jakarta Persistence (JPA)

Jakarta Persistence (JPA) は、旧称 Java Persistence API で、 Java エンタープライズアプリケーションでリレーショナルデータを管理するための Java 仕様です。

Jakarta EE: Persistence ​(JPA)​ プラグインを有効化

この機能は、デフォルトで IntelliJ IDEA にバンドルされて有効になっている Jakarta EE: 永続化 (JPA)(英語) プラグインに依存しています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。

  1. Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。

  2. Jakarta EE: Persistence ​(JPA)​ プラグインを見つけて、 有効化 をクリックします。

IntelliJ IDEA は以下を提供します:

  • JPA に固有のコーディング支援。

  • JPA 構成 persistence.xml およびオブジェクトリレーショナルマッピング orm.xml ファイルを管理するための専用ファセット。

  • JPA プロジェクト項目の管理、構成ファイルと永続クラスの作成、エディターでの関連ソースコードへの移動、ダイアグラムとコンソールのオープンなどのための 永続化ツールウィンドウ。

  • 永続化ツールウィンドウからアクセスできる実体関連(ER)ダイアグラム。

  • データベーススキーマまたは EJB デプロイ記述子ファイル ejb-jar.xml をインポートすることにより、管理対象エンティティクラスとそれらのオブジェクトリレーショナルマッピングを生成する機能。

  • JPQL クエリの作成と実行、およびクエリ結果の分析を行うための JPA コンソール。

JPA を使用して新しい Jakarta EE プロジェクトを作成する。

  1. 新規プロジェクト ウィザードを開く:

    • ホーム画面を表示している場合は、 プラス記号 新規 | フォルダーアイコン プロジェクト… を選択します。

    • 別のプロジェクトを開いている場合は、 ファイル | 新規 | プロジェクト に移動します。

  2. 左側の ジェネレーター リストから、 Jakarta EE ロゴJakarta EE を選択します。

    Jakarta EE プロジェクトウィザードの最初のステップ。CHKERRQ
  3. Jakarta EE プロジェクト設定を行います。

    準備ができたら、 次へ をクリックします。

  4. バージョン ドロップダウンリストから、使用する Jakarta EE バージョンを選択します。

  5. 仕様 リストから 永続化 (JPA) を選択してください。

    JPA 仕様のすべてのインターフェースを自分で実装する予定がない場合は、永続性フレームワークも含める必要があります。 デフォルトでは、IntelliJ IDEA は次の永続性フレームワークのサポートを提供します。

    • エクリプスリンク はリファレンス実装です。 試してみるだけの場合は選択してください。

    • Hibernate は最も一般的な実装です。 詳細については、 Hibernate を参照してください。

    JPA と Hibernate を使用した新しい Jakarta EE プロジェクト
  6. 作成 をクリックします。

Jakarta EE プロジェクトの作成方法やアプリケーションサーバーの設定など、詳細については チュートリアル: 最初の Jakarta EE アプリケーション を参照してください。

既存のプロジェクトに JPA を追加

  1. ビルドファイルをエディターで開きます( pom.xml または build.gradle 。プロジェクトで使用されている ビルドツールによって異なります)。

  2. JPA ライブラリを追加し、そのバージョンがプロジェクトの他の部分と一致していることを確認します:

    Jakarta EE
    <dependency> <groupId>jakarta.persistence</groupId> <artifactId>jakarta.persistence-api</artifactId> <version>3.2.0</version> </dependency>
    Java EE
    <dependency> <groupId>javax.persistence</groupId> <artifactId>javax.persistence-api</artifactId> <version>2.2</version> </dependency>
    Jakarta EE
    implementation 'jakarta.persistence:jakarta.persistence-api:3.2.0'
    Java EE
    implementation 'javax.persistence:javax.persistence-api:2.2'
    Jakarta EE
    implementation("jakarta.persistence:jakarta.persistence-api:3.2.0")
    Java EE
    implementation("javax.persistence:javax.persistence-api:2.2")
  3. Ctrl+Shift+O を押して変更をインポートします。

ビルドツールの使用方法の詳細については、 Maven または Gradle を参照してください。

ファセット設定の共有

カスタムファセットを作成し、拡張子 .iml を持つモジュールファイルをバージョン管理システムに追加することで、設定を変更および共有できます。

たとえば、JPA 用に選択したデータソースをチーム内で共有するには、JPA ファセットを作成し、その設定をコミットできます。

  1. メインメニューで、 ファイル | プロジェクト構造 に移動するか、 Ctrl+Alt+Shift+S を押します。 次に、 モジュール を選択します。

  2. ファセットを追加するモジュールが選択されていることを確認し、モジュールのリストの上にある 追加ボタン をクリックします。 使用可能なファセットのリストから、 Java Persistence API (JPA) を選択します。

    JPA ファセットの追加

    記述子 セクションが右側で使用可能になります。

  3. 「記述子 」セクションで「追加ボタン 」をクリックし、記述子のタイプを選択します。 新しいファイルを作成するか、既存のファイルへのパスを指定します。

  4. プロジェクトを再度開きます。 その後、変更はファセットを追加したモジュールの .iml ファイルに表示されます。

    モジュールファイルの JPA ファセット
  5. .iml ファイルを追加するをバージョン管理システムに追加します。

2026 年 11 月 3 日