在 Java EE 环境中组装 JPA 应用程序

您已开发且配置了应用程序以使用 Java™ Persistence API (JPA)。现在,您需要针对您的环境对 JPA 应用程序进行打包。

关于此任务

过程

封装应用程序。 为 Java EE 环境中使用 JPA 的应用程序提供了若干个封装选项。选择最适合于应用程序模块中的 JPA 用途和配置的封装选项。这些选项是其中一些最常用的封装选项。有关封装选项的确切列表,请参阅 Java Persistence API 规范。
注: IBM® Optim™ PureQuery Runtime 向 JPA 应用程序 JAR 文件添加了 persistence_unit_name.pdqxml 文件。这些文件在 persistence.xml 文件所在的 META-INF 目录中。 这些持久性文件是在开发任务期间创建的。请参阅主题“为 Java EE 环境开发 JPA 应用程序”以获取更多信息。
  • 对于独立 Enterprise JavaBeans (EJB) 模块或独立应用程序客户机模块,请将 EJB 和应用程序客户机模块封装在标准 Java archive (JAR) 文件中。确保封装应用程序时满足以下条件:
    • JAR 文件必须包含应用程序客户机的 EJB 类文件或 Java 类文件。
    • 归档的 META-INF 目录必须包含 persistence.xml
    • 如果应用程序使用映射文件、orm.xml 或定制映射文件,那么 JAR 文件也必须包含这些文件。如果未在持久性单元中指定 orm.xml 文件的位置,那么缺省位置是 JAR 文件的 META-INF 目录。
    • 当您开发应用程序时由注释处理器生成的 Criteria Metamodel 类文件需要包含在与实体类文件位置相同的 JAR 文件中。
  • 对于独立 Web 模块,请将应用程序封装在标准 Web 应用程序归档 (WAR) 文件中。确保封装应用程序时满足以下条件:
    • 当开发应用程序时由注释处理器生成的 Criteria Metamodel 类文件需要包含在与实体类文件位置相同的 WAR 文件中。
    • WAR 文件必须包含 Web 应用程序类文件。Web 应用程序类文件必须包含在 WEB-INF/classes 目录中或包含在 JAR 文件中,该 JAR 文件位于 WAR 文件的 WEB-INF/lib 目录中。
    • persistence.xml 文件必须包含在 WEB-INF/classes/META-INF 目录中或包含在 JAR 文件的 META-INF 目录中,该 JAR 文件包含在 WAR 文件的 WEB-INF/lib 目录中。
    • 如果应用程序使用映射文件、orm.xml 或定制映射文件,那么 WAR 文件也必须包含这些文件。映射文件可位于 WEB-INF/classes 目录或 JAR 文件中,该 JAR 文件包含在 WAR 文件的 WEB-INF/lib 目录中。使用 persistence.xml 文件的 <mapping-file> 元素来指定映射文件的位置。例如:
      <mapping-file>META-INF/JPAorm.xml</mapping-file>
  • 对于包含一个或多个模块的企业应用程序,请将该应用程序封装在标准企业应用程序归档 (EAR) 文件中。企业应用程序可包含一个或多个 EJB 模块、Web 模块或应用程序客户机模块。确保封装应用程序时满足以下条件:
    • 如果多个模块使用同一持久性单元,那么您可以创建持久性归档并将其封装在 EAR 文件中。
    • 将实体类、关联的 Criteria Metamodel 类、任何必需的支持类、persistence.xml 文件及其他映射文件包含在持久性归档文件中。对于 persistence.xml 和映射文件的位置,请遵循 EJB 和应用程序客户机模块的封装规则。
    • 每个使用持久性归档的模块在其 META-INF/MANIFEST.MF 文件中均必须具有一个类路径条目。如下是一个示例清单文件:
      Manifest-Version: 1.0
      Class-Path: MyJPAEntities.jar
    • 如果您的模块使用单独的持久性单元并共享实体类,那么您可以将这些实体类封装在持久性归档中并为每个模块指定不同的 persistence.xml 和映射文件。如果这些模块不共享实体类或持久性配置,请将每个模块封装为独立 EJB 模块、独立应用程序客户机模块或独立 Web 应用程序归档,然后将它们封装在 EAR 文件中。

下一步做什么

有关这些命令、类或其他 OpenJPA 信息的更多信息,请参阅 Apache OpenJPA User Guide。

指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tejb_assemblejpaee
文件名:tejb_assemblejpaee.html