Spring Boot入門系列（二十六）超級簡單！Spring Data JPA 的使用！

之前介紹了Mybatis資料庫ORM框架，也介紹了使用Spring Boot 的jdbcTemplate 操作資料庫。其實Spring Boot 還有一個非常實用的資料操作框架：Spring Data JPA。

Spring Data JPA 是Spring Data框架下的一個基於JPA標準操作資料的模組，簡化了操作持久層的程式碼，只需要編寫介面就可以。如果你是第一次使用 Spring Data JPA ，你一定會驚呼這東西簡直就是神器，幾乎不需要寫什麼關於資料庫訪問的程式碼一個基本的 CURD 的功能就出來了。使用非常簡單方便，下面我們就來講述 JPA 使用的基本操作。

JPA 是 Spring Boot 官方推薦的資料庫訪問元件，其充分體現了面向物件程式設計思想，有點像 asp.net 的 EFCore。JPA 也是眾多 ORM 的抽象。

一、Spring Data JPA介紹

JPA （Java Persistence API）， Java持久層 API的簡稱，是JDK 5.0註解或XML描述物件－關係表的對映關係，並將執行期的實體物件持久化到資料庫中，JPA是一個基於O/R對映的標準規範。

JPA的總體思想和現有Hibernate、TopLink、JDO等ORM框架大體一致。主要包括括以下3方面的技術：

ORM對映元資料將實體物件持久化到資料庫表中
API，用來操作實體物件，執行CRUD操作
查詢語言，通過面向物件，而非面向資料庫的查詢語言查詢資料

Spring Data JPA 是 Spring 基於 ORM 框架、JPA 規範的基礎上封裝的一套JPA應用框架，可使開發者用極簡的程式碼即可實現對資料的訪問和操作。它提供了包括增刪改查等在內的常用功能，且易於擴充套件！學習並使用 Spring Data JPA 可以極大提高開發效率。

SpringData：其實Spring Data 就是Spring提供了一個操作資料的框架。而Spring Data JPA只是Spring Data框架下的一個基於JPA標準操作資料的模組。

二、SpringBoot整合SpringData JPA

1、增加JPA的相關依賴

在pom.xml 中，增加如下配置：

<dependency>

    <groupId>org.springframework.boot</groupId>

    <artifactId>spring-boot-starter-data-jpa</artifactId>

</dependency>

<dependency>

    <groupId>mysql</groupId>

    <artifactId>mysql-connector-java</artifactId>

</dependency>

注意，需要新增MySql驅動。

2、修改配置檔案

需要在application.properties 中配置資料來源和jpa的基本的相關屬性，具體如下：

#資料庫連線

spring.datasource.url=jdbc:mysql://localhost:3306/zwz_test?serverTimezone=UTC&useUnicode=true&characterEncoding=utf-8&useSSL=true

spring.datasource.username=root

spring.datasource.password=root

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

#jpa配置

spring.jpa.properties.hibernate.hbm2ddl.auto=create

spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL5InnoDBDialect

#SQL 輸出

spring.jpa.show-sql=true

#format 下 SQL 進輸出

spring.jpa.properties.hibernate.format_sql=true

在上面的引數設定說明下：

　　1、spring.jpa.properties.hibernate.hbm2ddl.auto：配置實體類維護資料庫表結構的具體行為，

update：最常用的屬性，表示當實體類的屬性發生變化時，表結構跟著更新；
create：表示啟動的時候刪除上一次生成的表，並根據實體類重新生成表，這個時候之前表中的資料就會被清空；
create-drop：表示啟動時根據實體類生成表，但是當sessionFactory關閉的時候表會被刪除；
validate：表示啟動時驗證實體類和資料表是否一致；
none：則什麼都不做。

　　2、spring.jpa.show-sql ：表示hibernate在操作的時候在控制檯列印真實的sql語句，方便除錯。

　　3、spring.jpa.properties.hibernate.format_sql：表示格式化輸出的json字串，方便檢視。

　　4、spring.jpa.properties.hibernate.dialect：指定⽣成表名的儲存引擎為 InneoDB

3、資料庫實體類

資料庫實體類是一個 POJO Bean 物件。定義實體類後，在專案啟動時，系統會根據實體類建立對應的資料表，實體類如下：

package com.weiz.pojo;

import javax.persistence.Column;

import javax.persistence.Entity;

import javax.persistence.Id;

import javax.persistence.Table;

/**

 * 使用者實體類

 *

 * @author

 * @since

 */

@Entity

@Table(name = "Users")

public class Users {

    @Id

    private Long id;

    @Column(length = 32)

    private String name;

    @Column(length = 32)

    private String account;

    @Column(length = 64)

