項目背景

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

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

通過 @Bean 的方式注入 sql 查詢所需要的 JdbcTemplate 實例，后續(xù)的 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

補充文件夾

項目的建議目錄排版如下：

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

在 xxxApplication 這個啟動類的同層，建立 mapper 文件夾，用于存放相關的 xxMapper 的接口文件。需要在接口上使用類注解 @Mapper 讓 mybatis 框架來識別。 代碼示例如下

@Mapper
public interface RequestMapper {
}

在 mybatis 文件夾下，存放與 xxMapper 相對應的 xml 文件

根據(jù) 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 執(zhí)行的 sql，規(guī)范為對應的 Mapper + xml 文件，并調(diào)整相關的函數(shù)調(diào)用，整個項目的改造就基本完成

總結(jié)

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

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

到此這篇關于小項目改造快速引入 mybatis的文章就介紹到這了,更多相關引入 mybatis內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！