我需要persistence.xml 中的<class> 元素吗？

java hibernate orm jpa annotations

我有非常简单的persistance.xml 文件：

<?xml version="1.0" encoding="UTF-8"?>
<persistence version="1.0"
    xmlns="http://java.sun.com/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd">

    <persistence-unit name="eventractor" transaction-type="RESOURCE_LOCAL">
        <class>pl.michalmech.eventractor.domain.User</class>
        <class>pl.michalmech.eventractor.domain.Address</class>
        <class>pl.michalmech.eventractor.domain.City</class>
        <class>pl.michalmech.eventractor.domain.Country</class>

        <properties>
            <property name="hibernate.hbm2ddl.auto" value="validate" />
            <property name="hibernate.show_sql" value="true" />
        </properties>
    </persistence-unit>

</persistence>

它有效。

但是当我删除 <class> 元素时，应用程序看不到实体（所有类都用 @Entity 注释）。

是否有任何自动机制来扫描 @Entity 类？

Alexey Osetsky

persistence.xml 有一个可以使用的 jar-file。从 the Java EE 5 tutorial：

这个单元管理订单和客户。它不依赖于任何供应商特定的功能，因此可以部署到任何持久性提供商。 jdbc/MyOrderDB MyOrderApp.jar com.widgets.Order com.widgets.Customer

该文件定义了一个名为 OrderManagement 的持久性单元，它使用 JTA 感知数据源 jdbc/MyOrderDB。 jar-file 和 class 元素指定托管持久性类：实体类、可嵌入类和映射超类。 jar-file 元素指定对包含托管持久性类的打包持久性单元可见的 JAR 文件，而 class 元素显式命名托管持久性类。

对于 Hibernate，请查看 Chapter2. Setup and configuration 以了解更多详细信息。

编辑： 实际上，如果您不介意不符合规范，Hibernate 甚至在 Java SE 中也支持自动检测。为此，请添加 hibernate.archive.autodetection 属性：

<persistence-unit name="eventractor" transaction-type="RESOURCE_LOCAL">
  <!-- This is required to be spec compliant, Hibernate however supports
       auto-detection even in JSE.
  <class>pl.michalmech.eventractor.domain.User</class>
  <class>pl.michalmech.eventractor.domain.Address</class>
  <class>pl.michalmech.eventractor.domain.City</class>
  <class>pl.michalmech.eventractor.domain.Country</class>
   -->

  <properties>
    <!-- Scan for annotated classes and Hibernate mapping XML files -->
    <property name="hibernate.archive.autodetection" value="class, hbm"/>

    <property name="hibernate.hbm2ddl.auto" value="validate" />
    <property name="hibernate.show_sql" value="true" />
  </properties>
</persistence-unit>

我明白了，但是实体（@Entity）位于单独的 Maven 项目中，因此 jar 文件名可以在每次构建时更改。我正在寻找可以扫描特定包或类路径中的所有内容的东西。我只是懒得在persistence.xml 文件中输入很多很多元素。

在每个版本上？！我什至不会问为什么，但是......你可以使用过滤来解决这个问题。

不是每个人都完全一样，但我想抵制变化。

古老的线程，我知道，但看看 jpa-maven-plugin。

您可以在 persistence.xml 中使用元素（其中包含实体列表），这样您就可以保留所用文件的相同名称并将它们集成到所引用 jar 的构建中。

rsavchenko

在 Java SE 环境中，您必须按照规范指定所有类：

必须在 Java SE 环境中指定所有命名的托管持久性类的列表以确保可移植性

和

如果不打算将包含在持久性单元根中的带注释的持久性类包含在持久性单元中，则应使用 exclude-unlisted-classes 元素。 exclude-unlisted-classes 元素不适用于 Java SE 环境。

(JSR-000220 6.2.1.6)

在 Java EE 环境中，您不必这样做，因为提供程序会为您扫描注释。

非正式地，您可以尝试在您的 persistence.xml 中设置 <exclude-unlisted-classes>false</exclude-unlisted-classes>。此参数在 EE 中默认为 false，在 SE 中默认为 true。据我所知，EclipseLink 和 Toplink 都支持这一点。但是，如上所述，根据规范，您不应该依赖它在 SE 中工作。

您可以尝试以下方法（在 SE 环境中可能有效，也可能无效）：

<persistence-unit name="eventractor" transaction-type="RESOURCE_LOCAL">
     <exclude-unlisted-classes>false</exclude-unlisted-classes>

    <properties>
            <property name="hibernate.hbm2ddl.auto" value="validate" />
            <property name="hibernate.show_sql" value="true" />
    </properties>
</persistence-unit>

<exclude-unlisted-classes>false</exclude-unlisted-classes> 不适用于 WildFly 8.2.1.Final + Hibernate 4.3.7