jpa使用 at least one user library must be selected问题

at least one user library must be selected实际就是建立一个目录，导入三个包即可

①、 eclipselink.jar

②、javax.persistence.source_2.1.0.v201304241213.jar

③、javax.persistence_2.1.0.v201304241213.jar

（注：本系列笔记是在学习尚硅谷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压缩包解压到任何你想用于完成安装的文件夹中。我将文件解压到 “.\workspace\libraries\EclipseLink 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，它位于“.\workspace\libraries\EclipseLink 2.5.2\jlib”文件夹下面

③、添加 “.\workspace\libraries\EclipseLink 2.5.2\jlib\jpa”文件夹下 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>