Mybatis CRUD练习

目标

• 能够使用映射配置文件实现CRUD操作
• 能够使用注解实现CRUD操作

1，配置文件实现CRUD

如上图所示产品原型，里面包含了品牌数据的 查询 、按条件查询、添加、删除、批量删除、修改 等功能，而这些功能其实就是对数据库表中的数据进行CRUD操作。接下来我们就使用Mybatis完成品牌数据的增删改查操作。以下是我们要完成功能列表：

• 查询
  • 查询所有数据
  • 查询详情
  • 条件查询
• 添加
• 修改
  • 修改全部字段
  • 修改动态字段
• 删除
  • 删除一个
  • 批量删除

我们先将必要的环境准备一下。

1.1 环境准备

完全继承上面的环境，接着做

• 数据库表（tb_brand）及数据准备

  -- mybatis数据库下
  use mybatis;
  -- 删除tb_brand表
  drop table if exists tb_brand;
  -- 创建tb_brand表
  create table tb_brand
  (
      -- id 主键
      id           int primary key auto_increment,
      -- 品牌名称
      brand_name   varchar(20),
      -- 企业名称
      company_name varchar(20),
      -- 排序字段
      ordered      int,
      -- 描述信息
      description  varchar(100),
      -- 状态：0：禁用  1：启用
      status       int
  );
  -- 添加数据
  insert into tb_brand (brand_name, company_name, ordered, description, status)
  values ('三只松鼠', '三只松鼠股份有限公司', 5, '好吃不上火', 0),
         ('华为', '华为技术有限公司', 100, '华为致力于把数字世界带入每个人、每个家庭、每个组织，构建万物互联的智能世界', 1),
         ('小米', '小米科技有限公司', 50, 'are you ok', 1);
  

• 实体类 Brand

  在 cn.whu.pojo 包下创建 Brand 实体类。
  这里体会到 自动导包真的太爽了

  @Data
  @NoArgsConstructor
  @AllArgsConstructor
  @ToString
  public class Brand {
      // id 主键
      private Integer id;
      // 品牌名称
      private String brandName;
      // 企业名称
      private String companyName;
      // 排序字段
      private Integer ordered;
      // 描述信息
      private String description;
      // 状态：0：禁用  1：启用
      private Integer status;
  }
  

• 编写测试用例

  测试代码需要在 test/java 目录下创建包及测试用例。项目结构如下：

  

• 安装 MyBatisX 插件

  • MybatisX 是一款基于 IDEA 的快速开发插件，为效率而生。

  • 主要功能

    • XML映射配置文件 和 接口方法 间相互跳转
    • 根据接口方法生成 statement （就是sql映射配置）

  • 安装方式

    点击 file ，选择 settings ，就能看到如下图所示界面

  

  注意：旧版本安装完毕后可能需要重启IDEA 新版IDEA不需要

  • 插件效果

  

  红色头绳的表示映射配置文件，蓝色头绳的表示mapper接口。在mapper接口点击红色头绳的小鸟图标会自动跳转到对应的映射配置文件，在映射配置文件中点击蓝色头绳的小鸟图标会自动跳转到对应的mapper接口。也可以在mapper接口中定义方法，自动生成映射配置文件中的 statement ，如图所示
  
  

Debug01: 别名mybatisx报错

问题: mybatisx插件自动生成的statement配置，resultType默认是全路径名，并未使用别名，如果强制使用别名会报错，单并不影响运行，就是看着烦
解决: 直接alter+enter -> disabled ins… 忽略掉即可 不影响程序运行的

1.2 查询所有数据

如上图所示就页面上展示的数据，而这些数据需要从数据库进行查询。接下来我们就来讲查询所有数据功能，而实现该功能我们分以下步骤进行实现：

• 编写接口方法：Mapper接口

  • 参数：无

    查询所有数据功能是不需要根据任何条件进行查询的，所以此方法不需要参数。

    

  • 结果：List

    我们会将查询出来的每一条数据封装成一个 Brand 对象，而多条数据封装多个 Brand 对象，需要将这些对象封装到List集合中返回。
    

  • 执行方法、测试

1.2.1 编写接口方法

在 cn.whu.mapper 包写创建名为 BrandMapper 的接口。并在该接口中定义 List<Brand> selectAll() 方法。

public interface BrandMapper {

    /**
     * 查询所有
     */
    List<Brand> selectAll();
}

1.2.2 编写SQL语句

在 reources 下创建 cn/whu/mapper 目录结构，并在该目录下创建名为 BrandMapper.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="cn.whu.mapper.BrandMapper">
    <select id="selectAll" resultType="brand">
        select *
        from tb_brand;
    </select>
</mapper>

1.2.3 编写测试方法

在 MybatisTest 类中编写测试查询所有的方法
cn.whu.test.MybatisTest

@Test
public void testSelectAll() throws Exception {
    //1. 获取sqlSessionFactory
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);

    //2. 获取sqlSession对象
    SqlSession sqlSession = sqlSessionFactory.openSession();

    //3. 获取mapper接口的代理对象
    BrandMapper mapper = sqlSession.getMapper(BrandMapper.class);

    //4. 执行方法
    List<Brand> brands = mapper.selectAll();
    System.out.println(brands);

    //5. 释放资源
    sqlSession.close();
}

