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.Finallib equired 文件夹下的所有jar包

　　②、hibernate-release-4.3.10.Finallibjpa 文件夹下的所有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对象进行了持久化：