安裝或設定

類路徑要求

需要包含 Eclipselink 和 JPA API。示例 Maven 依賴項:

<dependencies>
  <dependency>
    <groupId>org.eclipse.persistence</groupId>
    <artifactId>eclipselink</artifactId>
    <version>2.6.3</version>
  </dependency>
  <dependency>
    <groupId>org.eclipse.persistence</groupId>
    <artifactId>javax.persistence</artifactId>
    <version>2.1.1</version>
  </dependency>
  <!-- ... -->
</dependencies>

過冬

Hibernate-core 是必需的。Maven 依賴示例:

<dependencies>
  <dependency>
    <!-- requires Java8! -->
    <!-- as of 5.2, hibernate-entitymanager is merged into hibernate-core -->
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>5.2.1.Final</version>
  </dependency>
  <dependency>
    <groupId>org.hibernate.javax.persistence</groupId>
    <artifactId>hibernate-jpa-2.1-api</artifactId>
    <version>1.0.0</version>
  </dependency>
  <!-- ... -->
</dependencies>

DataNucleus 將

需要 datanucleus-core,datanucleus-api-jpa 和 datanucleus-rdbms(當使用 RDBMS 資料儲存時)。Maven 依賴示例:

<dependencies>
  <dependency>
    <groupId>org.datanucleus</groupId>
    <artifactId>datanucleus-core</artifactId>
    <version>5.0.0-release</version>
  </dependency>
  <dependency>
    <groupId>org.datanucleus</groupId>
    <artifactId>datanucleus-api-jpa</artifactId>
    <version>5.0.0-release</version>
  </dependency>
  <dependency>
    <groupId>org.datanucleus</groupId>
    <artifactId>datanucleus-rdbms</artifactId>
    <version>5.0.0-release</version>
  </dependency>
  <dependency>
    <groupId>org.datanucleus</groupId>
    <artifactId>javax.persistence</artifactId>
    <version>2.1.2</version>
  </dependency>
  <!-- ... -->
</dependencies>

配置細節

JPA 要求使用檔案 persistence.xml ,它位於 CLASSPATH 根目錄下的 META-INF 下。此檔案包含 JPA 可以執行的可用永續性單元的定義。

JPA 還允許使用對映配置檔案 orm.xml ,也可以放在 META-INF 下。此對映檔案用於配置類如何對映到資料儲存區,並且是在 JPA 實體類本身中使用 Java 註釋的替代/補充。