Jakarta Persistence (JPA)

Enable the Jakarta EE: Persistence ​(JPA)​ plugin

This functionality relies on the Jakarta EE: Persistence ​(JPA)​ plugin, which is bundled and enabled in IntelliJ IDEA by default. If the relevant features are not available, make sure that you did not disable the plugin.

1. Press Ctrl+Alt+S to open settings and then select Plugins.

2. Open the Installed tab, find the Jakarta EE: Persistence ​(JPA)​ plugin, and select the checkbox next to the plugin name.

Create a new Jakarta Enterprise project with JPA

Since JPA is part of Jakarta EE (formerly known as Java EE), you can add support for it to any Java Enterprise/Jakarta Enterprise application.

1. Click New Project on the Welcome screen or select File | New | Project.

2. From the Generators list, select Jakarta EE.

3. Name the new project, select a build tool, a language you want to use, and select the Web application project template.

4. From the JDK list, select the JDK that you want to use in your project.

   If the JDK is installed on your computer, but not defined in the IDE, select Add JDK and specify the path to the JDK home directory.

   If you don't have the necessary JDK on your computer, select Download JDK.

   

5. On the next step of the wizard, select the Jakarta EE version to be supported.

6. From the Dependencies list, select Persistence (JPA).

   If you are not going to implement all the interfaces of the JPA specification yourself, you also need to include a persistence framework. By default, IntelliJ IDEA provides support for the following persistence frameworks:

   • EclipseLink is the reference implementation. Select it if you are just trying things out.

   • Hibernate is the most popular implementation. For more information, refer to Hibernate.

   

7. Click Create.

For more information about creating a Jakarta EE project, refer to Tutorial: Your first Jakarta EE application.

Enable JPA support for an existing project

1. Open the build file in the editor (pom.xml or build.gradle depending on the build tool that you use in your project).

2. Add the following dependency, but make sure to change the version according to your project's requirements:

   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. Press Ctrl+Shift+O to import the changes.

   Once the dependency has been added, Jakarta Persistence features, such as the Persistence tool window, become available right away.

For more information about working with build tools, refer to Maven or Gradle.

Share facet settings

You can change and share settings by creating custom facets and adding a module file with the .iml extension to the version control system.

For example, to share a selected data source for JPA within your team, you can create a JPA facet and commit its settings.

1. In the main menu, go to File | Project Structure or press Ctrl+Alt+Shift+S. Then select Modules.

2. Make sure the module to which you want to add a facet is selected and click above the list of modules. From the list of available facets, select JPA.

   

   The Descriptors section becomes available on the right.

3. In the Descriptors section, click and select a descriptor type. Create a new file or specify the path to an existing one.

4. Reopen the project. After that, the changes will appear in the .iml file of the module to which you have added the facet.

   

5. Add the .iml file to your version control system.