在 Spring Boot 中使用 HikariCP 連線池

沉默王二發表於2020-06-27

上次幫小王解決了如何在 Spring Boot 中使用 JDBC 連線 MySQL 後，我就一直在等，等他問我第三個問題，比如說如何在 Spring Boot 中使用 HikariCP 連線池。但我等了四天也沒有等到任何音訊，似乎他從我的世界裡消失了，而我卻仍然沉醉在他拍我馬屁的美妙感覺裡。

突然感覺，沒有小王的日子裡，好空虛。怎麼辦呢？想來想去還是寫文章度日吧，積極創作的過程中，也許能夠擺脫對小王的苦苦思念。寫什麼好呢？

想來想去，就寫如何在 Spring Boot 中使用 HikariCP 連線池吧。畢竟實戰專案當中，肯定不能使用 JDBC，連線池是必須的。而 HikariCP 據說非常的快，快到 Spring Boot 2 預設的資料庫連線池也從 Tomcat 切換到了 HikariCP（喜新厭舊的臭毛病能不能改改）。

HikariCP 的 GitHub 地址如下：

https://github.com/brettwooldridge/HikariCP

目前星標 12K，被使用次數更是達到了 43.1K。再來看看它的自我介紹。

牛逼的不能行啊，原來 Hikari 來源於日語，“光”的意思，這意味著快得像光速一樣嗎？講真，看簡介的感覺就好像在和我的女神“湯唯”握手一樣刺激和震撼。

既然 Spring Boot 2 已經預設使用了 HikariCP，那麼使用起來也相當的輕鬆愜意，只需要簡單幾個步驟。

01、初始化 MySQL 資料庫

既然要連線 MySQL，那麼就需要先在電腦上安裝 MySQL 服務（本文暫且跳過），並且建立資料庫和表。

CREATE DATABASE `springbootdemo`;
DROP TABLE IF EXISTS `mysql_datasource`;
CREATE TABLE `mysql_datasource` (
  `id` varchar(64) NOT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

02、使用 Spring Initlallzr 建立 Spring Boot 專案

建立一個 Spring Boot 專案非常簡單，通過 Spring Initlallzr（https://start.spring.io/）就可以了。

勾選 Web、JDBC、MySQL Driver 等三個依賴。

1）Web 表明該專案是一個 Web 專案，便於我們直接通過 URL 來實操。

3）MySQL Driver：連線 MySQL 伺服器的驅動器。

5）JDBC：Spring Boot 2 預設使用了 HikariCP，所以 HikariCP 會預設在 spring-boot-starter-jdbc 中附加依賴，因此不需要主動新增 HikariCP 的依賴。

PS：怎麼證明這一點呢？專案匯入成功後，在 pom.xml 檔案中，按住滑鼠左鍵 + Ctrl 鍵訪問 spring-boot-starter-jdbc 依賴節點，可在 spring-boot-starter-jdbc.pom 檔案中檢視到 HikariCP 的依賴資訊。

選項選擇完後，就可以點選【Generate】按鈕生成一個初始化的 Spring Boot 專案了。生成的是一個壓縮包，匯入到 IDE 的時候需要先解壓。

03、編輯 application.properties 檔案

專案匯入成功後，等待 Maven 下載依賴，完成後編輯 application.properties 檔案，配置 MySQL 資料來源資訊。

spring.datasource.url=jdbc:mysql://127.0.0.1:3306/springbootdemo?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=123456

是不是有一種似曾相識的感覺（和[上一篇]()中的資料來源配置一模一樣）？為什麼呢？答案已經告訴過大家了——預設、預設、預設，重要的事情說三遍，Spring Boot 2 預設使用了 HikariCP 連線池。

04、編輯 Spring Boot 專案

為了便於我們檢視 HikariCP 的連線資訊，我們對 SpringBootMysqlApplication 類進行編輯，增加以下內容。

@SpringBootApplication
public class HikariCpDemoApplication implements CommandLineRunner {
    @Autowired
    private DataSource dataSource;

    public static void main(String[] args) {
        SpringApplication.run(HikariCpDemoApplication.class, args);
    }

    @Override
    public void run(String... args) throws Exception {
        Connection conn = dataSource.getConnection();
        conn.close();
    }
}

HikariCpDemoApplication 實現了 CommandLineRunner 介面，該介面允許我們在專案啟動的時候載入一些資料或者做一些事情，比如說我們嘗試通過 DataSource 物件與資料來源建立連線，這樣就可以在日誌資訊中看到 HikariCP 的連線資訊。CommandLineRunner 介面有一個方法需要實現，就是我們看到的 run() 方法。

通過 debug 的方式，我們可以看到，在專案執行的過程中，dataSource 這個 Bean 的型別為 HikariDataSource。

05、執行 Spring Boot 專案

接下來，我們直接執行 HikariCpDemoApplication 類，這樣一個 Spring Boot 專案就啟動成功了。

HikariDataSource 物件的連線資訊會被列印出來。也就是說，HikariCP 連線池的配置啟用了。快給自己點個贊。

06、為什麼 Spring Boot 2.0 選擇 HikariCP 作為預設資料庫連線池

有幾種基準測試結果可用來比較HikariCP和其他連線池框架（例如c3p0，dbcp2，tomcat和vibur）的效能。例如，HikariCP團隊釋出了以下基準（可在此處獲得原始結果）：

HikariCP 團隊為了證明自己效能最佳，特意找了幾個背景對比了下。不幸充當背景的有 c3p0、dbcp2、tomcat 等傳統的連線池。

從上圖中，我們能感受出背景的尷尬，HikariCP 鶴立雞群了。HikariCP 製作以如此優秀，原因大致有下面這些：

1）位元組碼級別上的優化：要求編譯後的位元組碼最少，這樣 CPU 快取就可以載入更多的程式程式碼。

HikariCP 優化前的程式碼片段：

public final PreparedStatement prepareStatement(String sql, String[] columnNames) throws SQLException
{
    return PROXY_FACTORY.getProxyPreparedStatement(this, delegate.prepareStatement(sql, columnNames));
}

HikariCP 優化後的程式碼片段：

public final PreparedStatement prepareStatement(String sql, String[] columnNames) throws SQLException
{
    return ProxyFactory.getProxyPreparedStatement(this, delegate.prepareStatement(sql, columnNames));
}

以上兩段程式碼的差別只有一處，就是 ProxyFactory 替代了 PROXY_FACTORY，這個改動後的位元組碼比優化前減少了 3 行指令。具體的分析參照 HikariCP 的 Wiki 文件。

2）使用自定義的列表（FastStatementList）代替 ArrayList，可以避免 get() 的時候進行範圍檢查，remove() 的時候從頭到尾的掃描。