2、JPA的HelloWorld

这一节写一个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对象进行了持久化：