imported>Peterxy：修饰语句

2025-08-01T05:02:12Z

修饰语句

新页面

{{NoteTA
| G1 = it
}}{{copyedit|time=2018-07-29T04:01:29+00:00}}
'''Java持久化API'''（'''JPA'''）是一个[[Java]][[应用程序接口]]规范，描述了使用[[Java SE|Java标准版平台]]（Java SE）和[[Jakarta EE|Java企业版平台]]（Java EE）的应用中的[[Jakarta EE|关系数据]]的管理。

[[持久化]]，在这里包括三个层面的意思：

* [[應用程式介面|API]]本身，定义在<code>javax.persistence</code>包<tt>内</tt>
* Java持久化查询语言（JPQL）
* 对象/关系元数据

JPA的[[参考实现]]是{{link-en|EclipseLink|EclipseLink}}。

== 历史背景 ==
2006年5月11号，JPA 1.0规范作为JCP JSR 220的一部分最终被发布。JPA 2.0规范，在2009年12月发布（Java EE 6平台，依赖于JPA 2.0）。JPA 2.1规范，在2013年4月22日发布（Java EE 7平台，依赖于JPA 2.1<ref>{{cite web|url=https://docs.oracle.com/javaee/7/tutorial/overview007.htm|title=JavaEE 7 tutorial|publisher=Oracle|accessdate=2018-07-29|archive-date=2018-10-02|archive-url=https://web.archive.org/web/20181002022440/https://docs.oracle.com/javaee/7/tutorial/overview007.htm|dead-url=no}}</ref>）。JPA 2.2规范，于2017年夏季发布。

== 实体 ==
持久化实体是一个轻量级的Java类，其状态通常持久地保存到关系数据库的表中。这种实体的实例对应于表中的各个行。实体之间通常有关系，这些关系通过对象/关系元数据表示。可以在实体类文件中直接使用注释来指定这种关系，也可以在随应用程式分发的单独XML描述文件中指定。

=== 範例 ===
用注釋宣告含有對象/關係元數據的實體類 (省略import語句、setters/getters方法)

<syntaxhighlight lang="java">
@Entity
public class Person {
@Id
private long id;
private String firstName;
private String lastName;
private int age;
}
</syntaxhighlight>

<code>@Entity</code> 宣告類為一個實體，<code>@Id</code> 宣告該屬性為[[主鍵]]，例如: 此處的<code>id</code> 就是這個實體的[[主鍵]]。另外可以再用其他注釋來宣告元數據(例如: 使用<code>Table</code>來變更預設的資料表名稱)，或建立表與表之間的關聯。

== Java 持久化查询语言（JPQL） ==
Java持久化查询语言（JPQL）对存储在关系数据库中的实体进行查询。查询在语法上类似于SQL查询，但是操作的是实体对象而不是直接对数据库表进行操作。

== 动机 ==
在引入EJB 3.0规范之前，许多企业级Java开发人员使用由持久化框架（例如Hibernate）或数据访问对象（DAO）提供的轻量级持久化对象，来代替实体bean（EJB的一种）。这是因为在以前的EJB规范中，实体bean需要太多复杂的代码和繁重的资源占用，并且由于bean和DAO对象或持久化框架之间的源代码中的互连和依赖性，它们只能在Java EE应用程式服务器中使用。因此，最初在第三方持久性框架中提供的许多功能都被合并到Java持久化API中，并且从2006年开始，像Hibernate（版本3.2）和TopLink Essentials这样的项目已经实现Java持久化API规范。

== 相关技术 ==

=== 企业 JavaBeans（EJB） ===
EJB 3.0规范（本身是Java EE 5平台的一部分）包含Java持久化API的定义。无论如何，终端用户不需要EJB容器或Java EE应用程式服务器即可运行使用此持久性API的应用程式。<ref>[http://docs.jboss.org/hibernate/entitymanager/3.5/reference/en/html_single/#architecture-javase Hibernate EntityManager: Java SE environments] {{Wayback|url=http://docs.jboss.org/hibernate/entitymanager/3.5/reference/en/html_single/#architecture-javase |date=20190601084640 }}<br />[http://docs.jboss.org/hibernate/entitymanager/3.5/reference/en/html_single/#d0e980 Hibernate EntityManager: Obtaining an EntityManager in a Java SE environment] {{Wayback|url=http://docs.jboss.org/hibernate/entitymanager/3.5/reference/en/html_single/#d0e980 |date=20190601084640 }}</ref> Java持久化 API的未来版本将在单独的JSR和规范中定义，而不是在EJB JSR /规范中定义。

Java持久化API取代了EJB 2.0 CMP（持久化管理容器）的持久性解决方案

=== Java数据对象的API ===
Java持久化API作为统一Java Data Objects API和EJB 2.0容器管理持久性（CMP）API的一部分来开发。截至2009年，支持这些API的大多数产品都支持Java持久化API。

Java持久化API仅为关系数据库管理系统提供持久化特性。也就是说，JPA专注于对象关系映射（ORM）（请注意，除了关系数据库之外，还有JPA提供程式支持其他数据库模型，但这超出了JPA的设计范围）。有关JPA角色的说明，请参阅JPA 2规范第1节简介，其中非常清楚地说明“这项工作的技术目标是为Java应用程式开发人员提供一个对象/关系映射工具，使用Java领域模型来管理关系数据库。”

Java数据对象规范支持ORM，以及对其他类型的数据库模型的持久化，例如平面文件数据库和NoSQL数据库，包括文档数据库，图形数据库，以及字面上任何其他可想到的数据存储。

=== 服务数据对象 API ===
Java持久化API的设计者旨在提供关系持久化，其中许多关键领域来自对象关系映射工具，如Hibernate和TopLink。Java持久化API改进并取代了EJB 2.0，其体现在EJB 3.0中。服务数据对象（SDO）API（JSR 235）与Java持久化API有着截然不同的目标，被认为是互补的。<ref>{{Cite web|url=http://charltonb.typepad.com/weblog/2007/10/sdo-and-jpa.html|title=SDO and JPA|accessdate=5 May 2011|last=Barreto|first=Charlton|work=Digital Walkabout|archiveurl=https://web.archive.org/web/20110813112451/http://charltonb.typepad.com/weblog/2007/10/sdo-and-jpa.html|archivedate=2011-08-13|dead-url=no}}</ref><ref>{{Cite web|url=http://www.osoa.org/display/Main/SDO+and+Java+Persistence+Architecture+%28JPA%29|title=SDO and Java Persistence Architecture (JPA)|accessdate=5 May 2011|last=Edwards|first=Mike|work=Open SOA|publisher=osoa.org|archive-date=2011-09-29|archive-url=https://web.archive.org/web/20110929221810/http://www.osoa.org/display/Main/SDO+and+Java+Persistence+Architecture+(JPA)|dead-url=no}}</ref>SDO API专为面向服务的体系结构，多种数据格式而非关系数据和多种编程语言而设计。JCP管理SDO API的Java版本；SDO API的C++版本通过OASIS进行管理。

=== Hibernate ===
Hibernate为Java提供了一个开源的对象关系映射框架。版本3.2及更高版本提供了Java 持久化 API的实现。Gavin King创立了Hibernate项目。<ref>{{Cite book|url=https://books.google.com/books?id=EWVnnAEACAAJ|title=Java Persistence with Hibernate|publisher=Manning Publications|accessdate=8 December 2013|isbn=9781617290459|quote=Gavin King is the founder of the Hibernate project|archive-date=2019-06-05|archive-url=https://web.archive.org/web/20190605104413/https://books.google.com/books?id=EWVnnAEACAAJ|dead-url=no}}</ref>他代表JBoss参加JSR 220，这是负责开发JPA的JCP专家组。<ref>{{Cite web|url=http://www.jboss.com/company/leadership|title=JBoss.com - Industry Leadership|accessdate=2008-11-17|publisher=JBoss|quote=JSR 220, EJB 3.0 Spec Committee, Gavin King, Bill Burke, Marc Fleury|archive-date=2012-10-01|archive-url=https://web.archive.org/web/20121001072413/http://www.jboss.com/company/leadership/|dead-url=no}}</ref>这引发了围绕JPA和Hibernate之间关系的持续争议和猜测。Sun Microsystems表示<ref>{{Cite web|url=http://java.sun.com/javaee/overview/faq/persistence.jsp|title=Java Persistence API FAQ|accessdate=2010-07-01|publisher=Sun Microsystems|archiveurl=https://web.archive.org/web/20080822023926/http://java.sun.com/javaee/overview/faq/persistence.jsp|archivedate=2008-08-22|quote=The Java Persistence API draws upon the best ideas from persistence technologies such as Hibernate, TopLink, and JDO|dead-url=no}}</ref>，这些想法来自几个框架，包括Hibernate和Java 数据对象。

=== Spring Data JPA ===
抽象存储库的实现是Java应用程式框架Spring的领域驱动设计的关键构建块。透明地支持所有可用的JPA实现，并支持CRUD操作以及方便地执行数据库查询。

== JPA 2.0 ==
2007年7月，JPA 2.0 在JCP的JSR 317请求中作为新版本开发。2009年12月10日，JPA 2.0被批准为最终正式标准。JPA 2.0的重点是提供一些流行的ORM供应商中存在的特性，但在JPA 1.0中不能获得一致认可。

主要特性包括：

* 扩大对象关系功能的映射
** 支持内嵌对象的收集，通过多对一的关系映射来连接ORM
** 有序列表
** 访问类型的组合
* 一种标准查询API
* 标准化的SQL提示
* 标准化的附加元数据，以支持DDL生成
* 支持验证
* 支持共享对象的高速缓存

支持JPA 2.0的供应商:

* Batoo JPA
* DataNucleus (formerly JPOX)
* EclipseLink (formerly [[TopLink|Oracle TopLink]])
* [[IBM]], for [[IBM WebSphere Application Server|WebSphere Application Server]]<ref>{{Cite web|url=http://www-01.ibm.com/common/ssi/cgi-bin/ssialias?subtype=ca&infotype=an&appname=iSource&supplier=897&letternum=ENUS210-129|title=IBM WebSphere Application Server V7 Feature Pack for OSGi Applications and Java Persistence API|accessdate=8 December 2013|date=27 April 2010|work=Download web site|publisher=IBM|archive-date=2019-06-10|archive-url=https://web.archive.org/web/20190610231731/http://www-01.ibm.com/common/ssi/cgi-bin/ssialias?subtype=ca&infotype=an&appname=iSource&supplier=897&letternum=ENUS210-129|dead-url=no}}</ref>
* [[WildFly|JBoss]] with [[Hibernate]]
* [https://github.com/impetus-opensource/Kundera Kundera] {{Wayback|url=https://github.com/impetus-opensource/Kundera |date=20170222073553 }}
* ObjectDB
* OpenJPA
* OrientDB from Orient Technologies
* Versant Corporation JPA (not relational, object database)<ref>{{Cite web|url=http://community.versant.com/jpa.aspx|title=Versant JPA 2-Step Download|accessdate=8 December 2013|work=Download web site|publisher=[[Actian]]|archive-date=2013-12-08|archive-url=http://archive.wikiwix.com/cache/20131208025012/http://community.versant.com/jpa.aspx|dead-url=no}}</ref>

== JPA 2.1 ==
2011年7月，JPA 2.1 在JCP的JSR 338请求中作为新版本开发。2013年5月22日，JPA 2.1被批准为最终正式标准。

主要特性包括：

* 转换器-允许自定义的代码去装换不同的数据库和数据类型。
* 标准Update/Delete-允许通过标准API批量更新和删除。
* 实体图表-允许获取部分或合并对象。
* JPQL/标准增强-算子查询，通用数据库的功能，Join 联合查询，TREAT 选项。
* 模式生成
* 存储过程，允许查询被定义为数据库的存储过程。

支持JPA 2.1 的供应商:

* DataNucleus
* EclipseLink
* Hibernate

== JPA 2.2 ==
2017年，JPA 2.2在JCP的JSR 338请求中作为维护版本发布开发。维护审查已于2017年6月19日获得批准。

主要特性包括：

* 给所有有关的注释添加<code>@Repeatable</code>
* 允许所有JPA注释可用于元的注释。
* 添加查询结果流处理能力
* 允许AttributeConverters的CDI注入
* 支持Java 8的日期和时间类型

支持JPA 2.2的供应商:

* DataNucleus
* EclipseLink（自2.7版本以來）
* [[Hibernate]] （自5.3版本以來）

== JPA的未来工作 ==
未来的JPA规范信息可在此处获得：

* JPA Specification Mailing Lists
* JPA Specification JIRA<br />

2015年11月，Linda DeMichiel在javaee-spec用户邮件中宣布Lukas Jungmann接任规范化主管。Linda的声明还表示，“计划在Java EE 8时间框架内为JPA 2.2做MR”。<ref>{{Cite web|url=https://java.net/projects/javaee-spec/lists/users/archive/2015-11/message/1|title=Java EE Platform Specification: users@javaee-spec.java.net: Archive — Project Kenai|accessdate=2016-11-08|archive-date=2016-11-09|archive-url=https://web.archive.org/web/20161109023844/https://java.net/projects/javaee-spec/lists/users/archive/2015-11/message/1|dead-url=no}}</ref><ref>{{Citation|last=Java|title=JavaOne LIVE - Tuesday, Mission|date=2015-10-27|url=https://www.youtube.com/watch?v=1OKEpg5zpsU#t=4h19m26s|access-date=2016-11-08|archive-date=2019-02-16|archive-url=https://web.archive.org/web/20190216202400/https://www.youtube.com/watch?v=1OKEpg5zpsU#t=4h19m26s|dead-url=no}}</ref><ref>{{Cite news|url=https://events.rainfocus.com/oow15/catalog/oracle.jsp?event=javaone&search=jungmann&search.event=javaoneEvent|title=What’s New in the Java Persistence API (JSR 338) [CON7631]|last=Jungmann|first=Lukas|date=10 October 2015|work=JavaOne 2015 Session Catalog|via=rainfocus.com|accessdate=2016-11-08|archive-url=https://web.archive.org/web/20161109083929/https://events.rainfocus.com/oow15/catalog/oracle.jsp?event=javaone&search=jungmann&search.event=javaoneEvent|archive-date=2016-11-09|dead-url=yes}}</ref>

== 工具 ==

* NetBeans Jeddict
* Eclipse JPA（Dali）

== 参见 ==

* .NET Persistence API（NPA）
* [[Java数据库连接|JDBC]]
* [[MyBatis]]
* OpenXava
* [[IBM DB2|pureQuery]]
* [[SAP Web应用服务器|SAP NetWeaver Application Server]]
* XQJ
* [https://github.com/braisdom/ObjectiveSql ObjectiveSql] {{Wayback|url=https://github.com/braisdom/ObjectiveSql |date=20201229135311 }}

== 参考文献 ==
{{reflist}}

== 外部链接 ==

=== 一般信息 ===

* [http://jcp.org/aboutJava/communityprocess/final/jsr220/index.html Documentation for the final version of the EJB3 spec (called JSR220)] {{Wayback|url=http://jcp.org/aboutJava/communityprocess/final/jsr220/index.html |date=20200426220450 }}
* [http://glassfish.dev.java.net/javaee5/persistence/ GlassFish's Persistence page]{{Webarchive|url=https://archive.today/20130112000920/http://glassfish.java.net/javaee5/persistence/ |date=2013-01-12 }}
* [http://jcp.org/aboutJava/communityprocess/final/jsr317/index.html JCP Persistence page] {{Wayback|url=http://jcp.org/aboutJava/communityprocess/final/jsr317/index.html |date=20210119165310 }}

=== 教程 ===

* [http://docs.oracle.com/javaee/6/api/javax/persistence/package-summary.html Java EE 6 Persistence API Javadoc]{{Wayback|url=http://docs.oracle.com/javaee/6/api/javax/persistence/package-summary.html |date=20120820044211 }}
* [http://docs.oracle.com/javaee/6/tutorial/doc/bnbpy.html Java EE 6 Persistence API tutorial] {{Wayback|url=http://docs.oracle.com/javaee/6/tutorial/doc/bnbpy.html |date=20200508012524 }}
* [http://docs.oracle.com/javaee/7/api/javax/persistence/package-summary.html Java EE 7 Persistence API Javadoc] {{Wayback|url=http://docs.oracle.com/javaee/7/api/javax/persistence/package-summary.html |date=20200924194326 }}
* [http://docs.oracle.com/javaee/7/tutorial/partpersist.htm Java EE 7 Persistence API tutorial] {{Wayback|url=http://docs.oracle.com/javaee/7/tutorial/partpersist.htm |date=20190402121325 }}
* [http://www.thejavageek.com/jpa-tutorials/ JPA Tutorial by Prasad Kharkar] {{Wayback|url=http://www.thejavageek.com/jpa-tutorials/ |date=20200728085039 }}
* [http://www.javacodegeeks.com/2015/02/jpa-tutorial.html JPA Tutorial from Java Code Geeks] {{Wayback|url=http://www.javacodegeeks.com/2015/02/jpa-tutorial.html |date=20201108103920 }}
* [http://www.coderpanda.com/jpa-tutorial/ JPA Tutorial using OpenJPA as implementation] {{Wayback|url=http://www.coderpanda.com/jpa-tutorial/ |date=20201204102244 }}
* [http://java.sun.com/javaee/5/docs/tutorial/doc/?wp406141&JavaEETutorialPartFour.html#wp996871 Persistence in the Java EE 5 tutorial]{{Wayback|url=http://java.sun.com/javaee/5/docs/tutorial/doc/?wp406141&JavaEETutorialPartFour.html#wp996871 |date=20191017191350 }}
[[Category:Java企业平台]]
[[Category:Java规范请求]]
[[Category:对象关系映射]]

Java持久化API - 版本历史

imported>Peterxy：​修饰语句

imported>Peterxy：修饰语句