Mybatis 配置文件深入

1. 核心配置文件 SqlMapConfig.xml

1.1. MyBatis 核心配置文件层级关系

2. MyBatis 常用配置解析

2.1. environments 标签

数据库环境的配置，支持多环境配置

事务管理器（transactionManager）类型有两种：

• JDBC：这个配置就是直接使用了JDBC 的提交和回滚设置，它依赖于从数据源得到的连接来管理事务作用域。
• MANAGED：这个配置几乎没做什么。它从来不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如 JEE 应用服务器的上下文）。 默认情况下它会关闭连接，然而一些容器并不希望这样，因此需要将 closeConnection 属性设置为 false 来阻止它默认的关闭行为。

数据源（dataSource）类型有三种：

• UNPOOLED：这个数据源的实现只是每次被请求时打开和关闭连接。
• POOLED：这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来。
• JNDI：这个数据源的实现是为了能在如 EJB 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的引用。

2.2. mapper 标签

该标签的作用是加载映射的，加载方式有如下几种：

• 使用相对于类路径的资源引用，例如：<mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
• 使用完全限定资源定位符（URL），例如：<mapper url="file:///var/mappers/AuthorMapper.xml"/>
• 使用映射器接⼝实现类的完全限定类名，例如：<mapper class="org.mybatis.builder.AuthorMapper"/>
• 将包内的映射器接⼝实现全部注册为映射器，例如：<package name="org.mybatis.builder"/>

2.3. Properties 标签

实际开发中，习惯将数据源的配置信息单独抽取成一个 properties 文件，该标签可以加载额外配置的 properties 文件。

• jdbc.properties

driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql:///mybatis
username=root
password=123456

2.4. typeAliases 标签

类型别名是为 Java 类型设置一个短的名字。原来的类型名称配置如下：

配置 typeAliases，为 com.lagou.domain.User 定义别名为 user

上面我们是自定义的别名，mybatis 框架已经为我们设置好的一些常用的类型的别名

3. 映射配置文件 mapper.xml

3.1. 动态 sql 语句

3.1.1. 动态 sql 语句概述

Mybatis 的映射文件中，前面我们的 SQL 都是比较简单的，有些时候业务逻辑复杂时，我们的 SQL 是动态变化的，此时在前面的学习中我们的 SQL 就不能满足要求了。

参考的官方文档，描述如下：

3.1.2. 动态 SQL 之 if

我们根据实体类的不同取值，使用不同的 SQL 语句来进行查询。比如在 id 如果不为空时可以根据 id 查询，如果 username 不为空时还要加入用户名作为条件。这种情况在我们的多条件组合查询中经常会碰到。

<select id="findByCondition" parameterType="user" resultType="user">
  SELECT * FROM  user
  <where>
    <if test="id !=null">
      and id = #{id}
    </if>
    <if test="username !=null">
      and username = #{username}
    </if>
  </where>
</select>

当查询条件 id 和 username 都存在时，控制台打印的 sql 语句如下：

@Test
public void test7() throws IOException {
    InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
    SqlSession sqlSession = sqlSessionFactory.openSession();
    
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    
    User user1 = new User();
    user1.setId(1);
    user1.setUsername("lucy");
    
    List<User> all = mapper.findByCondition(user1);
    for (User user : all) {
        System.out.println(user);
    }
    
    sqlSession.close();
}

当查询条件只有 id 存在时，控制台打印的 sql 语句如下：

@Test
public void test7() throws IOException {
    InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
    SqlSession sqlSession = sqlSessionFactory.openSession();
    
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    
    User user1 = new User();
    user1.setId(1);
    
    List<User> all = mapper.findByCondition(user1);
    for (User user : all) {
        System.out.println(user);
    }
    
    sqlSession.close();
}

3.1.3. 动态 SQL 之 foreach

循环执行 sql 的拼接操作，例如：

SELECT * FROM USER WHERE id IN (1,2,5)

<select id="findByIds" parameterType="list" resultType="user">
  SELECT * FROM  user
  <where>
    <foreach collection="array" open="id in (" close=")" item="id" separator=",">
      #{id}
    </foreach>
  </where>
</select>

测试代码片段如下：

@Test
public void test8() throws IOException {
    InputStream resourceAsStream = Resources.getResourceAsStream("sqlMapConfig.xml");
    SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(resourceAsStream);
    SqlSession sqlSession = sqlSessionFactory.openSession();
    
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    int[] arr = {1, 2};
    
    List<User> all = mapper.findByIds(arr);
    for (User user : all) {
        System.out.println(user);
    }
}

foreach 标签用于遍历集合，它的属性：

• collection：代表要遍历的集合元素，注意编写时不要写 #{}
• open：代表语句的开始部分
• close：代表结束部分
• item：代表遍历集合的每个元素，生成的变量名
• sperator：代表分隔符

3.1.5. SQL 片段抽取

sql 中可将重复的 sql 提取出来，使用时用 include 引用即可，最终达到 sql 重用的目的。

<sql id="selectUser">
  SELECT * FROM  user
</sql>

<select id="findByIds" parameterType="list" resultType="user">
  <include refid="selectUser"/>
  <where>
    <foreach collection="array" open="id in (" close=")" item="id" separator=",">
      #{id}
    </foreach>
  </where>
</select>