Spring Boot+Mybatis-Plus 自定义SQL，动态SQL，注入mapper.xml文件

往期链接

Mybatis-Plus多表联合查询，通过注解实现
Mybatis官方的中文文档
Mybatis-Plus官方

问题描述

上一期写了使用注解的方式写一些自定义的SQL语句，但是今天写一些东西的时候发现，诶，使用注解的时候是很方便啊，但是如果写动态SQL的时候不是很方便，也不是不能写，但是就是写着不是很舒服，下面请看Mybatis官方的例子：

@Update({"<script>",
      "update Author",
      "  <set>",
      "    <if test='username != null'>username=#{username},</if>",
      "    <if test='password != null'>password=#{password},</if>",
      "    <if test='email != null'>email=#{email},</if>",
      "    <if test='bio != null'>bio=#{bio}</if>",
      "  </set>",
      "where id=#{id}",
      "</script>"})
    void updateAuthorValues(Author author);

发现了吧，写个注解，里面还要写个 < script> 标签，那我还不如直接写xml配置文件，还有提示，格式看着也比这个纯字符串强啊，但是写的时候出现了一个错误，可能是小白吧，这个我就感觉很奇妙了，为什么呢？下面先上错误

org.apache.ibatis.binding.BindingException: Invalid bound statement (not found):

其他的错误信息就可以不用看了，这个就能说明一切了，绑定错误，找不到，然后我就仔细的回去看了看，发现都在，怎么会出现绑定错误呢，两个文件之间还能通过插件跳转呢！！！

这个就很不解了，使用就卡了不短的时间，这里记录一下，分享一下，祝大家以后少写Bug少踩坑

解决方法

主要还是得让这个mapper.xml注入进去，这个就得说一个配置了在Spring Boot的配置文件中不管是application.yml或者是application.properties中，指定mapper.xml文件的位置的配置

这个属性就是指定mapper.xml文件位置的属性，有个默认值，大家都要注意了，本人用的就是默认值，有小伙伴想更改的也可以更改，不管是放到java的路径下或者是resources路径下，这个值写的时候不能用 .来分割，必须用/分割，不然就会识别不到，下面上个书写例子吧

# Mybatis-plus 配置
mybatis-plus:
  global-config:
    # 数据源策略
    db-config:
      id-type: auto
  # sql语句输出和结果输出
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
  # 配置mapper.xml文件路径
  mapper-locations: classpath:/mapper/*.xml

这个配置好了之后就能随心所欲的去写了，基础的生成好了，定制的也可以使用注解或者xml文件的方式了，下面就可以愉快的CRUD了。

小例子

主要是为了实现更新用户的角色信息，有三张表：用户表、角色表、用户角色关联表（关联表就不建立实体类了）。

实体类

role --> 角色
@TableName("t_role")
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Role implements Serializable {

    private static final long serialVersionUID = 1L;

    @TableId(value = "id", type = IdType.AUTO)
    private Integer id;

    private String name;
}

admin ---> 用户
@TableName("t_admin")
@Data
@AllArgsConstructor
@NoArgsConstructor
public class Admin implements Serializable {

    private static final long serialVersionUID = 1L;

    @TableId(value = "id", type = IdType.AUTO)
    private Integer id;

    @NotBlank
    private String loginAcct;

    @NotBlank
    private String userPswd;

    private String userName;

    private String email;

    private String createTime;
}

DAO层

RoleMapper --->  角色操作 AdminMapper里面只是基础的CRUD什么都没写，所以就不帖出来了
public interface RoleMapper extends BaseMapper<Role> {

    /**
     * 根据用户id获取该用户已经拥有的角色id
     * @param id 用户id
     * @return 用户已经拥有的角色id列表
     */
    @Select("select role_id from inner_admin_role where admin_id = #{id}")
    List<Integer> selectAdminAssignRole(Integer id);

    /**
     * 根据id删除该用户的所有角色信息
     * @param id 用户id
     */
    @Delete("delete from inner_admin_role where admin_id = #{id}")
    void deleteAdminRole(Integer id);

    /**
     * 根据id添加该用户的角色信息
     * @param id 用户id
     * @param roleIdList 角色id
     */
    void addAdminRole(@Param("id") Integer id, @Param("roleIdList") List<Integer> roleIdList);
}

<?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="xxxx(mapper类的全类名)">

    <!-- 通用查询映射结果 -->
    <resultMap id="BaseResultMap" type="xxxx(实体类的全类名)">
        <id column="id" property="id" />
        <result column="name" property="name" />
    </resultMap>

    <!-- 通用查询结果列 -->
    <sql id="Base_Column_List">
        id, name
    </sql>

    <insert id="addAdminRole">
        insert into inner_admin_role values
            <foreach collection="roleIdList" item="roleId" separator=",">
                (#{id},#{roleId})
            </foreach>
    </insert>
</mapper>

测试

基本上就写完了，接下来就可以测试了，主要测试的就是mapper.xml中写的语句

@SpringBootTest
public class MpTest {

    @Autowired
    RoleMapper roleMapper;
    
    @Test
    void mapperTest(){
        List<Integer> list = new ArrayList<>();
        list.add(1);
        list.add(2);
        list.add(3);
        list.add(4);
        list.add(5);
        roleMapper.addAdminRole(3, list);
    }
}

执行成功！！！
打印的SQL语句

insert into inner_admin_role values (?,?) , (?,?) , (?,?) , (?,?) , (?,?)
# 填入的参数
3(Integer), 1(Integer), 3(Integer), 2(Integer), 3(Integer), 3(Integer), 3(Integer), 4(Integer), 3(Integer), 5(Integer)

和预想的一样，执行成功

总结

这一系列应该会继续更新的，更新每一段的学习和出现的问题及解决，会有ssm和spring boot和spring cloud（正在学吧，进度应该不会很快），还有其他的一些java学习的东西，大家一起进步吧。