Hibernate 筆記

-

 

Hibernate 筆記

開始之前要有的觀念

Configuration

主要用於啟動、載入和管理 Hibernate的配置文件，創建完 Session 之後聲明週期應該要被拋棄
如果設定檔放在專案的根目錄的話 StandardServiceRegistryBuilder 會自動處理

SessionFactory

用於 Hibernate 的初始化和建立 Session 對象，這個是工廠模式的做法
他是線程安全的，因此可以被多線程使用，但是他是重量級的，因此一般來說一個專案只需要一個 SessionFactory 就好了。
SessionFactory 會做以下幾件事情：

  • 解析設定
  • 建立 connection pool
  • 建立 Mapping
  • 如果有啟用的話會建立Second-Level Cache

session

他會為 Hibernate 提供 DB 的 CRUD 入口，SessionFactory 會提供建立獲取生成 session 的方法。
session 有以下幾個特點：

  • 非線程安全，不可以多線程共用
  • 輕量級，可以多次建立和用完即丟
  • session 有一級緩存

Transaction

交易控制，從 session 的 beginTransaction 取得
有 commit 和 rollback 方法提供 commit 和 rollback

透過 properties 設定

# 連線設定
hibernate.connection.url=jdbc:h2:mem:db1;DB_CLOSE_DELAY=-1
hibernate.connection.username=sa
hibernate.connection.password=

# 印到 console 的設定
hibernate.show_sql=true #直接將 SQL 記錄到控制台
hibernate.format_sql=true #以多行、縮排格式記錄 SQL
hibernate.highlight_sql=true #透過 ANSI 轉義碼以語法高亮方式記錄 SQL

# Automatically export the schema
hibernate.hbm2ddl.auto=create

建立entity

/*
 * SPDX-License-Identifier: Apache-2.0
 * Copyright Red Hat Inc. and Hibernate Authors
 */
package org.hibernate.tutorial.annotations;

import java.time.LocalDateTime;
import jakarta.persistence.Column;
import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.Id;
import jakarta.persistence.Table;

@Entity //用於宣告說這個 POJO 是 entity
@Table(name = "Events") //宣告是使用於哪個 table，如果沒有寫的話就會是 class name 當作對應的 table
public class Event {

    @Id //將該欄位標記為儲存實體的識別碼（主鍵）
    @GeneratedValue //指定這是一個自動生成的 id，下方有詳細說明
    private Long id;

    private String title;

    @Column(name = "eventDate") //明確指定映射列的名稱。如果沒有此註解會使用變數名稱
    private LocalDateTime date;

    public Event() {
        // this form used by Hibernate
    }

    public Event(String title, LocalDateTime date) {
        // for application use, to create new events
        this.title = title;
        this.date = date;
    }

    public Long getId() {
        return id;
    }

    private void setId(Long id) {
        this.id = id;
    }

    public LocalDateTime getDate() {
        return date;
    }

    public void setDate(LocalDateTime date) {
        this.date = date;
    }

    public String getTitle() {
        return title;
    }

    public void setTitle(String title) {
        this.title = title;
    }
}

@GeneratedValue 說明
可以使用 @GeneratedValue(strategy = GenerationType.AUTO) 來設定，其中 GenerationType 是 enum，可以用來選擇不同生成的策略

  • AUTO: 這是預設值，會根據 DB 判斷最適合的策略
  • TABLE: 使用一個特定的 table 來保存主鍵，根據官方資料，此做法效能不好，如果用這個的話需要使用 generator 指定 table
  • SEQUENCE: 根據DB 的序列生成主鍵，前提是 DB 要支援
  • IDENTITY: 由 DB 生成，通常用於自動增長
  • UUID: 生成 UUID 會比較佔空間一點，但好處是與資料庫無關

建立連線

// SessionFactory 在一個應用程式中只會被設定一次！
// setUp() 方法首先會建立一個 StandardServiceRegistry 實例，
// 該實例將設定資訊（來自 hibernate.properties）整合到一組可供 SessionFactory 使用的服務中。
final StandardServiceRegistry registry =
        new StandardServiceRegistryBuilder()
                .build();
try {
    sessionFactory =
            // 1. 使用 StandardServiceRegistry 建立 MetadataSources，
            //    它讓我們可以告訴 Hibernate 我們的領域模型（Domain Model）。
            new MetadataSources(registry) 
                    // 2. 告知 Hibernate 我們要映射的實體類別是 Event.class。
                    .addAnnotatedClass(Event.class) 
                    // 3. 建立 Metadata 物件，它代表了應用程式領域模型的完整、經過部分驗證的視圖。
                    .buildMetadata() 
                    // 4. 最後，建立 SessionFactory。
                    //    SessionFactory 是執行緒安全的，通常在應用程式中只會有一個。
                    .buildSessionFactory(); 
}
catch (Exception e) {
    // 如果建立 SessionFactory 失敗，registry 物件不會被 SessionFactory 銷毀，
    // 所以我們需要手動銷毀它，以釋放資源。
    StandardServiceRegistryBuilder.destroy(registry);
}

