SpringBoot + MyBatis(註解版)，常用的SQL方法

蔡昭凱發表於2019-06-06
Spring BootMyBatisSQL

一、新建專案及配置

1.1 新建一個SpringBoot專案，並在pom.xml下加入以下程式碼

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

　　application.properties檔案下配置（使用的是MySql資料庫）

# 注：我的SpringBoot 是2.0以上版本，資料庫驅動如下
spring.datasource.driverClassName=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/database?characterEncoding=utf8&serverTimezone=UTC
spring.datasource.username=your_username
spring.datasource.password=your_password

# 可將 com.dao包下的dao介面的SQL語句列印到控制檯，學習MyBatis時可以開啟
logging.level.com.dao=debug

　　SpringBoot啟動類Application.java 加入@SpringBootApplication 註解即可（一般使用該註解即可，它是一個組合註解）

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

　　之後dao層的介面檔案放在Application.java 能掃描到的位置即可，dao層檔案使用@Mapper註解

@Mapper
public interface UserDao {
    /**
     * 測試連線
     */
    @Select("select 1 from dual")
    int testSqlConnent();
}

測試介面能返回資料即表明連線成功

二、簡單的增刪查改sql語句

　　2.1 傳入引數

　　(1) 可以傳入一個JavaBean

　　(2) 可以傳入一個Map

　　(3) 可以傳入多個引數，需使用@Param("ParamName") 修飾引數

　　2.2 Insert，Update，Delete 返回值

　　介面方法返回值可以使用 void 或 int，int返回值代表影響行數

　　2.3 Select 中使用@Results 處理對映

　　查詢語句中，如何名稱不一致，如何處理資料庫欄位對映到Java中的Bean呢？

　　(1) 可以使用sql 中的as 對查詢欄位改名，以下可以對映到User 的 name欄位

　　@Select("select "1" as name from dual")
    User testSqlConnent();

　　(2) 使用 @Results，有 @Result(property="Java Bean name", column="DB column name"), 例如：

　　 @Select("select t_id, t_age, t_name  "
            + "from sys_user             "
            + "where t_id = #{id}        ")
    @Results(id="userResults", value={
            @Result(property="id",   column="t_id"),
            @Result(property="age",  column="t_age"),
            @Result(property="name", column="t_name"),
    })
　　 User selectUserById(@Param("id") String id);

　　對於resultMap 可以給與一個id，其他方法可以根據該id 來重複使用這個resultMap。例如：

　　 @Select("select t_id, t_age, t_name  "
            + "from sys_user             "
            + "where t_name = #{name}        ")
    @ResultMap("userResults")
　　 User selectUserByName(@Param("name") String name);

　　2.4 注意一點，關於JavaBean 的構造器問題

　　我在測試的時候，為了方便，給JavaBean 新增了一個帶引數的構造器。後面在測試resultMap 的對映時，發現把對映關係@Results 註釋掉，返回的bean 還是有資料的；更改查詢欄位順序時，出現 java.lang.NumberFormatException: For input string: "hello"的異常。經過測試，發現是bean 的構造器問題。並有以下整理：

　　(1) bean 只有一個有參的構造方法，MyBatis 呼叫該構造器(引數按順序)，此時@results 註解無效。並有查詢結果個數跟構造器不一致時，報異常。

　　(2) bean 有多個構造方法，且沒有 無參構造器，MyBatis 呼叫跟查詢欄位數量相同的構造器；若沒有數量相同的構造器，則報異常。

　　(3) bean 有多個構造方法，且有 無參構造器， MyBatis 呼叫無引數造器。

　　(4) 綜上，一般情況下，bean 不要定義有參的構造器；若需要，請再定義一個無參的構造器。

