MyBatis的XML配置文件
Mybatis的开发有两种方式：
-
注解
-
XML配置文件
通过XML配置文件的形式来配置SQL语句，这份儿XML配置文件在MyBatis当中也称为XML映射文件。
导学：在MyBatis当中如何来定义一份儿XML映射文件？
在MyBatis当中，定义XML映射文件它是有一定的规范的。
2.1 XML配置文件规范
- 使用Mybatis的注解方式，主要是来完成一些简单的增删改查功能。
- 如果需要实现复杂的SQL功能，建议使用XML来配置映射语句，也就是将SQL语句写在XML配置文件中。
在Mybatis中使用XML映射文件方式开发，需要符合一定的规范 - XML映射文件定义规范：
XML映射文件的名称与Mapper接口名称保持一致，并且将XML映射文件和Mapper接口放置在相同包下（同包同名）- 在项目开发当中，一般都是一个接口对应一份儿映射配置文件；
XML映射文件的namespace{命名空间}属性与Mapper接口的全限定名{包名+接口名}一致；
XML映射文件中SQL语句的id与Mapper接口中的方法名一致，并保持返回类型一致。
- 通过以上的规则，MyBatis会在运行时动态生成Mapper接口的实现类，并根据接口方法的调用来查找对应的XML配置文件中的SQL语句，并执行该SQL语句，这样，就实现了Mapper接口方法与XML配置文件中SQL语句的关联。
- 在标准的Maven项目结构当中，java目录下存放的都是Java的源代码，而resources这个目录下存放的才是配置文件。
- 在映射配置文件当中来定义SQL语句。
- 每一个SQL语句都有一个唯一标识，就是它的id属性，这个id属性需要与Mapper接口的方法名保持一致。
-
resultType属性，指的是查询返回的单条记录所封装的类型。
2.2 XML配置文件实现
第1步：创建XML映射文件
注意：我们想要的包结构是一级一级的目录，如果用点来分隔，就会当成一个文件，目录之前的 分隔我们要使用斜杠/来分隔。
打开磁盘目录验证：
目录结构：
第2步：编写XML映射文件
- XML映射文件中的dtd约束，直接从MyBatis官网复制即可
配置XML文件的约束：
配置：XML映射文件的namespace属性为Mapper接口全限定名
- 在
标签当中，它有一个唯一的属性，就叫namespace命名空间， namespace属性需要与Mapper接口的全类名保持一致。
- XML配置文件的namespace属性与Mapper接口的全限定名一致！
配置：XML映射文件中sql语句的id与Mapper接口中的方法名一致，并保持返回类型一致
Mapper接口方法：
package com.gch.mapper;
import com.gch.pojo.Emp;
import org.apache.ibatis.annotations.*;
import java.time.LocalDate;
import java.util.List;
/**
加上@Mapper注解就代表程序在运行时会自动的创建该接口的代理对象,并且会将这个代理对象放入到IOC容器当中
*/
@Mapper
public interface EmpMapper {
/**
* 条件查询员工信息
* 基于XML映射文件的形式来配置SQL语句
* @param name => 查询的姓名
* @param gender => 查询的性别
* @param begin => 查询的入职时间
* @param end => 查询的离职时间
* @return => 把查询返回的多条记录封装到List集合里面
*/
public List select(String name, short gender, LocalDate begin, LocalDate end);
}
测试类：
package com.gch;
import com.gch.mapper.EmpMapper;
@SpringBootTest
class SpringbootMybatisCrudApplicationTests {
/**
从Spring的IOC容器当中,获取类型是EmpMapper的对象并注入
*/
@Autowired
private EmpMapper empMapper;
/**
* 条件查询
*/
@Test
public void testSelectList() {
// 调用查询方法查询员工信息,并将查询返回的结果使用List集合接收
List list = empMapper.select("张", (short) 1,
LocalDate.of(2010, 01, 01), LocalDate.of(2020, 01, 01));
// 遍历集合输出
list.stream().forEach(s ->{
System.out.println(s);
});
}
}
运行测试类，执行结果：
思考：在定义XML映射文件的时候，为什么要遵守这三点规范？
- 通过MyBatis这个框架来操作数据库，最终我们只需要调用Mapper接口当中的接口方法就可以完成数据库的操作，但是我们要明白，最终我们操作数据库并不是直接通过Mapper接口中的方法来操作数据库，而是执行了与该接口方法对应的SQL语句来完成数据库的操作。
思考：通过Mapper接口中的接口方法怎么找到与之关联的SQL语句？
- 如果使用注解的方式来进行配置，就不用思考这样的问题，因为使用注解的方式进行配置，我们执行这个接口方法，最终执行的不就是注解当中的SQL语句吗？SQL语句与Mapper接口中的接口方法是绑定在一起的。
- 但是如果我们采用XML配置文件的形式来配置SQL语句，Mapper接口中的接口方法的定义与XML配置文件当中配置的SQL语句，它们两是分开的，我们现在要做的就是根据Mapper接口中的接口方法来找到在XML配置文件当中配置的SQL语句。
- 如果我们按照规范来定义了这样一份儿XML配置文件，此时当我们调用Mapper接口当中的接口方法的时候，此时MyBatis框架就会自动的去查找namespace属性值与这个接口全类名相同的这份XML映射文件，并且在这份儿XML映射文件当中找到id属性值与方法名相同的这条SQL语句，最终来运行这条SQL语句，从而就完成了数据库的操作。
2.3 MybatisX的使用
- MybatisX是一款基于IDEA的快速开发Mybatis的插件，为效率而生。
- 通过MyBatisX这款插件就可以提高MyBatis的开发效率。
MybatisX的安装：
如图：
- 这只是IDEA的一个误报，IDEA识别错乱的一个问题；
- 在真实的企业开发当中，一个项目就是一个单独的工程，所以是不会出现这个问题的。
可以通过MybatisX快速定位：
MyBatisX的使用在后续学习中会继续分享...
学习了Mybatis中XML配置文件的开发方式了，大家可能会存在一个疑问：到底是使用注解方式开发还是使用XML方式开发？
官方说明：入门_MyBatis中文网
- 使用注解来映射简单语句会使代码显得更加简洁，但对于稍微复杂一点的语句，Java 注解不仅力不从心，还会让你本就复杂的 SQL 语句更加混乱不堪。 因此，如果你需要做一些很复杂的操作，最好用 XML 来映射语句。
- 选择何种方式来配置映射，以及认为是否应该要统一映射语句定义的形式，完全取决于你和你的团队。 换句话说，永远不要拘泥于一种方式，你可以很轻松的在基于注解和 XML 的语句映射方式间自由移植和切换。
结论：
- 使用Mybatis的注解，主要是来完成一些简单的增删改查功能。
- 如果需要实现复杂的SQL功能，建议使用XML来配置映射语句。