Jakarta Persistence (JPA)
Jakarta Persistence (JPA),前身为 Java Persistence API,是用于在 Java Enterprise应用程序中管理关系数据的 Java 规范。
启用 Jakarta EE:持久性(JPA)插件
此功能依赖于 Jakarta EE: Persistence (JPA)插件,该插件在 IntelliJ IDEA 中默认捆绑并启用。 如果相关功能不可用,请确保您没有禁用插件。
按 Ctrl+Alt+S 打开设置,然后选择 。
找到 Jakarta EE: Persistence (JPA) 插件并点击 启用。
IntelliJ IDEA 提供以下内容:
与 JPA 相关的编码支持。
用于管理 JPA 配置 persistence.xml 和对象关系映射 orm.xml 文件的专用面。
用于管理 JPA 项目项、创建配置文件和持久类、在编辑器中导航到相关源代码、打开图表和控制台等的 Persistence 工具窗口。
可从 持久性 工具窗口访问的实体关系 (ER) 图。
通过导入数据库架构或 EJB 部署描述符文件来生成托管实体类及其对象关系映射的功能 ejb-jar.xml 。
用于编写和运行 JPQL 查询及分析查询结果的 JPA console。
创建一个新的 Jakarta EE 项目并使用 JPA。
打开 新建项目 向导:
如果位于主屏幕,请选择 。
如果已打开另一个项目,请转到 。
从左侧的 生成器 列表中,选择
Jakarta EE。

设置 Jakarta EE 项目设置。
准备就绪后,点击 下一步。
从 版本 下拉菜单中选择要使用的 Jakarta EE 版本。
从 规范 列表中选择 持久化(JPA)。
如果您不打算自己实现 JPA 规范的所有接口,您还需要包含一个持久性框架。 默认情况下,IntelliJ IDEA 提供对以下持久化框架的支持:
EclipseLink 是参考实现。 如果您只是尝试一些东西,请选择它。
Hibernate 是最最受欢迎的的实现。 如需更多信息,请参阅 Hibernate。

点击 创建。
有关创建 Jakarta EE 项目的更多信息,例如如何设置应用程序服务器,请参阅 教程:您的第一个 Jakarta EE 应用程序。
向现有项目添加 JPA
在编辑器中打开构建文件( pom.xml 或 build.gradle ,具体取决于项目中使用的 构建工具)。
添加 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")
按 Ctrl+Shift+O 导入更改。
共享 facet 设置
您可以通过创建自定义 Facet,并将带有 .iml 扩展程序的模块文件添加到版本控制系统来更改和共享设置。
例如,为了在您的团队中共享选定的数据源用于 JPA,您可以创建一个 JPA facet 并提交其设置。
在主菜单中,转到 或按 Ctrl+Alt+Shift+S。 然后选择 模块。
请确保已选择要添加 Facet 的模块,然后点击模块列表上方的
。 在可用 Facet 列表中,选择 JPA。

右侧将会显示 描述符 部分。
在 描述符 部分,点击
并选择描述符类型。 创建一个新文件或指定现有文件的路径。
重新打开项目。 之后,更改将显示在已添加 Facet 的模块的 .iml 文件中。

将 .iml 文件添加到版本控制系统。