天天看點

Jpa使用詳解

目錄

  • ORM思想
    • 1.ORM概述
    • 2.為什麼要使用ORM
    • 3.常見的ORM架構
  • JPA簡介
    • 1.JPA概述
    • 2.JPA的優勢
    • 3.JPA與hibernate的關系
  • JPA入門案例
    • 1.搭建開發環境
      • 常用注解說明
  • JPA主鍵生成政策
  • JPA的API介紹
    • 1.Persistence對象
    • 2.EntityManagerFactory
    • 3.EntityManager
    • 4.EntityTransaction

ORM思想

1.ORM概述

ORM(Object-Relational Mapping) 表示對象關系映射。在面向對象的軟體開發中,通過ORM,就可以把對象映射到關系型資料庫中。隻要有一套程式能夠做到建立對象與資料庫的關聯,操作對象就可以直接操作資料庫資料,就可以說這套程式實作了ORM對象關系映射

簡單的說:ORM就是建立實體類和資料庫表之間的關系,進而達到操作實體類就相當于操作資料庫表的目的。

2.為什麼要使用ORM

當實作一個應用程式時(不使用O/R Mapping),我們可能會寫特别多資料通路層的代碼,從資料庫儲存資料、修改資料、删除資料,而這些代碼都是重複的。而使用ORM則會大大減少重複性代碼。對象關系映射(Object Relational Mapping,簡稱ORM),主要實作程式對象到關系資料庫資料的映射。

3.常見的ORM架構

當實作一個應用程式時(不使用O/R Mapping),我們可能會寫特别多資料通路層的代碼,從資料庫儲存資料、修改資料、删除資料,而這些代碼都是重複的。而使用ORM則會大大減少重複性代碼。對象關系映射(Object Relational Mapping,簡稱ORM),主要實作程式對象到關系資料庫資料的映射。

JPA簡介

1.JPA概述

JPA的全稱是Java Persistence API, 即Java 持久化API,是SUN公司推出的一套基于ORM的規範,内部是由一系列的接口和抽象類構成。JPA通過JDK 5.0注解描述對象-關系表的映射關系,并将運作期的實體對象持久化到資料庫中。

2.JPA的優勢

1. 标準化

JPA 是 JCP 組織釋出的 Java EE 标準之一,是以任何聲稱符合 JPA 标準的架構都遵循同樣的架構,提供相同的通路API,這保證了基于JPA開發的企業應用能夠經過少量的修改就能夠在不同的JPA架構下運作。

2. 容器級特性的支援

JPA架構中支援大資料集、事務、并發等容器級事務,這使得 JPA 超越了簡單持久化架構的局限,在企業應用發揮更大的作用。

3. 簡單友善

JPA的主要目标之一就是提供更加簡單的程式設計模型:在JPA架構下建立實體和建立Java 類一樣簡單,沒有任何的限制和限制,隻需要使用 javax.persistence.Entity進行注釋,JPA的架構和接口也都非常簡單,沒有太多特别的規則和設計模式的要求,開發者可以很容易的掌握。JPA基于非侵入式原則設計,是以可以很容易的和其它架構或者容器內建

4. 查詢能力

JPA的查詢語言是面向對象而非面向資料庫的,它以面向對象的自然文法構造查詢語句,可以看成是Hibernate HQL的等價物。JPA定義了獨特的JPQL(Java Persistence Query Language),JPQL是EJB QL的一種擴充,它是針對實體的一種查詢語言,操作對象是實體,而不是關系資料庫的表,而且能夠支援批量更新和修改、JOIN、GROUP BY、HAVING 等通常隻有 SQL 才能夠提供的進階查詢特性,甚至還能夠支援子查詢。

5. 進階特性

JPA 中能夠支援面向對象的進階特性,如類之間的繼承、多态和類之間的複雜關系,這樣的支援能夠讓開發者最大限度的使用面向對象的模型設計企業應用,而不需要自行處理這些特性在關系資料庫的持久化。

3.JPA與hibernate的關系