注意：现在我们感觉测试这部分代码写起来特别麻烦，我们可以先忍忍。以后我们只会写上面的第3步的代码，其他的都不需要我们来完成。

执行测试方法结果如下：

从上面结果我们看到了问题，有些数据封装成功了，而有些数据并没有封装成功。为什么这样呢？

这个问题可以通过两种方式进行解决：

• 给字段起别名
• 使用resultMap定义字段和属性的映射关系

1.2.4 起别名解决上述问题

从上面结果可以看到 brandName 和 companyName 这两个属性的数据没有封装成功，查询 实体类 和 表中的字段 发现，在实体类中属性名是 brandName 和 companyName ，而表中的字段名为 brand_name 和 company_name，如下图所示 。那么我们只需要保持这两部分的名称一致这个问题就迎刃而解。

我们可以在写sql语句时给这两个字段起别名，将别名定义成和属性名一致即可。

<select id="selectAll" resultType="brand">
    select
    id, brand_name as brandName, company_name as companyName, ordered, description, status
    from tb_brand;
</select>

而上面的SQL语句中的字段列表书写麻烦，如果表中还有更多的字段，同时其他的功能也需要查询这些字段时就显得我们的代码不够精炼。Mybatis提供了sql 片段可以提高sql的复用性。

SQL片段：

• 将需要复用的SQL片段抽取到 sql 标签中

  <sql id="brand_column">
  	id, brand_name as brandName, company_name as companyName, ordered, description, status
  </sql>
  

  id属性值是唯一标识，引用时也是通过该值进行引用。

• 在原sql语句中进行引用

  使用 include 标签引用上述的 SQL 片段，而 refid 指定上述 SQL 片段的id值。

  <select id="selectAll" resultType="brand">
      select
      <include refid="brand_column" />
      from tb_brand;
  </select>
  

最终配置：

1.2.5 使用resultMap解决上述问题

起别名 + sql片段的方式可以解决上述问题，但是它也存在问题。如果还有功能只需要查询部分字段，而不是查询所有字段，那么我们就需要再定义一个 SQL 片段，这就显得不是那么灵活。

那么我们也可以使用resultMap来定义字段和属性的映射关系的方式解决上述问题。

• 在映射配置文件中使用resultMap定义 字段 和 属性 的映射关系

    <!--id: 唯一标识 随便取名  type：指的是哪个pojo的映射 支持别名-->
    <!--
        <id></id> 映射主键的
            column： 表的列名
            property： 实体类的属性名
        <result></result> 映射其他一般字段的
    -->
    <resultMap id="brandResultMap" type="brand">
        <result column="brand_name" property="brandName"/>
        <result column="company_name" property="companyName"/>

    </resultMap>

注意：在上面只需要定义 字段名 和 属性名 不一样的映射，而一样的则不需要专门定义出来。

• SQL语句正常编写
  在<select>标签中，使用resultMap属性替换 resultType属性

  <select id="selectAll" resultMap="brandResultMap">
      select *
      from tb_brand;
  </select>
  

最终BrandMapper.xml

<mapper namespace="cn.whu.mapper.BrandMapper">

    <resultMap id="brandResultMap" type="brand">
        <result column="brand_name" property="brandName"/>
        <result column="company_name" property="companyName"/>
    </resultMap>

    <select id="selectAll" resultMap="brandResultMap">
        select *
        from tb_brand;
    </select>
</mapper>

1.2.6 小结

实体类属性名 和 数据库表列名 不一致，不能自动封装数据

• 起别名 : 在SQL语句中，对不一样的列名起别名，别名和实体类属性名一样
  • 可以定义 片段，提升复用性
• resultMap ：定义 完成不一致的属性名和列名的映射

而我们最终选择使用 resultMap的方式。查询映射配置文件中查询所有的 statement 书写如下：

 <resultMap id="brandResultMap" type="brand">
     <!--
            id：完成主键字段的映射
                column：表的列名
                property：实体类的属性名
            result：完成一般字段的映射
                column：表的列名
                property：实体类的属性名
        -->
     <result column="brand_name" property="brandName"/>
     <result column="company_name" property="companyName"/>
</resultMap>



<select id="selectAll" resultMap="brandResultMap">
    select *
    from tb_brand;
</select>

1.3 查询详情

有些数据的属性比较多，在页面表格中无法全部实现，而只会显示部分，而其他属性数据的查询可以通过 查看详情 来进行查询，如上图所示。

查看详情功能实现步骤：

• 编写接口方法：Mapper接口

  

  • 参数：id

    查看详情就是查询某一行数据，所以需要根据id进行查询。而id以后是由页面传递过来。

  • 结果：Brand

    根据id查询出来的数据只要一条，而将一条数据封装成一个Brand对象即可

• 编写SQL语句：SQL映射文件

  

• 执行方法、进行测试

1.3.1 编写接口方法

在 BrandMapper 接口中定义根据id查询数据的方法

/**
  * 查看详情：根据Id查询
  */
Brand selectById(int id);

1.3.2 编写SQL语句

在 BrandMapper.xml 映射配置文件中编写 statement，使用 resultMap 而不是使用 resultType

<select id="selectById"  resultMap="brandResultMap">
    select *
    from tb_brand where id = #{id};
</select>

注意：上述SQL中的 #{id}先这样写，一会我们再详细讲解

1.3.3 编写测试方法

在 test/java 下的 cn.whu.test 包下的 MybatisTest类中 定义测试方法
cn.whu.test.MybatisTest

    @Test
    public void testSelectById() throws Exception {
        // 接收参数
        int id = 1;

        //1. 获取sqlSessionFactory
        InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);

        //2. 获取sqlSession对象
        SqlSession sqlSession = sqlSessionFactory.openSession();

        //3. 获取mapper接口的代理对象
        BrandMapper mapper = sqlSession.getMapper(BrandMapper.class);

        //4. 执行方法
        Brand brand = mapper.selectById(id);
        System.out.println(brand);

        //5. 释放资源
        sqlSession.close();
    }

执行测试方法结果如下：

1.3.4 参数占位符

查询到的结果很好理解就是id为1的这行数据。而这里我们需要看控制台显示的SQL语句，能看到使用？进行占位。说明我们在映射配置文件中的写的 #{id} 最终会被？进行占位。接下来我们就聊聊映射配置文件中的参数占位符。

mybatis提供了两种参数占位符：

• #{} ：执行SQL时，会将 #{} 占位符替换为？，将来自动设置参数值。从上述例子可以看出使用#{} 底层使用的是 PreparedStatement ★ (JDBC学了 知道了预编译 就很好理解了 )

• ${} ：拼接SQL。底层使用的是 Statement，会存在SQL注入问题。如下图将 映射配置文件中的 #{} 替换成 ${} 来看效果

  <select id="selectById"  resultMap="brandResultMap">
      select *
      from tb_brand where id = ${id};
  </select>
  

  重新运行查看结果如下：

  

注意 : 从上面两个例子可以看出，以后开发我们使用 #{} 参数占位符。

    * 参数占位符:
           1. #{}: 会将其替换为 ?, 为了防止SQL注入
           2. ${}: 拼sql, 会存在SQL注入问题
           3. 使用时机：
                * 参数传递的时候： #{}
               【 * 表名或者列名不固定的情况下： ${} 会存在SQL注入问题  】 (了解即可 基本不用)

1.3.5 parameterType使用

对于有参数的mapper接口方法，我们在映射配置文件中应该配置 ParameterType 来指定参数类型。==只不过该属性都可以省略。==如下图：

<select id="selectById" parameterType="int" resultMap="brandResultMap">
    select *
    from tb_brand where id = ${id};
</select>

parameterType=“int” 不用写了 真好。接口方法里已经有了，然后调用的时候传什么就赋什么就行了

1.3.6 SQL语句中特殊字段处理

以后肯定会在SQL语句中写一下特殊字符，比如某一个字段大于某个值，如下图

可以看出报错了，因为映射配置文件是xml类型的问题，而 > < 等这些字符在xml中有特殊含义，所以此时我们需要将这些符号进行转义，可以使用以下两种方式进行转义

• 转义字符

  下图的 < 就是 < 的转义字符。

  

• <![CDATA[内容]]> （输入大写 CD 会有代码提示）

  

小结：

1.4 多条件查询 ★(参数接收方式)

我们经常会遇到如上图所示的多条件查询，将多条件查询的结果展示在下方的数据列表中。而我们做这个功能需要分析最终的SQL语句应该是什么样，思考两个问题

• 条件表达式
• 如何连接

条件字段 企业名称 和 品牌名称 需要进行模糊查询，所以条件应该是：

简单的分析后，我们来看功能实现的步骤：

• 编写接口方法

  • 参数：所有查询条件
  • 结果：List

• 在映射配置文件中编写SQL语句

• 编写测试方法并执行

1.4.1 编写接口方法

在 BrandMapper 接口中定义多条件查询的方法。

而该功能有三个参数，我们就需要考虑定义接口时，参数应该如何定义。Mybatis针对多参数有多种实现

• 使用 @Param("参数名称") 标记每一个参数，在映射配置文件中就需要使用 #{参数名称} 进行占位

  List<Brand> selectByCondition(@Param("status") int status, @Param("companyName") String companyName,@Param("brandName") String brandName);
  

• ★ 将多个参数封装成一个 实体对象 ，将该实体对象作为接口的方法参数。该方式要求在映射配置文件的SQL中使用 #{内容} 时，里面的内容必须和实体类属性名保持一致。

  List<Brand> selectByCondition(Brand brand);
  

• 将多个参数封装到map集合中，将map集合作为接口的方法参数。该方式要求在映射配置文件的SQL中使用 #{内容} 时，里面的内容必须和map集合中键的名称一致。

  List<Brand> selectByCondition(Map map);
  

1.4.2 编写SQL语句

在 BrandMapper.xml 映射配置文件中编写 statement，使用 resultMap 而不是使用 resultType

<select id="selectByCondition" resultMap="brandResultMap">
    select *
    from tb_brand
    where status = #{status}
    and company_name like #{companyName}
    and brand_name like #{brandName}
</select>

1.4.3 编写测试方法

在 test/java 下的 cn.whu.test 包下的 MybatisTest类中 定义测试方法
cn.whu.test.MybatisTest

• 方式:1：散装参数

散装参数: 如果方法中有多个参数，需要使用@Param(“SQL参数占位符名称(就是#{}内的名称)”)

@Test
public void testSelectByCondition() throws Exception {
    // 接收参数
    int status = 1;
    String companyName = "华为";
    String brandName = "华为";

    //处理参数
    companyName = "%" + companyName + "%";
    brandName = "%" + brandName + "%";

    //1. 获取sqlSessionFactory
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);

    //2. 获取sqlSession对象
    SqlSession sqlSession = sqlSessionFactory.openSession();

    //3. 获取mapper接口的代理对象
    BrandMapper mapper = sqlSession.getMapper(BrandMapper.class);

    //4. 执行方法
    List<Brand> brands = mapper.selectByCondition(status, companyName, brandName);
    System.out.println(brands);

    //5. 释放资源
    sqlSession.close();
}

• 方式2：对象参数

对象参数: 对象的属性名称要和参数占位符名称一致
（前面的test方法得注释了 否则编译不过）

@Test
public void testSelectByCondition2() throws Exception {
    // 接收参数
    int status = 1;
    String companyName = "华为";
    String brandName = "华为";

    //处理参数
    companyName = "%" + companyName + "%";
    brandName = "%" + brandName + "%";

    // 参数封装成对象
    Brand brand = new Brand();
    brand.setStatus(status);
    brand.setCompanyName(companyName);
    brand.setBrandName(brandName);


    //1. 获取sqlSessionFactory
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);

    //2. 获取sqlSession对象
    SqlSession sqlSession = sqlSessionFactory.openSession();

    //3. 获取mapper接口的代理对象
    BrandMapper mapper = sqlSession.getMapper(BrandMapper.class);

    //4. 执行方法
    List<Brand> brands = mapper.selectByCondition(brand);
    System.out.println(brands);

    //5. 释放资源
    sqlSession.close();
}

• 方式3：map集合参数

map的key值映射文件sql语句里的占位符保持一致 说明: #{占位符}

@Test
public void testSelectByCondition3() throws Exception {
    // 接收参数
    int status = 1;
    String companyName = "华为";
    String brandName = "华为";

    //处理参数
    companyName = "%" + companyName + "%";
    brandName = "%" + brandName + "%";

    // 参数封装成对象
    Map map = new HashMap();//值类型是变的 所以不能有范型
    map.put("status",status);//key和映射sql里的占位符保持一致     说明: #{占位符}
    map.put("companyName",companyName);
    map.put("brandName",brandName);

    //1. 获取sqlSessionFactory
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);

    //2. 获取sqlSession对象
    SqlSession sqlSession = sqlSessionFactory.openSession();

    //3. 获取mapper接口的代理对象
    BrandMapper mapper = sqlSession.getMapper(BrandMapper.class);

    //4. 执行方法
    List<Brand> brands = mapper.selectByCondition(map);
    System.out.println(brands);

    //5. 释放资源
    sqlSession.close();
}

文件编码改成UTF-8 否则中文字符识别不了。（这样会导致日志里面出现乱码，没得办法了）
运行结果和sql语句都是偶尔们想要的

[DEBUG] 17:02:01.435 [main] c.w.m.B.selectByCondition - ==>  Preparing: select * from tb_brand where status = ? and company_name like ? and brand_name like ? 
[DEBUG] 17:02:01.454 [main] c.w.m.B.selectByCondition - ==> Parameters: 1(Integer), %华为%(String), %华为%(String) 
[DEBUG] 17:02:01.466 [main] c.w.m.B.selectByCondition - <==      Total: 1 
[Brand(id=2, brandName=华为, companyName=华为技术有限公司, ordered=100, description=华为致力于把数字世界带入每个人、每个家庭、每个组织，构建万物互联的智能世界, status=1)]

小结

1.4.4 动态SQL ★

上述功能实现存在很大的问题。用户在输入条件时，肯定存在不是所有的条件都填写的情况，这个时候我们的SQL语句就不能那样写的

例如用户只输入 当前状态 时，SQL语句就是

select * from tb_brand where status = #{status}

而用户如果只输入企业名称时，SQL语句就是

select * from tb_brand where company_name like #{companName}

而用户如果输入了 当前状态 和 企业名称 时，SQL语句又不一样

select * from tb_brand where status = #{status} and company_name like #{companName}

sql语句条件是动态变化的，只写一种所有参数的呢？不行，where status = null 会导致查不出来任何值

针对上述的需要，Mybatis对动态SQL有很强大的支撑：

• if

• choose (when, otherwise)

• trim (where, set)

• foreach

我们先学习 if 标签和 where 标签：

• if 标签：条件判断

  • test 属性：逻辑表达式
    注意：逻辑表达式里是companyName而非company_name 也就是判断传入的参数或者说占位符

  <select id="selectByCondition" resultMap="brandResultMap">
      select *
      from tb_brand
      where
          <if test="status != null">
              and status = #{status}
          </if>
          <if test="companyName != null and companyName != '' ">
              and company_name like #{companyName}
          </if>
          <if test="brandName != null and brandName != '' ">
              and brand_name like #{brandName}
          </if>
  </select>
  

  如上的这种SQL语句就会根据传递的参数值进行动态的拼接。如果此时status和companyName有值那么就会值拼接这两个条件。

  执行结果如下：（注释掉最后一个参数）

// 参数封装成对象
Map map = new HashMap();//值类型是变的 所以不能有范型
map.put("status",status);//key和映射sql里的占位符保持一致     说明: #{占位符}
map.put("companyName",companyName);
//map.put("brandName",brandName);

DEBUG] 17:54:37.342 [main] c.w.m.B.selectByCondition - ==>  Preparing: select * from tb_brand where status = ? and company_name like ? 
[DEBUG] 17:54:37.363 [main] c.w.m.B.selectByCondition - ==> Parameters: 1(Integer), %华为%(String) 
[DEBUG] 17:54:37.375 [main] c.w.m.B.selectByCondition - <==      Total: 1 
[Brand(id=2, brandName=华为, companyName=华为技术有限公司, ordered=100, description=华为致力于把数字世界带入每个人、每个家庭、每个组织，构建万物互联的智能世界, status=1)]
[DEBUG] 17:54:37.382 [main] o.a.i.t.j.JdbcTransaction - Resetting autocommit to true on JDBC Connection [com.mysql.jdbc.JDBC4Connection@64ec96c6] 

看sql语句，就拼接了2两个

但是它也存在问题，如果此时给的参数值是

Map map = new HashMap();
// map.put("status" , status);
map.put("companyName", companyName);
map.put("brandName" , brandName);

拼接的SQL语句就变成了

select * from tb_brand where and company_name like ? and brand_name like ?

而上面的语句中 where 关键后直接跟 and 关键字，这就是一条错误的SQL语句。这个就可以使用 where 标签解决

• where 标签 （推荐）

  • 作用：
    • 替换where关键字
    • 会动态的去掉第一个条件前的 and
    • 如果所有的参数没有值则不加where关键字

  <select id="selectByCondition" resultMap="brandResultMap">
      select *
      from tb_brand
      <where>
          <if test="status != null">
              and status = #{status}
          </if>
          <if test="companyName != null and companyName != '' ">
              and company_name like #{companyName}
          </if>
          <if test="brandName != null and brandName != '' ">
              and brand_name like #{brandName}
          </if>
      </where>
  </select>
  

  注意：需要给每个条件前都加上 and 关键字。

• 自己解决：恒等式

  <select id="selectByCondition" resultMap="brandResultMap">
      select *
      from tb_brand
      where 1 = 1
  
      <if test="status != null">
          and status = #{status}
      </if>
      <if test="companyName != null and companyName!=''">
          and company_name like #{companyName}
      </if>
      <if test="brandName!=null and brandName!=''">
          and brand_name like #{brandName}
      </if>
  
  </select>
  

1.5 单个条件（动态SQL）

如上图所示，在查询时只能选择 品牌名称、当前状态、企业名称 这三个条件中的一个，但是用户到底选择哪儿一个，我们并不能确定。这种就属于单个条件的动态SQL语句。

这种需求需要使用到 choose（when，otherwise）标签 实现， 而 choose 标签类似于Java 中的switch语句。

通过一个案例来使用这些标签

1.5.1 编写接口方法

在 BrandMapper 接口中定义单条件查询的方法。

/**
  * 单条件动态查询
  * @param brand
  * @return
  */
List<Brand> selectByConditionSingle(Brand brand);

1.5.2 编写SQL语句

在 BrandMapper.xml 映射配置文件中编写 statement，使用 resultMap 而不是使用 resultType

<select id="selectByConditionSingle" resultMap="brandResultMap">
    select *
    from tb_brand
    <where>
        <choose><!--相当于switch-->
            <when test="status != null"><!--相当于case-->
                status = #{status}
            </when>
            <when test="companyName != null and companyName != '' "><!--相当于case-->
                company_name like #{companyName}
            </when>
            <when test="brandName != null and brandName != ''"><!--相当于case-->
                brand_name like #{brandName}
            </when>
        </choose>
    </where>
</select>

1.5.3 编写测试方法

在 test/java 下的 cn.whu.mapper 包下的 MybatisTest类中 定义测试方法

@Test
public void testSelectByConditionSingle() throws IOException {
    //接收参数
    int status = 1;
    String companyName = "华为";
    String brandName = "华为";

    // 处理参数
    companyName = "%" + companyName + "%";
    brandName = "%" + brandName + "%";

    //封装对象
    Brand brand = new Brand();
    //brand.setStatus(status);
    brand.setCompanyName(companyName);
    //brand.setBrandName(brandName);

    //1. 获取SqlSessionFactory
    String resource = "mybatis-config.xml";
    InputStream inputStream = Resources.getResourceAsStream(resource);
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    //2. 获取SqlSession对象
    SqlSession sqlSession = sqlSessionFactory.openSession();
    //3. 获取Mapper接口的代理对象
    BrandMapper brandMapper = sqlSession.getMapper(BrandMapper.class);
    //4. 执行方法
    List<Brand> brands = brandMapper.selectByConditionSingle(brand);
    System.out.println(brands);

    //5. 释放资源
    sqlSession.close();
}

