小專案改造快速引入 mybatis的流程分析

2022-05-28 18:02:06

專案背景

專案在最開始，定位為一個外掛、功能補充，為現有的 OA 提供一個報表功能，用於統計各個流程的資料

功能方面非常簡單，考慮到開發速度，直接按 springboot 專案進行開發，依賴方面僅僅使用 spring-boot-starter-web, spring-boot-starter-jdbc, sqljdbc4, lombook

通過 @Bean 的方式注入 sql 查詢所需要的 JdbcTemplate 範例，後續的 sql 操作全部都以 template.queryForList(sqlStr) 的方式進行

由於忽略的 sql 上的複雜，加上 java8 尚未支援字串模版，導致程式碼中的 sql 類似於如下

閱讀、修改非常不便，決定還是引入 mybatis，最核心的訴求提高 sql 的可閱讀性，以及可維護性

開始改造

引入對應的 `start`

pom.xml 中新增 springboot 專用的 mybatis 依賴

<dependency>
        <groupId>org.mybatis.spring.boot</groupId>
        <artifactId>mybatis-spring-boot-starter</artifactId>
        <version>2.2.2</version>
</dependency>

在 application.yml 中補充設定

主要是指定 mybatis 中 sql 所在的 xml 檔案解析位置

mybatis:
  mapper-locations:
    - classpath:mybaits/*.xml

補充資料夾

專案的建議目錄排版如下：

|- srcmainjava
    |- com.xx
        |- bean
        |- mapper
        xxxApplication
|- srcmainresources
    |- static
    |- mybaits
        |- Request.xml
    application.yml

在 xxxApplication 這個啟動類的同層，建立 mapper 資料夾，用於存放相關的 xxMapper 的介面檔案。需要在介面上使用類註解 @Mapper 讓 mybatis 框架來識別。 程式碼範例如下

@Mapper
public interface RequestMapper {
}

在 mybatis 資料夾下，存放與 xxMapper 相對應的 xml 檔案

根據 mybatis 官方檔案，可以得知用於存放 sql的標準 xml 檔案格式如下：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
  PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="org.mybatis.example.BlogMapper">
  <select id="selectBlog" resultType="Blog">
    select * from Blog where id = #{id}
  </select>
</mapper>

我們需要修改 mapper 標籤中的 namespace 屬性，使之和我們的 xxMapper 對應；以同樣的格式補充新的 <select></select> 查詢語句

最後，將通過 JdbcTemplate 執行的 sql，規範為對應的 Mapper + xml 檔案，並調整相關的函數呼叫，整個專案的改造就基本完成

總結

由於使用了 mybatis-spring-boot-starter 這個 start，加上我們遵循一些預設約定，只使用了一個設定就將 mybatis 應用到了這個專案上。這次改造中最大的變動就是將原 sql 處理為 xxMapper + xx.xml 兩種檔案

可以欣賞一下，寫在 xml 中的 sql，是多麼的優雅

到此這篇關於小專案改造快速引入 mybatis的文章就介紹到這了,更多相關引入 mybatis內容請搜尋it145.com以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援it145.com！