MyBatis学习笔记

一、MyBatis概述

1.什么是MyBatis?

MyBatis 是一款优秀的持久层框架，用于简化 JDBC 开发

MyBatis 本是 Apache 的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为yBatis 。2013年11月迁移到Github

官网：https://mybatis.org/mybatis-3/zh/index.html

2.持久层

负责将数据到保存到数据库的那一层代码
JavaEE三层架构：表现层、业务层、持久层

3.框架

框架就是一个半成品软件，是一套可重用的、通用的、软件基础代码模型
在框架的基础之上构建软件编写更加高效、规范、通用、可扩展

4.JDBC缺点

请添加图片描述

硬编码（英语：HardCode或HardCoding）是指在软件实现上，将输出或输入的相关参数（例如：路径、输出的形式或格式）直接以常量的方式撰写在源代码中，而非在运行期间由外界指定的设置、资源、数据或格式做出适当回应。一般被认定是种反模式或不完美的实现，因为软件受到输入数据或输出格式的改与硬编码相对的则是软编码，两者是相对关系，没有绝对之分。硬编码是关联很紧密的…

5.MyBatis简化

MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作

请添加图片描述

二、MyBatis快速入门

1.需求：查询user表中所有数据

2.具体实现（步骤）

在这里插入图片描述

1.创建user表，添加数据

create database mybatis;
use mybatis;drop table if exists tb_user;create table tb_user(id int primary key auto_increment,username varchar(20),password varchar(20),gender char(1),addr varchar(30)
);INSERT INTO tb_user VALUES (1, 'zhangsan', '123', '男', '北京');
INSERT INTO tb_user VALUES (2, '李四', '234', '女', '天津');
INSERT INTO tb_user VALUES (3, '王五', '11', '男', '西安');

2.创建模块，导入坐标

在这里插入图片描述

导入对应的坐标：

<dependencies><!--mybatis依赖--><dependency><groupId>org.mybatis</groupId><artifactId>mybatis</artifactId><version>3.5.5</version></dependency><!--mysql 驱动--><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId><version>5.1.46</version></dependency><!--junit 单元测试--><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.13</version><scope>test</scope></dependency><!-- 添加slf4j日志api --><dependency><groupId>org.slf4j</groupId><artifactId>slf4j-api</artifactId><version>1.7.20</version></dependency><!-- 添加logback-classic依赖 --><dependency><groupId>ch.qos.logback</groupId><artifactId>logback-classic</artifactId><version>1.2.3</version></dependency><!-- 添加logback-core依赖 --><dependency><groupId>ch.qos.logback</groupId><artifactId>logback-core</artifactId><version>1.2.3</version></dependency></dependencies>

logback.xml：

<?xml version="1.0" encoding="UTF-8"?>
<configuration><!--CONSOLE ：表示当前的日志信息是可以输出到控制台的。--><appender name="Console" class="ch.qos.logback.core.ConsoleAppender"><encoder><pattern>[%level] %blue(%d{HH:mm:ss.SSS}) %cyan([%thread]) %boldGreen(%logger{15}) - %msg %n</pattern></encoder></appender><logger name="com.itheima" level="DEBUG" additivity="false"><appender-ref ref="Console"/></logger><!--level:用来设置打印级别，大小写无关：TRACE, DEBUG, INFO, WARN, ERROR, ALL 和 OFF， 默认debug<root>可以包含零个或多个<appender-ref>元素，标识这个输出位置将会被本日志级别控制。--><root level="DEBUG"><appender-ref ref="Console"/></root>
</configuration>

在这里插入图片描述

3.编写 MyBatis 核心配置文件 – > 替换连接信息解决硬编码问题

在这里插入图片描述

创建mybatis-config.xml文件：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration><environments default="development"><environment id="development"><transactionManager type="JDBC"/><dataSource type="POOLED"><!--数据库连接信息--><property name="driver" value="com.mysql.jdbc.Driver"/><property name="url" value="jdbc:mysql:///mybatis?useSSL=false"/><!--输入自己的数据库用户名和密码--><property name="username" value="root"/><property name="password" value="root123456"/></dataSource></environment></environments><mappers><!--加载SQL映射文件--><mapper resource="org/mybatis/example/BlogMapper.xml"/></mappers>
</configuration>

在这里插入图片描述

4.编写 SQL 映射文件 --> 统一管理sql语句，解决硬编码问题

在这里插入图片描述

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--namespace:名称空间id：SQL语句的唯一标识resultType：对应的返回结果的类型
-->
<mapper namespace="test"><select id="selectAll" resultType="com.pojo.User">select * from tb_user;</select>
</mapper>

在这里插入图片描述

并创建对应的User类。

修改SQL映射文件的路径：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration><environments default="development"><environment id="development"><transactionManager type="JDBC"/><dataSource type="POOLED"><!--数据库连接信息--><property name="driver" value="com.mysql.jdbc.Driver"/><property name="url" value="jdbc:mysql:///mybatis?useSSL=false"/><property name="username" value="root"/><property name="password" value="root123456"/></dataSource></environment></environments><mappers><!--加载SQL映射文件--><mapper resource="userMapper.xml"/></mappers>
</configuration>

在这里插入图片描述

5.编码

定义POJO类

package com.pojo;//alt+鼠标左键，整列便捷
public class User {private String id;private String username;private String password;private String gender;private String addr;public String getId() {return id;}public void setId(String id) {this.id = id;}public String getUsername() {return username;}public void setUsername(String username) {this.username = username;}public String getPassword() {return password;}public void setPassword(String password) {this.password = password;}public String getGender() {return gender;}public void setGender(String gender) {this.gender = gender;}public String getAddr() {return addr;}public void setAddr(String addr) {this.addr = addr;}@Overridepublic String toString() {return "User{" +"id='" + id + '\'' +", username='" + username + '\'' +", password='" + password + '\'' +", gender='" + gender + '\'' +", addr='" + addr + '\'' +'}';}
}

加载核心配置文件，获取 SqlSessionFactory 对象
获取 SqlSession 对象，执行 SQL 语句

释放资源

package com;import com.pojo.User;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;import java.io.IOException;
import java.io.InputStream;
import java.util.List;/*** MyBatis 快速入门代码*/
public class MyBatisDemo {public static void main(String[] args) throws IOException {//1.加载mybatis的核心配置文件，获取 SqlSessionFactory//可以直接从官网复制String resource = "mybatis-config.xml";InputStream inputStream = Resources.getResourceAsStream(resource);SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);//2.获取 SqlSession对象，用它来执行SQLSqlSession sqlSession = sqlSessionFactory.openSession();//3.执行SQLList<User> users = sqlSession.selectList("test.selectAll");System.out.println(users);//4.释放资源sqlSession.close();}
}

在这里插入图片描述

3.解决SQL映射文件的警告提示

产生原因：Idea和数据库没有建立连接，不识别表信息
解决方式：在Idea中配置MySQL数据库连接

连接成功之后可以直接在idea中写SQL语句。

三、Mapper代理开发

1.目的

解决原生方式中的硬编码
简化后期执行SQL

在这里插入图片描述

2.使用Mapper代理开发的规则

定义与SQL映射文件同名的Mapper接口，并且将Mapper接口和SQL映射文件放置在同一目录下
设置SQL映射文件的namespace属性为Mapper接口全限定名
在 Mapper 接口中定义方法，方法名就是SQL映射文件中sql语句的id，并保持参数类型和返回值类型一致

3.使用 Mapper 代理方式完成入门案例

定义与SQL映射文件同名的Mapper接口，并且将Mapper接口和SQL映射文件放置在同一目录下
设置SQL映射文件的namespace属性为Mapper接口全限定名
在 Mapper 接口中定义方法，方法名就是SQL映射文件中sql语句的id，并保持参数类型和返回值类型一致
编码
1. 通过 SqlSession 的 getMapper方法获取 Mapper接口的代理对象
2. 调用对应方法完成sql的执行

注意：如果Mapper接口名称和SQL映射文件名称相同，并在同一目录下，则可以使用包扫描的方式简化SQL映射文件的加载

在这里插入图片描述

具体步骤：

1.定义与SQL映射文件同名的Mapper接口，并且将Mapper接口和SQL映射文件放置在同一目录下

注意：如果直接将SQL映射文件和Mapper接口放置在同一个目录下，不符合java代码和配置文件分开管理的规范。正确的做法是在resources目录下创建和mapper包一样的结构（在resources目录下一次性创建多级目录结构，中间不能使用.,而是用/分隔。如com/mapper）

在这里插入图片描述

2.设置SQL映射文件的namespace属性为Mapper接口全限定名

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--namespace:名称空间id：SQL语句的唯一标识resultType：对应的返回结果的类型
-->
<mapper namespace="com.mapper.UserMapper"><select id="selectAll" resultType="com.pojo.User">select * from tb_user;</select>
</mapper>

在这里插入图片描述

3.在 Mapper 接口中定义方法，方法名就是SQL映射文件中sql语句的id，并保持参数类型和返回值类型一致

package com.mapper;import com.pojo.User;import java.util.List;public interface UserMapper {//注意:此处应该根据SQL语义判断查询的是单个还是多个,如果是多个就用集合，单个就用实体类对象List<User> selectAll();
}

在这里插入图片描述

注意，在第一步中修改了SQL映射文件的路径，需要在mybatis-config.xml文件中修改正确的SQL文件映射路径。

在这里插入图片描述

4.编码

通过 SqlSession 的 getMapper方法获取 Mapper接口的代理对象
调用对应方法完成sql的执行

在这里插入图片描述

注意，当SQL映射文件有多个时，可以通过包扫描的方式，更加的简单方便。

在这里插入图片描述

四、MyBatis核心配置文件

1.MyBatis 核心配置文件的顶层结构

在这里插入图片描述

如：

在这里插入图片描述

注意：配置各个标签时，需要遵守前后顺序

五、配置文件实现CRUD

产品原型地址：

https://www.pmdaniu.com/storages/122645/74ccff58678d80583ea43a55547173eb-1818/start.html

在这里插入图片描述

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

查询
查询所有数据
查询详情
条件查询

添加
修改
修改全部字段
修改动态字段

删除
删除一个
批量删除

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

5.1 环境准备

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

-- 删除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

在 com.pojo 包下创建 Brand 实体类。

package com.pojo;public class Brand {// id 主键private Integer id;// 品牌名称private String brandName;// 企业名称private String companyName;// 排序字段private Integer ordered;// 描述信息private String description;// 状态：0：禁用  1：启用private Integer status;public Integer getId() {return id;}public void setId(Integer id) {this.id = id;}public String getBrandName() {return brandName;}public void setBrandName(String brandName) {this.brandName = brandName;}public String getCompanyName() {return companyName;}public void setCompanyName(String companyName) {this.companyName = companyName;}public Integer getOrdered() {return ordered;}public void setOrdered(Integer ordered) {this.ordered = ordered;}public String getDescription() {return description;}public void setDescription(String description) {this.description = description;}public Integer getStatus() {return status;}public void setStatus(Integer status) {this.status = status;}@Overridepublic String toString() {return "Brand{" +"id=" + id +", brandName='" + brandName + '\'' +", companyName='" + companyName + '\'' +", ordered=" + ordered +", description='" + description + '\'' +", status=" + status +'}';}
}

在这里插入图片描述

编写测试用例

测试代码需要在 test/java 目录下创建包及测试用例。项目结构如下：
安装 MyBatisX 插件
- MybatisX 是一款基于 IDEA 的快速开发插件，为效率而生。
- 主要功能
  - XML映射配置文件和接口方法间相互跳转
  - 根据接口方法生成 statement
- 安装方式
  
