Jakarta Persistence (JPA)

启用 Jakarta EE：持久性（JPA）插件

此功能依赖于 Jakarta EE: Persistence ​(JPA)​插件，该插件在 IntelliJ IDEA 中默认捆绑并启用。 如果相关功能不可用，请确保您没有禁用插件。

1. 按 Ctrl+Alt+S 打开设置，然后选择 插件。

2. 打开 已安装 标签，找到 Jakarta EE: Persistence (JPA)插件，并选中插件名称旁边的复选框。

创建一个新的 Jakarta EE 项目并使用 JPA。

1. 打开 新建项目 向导：

   • 在欢迎屏幕上，点击 新建项目。

   • 在 IDE 中，转到 文件 | 新建 | 项目。

2. 从 生成器 列表中选择 Jakarta EE。

   

3. 设置 Jakarta EE 项目设置。

4. 进入向导的下一步。 在左上角选择要使用的 Jakarta EE 版本。

5. 从 规范 列表中选择 持久性（JPA）。

   如果您不打算自己实现 JPA 规范的所有接口，您还需要包含一个持久性框架。 默认情况下，IntelliJ IDEA 提供对以下持久化框架的支持：

   • EclipseLink 是参考实现。 如果您只是尝试一些东西，请选择它。

   • Hibernate 是最最受欢迎的的实现。 如需更多信息，请参阅 Hibernate。

   

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.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 Persistence 功能，例如 Persistence 工具窗口，就会立即可用。

有关使用构建工具的详细信息，请参阅 Maven 或 Gradle。

共享 facet 设置

您可以通过创建自定义 Facet，并将带有 .iml 扩展名的模块文件添加到版本控制系统来更改并共享设置。

例如，为了在您的团队中共享选定的数据源用于 JPA，您可以创建一个 JPA facet 并提交其设置。

1. 在主菜单中，转到 文件 | 项目结构 或按 Ctrl+Alt+Shift+S。 然后选择 模块。

2. 请确保已选择要添加 Facet 的模块，然后点击模块列表上方的 。 在可用 Facet 列表中，选择 JPA。

   

   右侧将会显示 描述符 部分。

3. 在 描述符 部分，点击 并选择描述符类型。 创建一个新文件或指定现有文件的路径。

4. 重新打开项目。 之后，更改将显示在已添加 Facet 的模块的 .iml 文件中。

   

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