透過 Hibernate 提供的方法做 CRUD

public void testBasicUsage() {
    // 做 insert
    sessionFactory.inTransaction(session -> {
        session.persist(new Event("Our very first event!", now()));
        session.persist(new Event("A follow up event", now())); //session.persist 用於 insert
    });

    // 做 update 
    sessionFactory.inTransaction(session -> {
        // 在事務中，Hibernate 會自動偵測到受控物件的變更並將其更新到資料庫。
        // 首先，我們需要載入實體。
        Event eventToUpdate = session.createSelectionQuery("from Event where title = :title", Event.class)
                .setParameter("title", "Our very first event!")
                .getSingleResult();
        // 然後，直接修改物件。
        eventToUpdate.setTitle("Our very first event! (updated)");
    });

    //做安全 delete
    sessionFactory.inTransaction(session -> {
        // 要刪除一個物件，您需要先載入它，然後將它傳遞給 remove() 方法。
        Event eventToDelete = session.createSelectionQuery("from Event where title = :title", Event.class)
                .setParameter("title", "A follow up event")
                .getSingleResult();
        session.remove(eventToDelete);
    });

    //直接 delete
    sessionFactory.inTransaction(session -> {
    int deletedEntities = session.createMutationQuery("delete from Event where title = :title", Event.class)
            .setParameter("title", "A follow up event")
            .executeUpdate();
    out.println("Entities deleted: " + deletedEntities);
    });

    //做 query
    sessionFactory.inTransaction(session -> {
        session.createSelectionQuery("from Event", Event.class).getResultList()
                .forEach(event -> out.println("Event (" + event.getDate() + ") : " + event.getTitle()));
    });
    
    //帶搜尋條件的搜尋，用問號
    sessionFactory.inSession(session -> {
        var hql = "from Event where title = ? and id = ?";
        var query = session.createQuery(hql, Event.class);
        query.setParameter(0, "A follow up event");
        query.setParameter(1, 2L);
        var result = query.getResultList();
        out.println(result);
    });

    //帶搜尋條件的搜尋，用變數
    sessionFactory.inSession(session -> {
        var hql = "from Event where title = :title"; //設定 hql，
        var query = session.createQuery(hql, Event.class); //透過 session createQuery
        query.setParameter("title", "A follow up event"); //
        var result = query.getResultList();
        out.println(result);
    });
    
    //聚合函數
    sessionFactory.inSession(session -> {
        var hql = "select count(id) from Event";
        var query = session.createQuery(hql, Long.class);
        out.println(query.getSingleResult());
    });
    
    //分組
    sessionFactory.inSession(session -> {
        var hql = "select e.title, count(e.id) from Event e group by e.title";
        var query = session.createQuery(hql, Object[].class);
        out.println(query.getResultList());
    });
}

HQL 語句

HQL 語句說明
count同 SQL
sum同 SQL
avg同 SQL
max同 SQL
min同 SQL

留言

張貼留言

這個網誌中的熱門文章

基本 Spring security 快速入門

-
圖片
基本 Spring security 快速入門 最近學了 spring security 遇到一些 6 版和舊版的一些差異，所以想說寫一下快速入門，但有些前情提要: 這個入門不包含 spring security 的使用概念，關於這部分相當推薦閱讀 spring security 實戰這本書 本快速入門不包含 OAuth2 和權限控管，只會使用 Basic 驗證，但建議先學會入門之後再加深． 由於個人專案有使用到 swagge ，因此也會有相對的教學 主要使用到的 spring security 元件： org.springframework.security.authentication.AuthenticationProvider org.springframework.security.crypto.password.PasswordEncoder org.springframework.security.core.userdetails.UserDetailsService org.springframework.security.core.userdetails.UserDetails 撰寫 UserDetailsService 首先先在 service 新增 class 並且 implements UserDetailsService 實作的時候會發現需要實作: UserDetails loadUserByUsername ( String username ) throws UsernameNotFoundException ; 依照 function name 可以知道要實現的功能是去 DB 或 redis 之類的地方取得使用者資訊，並且將資料放進 UserDetails 後 return 出去，因此在開始寫 loadUserByUsername 方法之前需要先實作 UserDetails 實作 UserDetails 實作的時候會發現我們需要實作 getAuthorities getPassword getUsername isAccountNonExpired isAccountNonLocked isCredentialsNonExpired isEnabled 基本上依照 functio...
閱讀完整內容

記帳專案說明