    private String pwd;

    public Long getId() {

        return id;

    }

    public void setId(Long id) {

        this.id = id;

    }

    public String getName() {

        return name;

    }

    public void setName(String name) {

        this.name = name;

    }

    public String getAccount() {

        return account;

    }

    public void setAccount(String account) {

        this.account = account;

    }

    public String getPwd() {

        return pwd;

    }

    public void setPwd(String pwd) {

        this.pwd = pwd;

    }

}

程式碼說明：

　　@Entity：必選的註解，宣告這個類對應了一個數據庫表。
　　@Table：可選的註解。聲明瞭資料庫實體對應的表資訊。包括表名稱、索引資訊等。這裡宣告這個實體類對應的表名是 Users。如果沒有指定，則表名和實體的名稱保持一致，跟@Entity 註解配合使用。
　　@Id註解：聲明瞭實體唯一標識對應的屬性，。
　　@Column註解：用來宣告實體屬性的表字段的定義。預設的實體每個屬性都對應了表的一個欄位。欄位的名稱預設和屬性名稱保持一致（並不一定相等）。欄位的型別根據實體屬性型別自動推斷。這裡主要是聲明瞭字元欄位的長度。如果不這麼宣告，則系統會採用 255 作為該欄位的長度。

注意：這些註解是建立基於 POJO 的實體物件，需要注意的是 JPA 與 Mybatis 是有區別的。

4、執行驗證

以上就是整合jpa的全部配置，配置完之後，啟動專案，我們就可以看到日誌中如下的內容：

同時，連上資料庫之後，可以看到Users 表也建立成功了。

三、定義Repository

專案整合 jpa 成功之後，接下來可以定義Repository 資料訪問介面了，只需要繼承 JpaRepository 類，就會幫我們自動生成很多內建方法，如下：

package com.weiz.dao;

import com.weiz.pojo.Users;

import org.springframework.data.jpa.repository.JpaRepository;

import org.springframework.stereotype.Repository;

@Repository

public interface UserRespository extends JpaRepository<Users, Long> {

}

上面的程式碼可以看到，我們基本上一行程式碼也不用寫，就能實現Users 使用者的增刪改查等全部的方法。

四、如何呼叫

上面，我們建立了UserRespository 資料介面，接下來就來呼叫該介面實現簡單的增刪改查。

package com.weiz.controller;

import com.weiz.dao.UserRespository;

import com.weiz.pojo.Users;

import com.weiz.utils.JSONResult;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.RestController;

import java.util.Optional;

@RestController

@RequestMapping("/user")

public class UserController {

    @Autowired

    private UserRespository userRespository;

    @RequestMapping("/save")

    public JSONResult save(){

        Users user = new Users();

        user.setId((long) 1);

        user.setName("spring boot jpa");

        user.setPwd("123456");

        userRespository.save(user);

        return JSONResult.ok("儲存成功");

    }

    @RequestMapping("/update")

    public JSONResult update() {

        Users user = new Users();

        user.setId((long) 1);

        user.setName("spring boot jpa update");

        user.setPwd("123456");

        user.setAccount("sbj");

        userRespository.save(user);

        return JSONResult.ok("修改成功");

    }

    @RequestMapping("/delete")

    public JSONResult delete() {

        Users user = new Users();

        user.setId((long) 1);

        userRespository.delete(user);

        return JSONResult.ok("刪除成功");

    }

    @RequestMapping("/select")

    public JSONResult select() {

        Optional<Users> users = userRespository.findById((long) 1);

        return JSONResult.ok(users);

    }

}

以上的controller 就是簡單的呼叫增刪改查的方法。增加了對應的controller 之後，啟動專案即可測試使用者的增刪改查功能。這裡就不一一截圖了。

最後

以上就實現了spring boot 整合 jpa 操作資料庫，是不是特別簡單，整個過程我們所做的僅僅上面簡單的四步：

1、增加jpa的依賴

2、在配置檔案中裡面增加資料庫配置資訊。

3、宣告一個 Users 的資料庫實體物件。

4、聲明瞭一個持久層的介面，繼承JpaRepository<T, ID> 介面。

這樣，整個使用者管理模組的增加、刪除、修改、查詢功能就實現了，甚至還有排序和分頁的功能。

這就是 JPA 的強大之處。除了這些介面外，使用者還會有其他的一些自定義的查詢需求， JPA 也一樣可以滿足你的需求。

這個系列課程的完整原始碼，也會提供給大家。大家關注我的微信公眾號（架構師精進），回覆：springboot原始碼，獲取這個系列課程的完整原始碼。

Spring Boot入門系列（二十六）超級簡單！Spring Data JPA 的使用！