　　2.5 簡單查詢例子

   /**
     * 測試連線
     */
    @Select("select 1 from dual")
    int testSqlConnent();
    
    /**
     * 新增，引數是一個bean
     */
    @Insert("insert into sys_user       "
            + "(t_id, t_name, t_age)    "
            + "values                   "
            + "(#{id}, #{name}, ${age}) ")
    int insertUser(User bean);
    
    /**
     * 新增，引數是一個Map
     */
    @Insert("insert into sys_user       "
            + "(t_id, t_name, t_age)    "
            + "values                   "
            + "(#{id}, #{name}, ${age}) ")
    int insertUserByMap(Map<String, Object> map);
    
    /**
     * 新增，引數是多個值，需要使用@Param來修飾
     * MyBatis 的引數使用的@Param的字串，一般@Param的字串與引數相同
     */
    @Insert("insert into sys_user       "
            + "(t_id, t_name, t_age)    "
            + "values                   "
            + "(#{id}, #{name}, ${age}) ")
    int insertUserByParam(@Param("id") String id, 
                          @Param("name") String name,
                          @Param("age") int age);
    
    /**
     * 修改
     */
    @Update("update sys_user set  "
            + "t_name = #{name},  "
            + "t_age  = #{age}    "
            + "where t_id = #{id} ")
    int updateUser(User bean);
    
    /**
     * 刪除
     */
    @Delete("delete from sys_user  "
            + "where t_id = #{id}  ")
    int deleteUserById(@Param("id") String id);
    
    /**
     * 刪除
     */
    @Delete("delete from sys_user ")
    int deleteUserAll();
    
    /**
     * truncate 返回值為0
     */
    @Delete("truncate table sys_user ")
    void truncateUser();
    
    /**
     * 查詢bean
     * 對映關係@Results
     * @Result(property="java Bean name", column="DB column name"),
     */
    @Select("select t_id, t_age, t_name  "
            + "from sys_user             "
            + "where t_id = #{id}        ")
    @Results(id="userResults", value={
            @Result(property="id",   column="t_id"),
            @Result(property="age",  column="t_age"),
            @Result(property="name", column="t_name", javaType = String.class),
        })
    User selectUserById(@Param("id") String id);
    
    /**
     * 查詢List
     */
    @ResultMap("userResults")
    @Select("select t_id, t_name, t_age "
            + "from sys_user            ")
    List<User> selectUser();
    
    @Select("select count(*) from sys_user ")
    int selectCountUser();

三、MyBatis動態SQL

　　註解版下，使用動態SQL需要將sql語句包含在script標籤裡

<script></script>

3.1 if

　　通過判斷動態拼接sql語句，一般用於判斷查詢條件

<if test=''>...</if>

3.2 choose

　　根據條件選擇

<choose>
    <when test=''> ...
    </when>
    <when test=''> ...
    </when>
    <otherwise> ...
    </otherwise> 
</choose>

3.3 where，set

　　一般跟if 或choose 聯合使用，這些標籤或去掉多餘的 關鍵字 或 符號。如

<where>
    <if test="id != null "> 
        and t_id = #{id}
    </if>
</where>

　　若id為null，則沒有條件語句；若id不為 null，則條件語句為 where t_id = ? 

<where> ... </where>
<set> ... </set>

3.4 bind

　　繫結一個值，可應用到查詢語句中

<bind name="" value="" />

3.5 foreach

　　迴圈，可對傳入和集合進行遍歷。一般用於批量更新和查詢語句的 in

<foreach item="item" index="index" collection="list" open="(" separator="," close=")">
    #{item}
</foreach>

　　(1) item：集合的元素，訪問元素的Filed 使用 #{item.Filed}

　　(2) index: 下標，從0開始計數

　　(3) collection：傳入的集合引數

　　(4) open：以什麼開始

　　(5) separator：以什麼作為分隔符

　　(6) close：以什麼結束

　　例如 傳入的list 是一個 List<String>: ["a","b","c"]，則上面的 foreach 結果是: ("a", "b", "c")

