如何认识 JPA(详细篇)1

JPA 概述

1.JPA 是什么

Java Persistence API：用于对象持久化的 API

Java EE 5.0 平台标准的 ORM 规范，使得应用程序以统一的方式访问持久层

2.JPA 和 Hibernate 的关系

• JPA 是 hibernate 的一个抽象（就像 JDBC 和 JDBC 驱动的关系）：
  - JPA 是规范： JPA 本质上就是一种 ORM 规范，不是 ORM 框架 —— 因为 JPA 并未提供 ORM 实现，它只是制订了一些规范，提供了一些编程的 API 接口，但具体实现则由 ORM 厂商提供实现
  - Hibernate 是实现： Hibernate 除了作为 ORM 框架之外，它也是一种 JPA 实现
• 从功能上来说， JPA 是 Hibernate 功能的一个子集

3.JPA 包括 3 方面的技术

• ORM 映射元数据 ：JPA 支持 XML 和 JDK 5.0 注解两种元数据的形式，元数据描述对象和表之间的映射关系，框架据此将实体对象持久化到数据库表中。

• JPA 的 API：用来操作实体对象，执行 CRUD 操作，框架在后台完成所有的事情，开发者从繁琐的 JDBC 和 SQL 代码中解脱出来。

• 查询语言（JPQL）：这是持久化操作中很重要的一个方面，通过面向对象而非面向数据库的查询语言查询数据，避免程序和具体的 SQL 紧密耦合。

案例 HelloWorld

1.使用 JPA 持久化对象的步骤

创建 JPA 测试项目

创建之后，在 src 下创建 META-INF 文件夹
创建 Persistence.xml 在这个文件中配置持久化单元
    - 需要指定跟哪个数据库进行交互;
    - 需要指定 JPA 使用哪个持久化的框架以及配置该框架的基本属性

如果在 eclipse 下创建 JPA 工程

2.开发 JPA 依赖的 jar 文件

• hibernate-release-4.2.4.Final\lib\required*.jar
• hibernate-release-4.2.4.Final\lib\jpa*.jar
• 数据库驱动的 jar 包

提供jar下载：链接：https://pan.baidu.com/s/1kvzo77Zmt18dHV8_XAbjuw 密码：329p

3.persistence.xml

JPA 规范要求在类路径的 META-INF 目录下放置 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">
			 //name 属性用于定义特久单元的名称，必选
			 //transaction-type:指定 JPA 的事务处理策略
			 //RESOURCE_LOCAL：默认值，数据库级别的事务，只能针对一种数据，不支持分布式事务。如果需要支持分布式事务，使用JTA:transaction-type="JTA"
			 
    <persistence-unit name="jpa-1" transaction-type="RESOURCE_LOCAL">
        <!--
         配置使用ORM 产品来作为JPA的实现
         1,实际上配置式 javax.persistence.spi.PersistenceProvider 接口的实现类
         2,若JPA项目中只有一个JPA的实现产品，则也可以不配置该节点。
         -->
        <provider>org.hibernate.ejb.HibernatePersistence</provider>

        <!-- 添加持久化类（实体类） -->
        <class>com.test.jap.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="root"/>

            <!-- 配置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>

4.执行持久化操作

在 src 目录下创建 com.test.jap.helloworld 包
接下来 创建 Main 类

public class Main {
    public static void main(String[] args) {
        //1,创建EntitymanagerFactory
            String persistenceUnitName="jpa-1";
        EntityManagerFactory entityManagerFactory =
                Persistence.createEntityManagerFactory(persistenceUnitName);
        //2,创建EntityManager
        EntityManager entityManager = entityManagerFactory.createEntityManager();
        //3,开启事务
        EntityTransaction transaction = entityManager.getTransaction();
        transaction.begin();
        //4,进行持久化操作
        Customer customer = new Customer();
        customer.setAge(22);
        customer.setEmail("tom@test.com");
        customer.setLastName("tom");
        customer.setBirth(new Date());
        customer.setCreatedTime(new Date());

        entityManager.persist(customer);
        //5，提交事务
        transaction.commit();

        //6，关闭EntityManager
        entityManager.clear();

        //7关闭EntityManagerFactory
        entityManagerFactory.close();
    }
}

com.test.jap.helloworld 目录下创建 Customer 类（实体类）
我们用注解方式创建

@Table(name = "JAP_CUSTOMERS")//设置数据表名
@Entity //实体类
public class Customer {

    private Integer id;
    private String lastName;

    private String email;
    private int age;

    private Date createdTime;
    private Date birth;


    @GeneratedValue(strategy = GenerationType.AUTO)//自动生成递增
    @Id//主键
    public Integer getId() {
        return id;
    }


    public void setId(Integer id) {
        this.id = id;
    }

