Hibernate / JPA 與 MySQL 資料庫

本章打通「Java 物件」與「資料庫資料」之間的橋樑： 理解 ORM 的概念、設定資料庫連線、定義 Entity 與 Repository， 並學會觀察 Hibernate 在背後產生的 SQL。

ORM、JPA、Hibernate、Spring Data JPA 的關係

寫過 JDBC 的人都知道痛苦所在：手寫 SQL 字串、手動把 一欄一欄搬進物件、自己管理連線與交易。 ORM（Object-Relational Mapping，物件關聯對映）就是把這些苦工自動化：

三個常被混用的名詞，其實是三個層次：

準備資料庫

如果採用第 1 章「方式 C」的 Docker 指令，容器啟動時就自動建立了 資料庫，本節可以跳過。

若是自行安裝的 MySQL，可以手動建立資料庫：

-- 登入 MySQL 後執行：
-- utf8mb4 是 MySQL 的完整 UTF-8 實作（支援表情符號等 4-byte 字元）
CREATE DATABASE bookstore_db
  CHARACTER SET utf8mb4
  COLLATE utf8mb4_unicode_ci;

-- 確認建立成功
SHOW DATABASES;

資料庫連線設定：application.yml

Spring Boot 的主設定檔位於 。 先看完整內容，重點在 （連線資訊）與 （Hibernate 行為）兩段：

JDBC 連線字串解析

ddl-auto：Hibernate 如何管理資料表結構

Entity 對映：Book

Entity 是 ORM 的核心——一個標註了 JPA 註解的 Java 類別， 描述「物件如何對映到資料表」。先看本專案的主角 ：

常用 JPA 註解整理：

啟動程式後，Hibernate（）會自動產生對應的資料表：

create table books (
    id bigint not null auto_increment,
    title varchar(200) not null,
    author varchar(100) not null,
    isbn varchar(20) not null,
    price decimal(10,2) not null,
    stock integer not null,
    description TEXT,
    created_at datetime(6) not null,
    updated_at datetime(6),
    primary key (id),
    constraint uk_books_isbn unique (isbn)
) engine=InnoDB;

Entity 對映：User 與 Role

使用者資料同樣用 Entity 描述。注意兩個教學重點： 資料表刻意取名 （ 是 MySQL 保留字）， 以及角色 enum 用 儲存。

Repository：宣告介面就完成資料存取層

Spring Data JPA 最神奇的地方：只要宣告介面、繼承 ， 啟動時就會自動產生實作，完全不用寫 SQL 或實作類別。

衍生查詢：用方法名稱寫查詢

Spring Data JPA 會解析方法名稱、自動產生查詢，常用關鍵字：

方法名稱寫不出來的複雜查詢，就用 自己寫 JPQL （如 ）。 JPQL 長得像 SQL，但操作對象是 Entity 與屬性（、）， 不是資料表與欄位，由 Hibernate 負責翻譯成真正的 SQL。

眼見為憑：觀察 Hibernate 的 SQL

設定檔開啟了 與參數綁定日誌， 呼叫 API 時主控台會即時印出 Hibernate 產生的 SQL，例如查詢單本書籍：

Hibernate:
    select
        b1_0.id, b1_0.author, b1_0.created_at, b1_0.description,
        b1_0.isbn, b1_0.price, b1_0.stock, b1_0.title, b1_0.updated_at
    from
        books b1_0
    where
        b1_0.id=?
-- 綁定參數日誌：binding parameter [1] as [BIGINT] - [1]

交易管理：@Transactional

在 Spring 中只要在 Service 方法標上 ：

• 方法開始時開啟交易，正常結束時 commit。

• 方法拋出 時自動 rollback。

• 查詢類方法標 ， 告訴 Hibernate 與資料庫「這是唯讀操作」，可以做效能最佳化。

實際用法會在下一章的 中看到。