3.6 動態SQL例子

    /**
     * if 對內容進行判斷
     * 在註解方法中，若要使用MyBatis的動態SQL，需要編寫在<script></script>標籤內
     * 在 <script></script>內使用特殊符號，則使用java的轉義字元，如  雙引號 "" 使用&quot;&quot; 代替
     * concat函式：mysql拼接字串的函式
     */
    @Select("<script>"
            + "select t_id, t_name, t_age                          "
            + "from sys_user                                       "
            + "<where>                                             "
            + "  <if test='id != null and id != &quot;&quot;'>     "
            + "    and t_id = #{id}                                "
            + "  </if>                                             "
            + "  <if test='name != null and name != &quot;&quot;'> "
            + "    and t_name like CONCAT('%', #{name}, '%')       "
            + "  </if>                                             "
            + "</where>                                            "
            + "</script>                                           ")
    @Results(id="userResults", value={
        @Result(property="id",   column="t_id"),
        @Result(property="name", column="t_name"),
        @Result(property="age",  column="t_age"),
    })
    List<User> selectUserWithIf(User user);
    
    /**
     * choose when otherwise 類似Java的Switch，選擇某一項
     * when...when...otherwise... == if... if...else... 
     */
    @Select("<script>"
            + "select t_id, t_name, t_age                                     "
            + "from sys_user                                                  "
            + "<where>                                                        "
            + "  <choose>                                                     "
            + "      <when test='id != null and id != &quot;&quot;'>          "
            + "            and t_id = #{id}                                   "
            + "      </when>                                                  "
            + "      <otherwise test='name != null and name != &quot;&quot;'> "
            + "            and t_name like CONCAT('%', #{name}, '%')          "
            + "      </otherwise>                                             "
            + "  </choose>                                                    "
            + "</where>                                                       "
            + "</script>                                                      ")
    @ResultMap("userResults")
    List<User> selectUserWithChoose(User user);
    
    /**
     * set 動態更新語句，類似<where>
     */
    @Update("<script>                                           "
            + "update sys_user                                  "
            + "<set>                                            "
            + "  <if test='name != null'> t_name=#{name}, </if> "
            + "  <if test='age != null'> t_age=#{age},    </if> "
            + "</set>                                           "
            + "where t_id = #{id}                               "
            + "</script>                                        ")
    int updateUserWithSet(User user);
    
    /**
     * foreach 遍歷一個集合，常用於批量更新和條件語句中的 IN
     * foreach 批量更新
     */
    @Insert("<script>                                  "
            + "insert into sys_user                    "
            + "(t_id, t_name, t_age)                   "
            + "values                                  "
            + "<foreach collection='list' item='item'  "
            + " index='index' separator=','>           "
            + "(#{item.id}, #{item.name}, #{item.age}) "
            + "</foreach>                              "
            + "</script>                               ")
    int insertUserListWithForeach(List<User> list);
    
    /**
     * foreach 條件語句中的 IN
     */
    @Select("<script>"
            + "select t_id, t_name, t_age                             "
            + "from sys_user                                          "
            + "where t_name in                                        "
            + "  <foreach collection='list' item='item' index='index' "
            + "    open='(' separator=',' close=')' >                 "
            + "    #{item}                                            "
            + "  </foreach>                                           "
            + "</script>                                              ")
    @ResultMap("userResults")
    List<User> selectUserByINName(List<String> list);
    
    /**
     * bind 建立一個變數，繫結到上下文中
     */
    @Select("<script>                                              "
            + "<bind name=\"lname\" value=\"'%' + name + '%'\"  /> "
            + "select t_id, t_name, t_age                          "
            + "from sys_user                                       "
            + "where t_name like #{lname}                          "
            + "</script>                                           ")
    @ResultMap("userResults")
    List<User> selectUserWithBind(@Param("name") String name);

 

四、MyBatis 對一，對多查詢

　　首先看@Result註解原始碼

public @interface Result {
  boolean id() default false;

  String column() default "";

  String property() default "";

  Class<?> javaType() default void.class;

  JdbcType jdbcType() default JdbcType.UNDEFINED;

  Class<? extends TypeHandler> typeHandler() default UnknownTypeHandler.class;

  One one() default @One;

  Many many() default @Many;
}

　　可以看到有兩個註解 @One 和 @Many，MyBatis就是使用這兩個註解進行對一查詢和對多查詢

　　@One 和 @Many寫在@Results 下的 @Result 註解中，並需要指定查詢方法名稱。具體實現看以下程式碼

// User Bean的屬性
private String id;
private String name;
private int age;
private Login login; // 每個使用者對應一套登入賬戶密碼
private List<Identity> identityList; // 每個使用者有多個證件型別和證件號碼

// Login Bean的屬性
private String username;
private String password;

// Identity Bean的屬性
private String idType;
private String idNo;
   /**
     * 對@Result的解釋
     * property：       java bean 的成員變數
     * column：         對應查詢的欄位，也是傳遞到對應子查詢的引數，傳遞多引數使用Map column = "{param1=SQL_COLUMN1,param2=SQL_COLUMN2}"
     * one=@One：       對一查詢
     * many=@Many：     對多查詢
     * select：         需要查詢的方法，全稱
　　　* fetchType.EAGER: 急載入
     */
    @Select("select t_id, t_name, t_age "
            + "from sys_user            "
            + "where t_id = #{id}       ")
    @Results({
        @Result(property="id",    column="t_id"),
        @Result(property="name",  column="t_name"),
        @Result(property="age",   column="t_age"),
        @Result(property="login", column="t_id",
          one=@One(select="com.github.mybatisTest.dao.OneManySqlDao.selectLoginById", fetchType=FetchType.EAGER)),
        @Result(property="identityList", column="t_id",
          many=@Many(select="com.github.mybatisTest.dao.OneManySqlDao.selectIdentityById", fetchType=FetchType.EAGER)),
    })
    User2 selectUser2(@Param("id") String id);
    
    /**
     * 對一 子查詢
     */
    @Select("select t_username, t_password "
            + "from sys_login              "
            + "where t_id = #{id}          ")
    @Results({
        @Result(property="username", column="t_username"),
        @Result(property="password", column="t_password"),
    })
    Login selectLoginById(@Param("id") String id);
    
    /**
     * 對多 子查詢
     */
    @Select("select t_id_type, t_id_no "
            + "from sys_identity              "
            + "where t_id = #{id}          ")
    @Results({
        @Result(property="idType", column="t_id_type"),
        @Result(property="idNo", column="t_id_no"),
    })
    List<Identity> selectIdentityById(@Param("id") String id);

