這篇文章主要介紹了小項(xiàng)目改造快速引入 mybatis,功能方面非常簡(jiǎn)單，考慮到開發(fā)速度，直接按 springboot 項(xiàng)目進(jìn)行開發(fā)，依賴方面僅僅使用 spring-boot-starter-web, spring-boot-starter-jdbc, sqljdbc4, lombook，需要的朋友可以參考下

項(xiàng)目背景

項(xiàng)目在最開始，定位為一個(gè)插件、功能補(bǔ)充，為現(xiàn)有的 OA 提供一個(gè)報(bào)表功能，用于統(tǒng)計(jì)各個(gè)流程的數(shù)據(jù)

功能方面非常簡(jiǎn)單，考慮到開發(fā)速度，直接按 springboot 項(xiàng)目進(jìn)行開發(fā)，依賴方面僅僅使用 spring-boot-starter-web, spring-boot-starter-jdbc, sqljdbc4, lombook

通過(guò) @Bean 的方式注入 sql 查詢所需要的 JdbcTemplate 實(shí)例，后續(xù)的 sql 操作全部都以 template.queryForList(sqlStr) 的方式進(jìn)行

由于忽略的 sql 上的復(fù)雜，加上 java8 尚未支持字符串模版，導(dǎo)致代碼中的 sql 類似于如下

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

開始改造

引入對(duì)應(yīng)的 `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 中補(bǔ)充配置

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

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

補(bǔ)充文件夾

項(xiàng)目的建議目錄排版如下：

|- src\main\java
    |- com.xx
        |- bean
        |- mapper
        xxxApplication
|- src\main\resources
    |- static
    |- mybaits
        |- Request.xml
    application.yml

在 xxxApplication 這個(gè)啟動(dòng)類的同層，建立 mapper 文件夾，用于存放相關(guān)的 xxMapper 的接口文件。需要在接口上使用類注解 @Mapper 讓 mybatis 框架來(lái)識(shí)別。 代碼示例如下

@Mapper
public interface RequestMapper {
}

在 mybatis 文件夾下，存放與 xxMapper 相對(duì)應(yīng)的 xml 文件

根據(jù) mybatis 官方文檔，可以得知用于存放 sql的標(biāo)準(zhǔn) 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 標(biāo)簽中的 namespace 屬性，使之和我們的 xxMapper 對(duì)應(yīng)；以同樣的格式補(bǔ)充新的 <select></select> 查詢語(yǔ)句

最后，將通過(guò) JdbcTemplate 執(zhí)行的 sql，規(guī)范為對(duì)應(yīng)的 Mapper + xml 文件，并調(diào)整相關(guān)的函數(shù)調(diào)用，整個(gè)項(xiàng)目的改造就基本完成

總結(jié)

由于使用了 mybatis-spring-boot-starter 這個(gè) start，加上我們遵循一些默認(rèn)約定，只使用了一個(gè)配置就將 mybatis 應(yīng)用到了這個(gè)項(xiàng)目上。這次改造中最大的變動(dòng)就是將原 sql 處理為 xxMapper + xx.xml 兩種文件

可以欣賞一下，寫在 xml 中的 sql，是多么的優(yōu)雅