(注:本系列笔记是在学习尚硅谷JPA课程的时候写下的,结合课程内容和自我理解,方便自己以后进行复习)
一、在创建JPA之前看看什么是JPA
1、Java Persistence API:用于对象持久化的 API
2、Java EE 5.0 平台标准的 ORM 规范,使得应用程序以统一的方式访问持久层
3、结合下面两幅图片进行理解:
JPA功能示意图:
Figure 1.1
JDBC功能示意图:
Figure 1.2
4、JPA和Hibernate的关系
JPA 是 hibernate 的一个抽象(就像JDBC和JDBC驱动的关系):
——JPA 是规范:JPA 本质上就是一种 ORM 规范,不是ORM 框架 —— 因为 JPA 并未提供 ORM 实现,它只是制订了一些规范,提供了一些编程的 API 接口,但具体实现则由 ORM 厂商提供实现
——Hibernate 是实现:Hibernate 除了作为 ORM 框架之外,它也是一种 JPA 实现
从功能上来说, JPA 是 Hibernate 功能的一个子集
二、创建JPA工程之前需要解决一个问题:at least one user library must be selected
问题描述:在Workspace中右键,new → JPA Project,选择JAP version为2.0。此时,向导中的Finish是灰色的,不能够点击完成。没办法,只好点击Next看看,一路Next下去看到如下图Figure 2.1所示这样一个问题:at least one user library must be selected。
Figure 2.1
没有办法创建JAP工程,只好网上搜索,找到一篇歪果仁写的一篇博文,很好的解决了我这个问题:
http://www.javabeat.net/eclipselink-jpa-installation-configuration/
下面将博文要点整理成如下中文:
这篇文章将向你介绍如何安装和使用EclipseLink-JPA:
1、安装EclipseLink JAR 文件
- 从 https://www.eclipse.org/eclipselink/downloads/ 处下载 EclipseLink 2.5.2 Installer Zip (38 MB) 资源(也可以选择其它版本)。EclipseLink中提供了所有持久化服务的的实现。
- 持久化服务将会用到下面三个jar包:
①、eclipselink.jar
②、javax.persistence.source_2.1.0.v201304241213.jar
③、javax.persistence_2.1.0.v201304241213.jar
- 将下载好的EclipseLink 2.5.2压缩包解压到任何你想用于完成安装的文件夹中。我将文件解压到 “.workspacelibrariesEclipseLink 2.5.2” 文件夹下。
2、在Eclipse IDE中设置 JPA Facet
首先在Eclipse中创建一个动态web工程,为我们后续添加 JPA facet 作准备。步骤如下:
①、打开 Eclipse IDE
②、创建一个动态的Web工程
③、在刚刚创建好的工程上点击右键,选择properties
④、在左侧那一列中点击 “Project Facets”
⑤、然后在右侧选中 JPA 选项,同时选择 JPA version 为2.0。如下图Figure 2.2所示:
Figure 2.2
这里有一个要注意的,因为有后续的很多设置要完成,所以在选择JPA和Version以后不能直接点击OK,而是要点击上图中下面部分标注的“Further configuration ...”链接来进行后续配置。这个操作将会打开一个新的对话框用于配置JPA Facet。
3、添加 JPA Facet
新弹开的对话框如下图Figure 2.3所示。用户可以在这个对话框中添加必须的库来实现JPA。
Figure 2.3
①、对话框上端的platform默认情况下是“Generic 2.0”,我们可以依据我们自己下载的EclipseLink版本来进行修改。我下载的是2.5.2版本,所以如Figure 2.3所示选择platform为EclipseLink 2.4.x/2.5.x版本
②、JPA implementation菜单不需要做任何修改。“User Library” type将会允许用户添加JPA库
③、点击右侧的“Manager Libraries”。除此之外,另外一个实现方法就是点击“Download Library”来进行下载库,但是这里下载实在是太慢,所以不使用它。
④、点击“Manager Libraries”以后会弹出一个对话框,在新的对话框中点击“New”。
⑤、“New”以后又会弹出一个对话框,要我们填写库的名字,我填写为“EclipseLink 2.5.2”。点击OK。
到目前为止,我们已经做好了添加jar包的前期准备。接下来就是添加上面“1、安装EclipseLink JAR 文件”这一步中提到的那三个jar包了。到目前的效果图如下Figure 2.4:
Figure 2.4
4、配置Library
配置Library需要我们添加JPA实现所必须的jar包。按照下面的步骤来完成配置:
①、点击“Add External JARs...”(也就是Figure 2.4图中红色框中的按钮)
②、添加 eclipselink.jar,它位于“.workspacelibrariesEclipseLink 2.5.2jlib”文件夹下面
③、添加 “.workspacelibrariesEclipseLink 2.5.2jlibjpa”文件夹下 javax.persistence.* 开头的jar包(也就是前面说的后两个jar包)。如Figure 2.5所示
Figure 2.5
④、点击下端的OK按钮,会关闭添加library的对话框。
⑤、但是,为了避免JPA Facet报“At least one user library must be selected”这个错误。我们选择刚刚生成的library
⑥、点击OK。
到现在为止,前面提到的At least one user library must be selected错误已经得到了解决。到这里我们再回头去创建一个JPA工程就没有什么问题了。但是,歪果仁的这篇文章的目的是为了在动态Web工程中创建一个JPA环境。
这个是很有必要的,想想也是,现在单纯为了学习建了一个JPA工程,以后做Web工程的时候就需要创建一个动态Web工程了。
而且,后面的两个步骤还是挺有意思的,所以,这里是插叙,下面继续翻译歪果仁的文章。
到现在为止我们创建的动态web工程已经能够使用JPA了。但是,JPA是一个和关系型数据库相联系的持久化服务。所以,接下来我们就需要创建一个数据库连接
5、创建数据库链接(新意在于可以在配置的同时完成链接的测试工作)
一旦你创建完成了一个user library,接下来的工作就是创建一个数据库连接。最后一个对话框应该如Figure 2.6所示:
Figure 2.6
为了建立数据库的链接,按照以下步骤进行:
①、点击“Add Connection...”超链接(Figure 2.6中有标注)
②、Connection Profile 对话框将会弹出
③、选择工程中在对话框中选择工程使用的数据库种类。本教程中假设你使用的是MySQL数据库。
④、修改链接的名字,点击Next
⑤、填写“Specify a Driver and Connection Details”表单。在最初的时候可能弹出的对话框中没有驱动可以选择,这个时候我们需要手动的添加相关驱动,步骤如Figure 2.7和Figure2.8所示:
Figure 2.7
Figure2.8
点击上面的Figure 2.8中的OK以后,新的driver就添加完成了。随后就是在Figure 2.9中修改数据库名,填写用户名和密码,然后点击“Test Connection”测试数据库连接是否成功:
Figure 2.9
有意思的是,测试通过会弹出一个 ping successed! 提示框,如Figure 2.10所示:
Figure 2.10
⑥、在第⑤步的末尾,我们已经为JPA工程准备好了数据库连接
⑦、点击Figure 2.9中的finish按钮
⑧、点击finish以后对话框将会关闭,所以要确定连接已经被选中
⑨、点击,OK关闭Further configuration dialog。继续点击OK关闭project facets
现在,你已经创建完成了一个新的动态web工程,同时为它配置好了JPA环境。在eclipse左侧的导航栏里面你可以在src下看见一个META-INF文件夹了,该文件夹下面有一个persistence.xml文件。
6、配置persistence.xml文件
如果你按照步骤进行到这里了,而且所有步骤都成功操作了。现在是时候“编辑”persistence.xml文件的时候了,这个文件将会帮助我们连接我们的数据库。
为了配置persistence.xml文件,你需要双击打开它。它会在单独的一个xml文件编辑器中打开,在这个编辑器的底端会有很多的标签。现在我们按照以下的步骤完成persistence.xml文件的配置工作:
①、导航到Connection标签
②、将transaction type选择为“Resource Local”。这个改变将会激活EclipseLink connection pool。
③、点击“populate from connection”。见Figure 2.11
④、选择之前配置好的链接。见Figure 2.12
⑥、用 Ctrl + s 来保存文件。见Figure 2.13
⑦、导航到Source标签。你将会看到用于数据库连接的最小配置。
Figure 2.11
Figure 2.12
Figure 2.13
看看xml中的源码如下:
<?xml version="1.0" encoding="UTF-8"?> <persistence version="2.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_2_0.xsd"> <persistence-unit name="a" transaction-type="RESOURCE_LOCAL"> <properties> <property name="javax.persistence.jdbc.url" value="jdbc:mysql://localhost:3306/jpa"/> <property name="javax.persistence.jdbc.user" value="root"/> <property name="javax.persistence.jdbc.password" value="tiger123"/> <property name="javax.persistence.jdbc.driver" value="com.mysql.jdbc.Driver"/> </properties> </persistence-unit> </persistence>