　　測試結果，可以看到只呼叫一個方法查詢，相關對一查詢和對多查詢也會一併查詢出來

// 測試類程式碼
        @Test
    public void testSqlIf() {
        User2 user = dao.selectUser2("00000005");
        System.out.println(user);
        System.out.println(user.getLogin());
        System.out.println(user.getIdentityList());
    }    

// 查詢結果
    User2 [id=00000005, name=name_00000005, age=5]
    Login [username=the_name, password=the_password]
    [Identity [idType=01, idNo=12345678], Identity [idType=02, idNo=987654321]]

五、MyBatis開啟事務

5.1 使用 @Transactional 註解開啟事務

　　@Transactional標記在方法上，捕獲異常就rollback，否則就commit。自動提交事務。

　　/**
     * @Transactional 的引數
     * value                   |String                        | 可選的限定描述符，指定使用的事務管理器
     * propagation             |Enum: Propagation             | 可選的事務傳播行為設定
     * isolation               |Enum: Isolation               | 可選的事務隔離級別設定
     * readOnly                |boolean                       | 讀寫或只讀事務，預設讀寫
     * timeout                 |int (seconds)                 | 事務超時時間設定
     * rollbackFor             |Class<? extends Throwable>[]  | 導致事務回滾的異常類陣列
     * rollbackForClassName    |String[]                      | 導致事務回滾的異常類名字陣列
     * noRollbackFor           |Class<? extends Throwable>[]  | 不會導致事務回滾的異常類陣列
     * noRollbackForClassName  |String[]                      | 不會導致事務回滾的異常類名字陣列
     */
    @Transactional(timeout=4)
    public void testTransactional() {
            // dosomething..
    }

5.2 使用Spring的事務管理

　　如果想使用手動提交事務，可以使用該方法。需要注入兩個Bean，最後記得提交事務。

　　@Autowired
    private DataSourceTransactionManager dataSourceTransactionManager;
    
    @Autowired
    private TransactionDefinition transactionDefinition;

　　public void testHandleCommitTS(boolean exceptionFlag) {
//        DefaultTransactionDefinition transactionDefinition = new DefaultTransactionDefinition();
//        transactionDefinition.setPropagationBehavior(TransactionDefinition.PROPAGATION_REQUIRES_NEW);
        // 開啟事務
        TransactionStatus transactionStatus = dataSourceTransactionManager.getTransaction(transactionDefinition);
        try {
            // dosomething
            // 提交事務
            dataSourceTransactionManager.commit(transactionStatus);
        } catch (Exception e) {
            e.printStackTrace();
            // 回滾事務
            dataSourceTransactionManager.rollback(transactionStatus);
        }
    }

六、使用SQL語句構建器

　　MyBatis提供了一個SQL語句構建器，可以讓編寫sql語句更方便。缺點是比原生sql語句，一些功能可能無法實現。

　　有兩種寫法，SQL語句構建器看個人喜好，我個人比較熟悉原生sql語句，所有挺少使用SQL語句構建器的。

　　(1) 建立一個物件迴圈呼叫方法

new SQL().DELETE_FROM("user_table").WHERE("t_id = #{id}").toString()

　　(2) 內部類實現 

new SQL() {{
　　　DELETE_FROM("user_table");
　　　WHERE("t_id = #{id}");
}}.toString();

　　需要實現ProviderMethodResolver介面，ProviderMethodResolver介面屬於比較新的api，如果找不到這個介面，更新你的mybatis的版本，或者Mapper的@SelectProvider註解需要加一個 method註解， @SelectProvider(type = UserBuilder.class, method = "selectUserById")

　　繼承ProviderMethodResolver介面，Mapper中可以直接指定該類即可，但對應的Mapper的方法名要更Builder的方法名相同 。

Mapper:
@SelectProvider(type = UserBuilder.class)
public User selectUserById(String id);

UserBuilder:
public static String selectUserById(final String id)...

　　dao層程式碼：(建議在dao層中的方法加上@see的註解，並指示對應的方法，方便後期的維護)

