管理 persistence.xml 文件

当您创建项目时,Eclipse 将在该项目的目录中创建 META-INF\persistence.xml 文件。

创建 JPA 项目时,可以在 META-INF 目录中创建存根 persistence.xml 文件(请参阅创建新的 JPA 项目)。可以通过 XML 编辑器(请参阅)或者通过 persistence.xml 编辑器来管理此文件。


注意:

根据 JPA 实现不同(例如,EclipseLink),persistence.xml 编辑器中可能会提供下列附加页面:
  • 定制

    使用此页来定义与更改跟踪和会话定制程序相关的属性。

  • 高速缓存

    使用此页来定义高速缓存属性。

  • 日志记录

    使用此页来定义日志记录属性。

  • 选项

    使用此页来定义会话和目标数据库属性。

  • 模式生成

    使用此页来定义与 DDL 相关的属性。

对于使用 EclipseLink JPA 实现的项目,“连接”页还包含 JDBC 连接池属性。

如果该项目使用“常规”平台,那么将只提供常规连接属性源代码页面。


要使用 persistence.xml 编辑器,请执行下列操作:

  1. 打开 peristence.xml 文件。将显示编辑器的常规页。

  2. 使用常规页来定义 persistence.xml 文件中与 <persistent-unit> 相关的属性以及 <provider><class> 元素(如下表所述)。


    提示:

    persistence.xml 编辑器的“源代码”页使您能够查看和编辑原始 XML 文件。

    属性 描述 定义的元素
    名称 输入持久单元的名称。 <persistence-unit name = "<Name>">
    持久性提供程序 输入持久性提供程序的名称。 <provider>
    描述 输入此持久单元的描述。这是可选属性。 <description>
    管理的类 添加或除去通过该持久单元管理的类。 <class>
        排除未列示的类 要将所有带有注释的实体类包括在持久单元的根中,请选中此项。 <exclude-unlisted-classes>
    XML 映射文件  添加或除去对象/关系映射 XML 文件,这些文件定义通过持久单元管理的类。 <mapping-file>
    JAR 文件 添加或除去其他 JAR 文件和库

  3. 使用连接页来定义 <jta-data-source><non-jta-data-source> 元素,如下所示:

    要配置持久性提供程序所使用的 JTA(Java 事务 API)数据源:

    1. 从“事务类型”列表中选择 JTA

    2. 输入数据源的全局 JNDI 名称。

    要配置非 JTA 数据源,请执行下列操作:

    1. 从“事务类型”列表中选择资源本地

    2. 输入数据源的全局 JNDI 名称。


      注意:

      要使用容器提供的数据源,请选择 Default()

    对于使用通用平台的项目,还可以定义 EclipseLink 连接池驱动程序、连接池驱动程序、URL、用户名和密码。

  4. 使用“属性”页中的表来设置特定于供应商的 <properties> 元素。

    要添加 <property> 元素,请执行下列操作:

    1. 单击添加

    2. 使用该表的“名称”和“值”字段,输入 <property> 元素的 <name><value> 属性。

    要除去 <property> 元素,请从表中选择已定义的属性,然后单击除去


    注意:

    如果该项目使用 EclipseLink 平台,那么“连接”页还将包含 JDBC 连接池参数。

相关参考

persistence.xml 编辑器

 

相关任务

使类同步

 

相关概念

persistence.xml 文件