这一节写一个JPA的HelloWorld来体验一下。
一、建立工程
按照 1、创建一个JPA project(解决“at least one user library must be selected”问题)中说的步骤建立一个JPA project。创建过程极其简单,就是 New → JPA project 就可以了。当然,如果在创建的过程中出现了at least one user library must be selected 问题,而user library中又没有选项的时候可以参看第一节后面的解决方案(如果想给动态web工程创建JPA环境也参照这一节)。然后在工程中创建一个lib目录用于放置第三方jar包。工程结构如下:
二、添加必须的jar包
JPA是一个标准,其有很多种实现,如Hibernate,OpenJPA,TopLink等。之前学习过Hibernate,那么就用Hibernate的实现来进行学习。
要用到的jar包有:
①、hibernate-release-4.3.10.Final\lib\required 文件夹下的所有jar包
②、hibernate-release-4.3.10.Final\lib\jpa 文件夹下的所有jar包
③、MySQL 的jdbc驱动包 mysql-connector-java-5.1.7-bin.jar
三、创建实体(entity)类Customer.java
在创建实体类的时候会用到一些注解,这些注解在下一节进行讲解。不过这些注解的作用很容易理解。下面是Customer的代码:
package com.magicode.jpa.helloworld; import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
import javax.persistence.Table; /**
* @Entity 用于注明该类是一个实体类
* @Table(name="t_customer") 表明该实体类映射到数据库的 t_customer 表
*/
@Table(name="t_customer")
@Entity
public class Customer { private Integer id;
private String lastName; private String email;
private int age; /**
* @GeneratedValue(strategy=GenerationType.AUTO) 指明主键生成策略为AUTO
* @Id 表明实体类的主键
*/
@GeneratedValue(strategy=GenerationType.AUTO)
@Id
public Integer getId() {
return id;
} /**
* @Column 指明lastName属性映射到表的 LAST_NAME 列中
* 同时还可以指定其长度、能否为null等数据限定条件
*/
@Column(name="LAST_NAME", length=50, nullable=false)
public String getLastName() {
return lastName;
} public String getEmail() {
return email;
} public int getAge() {
return age;
} public void setId(Integer id) {
this.id = id;
} public void setLastName(String lastName) {
this.lastName = lastName;
} public void setEmail(String email) {
this.email = email;
} public void setAge(int age) {
this.age = age;
} }
四、修改配置文件persistence.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属性值,main函数中会用到它 -->
<persistence-unit name="jpa-1" transaction-type="RESOURCE_LOCAL"> <!-- 配置使用什么样的ORM产品作为JPA的实现
1、实际上配置的是 javax.persistence.spi.PersistenceProvider 接口的实现类
2、若JPA项目中只有一个JPA的实现产品,则可以不配置provider节点
-->
<provider>org.hibernate.jpa.HibernatePersistenceProvider</provider> <!-- 添加持久化类 -->
<class>com.magicode.jpa.helloworld.Customer</class> <properties>
<!-- 连接数据库的基本信息 -->
<property name="javax.persistence.jdbc.driver" value="com.mysql.jdbc.Driver" />
<property name="javax.persistence.jdbc.url" value="jdbc:mysql:///jpa" />
<property name="javax.persistence.jdbc.user" value="root" />
<property name="javax.persistence.jdbc.password" value="tiger123" /> <!-- 配置JPA实现产品的基本属性:配置Hibernate的基本属性 -->
<property name="hibernate.format_sql" value="true" />
<property name="hibernate.show_sql" value="true" />
<property name="hibernate.hbm2ddl.auto" value="update" /> </properties> </persistence-unit>
</persistence>
五、编写测试主函数Main.java。一共分为7个步骤进行:
package com.magicode.jpa.helloworld; import javax.persistence.EntityManager;
import javax.persistence.EntityManagerFactory;
import javax.persistence.EntityTransaction;
import javax.persistence.Persistence; public class Main { public static void main(String[] args) { /*
* 1、获取EntityManagerFactory实例
* 利用Persistence类的静态方法,结合persistence.xml中
* persistence-unit标签的name属性值得到
*/
EntityManagerFactory emf =
Persistence.createEntityManagerFactory("jpa-1"); // 2、获取EntityManager实例
EntityManager em = emf.createEntityManager(); // 3、开启事物
EntityTransaction transaction = em.getTransaction();
transaction.begin(); // 4、调用EntityManager的persist方法完成持久化过程
Customer customer = new Customer();
customer.setAge(9);
customer.setEmail("Tom@163.com");
customer.setLastName("Tom");
em.persist(customer); // 5、提交事物
transaction.commit();
// 6、关闭EntityManager
em.close();
// 7、关闭EntityManagerFactory
emf.close(); } }
可以看出:EntityManagerFactory 的功能类似于 Hibernate 中的 SessionFactory; EntityManager 的功能类似于 Hibernate 中的Session。
六、运行结果
运行mian方法,JPA就会自动的连接到数据库jpa中,同时创建一个t_customer数据表。有一个需要注意的地方:需要手动创建一个数据库jpa。JPA会自动帮我们创建数据表,但是它不会自动创建数据库。
main方法运行以后创建的数据表t_customer,并把一个Customer对象进行了持久化: