初学Mybatis之配置解析

MyBatis 中文网配置教程

mybatis-config.xml

环境配置（environments）

尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境

可以有多个 enviroment，但是 enviroments default（默认）只能指定一个

<environments default="development">
  <environment id="development">
    <transactionManager type="JDBC">
      <property name="..." value="..."/>
    </transactionManager>
    <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>

事务管理器配置：<transactionManager type="JDBC">

 这个配置直接使用了 JDBC 的提交和回滚，它依赖从数据源获得的连接来管理事务作用域

 MyBatis 中有两种类型的事务管理器：JDBC、MANAGED

数据源配置：<dataSource type="POOLED">

数据源的作用就是连接数据库（比如 dbcp、c3p0、druid、hikari）

 MyBatis 中有三种内建的数据源类型：

UNPOOLED（没有连接池）、POOLED（连接池）、JNDI（正常连接）

池：用完可以回收

POOLED 能使并发 Web 应用快速响应请求

MyBatis 默认事务管理器是 JDBC，默认连接池是 POOLED

属性（properties）

可以通过 properties 属性来实现引用配置文件

这些属性可以在外部进行配置，并可以进行动态替换

既可以在典型的 Java 属性文件中（db.properties）配置这些属性，也可以在 properties 元素的子元素中设置

在 resources 目录下创建 db.properties 文件

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=false&useUnicode=true&characterEncoding=UTF-8
username=root
password=root

mybatis-config.xml：

引入外部配置文件  <properties resource="db.properties"/>

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">

<!-- configuration核心配置文件 -->
<configuration>

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

    <environments default="development">
        <environment id="development">
            <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>

    <!-- 每一个Mapper.xml都需要在Mybatis核心配置文件中注册 -->
    <mappers>
        <mapper resource="com/demo/dao/UserMapper.xml"/>
    </mappers>

</configuration>

可以直接引入外部文件，也可以在其中增加一些属性配置

如果两个文件有同一个字段，优先使用外部配置文件

类型别名（typeAliases）

类型别名可为 Java 类型设置一个缩写名字

它仅用于 XML 配置，降低冗余的全限定类名书写

给实体类起别名，resultType 就可以使用别名

    <!-- 给实体类起别名 -->
    <typeAliases>
        <typeAlias type="com.demo.pojo.User" alias="User"/>
    </typeAliases>

 还可以通过扫描包的形式使用别名

指定一个包名，MyBatis 会在包名下搜索需要的 Java Bean

    <!-- 扫描实体类的包 -->
    <typeAliases>
        <package name="com.demo.pojo"/>
    </typeAliases>

扫描包的情况下，可以在实体类上增加注解指定别名，@Alias()

设置（settings）

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

<settings>
  <setting name="cacheEnabled" value="true"/>
  <setting name="lazyLoadingEnabled" value="true"/>
  <setting name="multipleResultSetsEnabled" value="true"/>
  <setting name="useColumnLabel" value="true"/>
  <setting name="useGeneratedKeys" value="false"/>
  <setting name="autoMappingBehavior" value="PARTIAL"/>
  <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
  <setting name="defaultExecutorType" value="SIMPLE"/>
  <setting name="defaultStatementTimeout" value="25"/>
  <setting name="defaultFetchSize" value="100"/>
  <setting name="safeRowBoundsEnabled" value="false"/>
  <setting name="mapUnderscoreToCamelCase" value="false"/>
  <setting name="localCacheScope" value="SESSION"/>
  <setting name="jdbcTypeForNull" value="OTHER"/>
  <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
</settings>

映射器（mappers） 

告诉 MyBatis 到哪去找映射文件

方法一：使用 resource 绑定注册

    <!-- 每一个Mapper.xml都需要在Mybatis核心配置文件中注册 -->
    <mappers>
        <mapper resource="com/demo/dao/UserMapper.xml"/>
    </mappers>

方法二：使用 class 绑定注册

    <mappers>
        <mapper class="com.demo.dao.UserMapper"/>
    </mappers>

注意：接口和 Mapper 配置文件必须同名且在同一个包下

方法三： 使用扫描包绑定注册

    <mappers>
        <package name="com.demo.dao"/>
    </mappers>

注意：接口和 Mapper 配置文件必须同名且在同一个包下