　　/**
     * @see UserBuilder#selectUserById()
     */
    @Results(id ="userResults", value={
        @Result(property="id",   column="t_id"),
        @Result(property="name", column="t_name"),
        @Result(property="age",  column="t_age"),
    })
    @SelectProvider(type = UserBuilder.class)
    User selectUserById(String id);
    
    /**
     * @see UserBuilder#selectUser(String)
     */
    @ResultMap("userResults")
    @SelectProvider(type = UserBuilder.class)
    List<User> selectUser(String name);
    
    /**
     * @see UserBuilder#insertUser()
     */
    @InsertProvider(type = UserBuilder.class)
    int insertUser(User user);
    
    /**
     * @see UserBuilder#insertUserList(List)
     */
    @InsertProvider(type = UserBuilder.class)
    int insertUserList(List<User> list);
    
    /**
     * @see UserBuilder#updateUser()
     */
    @UpdateProvider(type = UserBuilder.class)
    int updateUser(User user);
    
    /**
     * @see UserBuilder#deleteUser()
     */
    @DeleteProvider(type = UserBuilder.class)
    int deleteUser(String id);

　　Builder程式碼：

public class UserBuilder implements ProviderMethodResolver {
    
    private final static String TABLE_NAME = "sys_user";
    
    public static String selectUserById() {
        return new SQL()
            .SELECT("t_id, t_name, t_age")
            .FROM(TABLE_NAME)
            .WHERE("t_id = #{id}")
            .toString();
    }
    
    public static String selectUser(String name) {
        SQL sql = new SQL()
                .SELECT("t_id, t_name, t_age")
                .FROM(TABLE_NAME);
        if (name != null && name != "") {
            sql.WHERE("t_name like CONCAT('%', #{name}, '%')");
        }
        return sql.toString();
    }

    public static String insertUser() {
        return new SQL()
            .INSERT_INTO(TABLE_NAME)
            .INTO_COLUMNS("t_id, t_name, t_age")
            .INTO_VALUES("#{id}, #{name}, #{age}")
            .toString();
    }
    
    /**
     * 使用SQL Builder進行批量插入
     * 關鍵是sql語句中的values格式書寫和訪問引數
     * values格式：values (?, ?, ?) , (?, ?, ?) , (?, ?, ?) ...
     * 訪問引數：MyBatis只能讀取到list引數，所以使用list[i].Filed訪問變數，如 #{list[0].id}
     */
    public static String insertUserList(List<User> list) {
        SQL sql = new SQL()
            .INSERT_INTO(TABLE_NAME)
            .INTO_COLUMNS("t_id, t_name, t_age");
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < list.size(); i++) {
            if (i > 0) {
                sb.append(") , (");
            }
            sb.append("#{list[");
            sb.append(i);
            sb.append("].id}, ");
            sb.append("#{list[");
            sb.append(i);
            sb.append("].name}, ");
            sb.append("#{list[");
            sb.append(i);
            sb.append("].age}");
        }
        sql.INTO_VALUES(sb.toString());
        return sql.toString();
    }
    
    public static String updateUser() {
        return new SQL()
            .UPDATE(TABLE_NAME)
            .SET("t_name = #{name}", "t_age = #{age}")
            .WHERE("t_id = #{id}")
            .toString();
    }
    
    public static String deleteUser() {
        return new SQL()
            .DELETE_FROM(TABLE_NAME)
            .WHERE("t_id = #{id}")
            .toString();

　　或者  Builder程式碼：

public class UserBuilder2 implements ProviderMethodResolver {
    
    private final static String TABLE_NAME = "sys_user";
    
    public static String selectUserById() {
        return new SQL() {{
            SELECT("t_id, t_name, t_age");
            FROM(TABLE_NAME);
            WHERE("t_id = #{id}");
        }}.toString();
    }
    
    public static String selectUser(String name) {
        return new SQL() {{
            SELECT("t_id, t_name, t_age");
            FROM(TABLE_NAME);
            if (name != null && name != "") {
                WHERE("t_name like CONCAT('%', #{name}, '%')");                }
        }}.toString();
    }

    public static String insertUser() {
        return new SQL() {{
            INSERT_INTO(TABLE_NAME);
            INTO_COLUMNS("t_id, t_name, t_age");
            INTO_VALUES("#{id}, #{name}, #{age}");
        }}.toString();
    }
    
    public static String updateUser(User user) {
        return new SQL() {{
            UPDATE(TABLE_NAME);
            SET("t_name = #{name}", "t_age = #{age}");
            WHERE("t_id = #{id}");
        }}.toString();
    }
    
    public static String deleteUser(final String id) {
        return new SQL() {{
            DELETE_FROM(TABLE_NAME);
            WHERE("t_id = #{id}");
        }}.toString();
    }
}

 

相關文章