-
圖片
新專案說明 最近開新的專案，目前專案的系統架構和後端處理的差不多了，剩下前端的部分正在一邊學 react 一邊完成中，考慮到最近要開始找工作了，所以想說寫個部落格一邊介紹目前專案的架構與紀錄目前的狀態。 專案整體架構 在開始之前我們先發一張架構圖吧，接下來請把架構圖當成地圖開始冒險吧。 這次的專案主要是走雲原生的概念，下述我們分成基礎設施、前端、後端來聊吧 基礎建置 雲端服務廠商選擇: AWS 這個專案從剛開始設計就是預計上雲且使用的是 aws，主要有兩個點 我們家並沒有固定 IP ，如果要走地端的話勢必要使用到 DDNS ，那牽涉的範圍就會更廣了，因此決定直接上雲 根據網路上查到的資料，目前 aws 市佔 33% ，考慮到將來要找工作與方便尋找資料因此決定直接使用 aws 用到的 AWS 服務 接下來先概覽一下用到的服務與相關功能，下面會以使用者接觸到服務的順序來說明： 服務名稱 用途 router53 DNS, 用於將 domain 轉換成 IP, 我的 domain 也是在該服務購買的 彈性 IP 當我們租了 AWS 的伺服器時是沒有對外 IP 的，因此我們需要透過彈性 IP 申請並且綁定到我們的 EC2 安全群組 連到伺服器的防火牆，可以設定每個 port 是否要開啟，並且設定白名單等 EC2 這個就是我租伺服器的本體，所有的服務與反向代理等都是放在這裡 EC2 建置了哪些服務 這邊會講一下我安裝與使用到哪些非我開發的服務 資料庫： 資料庫的部分我使用的是 mariaDB, 會選擇 mariaDB 的原因除了他是 MySQL 的分支之外，他的社群很活躍、穩定性也很高 catch: catch 的部分我使用 redis ，主要適用於處理會需要經常取得資料或者不需要持久化的資料，目前我主要用於記錄使用者登入後的 token，由於採取的是前後端分離的架構，後端會需要頻繁的驗證 token 和透過 token 取得用者資訊，因此這部分得資料就放在 redis，更詳細的使用邏輯將會在後面提到後端的時候說明。 SSL: 這個專案的 SSL 主要用於 https 連線，這部分是使用 Let's Encrypt 家的憑證。 會用 Let's Encrypt 的原因最主要是免費和自動化申請，如果考慮到...
閱讀完整內容

JMSTemplate 的教學

-
前言（一堆廢話） 嘿，大家好久不見！我發現距離上次在 Blogger 發文，竟然已經過了快半年了。想想還真有點不好意思，不過這次我可是帶著新東西來跟大家分享的！ 這次要聊的是 Java JMSTemplate。為什麼突然要學這個呢？主要是因為我最近換了新公司，而他們那邊剛好需要用到 訊息佇列 (Message Queue) 的技術，所以我就趁這個機會好好學了一下。 (老實說，我其實都工作六年了，這東西早就該會了啦！) Message Queue 是什麼和目的 這部分我覺得我讀的書的寫的很棒，因此想說直接引用過來。 假設現在是星期五 16:55 ，在幾分鐘就可以開始期待已久的休假了。再過幾分鐘你的飛機就要起飛了，但是在這幾分鐘你需要先確定主管和同事了解你的工作進度，這樣他們才有機會於下週一接續你的工作。這時候該怎麼辦？ 這時候避免打擾到他們最好的做法就是留紙條或發送 E-mail ，如此一來他們就可以在下週一或有空的時候看到 E-mail 接續工作。 這段很完美的解釋了 Message Queue，的概念，將訊息傳到佇列，之後根據佇列的先進先出讓服務吸收消化，最後調整服務一次接收多少 Message 。 如此一來可以帶來以下幾個好處： 解耦合： 發送者可以完全不管接收者狀態與是否可以承受，只需要將訊息丟到 Queue 就好了 系統不同的區塊可以獨立開發（其實就跟現今流行的微服務類似概念） 非同步處理：發送者可以完全不需要等待另一方處理就可以繼續處理下一個 request。這樣講有點抽象，可以想像麥當勞點餐系統，櫃檯的人員不需要完全確認廚房是否收到單就可以接下一個客人了。 提高可靠性：很多提供 Message Queue 的元件會提供持久化的功能，他會將 message 存起來，這樣一來就算遇到某個 Message 處理有問題，也可以很快查到並且做後續 support。 水平擴展：我們可以很輕易地增加消費 Message 的處理人員，這樣就可以提高 Queue 的消化速度，已應付高流量又要快速處理的需求。 等等 上述只有放我自己認為很重要的優點，但其實還有很多的優點。 名詞 那優點介紹完之後我們來聊一下在 Message Queue 常會用到的名詞， 佇列(Queue)：就像是排隊一樣，先進先出。 生產者(Producer)：就是指生成 Message 的服務 消費者(...
閱讀完整內容