  点击 file/文件 ，选择 settings/设置 ，在插件中搜索mybatis就能看到如下图所示界面，点击安装即可（这里已经安装）。
- 插件效果
  
  红色头绳的表示映射配置文件，蓝色头绳的表示mapper接口。在mapper接口点击红色头绳的小鸟图标会自动跳转到对应的映射配置文件，在映射配置文件中点击蓝色头绳的小鸟图标会自动跳转到对应的mapper接口。也可以在mapper接口中定义方法，自动生成映射配置文件中的 statement ，如图所示

5.2 查询所有数据

在这里插入图片描述

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

编写接口方法： Mapper接口
- 参数：无
- 结果：List
编写 SQL语句： SQL映射文件：
执行方法，测试

编写接口方法：Mapper接口
- 参数：无
  
  查询所有数据功能是不需要根据任何条件进行查询的，所以此方法不需要参数。
- 结果：List
  
  我们会将查询出来的每一条数据封装成一个 Brand 对象，而多条数据封装多个 Brand 对象，需要将这些对象封装到List集合中返回。
- 执行方法、测试

5.2.1 编写接口方法

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

package com.mapper;import com.test.Brand;
import java.util.List;public interface BrandMapper {/***查询所有*/List<Brand> selectAll();
}

在这里插入图片描述

5.2.2 编写SQL语句

在 reources 下创建 com/mapper 目录结构，并在该目录下创建名为 BrandMapper.xml 的映射配置文件

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mapper namespace="com.mapper.BrandMapper"><select id="selectAll" resultType="brand">select *from tb_brand;</select>
</mapper>

在这里插入图片描述

5.2.3 编写测试方法

在 MybatisTest 类中编写测试查询所有的方法

@Test
public void testSelectAll() throws IOException {//1. 获取SqlSessionFactoryString 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.selectAll();System.out.println(brands);//5. 释放资源sqlSession.close();}

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

执行测试方法结果如下：

在这里插入图片描述

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

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

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

5.2.4 起别名解决上述问题

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

在这里插入图片描述

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

<select id="selectAll" resultType="brand">selectid, brand_name as brandName, company_name as companyName, ordered, description, statusfrom 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.起别名：对不一样的列表起别名，让别名和实体类的属性名一样
*缺点：每次查询都要定义一次别名
*SQL片段
*缺点：不灵活，如果查询的内容不一样，需要重新定义片段
2.resultMap：

1.定义标签

2.在标签中，使用resultMap属性替换resultType属性

5.2.5 使用resultMap解决上述问题

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

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

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

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

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

SQL语句正常编写

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

在这里插入图片描述

5.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>

5.3 查询详情

在这里插入图片描述

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

查看详情功能实现步骤：

编写接口方法：Mapper接口
- 参数：id
  
  查看详情就是查询某一行数据，所以需要根据id进行查询。而id以后是由页面传递过来。
- 结果：Brand
  
  根据id查询出来的数据只要一条，而将一条数据封装成一个Brand对象即可
编写SQL语句：SQL映射文件
执行方法、进行测试

5.3.1 编写接口方法

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

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

在这里插入图片描述

5.3.2 编写SQL语句

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

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

在这里插入图片描述

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

5.3.3 编写测试方法

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

 @Test
public void testSelectById() throws IOException {//接收参数，该id以后需要传递过来int id = 1;//1. 获取SqlSessionFactoryString 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. 执行方法Brand brand = brandMapper.selectById(id);System.out.println(brand);//5. 释放资源sqlSession.close();
}

在这里插入图片描述

执行测试方法结果如下：

在这里插入图片描述

5.3.4 参数占位符

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

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

#{} ：执行SQL时，会将 #{} 占位符替换为？，将来自动设置参数值。从上述例子可以看出使用#{} 底层使用的是 PreparedStatement
${} ：拼接SQL。底层使用的是 Statement，会存在SQL注入问题。如下图将映射配置文件中的 #{} 替换成 ${} 来看效果
```
<select id="selectById"  resultMap="brandResultMap">select *from tb_brand where id = ${id};
</select>
```
重新运行查看结果如下：

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

5.3.5 parameterType使用

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

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

5.3.6 SQL语句中特殊字段处理

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

在这里插入图片描述

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

转义字符

下图的 < 就是 < 的转义字符。
<![CDATA[内容]]>
总结：
1. 参数占位符：
  - #{}：执行SQL时，会将#{}占位符替换为?,将来自动设置参数值
  - ${}：拼SQL。会存在SQL注入问题
  - 使用时机：
    - 参数传递，都使用#{}
    - 如果要对表名、列名进行动态设置，只能使用${}进行sql拼接。
2. parameterType：
  
  用于设置参数类型，该参数可以省略
3. SQL 语句中特殊字符处理：
  - 转义字符
  - <![CDATA[ 内容 ]]>:CD提示

5.4 多条件查询

在这里插入图片描述

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

条件表达式
如何连接

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

在这里插入图片描述

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

编写接口方法
- 参数：所有查询条件
- 结果：List
在映射配置文件中编写SQL语句
编写测试方法并执行

5.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);
```

5.4.2 编写SQL语句

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

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

在这里插入图片描述

5.4.3 编写测试方法

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

方法一：散装参数：如果方法中有多个参数，需要使用@Param(“SQL参数占位符名称”)

@Testpublic void testSelectByCondition() throws IOException {//接收参数int status = 1;String companyName = "华为";String brandName = "华为";//参数处理companyName = "%" + companyName + "%";brandName = "%" + brandName + "%";//1. 获取SqlSessionFactoryString 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.selectByCondition(status, companyName, brandName);System.out.println(brands);//5. 释放资源sqlSession.close();}

在这里插入图片描述

方法二：对象参数。将多个参数封装成一个实体对象，将该实体对象作为接口的方法参数。

@Testpublic void testSelectByCondition() 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. 获取SqlSessionFactoryString 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.selectByCondition(brand);System.out.println(brands);//5. 释放资源sqlSession.close();}

在这里插入图片描述

方法三：方法三：将多个参数封装到map集合中，将map集合作为接口的方法参数。

@Testpublic void testSelectByCondition() throws IOException {//接收参数int status = 1;String companyName = "华为";String brandName = "华为";//参数处理companyName = "%" + companyName + "%";brandName = "%" + brandName + "%";Map map = new HashMap();map.put("status" , status);map.put("companyName", companyName);map.put("brandName" , brandName);//1. 获取SqlSessionFactoryString 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.selectByCondition(map);System.out.println(brands);//5. 释放资源sqlSession.close();}

在这里插入图片描述

总结：

SQL语句设置多个参数有几种方式？

散装参数：需要使用@Param(“SQL中的参数名称”)

使用麻烦

实体类封装参数
- 只需要保证SQL中的参数名和实体类属性名对应上，即可设置成功
map集合
- 只需要保证SQL中的参数名和 map集合的键的名称对应上，即可设置成功

5.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}

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

if

choose (when, otherwise)

trim (where, set)

foreach

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

if 标签：条件判断

test 属性：逻辑表达式

<select id="selectByCondition" resultMap="brandResultMap">select *from tb_brandwhere<if test="status != null">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>

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

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

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

执行结果如下：

在这里插入图片描述

拼接的SQL语句就变成了

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

而上面的语句中 where 关键后直接跟 and 关键字，这就是一条错误的SQL语句。可以在SQL语句中加入恒等式。如下：

<select id="selectByCondition" resultMap="brandResultMap">select *from tb_brandwhere 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>

在mybatis中，可以使用标签来替换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 关键字。

总结：

if：用于判断参数是否有值，使用test属性进行条件判断
- 存在的问题：第一个条件不需要逻辑运算符
- 解决方案：
  1. 使用恒等式让所有条件格式都一样
  2. 标签替换 where 关键字

5.5 单个条件查询（动态SQL）

在这里插入图片描述

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

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

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

5.5.1 编写接口方法

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

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

5.5.2 编写SQL语句

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

<select id="selectByConditionSingle" resultMap="brandResultMap">select *from tb_brandwhere<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></select>

此时，如果传入的传入的参数为空，则查询语句为：

select * from tb_brand where;

则会出现错误。

在这里插入图片描述

此时,可将SQL语句中加入恒等式:

标签的作业是当用户选择为空时，自动在SQL语句where后面加入恒等式，保证SQL语句不会出错。当有用户有选择时，则标签内容不会生效。相当于java中Switch语句中的default标签。

<select id="selectByConditionSingle" resultMap="brandResultMap">select *from tb_brandwhere<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><otherwise>1=1</otherwise></choose>

在这里插入图片描述

当然，结合上一个例子当中，我们可以直接将where替换为标签

<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>

5.5.3 编写测试方法

在 test/java 下的 com.itheima.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. 获取SqlSessionFactoryString 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();
}

执行测试方法结果如下：

在这里插入图片描述

5.6 添加数据

在这里插入图片描述

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

编写接口方法

参数：除了id之外的所有的数据。id对应的是表中主键值，而主键我们是自动增长生成的。
编写SQL语句
编写测试方法并执行

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

5.6.1 编写接口方法

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

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

在这里插入图片描述

5.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>

在这里插入图片描述

5.6.3 编写测试方法

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

@Test
public void testAdd() throws IOException {//接收参数int status = 1;String companyName = "波导手机";String brandName = "波导";String description = "手机中的战斗机";int ordered = 100;//封装对象Brand brand = new Brand();brand.setStatus(status);brand.setCompanyName(companyName);brand.setBrandName(brandName);brand.setDescription(description);brand.setOrdered(ordered);//1. 获取SqlSessionFactoryString 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.add(brand);//提交事务sqlSession.commit();//5. 释放资源sqlSession.close();
}

执行结果如下：

在这里插入图片描述

MyBatis事务：
- openSession()：默认开启事务，进行增删改操作后需要使用 sqlSession.commit(); 手动提交事务
- openSession(true)：可以设置为自动提交事务（关闭事务）

5.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 ：指定将获取到的主键值封装到哪儿个属性里

在测试方法中进行测试：

@Testpublic void testAdd() throws IOException {//接收参数int status = 1;String companyName = "波导手机";String brandName = "波导";String description = "手机中的战斗机";int ordered = 100;//封装对象Brand brand = new Brand();brand.setStatus(status);brand.setCompanyName(companyName);brand.setBrandName(brandName);brand.setDescription(description);brand.setOrdered(ordered);//1. 获取SqlSessionFactoryString 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.add(brand);Integer id = brand.getId();System.out.println(id);//提交事务sqlSession.commit();//5. 释放资源sqlSession.close();}

在这里插入图片描述

总结：

返回添加数据的主键

5.7 修改

在这里插入图片描述

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

接下来我们就具体来实现

修改全部字段

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

  /*** 修改*/
int update(Brand brand);

编写SQL语句

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

编写测试方法：

	@Testpublic void testUpdate() throws IOException {//接收参数int status = 1;String companyName = "波导手机";String brandName = "波导";String description = "波导手机,手机中的战斗机";int ordered = 200;int id=5;//封装对象Brand brand = new Brand();brand.setStatus(status);brand.setCompanyName(companyName);brand.setBrandName(brandName);brand.setDescription(description);brand.setOrdered(ordered);brand.setId(id);//1. 获取SqlSessionFactoryString 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. 执行方法int count = brandMapper.update(brand);System.out.println(count);//提交事务sqlSession.commit();//5. 释放资源sqlSession.close();}

在这里插入图片描述

通过上述方法修改，如果我们要修改部分内容，则没用重新提交的数据会被设置为null，即不会保留之前的内容，显然是不符合的。所以这种情况下需要动态修改。

修改动态字段：

5.7.1 编写接口方法

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

 /*** 修改*/
int update(Brand brand);

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

5.7.2 编写SQL语句

在 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 标签可以用于动态包含需要更新的列，忽略其它不更新的列。原理同之前将where修改为标签一样。

5.7.3 编写测试方法

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

@Testpublic void testUpdate() throws IOException {//接收参数int status = 0;String companyName = "波导手机";String brandName = "波导";String description = "波导手机,手机中的战斗机";int ordered = 100;int id=5;//封装对象Brand brand = new Brand();brand.setStatus(status);//brand.setCompanyName(companyName);//brand.setBrandName(brandName);//brand.setDescription(description);brand.setOrdered(ordered);brand.setId(id);//1. 获取SqlSessionFactoryString 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. 执行方法int count = brandMapper.update(brand);System.out.println(count);//提交事务sqlSession.commit();//5. 释放资源sqlSession.close();}

执行测试方法结果如下：

在这里插入图片描述

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

5.8 删除一行数据

在这里插入图片描述

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

接下来就来实现该功能。

5.8.1 编写接口方法

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

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

5.8.2 编写SQL语句

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

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

5.8.3 编写测试方法

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

 @Test
public void testDeleteById() throws IOException {//接收参数int id = 5;//1. 获取SqlSessionFactoryString 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.deleteById(id);//提交事务sqlSession.commit();//5. 释放资源sqlSession.close();
}

在这里插入图片描述

运行过程只要没报错，直接到数据库查询数据是否还存在。

5.9 批量删除

在这里插入图片描述

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

5.9.1 编写接口方法

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

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

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

1.9.2 编写SQL语句

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

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

foreach 标签

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

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

<delete id="deleteByIds">delete from tb_brand where idin<!--(<foreach collection="array" separator="," item="id">#{id}</foreach>)--><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);

collection中使用默认的方式遍历获取元素：

在这里插入图片描述

使用@Param注解改变map集合的默认key的名称：

在这里插入图片描述

5.9.3 编写测试方法

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

@Test
public void testDeleteByIds() throws IOException {//接收参数int[] ids = {1,3};//1. 获取SqlSessionFactoryString 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();
}

5.10 Mybatis参数传递

Mybatis 接口方法中可以接收各种各样的参数，如下：

多个参数
单个参数：单个参数又可以是如下类型
- POJO 类型
- Map 集合类型
- Collection 集合类型
- List 集合类型
- Array 类型
- 其他类型

Mybatis底层对于这些参数进行不同的封装处理方式。（Mybatis提供了ParamNameResolve类来进行参数封装）

5.10.1 多个参数

如下面的代码，就是接收两个参数，而接收多个参数需要使用 @Param 注解，那么为什么要加该注解呢？这个问题要弄明白就必须来研究Mybatis 底层对于这些参数是如何处理的。

User select(@Param("username") String username,@Param("password") String password);

<select id="select" resultType="user">select *from tb_userwhere username=#{username}and password=#{password}
</select>

我们在接口方法中定义多个参数，Mybatis 会将这些参数封装成 Map 集合对象，值就是参数值，而键在没有使用 @Param 注解时有以下命名规则：

以 arg 开头：第一个参数就叫 arg0，第二个参数就叫 arg1，以此类推。如：

map.put(“arg0”，参数值1);

map.put(“arg1”，参数值2);
以 param 开头：第一个参数就叫 param1，第二个参数就叫 param2，依次类推。如：

map.put(“param1”，参数值1);

map.put(“param2”，参数值2);

代码验证：

在 UserMapper 接口中定义如下方法

User select(String username,String password);

在 UserMapper.xml 映射配置文件中定义SQL

<select id="select" resultType="user">select *from tb_userwhere username=#{arg0}and password=#{arg1}
</select>

或者

<select id="select" resultType="user">select *from tb_userwhere username=#{param1}and password=#{param2}
</select>

测试方法：

@Testpublic void testSelect() throws IOException {String username="zhangsan";String password="123";//1. 获取SqlSessionFactoryString 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接口的代理对象UserMapper userMapper = sqlSession.getMapper(UserMapper.class);//4. 执行方法User user = userMapper.select(username, password);System.out.println(user);//5. 释放资源sqlSession.close();}

运行代码结果如下

在映射配合文件的SQL语句中使用用 arg 开头的和 param 书写，代码的可读性会变的特别差，此时可以使用 @Param 注解，来替换默认集合中默认的arg键名。

在接口方法参数上使用 @Param 注解，Mybatis 会将 arg 开头的键名替换为对应注解的属性值。

代码验证：

在 UserMapper 接口中定义如下方法，在 username 参数前加上 @Param 注解
```
User select(@Param("username") String username, String password);
```
Mybatis 在封装 Map 集合时，键名就会变成如下：

map.put(“username”，参数值1);

map.put(“arg1”，参数值2);

map.put(“param1”，参数值1);

map.put(“param2”，参数值2);

在 UserMapper.xml 映射配置文件中定义SQL

<select id="select" resultType="user">select *from tb_userwhere username=#{username}and password=#{param2}
</select>

运行程序结果没有报错。而如果将 #{} 中的 username 还是写成 arg0

<select id="select" resultType="user">select *from tb_userwhere username=#{arg0}and password=#{param2}
</select>

运行程序则可以看到错误

结论：以后接口参数是多个时，在每个参数上都使用 @Param 注解。这样代码的可读性更高。

5.10.2 单个参数

POJO 类型

直接使用。要求 属性名 和 参数占位符名称 一致
Map 集合类型

直接使用。要求 map集合的键名 和 参数占位符名称 一致
Collection 集合类型

Mybatis 会将集合封装到 map 集合中，如下：

map.put(“arg0”，collection集合);

map.put(“collection”，collection集合;

可以使用 @Param 注解替换map集合中默认的 arg 键名。
List 集合类型

Mybatis 会将集合封装到 map 集合中，如下：

map.put(“arg0”，list集合);

map.put(“collection”，list集合);

map.put(“list”，list集合);

可以使用 @Param 注解替换map集合中默认的 arg 键名。
Array 类型

Mybatis 会将集合封装到 map 集合中，如下：

map.put(“arg0”，数组);

map.put(“array”，数组);

可以使用 @Param 注解替换map集合中默认的 arg 键名。
其他类型

比如int类型，参数占位符名称 叫什么都可以。尽量做到见名知意

六、注解实现CRUD

使用注解开发会比配置文件开发更加方便。如下就是使用注解进行开发

@Select(value = "select * from tb_user where id = #{id}")
public User select(int id);

注意：

注解是用来替换映射配置文件方式配置的，所以使用了注解，就不需要再映射配置文件中书写对应的 statement

Mybatis 针对 CURD 操作都提供了对应的注解，已经做到见名知意。如下：

查询：@Select
添加：@Insert
修改：@Update
删除：@Delete

接下来我们做一个案例来使用 Mybatis 的注解开发

代码实现：

将之前案例中 UserMapper.xml 中的根据id查询数据的 statement 注释掉
在 UserMapper 接口的 selectById 方法上添加注解
运行测试程序也能正常查询到数据

这里只演示这一个查询的注解开发，其他的都是类似的。

==注意：==在官方文档中 入门 中有这样的一段话：

在这里插入图片描述

所以，注解完成简单功能，配置文件完成复杂功能。

而我们之前写的动态 SQL 就是复杂的功能，如果用注解使用的话，就需要使用到 Mybatis 提供的SQL构建器来完成，而对应的代码如下：

在这里插入图片描述

上述代码将java代码和SQL语句融到了一块，使得代码的可读性大幅度降低。