执行测试方法结果如下：

万一啥条件都没有，也会出bug.
解决方式有2种：
1：<otherwise>
2、直接用之前的<where>

• 使用<otherwise>

<select id="selectByConditionSingle" resultMap="brandResultMap">
    select *
    from tb_brand
    where
    <choose><!--相当于switch 选择其中一个-->
        <when test="status != null"> /*相当于case*/
            status = #{status} /*单个条件，肯定没有and*/
        </when>

        <when test="companyName != null and companyName!=''">
            company_name like #{companyName}
        </when>

        <when test="brandName!=null and brandName!=''">
            brand_name like #{brandName}
        </when>
        <otherwise> /*保底的 where 后面不能一个条件都没有啊*/
            1 = 1
        </otherwise>
    </choose>
</select>

• 使用<where>

<select id="selectByConditionSingle" resultMap="brandResultMap">
     select *
     from tb_brand
     <where>
         <choose><!--相当于switch 选择其中一个-->
             <when test="status != null">/*相当于case*/
                 status = #{status} /*单个条件，肯定没有and*/
             </when>

             <when test="companyName != null and companyName!=''">
                 company_name like #{companyName}
             </when>

             <when test="brandName!=null and brandName!=''">
                 brand_name like #{brandName}
             </when>
         </choose>
     </where>
 </select>

没有指定条件，就应该查询所有

---

-----------------------Mybatis配置文件增删改---------------------------

1.6 添加数据

如上图是我们平时在添加数据时展示的页面，而我们在该页面输入想要的数据后添加 提交 按钮，就会将这些数据添加到数据库中。接下来我们就来实现添加数据的操作。

• 编写接口方法

  
  参数：除了id之外的所有的数据。id对应的是表中主键值，而主键我们是 自动增长 生成的。

• 编写SQL语句
  

• 编写测试方法并执行

明确了该功能实现的步骤后，接下来我们进行具体的操作。

1.6.1 编写接口方法

在 BrandMapper 接口中定义添加方法。

 /**
   * 添加
   */
void add(Brand brand);

1.6.2 编写SQL语句

在 BrandMapper.xml 映射配置文件中编写添加数据的 statement

<insert id="add">
    insert into tb_brand (brand_name, company_name, ordered, description, status)
    values (#{brandName}, #{companyName}, #{ordered}, #{description}, #{status});
</insert>

1.6.3 编写测试方法

在 test/java 下的 cn.whu.mapper 包下的 MybatisTest类中 定义测试方法

注意mybatis会关闭自动提交： Setting autocommit to false on JDBC Connection
也就是需要你手动提交事务 (否则IDEA里显示添加成功，数据库里却查不到)
…
方法1： 手动提交事务： sqlSession.commit();
方法2：把自动提交事务打开：SqlSession sqlSession = sqlSessionFactory.openSession(true);

@Test
public void testAdd() throws Exception {
    // 接收参数
    String brandName = "菠萝手机";
    String companyName = "菠萝有限公司";
    int ordered = 100;
    String description = "美国有苹果,中国有菠萝";
    int status = 1;

    // 参数封装成对象
    Brand brand = new Brand();
    brand.setBrandName(brandName);
    brand.setCompanyName(companyName);
    brand.setOrdered(ordered);
    brand.setDescription(description);
    brand.setStatus(status); //默认启用

    //1. 获取sqlSessionFactory
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);

    //2. 获取sqlSession对象
    SqlSession sqlSession = sqlSessionFactory.openSession();
    //SqlSession sqlSession = sqlSessionFactory.openSession(true);//这里把自动提交事务打开也行

    //3. 获取mapper接口的代理对象
    BrandMapper mapper = sqlSession.getMapper(BrandMapper.class);

    //4. 执行方法
    mapper.add(brand);

    // mybatis需要手动提交事务
    sqlSession.commit();

    //5. 释放资源
    sqlSession.close();
}

执行结果如下：

[DEBUG] 19:57:26.363 [main] o.a.i.t.j.JdbcTransaction - Setting autocommit to false on JDBC Connection [com.mysql.jdbc.JDBC4Connection@3e2055d6] 
[DEBUG] 19:57:26.365 [main] c.w.m.B.add - ==>  Preparing: insert into tb_brand(brand_name, company_name, ordered, description, status) value(?,?,?,?,?) 
[DEBUG] 19:57:26.384 [main] c.w.m.B.add - ==> Parameters: 菠萝手机(String), 菠萝有限公司(String), 100(Integer), 美国有苹果,中国有菠萝(String), 1(Integer) 
[DEBUG] 19:57:26.385 [main] c.w.m.B.add - <==    Updates: 1 
[DEBUG] 19:57:26.385 [main] o.a.i.t.j.JdbcTransaction - Committing JDBC Connection [com.mysql.jdbc.JDBC4Connection@3e2055d6] 
[DEBUG] 19:57:26.386 [main] o.a.i.t.j.JdbcTransaction - Resetting autocommit to true on JDBC Connection [com.mysql.jdbc.JDBC4Connection@3e2055d6] 
[DEBUG] 19:57:26.386 [main] o.a.i.t.j.JdbcTransaction - Closing JDBC Connection [com.mysql.jdbc.JDBC4Connection@3e2055d6] 

