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)是必须有的。