Mybatis配置解析

配置mybatis-config.xml

MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。 配置文档的顶层结构如下：

• configuration（配置）
• properties（属性）
• settings（设置）
• typeAliases（类型别名）
• typeHandlers（类型处理器）
• objectFactory（对象工厂）
• plugins（插件）
  • environments（环境配置）
  • environment（环境变量）
  • transactionManager（事务管理器）
  • dataSource（数据源）
• databaseIdProvider（数据库厂商标识）
• mappers（映射器）

掌握

环境配置（environments）

MyBatis 可以配置成适应多种环境，使用总标签的<environments default="development">default属性选择用那套配置，不过要记住：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境

在 MyBatis 中有两种类型的事务管理器（也就是 type="[JDBC|MANAGED]"），默认的事务管理器使用的是JDBC

在 MyBatis 中有三种内建的数据源类型（也就是 type="[UNPOOLED|POOLED|JNDI]"），默认的数据源使用的是POOLED，

UNPOOLED：不支持连接池

POOLED：支持连接池

JNDI：适应个别容器

属性（properties）

这些属性可以在外部进行配置，并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性，也可以在 properties 元素的子元素中设置（db.properties）

编写db.properties，此处就无序使用&amp;转义字符来表示&

driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT&useSSL=true
username=root
password=123456

在核心配置文件中引入

image-20200414191142121.png

Mybatis核心配置文件的标签顺序都是固定的，一定要按照顺序书写，若要写properties，则必须写在最前面

<!--引入外部文件-->
    <properties resource="db.properties"/>

    <!--配置，可多套配置，default表示默认使用配置-->
    <environments default="development">
        <environment id="development"><!--id为不重复单一标识符-->
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>

引入外部文件后，就可以动态获取要连接的数据库信息了

properties标签可以同时引入外部文件并添加额外的属性

<!--引入外部文件-->
<properties resource="db.properties">
    <property name="username" value="root"/>
    <property name="password" value="123456"/>
</properties>

此时若外部文件没有相同名称的属性，则可以获取对应属性，若外部文件存在同名属性，会使用外部文件的同名属性，例如此处外部文件存在username和password，所以即使在properties内设置了username和password，也会使用外部文件的username和password

可以直接引入外部文件

可以额外添加一些属性配置

若添加的属性配置与外部文件同名，会使用外部文件的

类型别名（typeAliases）

方式一：

类型别名可为 Java 类型设置一个缩写名字。 它仅用于 XML 配置，意在降低冗余的全限定类名书写

<typeAliases>
  <typeAlias alias="user" type="cn.yzx.pojo.User"/>
</typeAliases>

之后就可以在xml配置sql语句时，使用user来表示cn.yzx.pojo.User，它仅用于 XML 配置

方式二：

每一个在包 domain.blog 中的 Java Bean，在没有注解的情况下，会使用 Bean 的首字母小写的非限定类名来作为它的别名

<typeAliases>
  <package name="cn.yzx.pojo"/>
</typeAliases>

之后就可以使用User的首字母小写user来表示cn.yzx.pojo.User

可见，方式一可以自定义名称，方式二则是固定的，但是方式二可以使用注解来达到自定义名称的效果

@Alias("author")
public class Author {
    ...
}

定义类是，添加此注解，则使用方式二来配置别名，别名为注解中设置的别名

设置（settings）

这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为

image-20200414225203590.png image-20200414225218552.png

映射器（mappers）

<!-- 使用相对于类路径的资源引用 推荐 -->
<mappers>
  <mapper resource="cn/yzx/mapper/userMapper.xml"/>
</mappers>

<!-- 使用映射器接口实现类的完全限定类名 -->
<mappers>
  <mapper class="cn.yzx.mapper.userMapper.xml"/>
</mappers>

<!-- 将包内的映射器接口实现全部注册为映射器 -->
<mappers>
  <package name="cn.yzx.mapper"/>
</mappers>

注意：第二第三种方法，要求配置文件和实体类必须在同一包下，且名称相同，否则会报错，只要按照规矩使用，第三种方式还是很方便的，但是常用第一种方式，每一个实体类对应的mapper都必须在核心配置文件中进行注册

作用域

image-20200414232519251.png

SqlSessionFactoryBuilder

这个类可以被实例化、使用和丢弃，一旦创建了 SqlSessionFactory，就不再需要它了，因此 SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域（也就是局部方法变量）

SqlSessionFactory

SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例，因此 SqlSessionFactory 的最佳作用域是应用作用域，即项目启动生成，项目关闭释放

SqlSession

每个线程都应该有它自己的 SqlSession 实例。SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域，一次方法获取SqlSession 后而已多次获取Mapper进行操作，但最后一定要close，将连接归还给池，这样不会造成资源的浪费

结果集映射（精髓）

ResultMap元素是 MyBatis 中最重要最强大的元素。它可以让你从 90% 的 JDBC ResuleSets 数据提取代码中解放出来，并在一些情形下允许你进行一些 JDBC 不支持的操作

复盘一个错误：

首先将实体类中的一个属性名不与表中列名对应，比如表中为pwd，在实体类中改为password

image-20200415000027437.png

此时会出现如下错误

image-20200415003117261.png

可见，password的值都为null，这是因为

select * from user;
select id,name,pwd form user;

* 其实 就是全部属性名的简写，而此时实体类属性名与表属性名并不一致，导致查询出来的pwd值无法被正常读取

此时就需要使用结果集映射，简单的操作是不需要使用结果集映射的，因为mybatis简化的基础就是自动使用结果集映射

<select id="selectUsers" resultType="User">
  select
    id             as "id",
    name           as "userName",
    pwd           as "pwd"
  from some_table
  where id = #{id}
</select>

但此处用于展示例子，所以使用结果集映射来达到效果

image-20200415004302220.png

type为返回值类型，column为表中的属性名，property为实体类中的对应属性名，这样就映射成功了

image-20200415004350720.png

只需要对名称不同的属性进行映射即可