JPA規範本質上就是一種ORM規範,注意不是ORM架構——因為JPA并未提供ORM實作,它隻是制訂了一些規範,提供了一些程式設計的API接口,但具體實作則由服務廠商來提供實作。

JPA和Hibernate的關系就像JDBC和JDBC驅動的關系,JPA是規範,Hibernate除了作為ORM架構之外,它也是一種JPA實作。JPA怎麼取代Hibernate呢?JDBC規範可以驅動底層資料庫嗎?答案是否定的,也就是說,如果使用JPA規範進行資料庫操作,底層需要hibernate作為其實作類完成資料持久化工作。

Jpa使用詳解

JPA入門案例

1.搭建開發環境

第一步:建立一個maven工程

Jpa使用詳解

第二步:引入jar包

<properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.hibernate.version>5.0.7.Final</project.hibernate.version>
    </properties>

<dependencies>
    <!-- junit -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
        <scope>test</scope>
    </dependency>

    <!-- hibernate對jpa的支援包 -->
    <dependency>
        <groupId>org.hibernate</groupId>
        <artifactId>hibernate-entitymanager</artifactId>
        <version>${project.hibernate.version}</version>
    </dependency>

    <!-- c3p0 -->
    <dependency>
        <groupId>org.hibernate</groupId>
        <artifactId>hibernate-c3p0</artifactId>
        <version>${project.hibernate.version}</version>
    </dependency>

    <!-- log日志 -->
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
    </dependency>

    <!-- Mysql and MariaDB -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.6</version>
    </dependency>
</dependencies>
           

第三步:建立資料庫表

