IntelliJ IDEA 2026.1 Help

Jakarta Persistence (JPA)

以前は JavaPersistence API として知られていた Jakarta Persistence(英語) (JPA) は、 Java エンタープライズアプリケーションでリレーショナルデータを管理するための Java 仕様です。

Jakarta EE: Persistence（JPA）プラグインを有効化する。

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

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

  2. インストール済み タブを開き、 Jakarta EE：永続化（JPA）プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。

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

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

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

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

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

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

  • JPQL クエリを作成して実行し、クエリ結果を分析するための コンソール。

JPA を使用して新しい Jakarta エンタープライズプロジェクトを作成する

JPA は JakartaEE（旧称 Java EE）の一部であるため、任意の Java エンタープライズ /Jakarta エンタープライズアプリケーションに JPA のサポートを追加できます。

  1. 'ようこそ' 画面で 新規プロジェクト をクリックするか、 ファイル(F) | 新規(N) | プロジェクト を選択します。

  2. ジェネレーター リストから Jakarta EE を選択してください。

  3. 新しいプロジェクトに名前を付け、使用する言語であるビルドツールを選択し、 Web アプリケーション プロジェクトテンプレートを選択します。

  4. JDK リストから、プロジェクトで使用する JDK を選択します。

    JDK がコンピューターにインストールされているが、IDE で定義されていない場合は、 JDK を追加 を選択し、JDK ホームディレクトリへのパスを指定します。

    必要な JDK がコンピューターにない場合は、 JDK のダウンロード を選択します。

    JPA サポートを使用した新しいプロジェクトの作成

  5. ウィザードの次のステップで、サポートする Jakarta EE バージョンを選択します。

  6. 依存関係 リストから 永続化 (JPA) を選択してください。

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

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

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

    JPA と Hibernate を使用した新しい Jakarta EE プロジェクト

  7. 作成(C) をクリックします。

Jakarta EE プロジェクトの作成に関する詳細は、 チュートリアル: 最初の Jakarta EE アプリケーション を参照してください。

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

  1. ビルドファイルをエディターで開きます（プロジェクトで使用するビルドツールに応じて、 pom.xml または build.gradle ）。

  2. 次の依存関係を追加しますが、バージョンがプロジェクト全体と一致していることを確認してください。

    Jakarta EE
    <dependency> <groupId>jakarta.persistence</groupId> <artifactId>jakarta.persistence-api</artifactId> <version>3.1.0</version> </dependency>
    Java EE
    <dependency> <groupId>javax.persistence</groupId> <artifactId>javax.persistence-api</artifactId> <version>2.2</version> <scope>provided</scope> </dependency>
    Jakarta EE
    implementation 'jakarta.persistence:jakarta.persistence-api:3.1.0'
    Java EE
    compileOnly('javax.persistence:javax.persistence-api:2.2')

  3. Ctrl+Shift+O を押して変更をインポートします。

    依存関係が追加されると、 永続化ツールウィンドウなどの Jakarta 永続化機能がすぐに使用できるようになります。

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

ファセット設定の共有

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

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

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

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

    JPA ファセットの追加

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

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

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

    モジュールファイルの JPA ファセット

  5. .iml ファイルを追加するをバージョン管理システムに追加します。

2026 年 3 月 30 日
Jakarta Server Faces (JSF)永続化ツールウィンドウ