MyBatis--動態SQL（if的用法）

(ps:測試工具為idea,SpringBoot整合Mybatis,基礎配置及簡單的單表操作省略....)

准備工作--

1.建表

CREATE TABLE `sys_user`  (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `user_name` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '用戶名',
  `user_password` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '密碼',
  `user_email` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '郵箱',
  `user_info` text CHARACTER SET utf8 COLLATE utf8_general_ci NULL COMMENT '簡介',
  `head_img` blob NULL COMMENT '頭像',
  `create_time` datetime(0) NULL DEFAULT NULL COMMENT '創建時間',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 1007 CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Dynamic;

-- ----------------------------
-- Records of sys_user
-- ----------------------------
INSERT INTO `sys_user` VALUES (1, 'admin', '123456', '[e-mail]', '管理員', NULL, '2020-03-04 13:01:03');
INSERT INTO `sys_user` VALUES (1001, 'test', '123456', '[e-mail]', '測試人員', NULL, '2020-03-04 13:01:43');
INSERT INTO `sys_user` VALUES (1005, 'test0', '123456', '[e-mail]', NULL, NULL, '2020-06-22 14:49:48');
INSERT INTO `sys_user` VALUES (1006, 'test1', '123456', '[e-mail]', NULL, NULL, '2020-06-22 14:49:48');
INSERT INTO `sys_user` VALUES (1007, 'test2', '123456', '[e-mail]', NULL, NULL, '2020-06-22 14:49:48');

SET FOREIGN_KEY_CHECKS = 1;

2.實體類

package com.beilin.menber.entity;


import lombok.Data;
/**
 * 用戶表
 */
import java.util.Date;
import java.util.List;

@Data
public class SysUser {
    private Long id;//id自增
    private String userName;//用戶名
    private String userPassword;//密碼
    private String userEmail;//郵箱
    private String userInfo;//簡介
    private byte[] headImg;//頭像
    private Date createTime;//創建時間


}

3.UserMapper接口

package com.beilin.menber.dao;
import java.util.List;

public interface UserMapper {

    //根據id查詢
    SysUser selectById(Long id);

   }

4.XML文件

<?xml version="1.0" encoding="UTF-8" ?>
<!-- mybatis的dtd文件 -->
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--namespace屬性： 用於指定指向那個接口 -->
<mapper namespace="com.beilin.menber.dao.UserMapper">
    <resultMap id="userMap" type="com.beilin.menber.entity.SysUser">
        <id property="id" column="id"/>
        <result property="userName" column="user_name"/>
        <result property="userPassword" column="user_password"/>
        <result property="userEmail" column="user_email"/>
        <result property="userInfo" column="user_info"/>
        <result property="headImg" column="head_img" jdbcType="BLOB"/>
        <result property="createTime" column="create_time" jdbcType="TIMESTAMP"/>
    </resultMap>
        
      <sql id="userBase">
         
   id,user_name,user_password,user_email,user_info,head_img,create_time
    </sql>
    
      <select id="selectById" resultType="SysUser">
            select * from sys_user where id =#{id}
        </select>

</mapper>

　

　　動態 SQL 是 MyBatis 的強大特性之一。如果你使用過 JDBC 或其它類似的框架，你應該能理解根據不同條件拼接 SQL 語句有多痛苦，例如拼接時要確保不能忘記添加必要的空格，還要注意去掉列表最后一個列名的逗號。利用動態 SQL，可以徹底擺脫這種痛苦。

　　使用動態 SQL 並非一件易事，但借助可用於任何 SQL 映射語句中的強大的動態 SQL 語言，MyBatis 顯著地提升了這一特性的易用性。

• if
• choose (when, otherwise)
• trim (where, set)
• foreach

if標簽通常用於WHERE語句中，通過判斷參數值來決定是否使用某個查詢條件，它也經常用於UPDATE語句中判斷是否更新某一字段，還可以在INSERT語句中用來判斷是否插入某個字段的值。

　　假設需求：實現一個用戶管理高級查詢功能，根據輸入的條件去檢索用戶信息，當只輸入用戶時，需要根據用戶名進行模糊搜索；當只輸入郵箱時，根據郵箱進行匹配；當同時輸入用戶名和郵箱時，用這兩個條件去查詢匹配的用戶。

　首先需要在UserMapper接口中增加對應的接口方法，代碼如下：

 

 /**
     * 根據動態條件查詢用戶信息
     * @param user
     * @return
     */
    List<SysUser> selectByUser(SysUser user);

 

 XML文件SQL

<select id="selectByUser" resultType="SysUser">
   select id,
　　　　user_name userName,
　　　　user_password userPassword,
　　　　user_email userEmail,
　　　　user_info userInfo,
　　　　create_time createTime
   from sys_user
   where 1 = 1 
   <if test="userName != null and userName !=''">
   and user_name like concat('%',#{userName},'%')
   </if>
   <if test="userEmail != null and userEmail !=''">
      and user_email like concat('%',#{userEmai},'%')
   </if>
</select>

 新建UserMapperTest測試類

package com.beilin.menber.dao;


import com.beilin.menber.entity.SysUser;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.util.Assert;

import java.util.ArrayList;
import java.util.Date;
import java.util.List;
import static org.junit.jupiter.api.Assertions.*;

@SpringBootTest
class UserMapperTest {
    @Autowired
    private UserMapper userMapper;


    @Test
    void test(){
        SysUser user=new SysUser();
        //只傳入用戶名時
        user.setUserName("ad");
        List<SysUser>userList =userMapper.selectByUser(user);
        System.out.println(userList);

    }

     @Test
    void test1(){
         SysUser user=new SysUser();
         //只傳入郵箱時
         user.setUserEmail("test");
         List<SysUser>userList =userMapper.selectByUser(user);
         System.out.println(userList);
    }
     @Test
    void test2(){
         SysUser user=new SysUser();
         //同時傳入用戶名和郵箱
         user.setUserEmail("@mybatis.com");
         user.setUserName("t");
         List<SysUser>userList =userMapper.selectByUser(user);
         System.out.println(userList);
    }

  

}

右鍵運行，然后控制台就會輸出對應的信息，這里不一一測試了

 

 

 

• 注意SQL中where關鍵字后面的條件

　　　　where 1 = 1

　　由於兩個條件都是動態的，所以如果沒有1=1這個默認條件，當兩個if判斷都不滿足時，最后生成的SQL就會以where結束，這樣不符合SQL規范，因此就會報錯。加上1=1這個條件就可以避免SQL語法錯誤導致的異常。這種寫法並美觀，后面可以使用where標簽替代這種寫法。

• 注意條件中的and(或or)

　　這里的and(或or)需要手動添加，當這部分條件拼接到where 1 = 1 后面時仍然是合法的SQL，因為有默認的1=1這個條件，我們才不需要判斷第一個動態條件是否需要加上and(或or),因為這種情況下and(或or)是必須有的。