/*建立客戶表*/
    CREATE TABLE cst_customer (
      cust_id bigint(32) NOT NULL AUTO_INCREMENT COMMENT \'客戶編号(主鍵)\',
      cust_name varchar(32) NOT NULL COMMENT \'客戶名稱(公司名稱)\',
      cust_source varchar(32) DEFAULT NULL COMMENT \'客戶資訊來源\',
      cust_industry varchar(32) DEFAULT NULL COMMENT \'客戶所屬行業\',
      cust_level varchar(32) DEFAULT NULL COMMENT \'客戶級别\',
      cust_address varchar(128) DEFAULT NULL COMMENT \'客戶聯系位址\',
      cust_phone varchar(64) DEFAULT NULL COMMENT \'客戶聯系電話\',
      PRIMARY KEY (`cust_id`)
    ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;
           

第四步:建立客戶實體類

public class Customer {

    private Long custId;
    private String custName;
    private String custSource;
    private String custIndustry;
    private String custLevel;
    private String custAddress;
    private String custPhone;

    public Long getCustId() {
        return custId;
    }
    public void setCustId(Long custId) {
        this.custId = custId;
    }
    public String getCustName() {
        return custName;
    }
    public void setCustName(String custName) {
        this.custName = custName;
    }
    public String getCustSource() {
        return custSource;
    }
    public void setCustSource(String custSource) {
        this.custSource = custSource;
    }
    public String getCustIndustry() {
        return custIndustry;
    }
    public void setCustIndustry(String custIndustry) {
        this.custIndustry = custIndustry;
    }
    public String getCustLevel() {
        return custLevel;
    }
    public void setCustLevel(String custLevel) {
        this.custLevel = custLevel;
    }
    public String getCustAddress() {
        return custAddress;
    }
    public void setCustAddress(String custAddress) {
        this.custAddress = custAddress;
    }
    public String getCustPhone() {
        return custPhone;
    }
    public void setCustPhone(String custPhone) {
        this.custPhone = custPhone;
    }

    @Override
    public String toString() {
        return "Customer{" +
                "custId=" + custId +
                ", custName=\'" + custName + \'\\'\' +
                ", custSource=\'" + custSource + \'\\'\' +
                ", custIndustry=\'" + custIndustry + \'\\'\' +
                ", custLevel=\'" + custLevel + \'\\'\' +
                ", custAddress=\'" + custAddress + \'\\'\' +
                ", custPhone=\'" + custPhone + \'\\'\' +
                \'}\';
    }
}
           

第五步:編寫實體類和資料庫表的映射配置[重點]

import javax.persistence.*;

@Entity //聲明實體類
@Table(name="cst_customer") //建立實體類和表的映射關系
public class Customer {

    @Id//聲明目前私有屬性為主鍵
    @GeneratedValue(strategy= GenerationType.IDENTITY) //配置主鍵的生成政策
    @Column(name="cust_id") //指定和表中cust_id字段的映射關系
    private Long custId;

    @Column(name="cust_name") //指定和表中cust_name字段的映射關系
    private String custName;

    @Column(name="cust_source")//指定和表中cust_source字段的映射關系
    private String custSource;

    @Column(name="cust_industry")//指定和表中cust_industry字段的映射關系
    private String custIndustry;

    @Column(name="cust_level")//指定和表中cust_level字段的映射關系
    private String custLevel;

    @Column(name="cust_address")//指定和表中cust_address字段的映射關系
    private String custAddress;

    @Column(name="cust_phone")//指定和表中cust_phone字段的映射關系
    private String custPhone;

    public Long getCustId() {
        return custId;
    }
    public void setCustId(Long custId) {
        this.custId = custId;
    }
    public String getCustName() {
        return custName;
    }
    public void setCustName(String custName) {
        this.custName = custName;
    }
    public String getCustSource() {
        return custSource;
    }
    public void setCustSource(String custSource) {
        this.custSource = custSource;
    }
    public String getCustIndustry() {
        return custIndustry;
    }
    public void setCustIndustry(String custIndustry) {
        this.custIndustry = custIndustry;
    }
    public String getCustLevel() {
        return custLevel;
    }
    public void setCustLevel(String custLevel) {
        this.custLevel = custLevel;
    }
    public String getCustAddress() {
        return custAddress;
    }
    public void setCustAddress(String custAddress) {
        this.custAddress = custAddress;
    }
    public String getCustPhone() {
        return custPhone;
    }
    public void setCustPhone(String custPhone) {
        this.custPhone = custPhone;
    }

    @Override
    public String toString() {
        return "Customer{" +
                "custId=" + custId +
                ", custName=\'" + custName + \'\\'\' +
                ", custSource=\'" + custSource + \'\\'\' +
                ", custIndustry=\'" + custIndustry + \'\\'\' +
                ", custLevel=\'" + custLevel + \'\\'\' +
                ", custAddress=\'" + custAddress + \'\\'\' +
                ", custPhone=\'" + custPhone + \'\\'\' +
                \'}\';
    }
}
           

常用注解說明

@Entity
        	作用:指定目前類是實體類。
        @Table
        	作用:指定實體類和表之間的對應關系。
        	屬性:
        		name:指定資料庫表的名稱
        @Id
        	作用:指定目前字段是主鍵。
        @GeneratedValue
        	作用:指定主鍵的生成方式。。
        	屬性:
        		strategy :指定主鍵生成政策。
        @Column
        	作用:指定實體類屬性和資料庫表之間的對應關系
        	屬性:
        		name:指定資料庫表的列名稱。
        		unique:是否唯一  
        		nullable:是否可以為空  
        		inserttable:是否可以插入  
        		updateable:是否可以更新  
        		columnDefinition: 定義建表時建立此列的DDL  
        		secondaryTable: 從表名。如果此列不建在主表上(預設建在主表),該屬性定義該列所在從表的名字搭建開發環境[重點]
           

第六步:配置JPA的核心配置檔案

在java工程的resources路徑下建立一個名為META-INF的檔案夾,在此檔案夾下建立一個名為persistence.xml的配置檔案

<?xml version="1.0" encoding="UTF-8"?>
<persistence 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"
             version="2.0">

    <!--配置持久化單元
		name:持久化單元名稱
		transaction-type:事務類型
		 	RESOURCE_LOCAL:本地事務管理
		 	JTA:分布式事務管理 -->
    <persistence-unit name="myJpa" transaction-type="RESOURCE_LOCAL">

        <!--配置JPA規範的服務提供商 也就是JPA的具體實作 -->
        <provider>org.hibernate.jpa.HibernatePersistenceProvider</provider>
        <properties>
            <!-- 資料庫驅動 -->
            <property name="javax.persistence.jdbc.driver" value="com.mysql.jdbc.Driver" />
            <!-- 資料庫位址 -->
            <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="123456" />

            <!--jpa提供者的可選配置:我們的JPA規範的提供者為hibernate,是以jpa的核心配置中相容hibernate的配 -->
            <property name="hibernate.show_sql" value="true" />
            <property name="hibernate.format_sql" value="true" />
            <property name="hibernate.hbm2ddl.auto" value="create" />

        </properties>

    </persistence-unit>

</persistence>
           

第七步:編寫單元測試

在test目錄下面建立JpaTest測試類

import cn.wgzblog.entity.Customer;
import org.junit.Test;

import javax.persistence.EntityManager;
import javax.persistence.EntityManagerFactory;
import javax.persistence.EntityTransaction;
import javax.persistence.Persistence;

public class JpaTest {

    @Test
    public void test() {
        /**
         * 建立實體管理類工廠,借助Persistence的靜态方法擷取
         * 		其中傳遞的參數為持久化單元名稱,需要jpa配置檔案中指定
         */
        EntityManagerFactory factory = Persistence.createEntityManagerFactory("myJpa");
        //建立實體管理類
        EntityManager entityManager = factory.createEntityManager();
        //擷取事務對象
        EntityTransaction transaction = entityManager.getTransaction();
        //開啟事務
        transaction.begin();
        //設定實體類
        Customer customer=new Customer();
        customer.setCustAddress("上海陸家嘴");
        customer.setCustName("五公子");
        customer.setCustPhone("18898886666");
        //儲存操作
        entityManager.persist(customer);
        //送出事務
        transaction.commit();
        // 釋放資源
        entityManager.close();
        factory.close();
    }
}
           

輸出結果:

Hibernate: 
    drop table if exists cst_customer
Hibernate: 
    create table cst_customer (
        cust_id bigint not null auto_increment,
        cust_address varchar(255),
        cust_industry varchar(255),
        cust_level varchar(255),
        cust_name varchar(255),
        cust_phone varchar(255),
        cust_source varchar(255),
        primary key (cust_id)
    )
Hibernate: 
    insert 
    into
        cst_customer
        (cust_address, cust_industry, cust_level, cust_name, cust_phone, cust_source) 
    values
        (?, ?, ?, ?, ?, ?)
           

JPA主鍵生成政策

通過annotation(注解)來映射hibernate實體的,基于annotation的hibernate主鍵辨別為@Id, 其生成規則由@GeneratedValue設定的.這裡的@id和@GeneratedValue都是JPA的标準用法。

JPA提供的四種标準用法為TABLE,SEQUENCE,IDENTITY,AUTO。

具體說明如下:

IDENTITY:主鍵由資料庫自動生成(主要是自動增長型)

用法:

@Id  
@GeneratedValue(strategy = GenerationType.IDENTITY) 
private Long custId;
           

SEQUENCE:根據底層資料庫的序列來生成主鍵,條件是資料庫支援序列。

用法:

@Id  
@GeneratedValue(strategy = GenerationType.SEQUENCE,generator="payablemoney_seq")  
@SequenceGenerator(name="payablemoney_seq", sequenceName="seq_payment")  
private Long custId;


//@SequenceGenerator源碼中的定義
@Target({TYPE, METHOD, FIELD})   
@Retention(RUNTIME)  
public @interface SequenceGenerator {  
    //表示該表主鍵生成政策的名稱,它被引用在@GeneratedValue中設定的“generator”值中
    String name();  
    //屬性表示生成政策用到的資料庫序列名稱。
    String sequenceName() default "";  
    //表示主鍵初識值,預設為0
    int initialValue() default 0;  
    //表示每次主鍵值增加的大小,例如設定1,則表示每次插入新記錄後自動加1,預設為50
    int allocationSize() default 50;  
}

           

AUTO*:主鍵由程式控制

用法:

@Id  
@GeneratedValue(strategy = GenerationType.AUTO)  
private Long custId;
           

TABLE:使用一個特定的資料庫表格來儲存主鍵

@Id  
@GeneratedValue(strategy = GenerationType.TABLE, generator="payablemoney_gen")  
@TableGenerator(name = "pk_gen",  
                table="tb_generator",  
                pkColumnName="gen_name",  
                valueColumnName="gen_value",  
                pkColumnValue="PAYABLEMOENY_PK",  
                allocationSize=1  
               ) 
private Long custId;


//@TableGenerator的定義:
@Target({TYPE, METHOD, FIELD})   
@Retention(RUNTIME)  
public @interface TableGenerator {  
    //表示該表主鍵生成政策的名稱,它被引用在@GeneratedValue中設定的“generator”值中
    String name();  
    //表示表生成政策所持久化的表名,例如,這裡表使用的是資料庫中的“tb_generator”。
    String table() default "";  
    //catalog和schema具體指定表所在的目錄名或是資料庫名
    String catalog() default "";  
    String schema() default "";  
    //屬性的值表示在持久化表中,該主鍵生成政策所對應鍵值的名稱。例如在“tb_generator”中将“gen_name”作為主鍵的鍵值
    String pkColumnName() default "";  
    //屬性的值表示在持久化表中,該主鍵目前所生成的值,它的值将會随着每次建立累加。例如,在“tb_generator”中将“gen_value”作為主鍵的值 
    String valueColumnName() default "";  
    //屬性的值表示在持久化表中,該生成政策所對應的主鍵。例如在“tb_generator”表中,将“gen_name”的值為“CUSTOMER_PK”。 
    String pkColumnValue() default "";  
    //表示主鍵初識值,預設為0。 
    int initialValue() default 0;  
    //表示每次主鍵值增加的大小,例如設定成1,則表示每次建立新記錄後自動加1,預設為50。
    int allocationSize() default 50;  
    UniqueConstraint[] uniqueConstraints() default {};  
} 

//這裡應用表tb_generator,定義為 :
CREATE TABLE  tb_generator (  
    id NUMBER NOT NULL,  
    gen_name VARCHAR2(255) NOT NULL,  
    gen_value NUMBER NOT NULL,  
    PRIMARY KEY(id)  
)

           

JPA的API介紹

1.Persistence對象

Persistence對象主要作用是用于擷取EntityManagerFactory對象的 。通過調用該類的createEntityManagerFactory靜态方法,根據配置檔案中持久化單元名稱建立EntityManagerFactory。

//1. 建立 EntitymanagerFactory
String unitName = "myJpa";
EntityManagerFactory factory= Persistence.createEntityManagerFactory(unitName);
           

2.EntityManagerFactory

EntityManagerFactory 接口主要用來建立 EntityManager 執行個體

//建立實體管理類
EntityManager em = factory.createEntityManager();
           

由于EntityManagerFactory 是一個線程安全的對象(即多個線程通路同一個EntityManagerFactory 對象不會有線程安全問題),并且EntityManagerFactory 的建立極其浪費資源,是以在使用JPA程式設計時,我們可以對EntityManagerFactory 的建立進行優化,隻需要做到一個工程隻存在一個EntityManagerFactory 即可

3.EntityManager

在 JPA 規範中, EntityManager是完成持久化操作的核心對象。實體類作為普通 java對象,隻有在調用 EntityManager将其持久化後才會變成持久化對象。EntityManager對象在一組實體類與底層資料源之間進行 O/R 映射的管理。它可以用來管理和更新 Entity Bean, 根椐主鍵查找 Entity Bean, 還可以通過JPQL語句查詢實體。

我們可以通過調用EntityManager的方法完成擷取事務,以及持久化資料庫的操作

方法說明:

getTransaction : 擷取事務對象
persist : 儲存操作
merge : 更新操作
remove : 删除操作
find/getReference : 根據id查詢
           

4.EntityTransaction

在 JPA 規範中, EntityTransaction是完成事務操作的核心對象,對于EntityTransaction在我們的java代碼中承接的功能比較簡單

begin:開啟事務
commit:送出事務
rollback:復原事務