    @Column(name = "LAST_NAME",length = 50,nullable = false)//重命名,字段设置50,不能为空
    public String getLastName() {
        return lastName;
    }

    public void setLastName(String lastName) {
        this.lastName = lastName;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }

    @Temporal(TemporalType.TIMESTAMP)//时间日期
    public Date getCreatedTime() {
        return createdTime;
    }

    public void setCreatedTime(Date createdTime) {
        this.createdTime = createdTime;
    }

    @Temporal(TemporalType.DATE)//日期
    public Date getBirth() {
        return birth;
    }

    public void setBirth(Date birth) {
        this.birth = birth;
    }

    //工具方法.不需要映射为数据表的一列
    @Transient
    public String getInfo(){
        return "lastName: "+ lastName + ",email: " + email;
    }
}

创建数据库

运行 Main 类

运行结果：

查看数据库：


回顾一下 Customer 类注解

JPA 基本注解

@Entity @Transient @Temporal @Table
用table来生成注解详解
@Id @GeneratedValue @Column @Basic

@Entity

@Entity 标注用于实体类声明语句之前，指出该 Java 类为实体类，将映射到指定的数据库表。如声明一个实体类 Customer，它将映射到数据库中的 customer 表上。

效果图：

@Table

• 当实体类与其映射的数据库表名不同名时 需要使用 @Table 标注说明，该标注 与 @Entity 标注并列使用，置于实体类声明语句之前，可写于单独语句行，也可与声明语句同行。
• @Table 标注的常用选项是 name，用于指明数据库的表名
• @Table 标注还有一个两个选项 catalog 和 schema 用于设置表所属的数据库目录或模式，通常为数据库名。uniqueConstraints 选项用于设置约束条件，通常不须设置。

效果图：

@Id

• @Id 标注用于声明一个实体类的属性映射为数据库的主键列。该属性通常置于属性声明语句之前，可与声明语句同行，也可写在单独行上。
• @Id 标注也可置于属性的 getter 方法之前。

效果图

@GeneratedValue

• @GeneratedValue 用于标注主键的生成策略，通过 strategy 属性指定。默认情况下，JPA 自动选择一个最适合底层数据库的主键生成策略：SqlServer 对应 identity，MySQL 对应 auto increment。
• 在 javax.persistence.GenerationType 中定义了以下几种可供选择的策略：

IDENTITY：采用数据库 ID 自增长的方式来自增主键字段，Oracle 不支持这种方式；
AUTO： JPA 自动选择合适的策略，是默认选项；
SEQUENCE：通过序列产生主键，通过 @SequenceGenerator 注解指定序列名，MySql 不支持这种方式
TABLE：通过表产生主键，框架借由表模拟序列产生主键，使用该策略可以使应用更易于数据库移植

效果图

@Basic

• @Basic 表示一个简单的属性到数据库表的字段的映射,对于没有任何标注的 getXxxx() 方法,默认即为 @Basic
• fetch: 表示该属性的读取策略,有 EAGER 和 LAZY 两种,分别表示主支抓取和延迟加载,默认为 EAGER.
• optional:表示该属性是否允许为 null, 默认为 true

@Column

• 当实体的属性与其映射的数据库表的列不同名时需要使用 @Column 标注说明，该属性通常置于实体的属性声明语句之前，还可与 @Id 标注一起使用。
• @Column 标注的常用属性是 name，用于设置映射数据库表的列名。此外，该标注还包含其它多个属性，如：unique 、nullable、length 等。
• @Column 标注的 columnDefinition 属性: 表示该字段在数据库中的实际类型.通常 ORM 框架可以根据属性类型自动判断数据库中字段的类型,但是对于 Date 类型仍无法确定数据库中字段类型究竟是 DATE,TIME 还是 TIMESTAMP.此外,String 的默认映射类型为 VARCHAR, 如果要将 String 类型映射到特定数据库的 BLOB 或 TEXT 字段类型.
• @Column 标注也可置于属性的 getter 方法之前
  
  

@Transient

表示该属性并非一个到数据库表的字段的映射,ORM 框架将忽略该属性.
如果一个属性并非数据库表的字段映射,就务必将其标示为 @Transient,否则,ORM 框架默认其注解为 @Basic

@Temporal

在核心的 Java API 中并没有定义 Date 类型的精度(temporal precision). 而在数据库中,表示 Date 类型的数据有 DATE, TIME, 和 TIMESTAMP 三种精度(即单纯的日期,时间,或者两者 兼备). 在进行属性映射时可使用 @Temporal 注解来调整精度.

显示日期

显示日期时间

用 table 来生成主键详解

创建数据表

在数据表中添加值

Customer.java

添加完之后运行 main

查看数据库


在运行一次

ID 值变 200

原因在这里每次长 100 个