1.6.4 添加-主键返回

在数据添加成功后，有时候需要获取插入数据库那行数据的主键（主键是自增长）。

比如：添加订单和订单项，如下图就是京东上的订单

订单数据存储在订单表中，订单项存储在订单项表中。

• 添加订单数据

  

• 添加订单项数据，订单项中需要设置所属订单的id

  

明白了什么时候 主键返回 。接下来我们简单模拟一下，在添加完数据后打印id属性值，能打印出来说明已经获取到了。

我们将上面添加品牌数据的案例中映射配置文件里 statement 进行修改，如下

<insert id="add" useGeneratedKeys="true" keyProperty="id">
    insert into tb_brand (brand_name, company_name, ordered, description, status)
    values (#{brandName}, #{companyName}, #{ordered}, #{description}, #{status});
</insert>

在 insert 标签上添加如下属性：

• useGeneratedKeys：是够获取自动增长的主键值。true表示获取
• keyProperty ：指定将获取到的主键值封装到哪儿个属性里

不配置，直接添加完直接用brand.getId()，得到的是null，没用
（这里也能看出不合理，自己插入的行数据，竟然有行内信息是自己不知道的）

再测试执行，testAdd()代码无需改动，add()方法后添加一行：

System.out.println(brand.getId());

即可

• 小结：
  

1.7 修改

如图所示是修改页面，用户在该页面书写需要修改的数据，点击 提交 按钮，就会将数据库中对应的数据进行修改。注意一点，如果哪儿个输入框没有输入内容，我们是将表中数据对应字段值替换为空白还是保留字段之前的值？答案肯定是保留之前的数据。

接下来我们就具体来实现

1.7.1 编写接口方法

在 BrandMapper 接口中定义修改方法。

 /**
   * 修改 : 返回值int 就是影响的行数
   */
int update(Brand brand);

上述方法参数 Brand 就是封装了需要修改的数据，而id肯定是有数据的，这也是和添加方法的区别。

--------修改全部字段--------

1.7.2 编写SQL语句

 <update id="update">
     update tb_brand
     set brand_name = #{brandName},
         company_name = #{companyName},
         ordered = #{ordered},
         description = #{description},
         status = #{status}
     where id = #{id};
 </update>

1.7.3 编写测试方法

在 BrandMapper.xml 映射配置文件中编写修改数据的 statement。

    public void testUpdate() throws Exception {
        // 接收参数
        int id = 9;//要修改哪条数据
        String brandName = "菠萝手机2";
        String companyName = "菠萝无限公司";
        int ordered = 100;
        String description = "美国有苹果,中国有菠萝";
        int status = 1;

        // 参数封装成对象
        Brand brand = new Brand();
        brand.setId(id);
        brand.setBrandName(brandName);
        brand.setCompanyName(companyName);
        brand.setOrdered(ordered);
        brand.setDescription(description);
        brand.setStatus(status); //默认启用

        //1. 获取sqlSessionFactory
        InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);

        //2. 获取sqlSession对象
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //SqlSession sqlSession = sqlSessionFactory.openSession(true);//这里把自动提交事务打开也行

        //3. 获取mapper接口的代理对象
        BrandMapper mapper = sqlSession.getMapper(BrandMapper.class);

        //4. 执行方法
        int count = mapper.update(brand);
        System.out.println(count);//count影响的行数
        // 返回值 影响的行数 可以获取到 输出为： 1

        // mybatis需要手动提交事务
        sqlSession.commit();

        //5. 释放资源
        sqlSession.close();
    }

执行结果如下：确实修改了所有的字段

--------动态修改部分字段--------

1.7.2 编写SQL语句

提交了的值修改，未提交的值不修改(保持原来的旧值) 多好的需求啊
…
<set>标签可以解决两个问题：1 是万一最后一个条件不成立引发的逗号,问题。2 是万一所有字段都为空，set多余的问题

在 BrandMapper.xml 映射配置文件中编写修改数据的 statement。

<update id="update">
    update tb_brand
    <set>
        <if test="brandName != null and brandName != ''">
            brand_name = #{brandName},
        </if>
        <if test="companyName != null and companyName != ''">
            company_name = #{companyName},
        </if>
        <if test="ordered != null">
            ordered = #{ordered},
        </if>
        <if test="description != null and description != ''">
            description = #{description},
        </if>
        <if test="status != null">
            status = #{status}
        </if>
    </set>
    where id = #{id};
</update>

set 标签可以用于动态包含需要更新的列，忽略其它不更新的列。

1.7.3 编写测试方法

在 test/java 下的 cn.whu.mapper 包下的 MybatisTest类中 定义测试方法

@Test
public void testUpdate() throws Exception {
    // 接收参数
    int id = 9;//要修改哪条数据
    String brandName = "菠萝手机2";
    String companyName = "菠萝无限公司";
    int ordered = 100;
    String description = "美国有苹果,中国有菠萝";
    int status = 0;

    // 参数封装成对象
    Brand brand = new Brand();
    /* 只设置两个值了 */
    brand.setId(id);
    brand.setStatus(status);

    //1. 获取sqlSessionFactory
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);

    //2. 获取sqlSession对象
    SqlSession sqlSession = sqlSessionFactory.openSession();
    //SqlSession sqlSession = sqlSessionFactory.openSession(true);//这里把自动提交事务打开也行

    //3. 获取mapper接口的代理对象
    BrandMapper mapper = sqlSession.getMapper(BrandMapper.class);

    //4. 执行方法
    int count = mapper.update(brand);
    System.out.println(count);//count影响的行数
    // 返回值 影响的行数 可以获取到

    // mybatis需要手动提交事务
    sqlSession.commit();

    //5. 释放资源
    sqlSession.close();
}

执行测试方法结果如下：

从结果中SQL语句可以看出，只修改了 status 字段值，因为我们给的数据中只给Brand实体对象的 status 属性设置值了。这就是 set 标签的作用。

1.8 删除一行数据

如上图所示，每行数据后面都有一个 删除 按钮，当用户点击了该按钮，就会将该行数据删除掉。那我们就需要思考，这种删除是根据什么进行删除呢？是通过主键id删除，因为id是表中数据的唯一标识。

接下来就来实现该功能。

1.8.1 编写接口方法

在 BrandMapper 接口中定义根据id删除方法。

/**
  * 根据id删除
  */
void deleteById(int id);

1.8.2 编写SQL语句

在 BrandMapper.xml 映射配置文件中编写删除一行数据的 statement

<delete id="deleteById">
    delete from tb_brand where id = #{id};
</delete>

1.8.3 编写测试方法

在 test/java 下的 cn.whu.mapper 包下的 MybatisTest类中 定义测试方法

@Test
public void testDeleteById() throws Exception {
    // 接收参数
    int id = 12;//要删除哪条数据
    //1. 获取sqlSessionFactory
    InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);
    //2. 获取sqlSession对象
    SqlSession sqlSession = sqlSessionFactory.openSession();
    //SqlSession sqlSession = sqlSessionFactory.openSession(true);//这里把自动提交事务打开也行
    //3. 获取mapper接口的代理对象
    BrandMapper mapper = sqlSession.getMapper(BrandMapper.class);
    //4. 执行方法
    mapper.deleteById(id);
    // mybatis需要手动提交事务
    sqlSession.commit();
    //5. 释放资源
    sqlSession.close();
}

运行过程只要没报错，直接到数据库查询数据是否还存在。发现确实删除了

• 小结：
  

1.9 批量删除

如上图所示，用户可以选择多条数据，然后点击上面的 删除 按钮，就会删除数据库中对应的多行数据。

1.9.1 编写接口方法

在 BrandMapper 接口中定义删除多行数据的方法。

/**
  * 批量删除
  */
void deleteByIds(int[] ids);

参数是一个数组，数组中存储的是多条数据的id

1.9.2 编写SQL语句 (foreach 标签)

在 BrandMapper.xml 映射配置文件中编写删除多条数据的 statement。

编写SQL时需要遍历数组来拼接SQL语句。Mybatis 提供了 foreach 标签供我们使用

foreach 标签

用来迭代任何可迭代的对象（如数组，集合）。

• collection 属性：
  • mybatis会将数组参数，封装为一个Map集合。
    • 默认：array = 数组
    • 使用@Param注解改变map集合的默认key的名称
• item 属性：本次迭代获取到的元素。
• separator 属性：集合项迭代之间的分隔符。foreach 标签不会错误地添加多余的分隔符。也就是最后一次迭代不会加分隔符。
• open 属性：该属性值是在拼接SQL语句之前拼接的语句，只会拼接一次
• close 属性：该属性值是在拼接SQL语句拼接后拼接的语句，只会拼接一次

<delete id="deleteByIds">
    delete from tb_brand where id
    in
    <foreach collection="array" item="id" separator="," open="(" close=")">
        #{id}
    </foreach>
    ;
</delete>

假如数组中的id数据是{1,2,3}，那么拼接后的sql语句就是：

delete from tb_brand where id in (1,2,3);

1.9.3 编写测试方法

在 test/java 下的 com.itheima.mapper 包下的 MybatisTest类中 定义测试方法

@Test
public void testDeleteByIds() throws IOException {
    //接收参数
    int[] ids = {5,7,8};

    //1. 获取SqlSessionFactory
    String resource = "mybatis-config.xml";
    InputStream inputStream = Resources.getResourceAsStream(resource);
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    //2. 获取SqlSession对象
    SqlSession sqlSession = sqlSessionFactory.openSession();
    //SqlSession sqlSession = sqlSessionFactory.openSession(true);
    //3. 获取Mapper接口的代理对象
    BrandMapper brandMapper = sqlSession.getMapper(BrandMapper.class);
    //4. 执行方法
    brandMapper.deleteByIds(ids);
    //提交事务
    sqlSession.commit();
    //5. 释放资源
    sqlSession.close();
}