随笔- 143 文章- 0 评论- 0 阅读- 4417

mybatis 全局配置文件

1. 全局配置文件

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  "https://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
  <!-- 环境变量列表 -->  
  <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 映射文件列表 -->  
  <mappers>
    <mapper resource="org/mybatis/example/BlogMapper.xml"/>
  </mappers>
</configuration>

官网完整的配置

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

1.1 properties

<!-- 定义 properties -->
<properties>
    <property name="jdbc.driver" value="com.mysql.jdbc.Driver" />
    <property name="jdbc.url" value="jdbc:mysql://localhost:3306/test" />
    <property name="jdbc.username" value="root"/>
    <property name="jdbc.password" value="root"/>
</properties>

对于关键信息配置，常见做法是独立一个配置文件，通过 resource 引入这个配置文件，如： <properties resource="org/mybatis/example/config.properties" />

1.2 settings 全局设置

<settings>
    <!-- 缓存开关（二级缓存） -->
    <setting name="cacheEnabled" value="true"/>
    <!-- 一级缓存 -->
    <setting name="localCacheScope" value="SESSION"/>
    
    <!-- 懒加载配置 -->
    <setting name="lazyLoadingEnabled" value="true"/>
    <setting name="aggressiveLazyLoading" value="true"/>
    <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
    
    <!-- 自动映射配置 -->
    <setting name="autoMappingBehavior" value="PARTIAL"/>
    <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
    <setting name="mapUnderscoreToCamelCase" value="false"/>
    
    <!-- 日志配置，STDOUT_LOGGING -->
    <setting name="logPrefix" value="exampleLogPreFix_"/>
    <setting name="logImpl" value="SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING"/>
    
     <!-- 查询结果为空时，默认是直接返回 null，如果配置成 true 会返回一个空对象（对象不为空，所有属性没有值）-->
    <setting name="returnInstanceForEmptyRow" value="false"/>
    <!-- 字段为空是否映射到实体属性（调用 setter，如果是 map 就是 put 方法）对 map 有影响-->
    <setting name="callSettersOnNulls" value="false"/>
    <!-- 是否允许单一语句返回多结果集，这个不用想肯定要打开 -->
    <setting name="multipleResultSetsEnabled" value="true"/>
    <!-- 使用列标签代替列名 -->
    <setting name="useColumnLabel" value="true"/>
    <!-- 允许 JDBC 支持自动生成主键 -->
    <setting name="useGeneratedKeys" value="false"/>
    <!-- 配置默认的执行器 -->
    <setting name="defaultExecutorType" value="SIMPLE"/>
    <!-- 设置超时时间，单位秒，默认为空 -->
    <setting name="defaultStatementTimeout" value="25"/>
    <!-- 一次性返回多少数据，默认是 null 返回全部 -->
    <setting name="defaultFetchSize" value="100"/>
    <!-- 分页设置。mybatis 自带的分页是内存中的假分页，不要用 -->
    <setting name="safeRowBoundsEnabled" value="false"/>
    <!-- 是否允许在嵌套语句中使用结果处理器。一对多多对多场景，肯定也要映射结果撒 -->
    <setting name="safeResultHandlerEnabled" value="true"/>
    <!-- 指定动态 SQL 生成使用的默认脚本语言。也就是处理动态sql的类 -->
    <setting name="defaultScriptingLanguage" value="org.apache.ibatis.scripting.xmltags.XMLLanguageDriver"/>
    <!-- 上面是处理动态 SQL，这个是来处理枚举的 -->
    <setting name="defaultEnumTypeHandler" value="org.apache.ibatis.type.EnumTypeHandler"/>
    
    <!-- 不常用的 -->
    <setting name="proxyFactory" value="CGLIB | JAVASSIST"/>
    <setting name="vfsImpl" value="org.mybatis.example.YourselfVfsImpl"/>
    <setting name="useActualParamName" value="true"/>
    <setting name="configurationFactory" value="org.mybatis.example.ConfigurationFactory"/>
    <setting name="jdbcTypeForNull" value="OTHER"/>
</settings>

缓存配置开关：mybatis 分为一级缓存、二级缓存、自定义的三级缓存，后面专门讲
懒加载配置
1. 只配置 lazyLoadingEnabled，所有方法都懒加载（但是有些特殊方法不能懒加载）
2. aggressiveLazyLoading 简而言之是有特殊方法不懒加载，lazyLoadTriggerMethods 指明哪些是特殊方法
自动映射配置
1. autoMappingBehavior：查询结果列和实体属性怎么映射
  1. NONE 不映射；
  2. PARTIAL 是集合的字段不映射；
  3. FULL 集合字段也映射
2. autoMappingUnknownColumnBehavior：查询结果列对应不上实体属性怎么处理
  1. NONE 不做任何反应
  2. WARNING 日志输出警告（日志是 warning 级别，AutoMappingUnknownColumnBehavior）
  3. FAILING 抛异常（SqlSessionException）
3. mapUnderscoreToCamelCase：查询结果列自动转驼峰

1.3 typeAliases 别名配置

别名配置，两种方式

方式一

<typeAliases>
  <typeAlias alias="Author" type="domain.blog.Author"/>
  <typeAlias alias="Blog" type="domain.blog.Blog"/>
</typeAliases>

方式二

配置文件中只写包名，这个包下的 java 类都会以类名作为别名（第一个字幕小写）
```
<typeAliases>
  <package name="domain.blog"/>
</typeAliases>
```
如果包下的某个类不想使用默认的别名，还可以单独配置
```
// 默认是 author，使用注解 @Alias 自定义别名
@Alias("author1")
public class Author {
    ...
}
```

1.4 typeHandlers 类型处理器

类型处理器，sql 查询结果字段的 jdbc 类型处理成 java 类型，比如 jdbc 的 datetime、varchar 转为 java 的 Date、String 等

有需要可以自定义类型处理器，继承 BaseTypeHandler 重写里面的方法即可。比如数据脱敏，性别枚举转换等

一般不会全局配置类型处理器，某个表的个别字段单独处理处理

1.5 plugins 插件配置

非常重要，后面专门讲插件

1.6 environments 环境配置

用来配置数据环境的，事务、数据源、连接使用池化技术等，可以配置多个，但是必须指定一个作为默认环境

虽然可以使用多个环境，但是每个 SqlSessionFactory 实例只能选择一种环境

配置示例：

<environments default="dev">
    <!-- 开发环境 -->
    <environment id="dev">
        <!-- 事务管理器，可选 JDBC 和 MANAGED，默认是 JDBC -->
        <transactionManager type="JDBC">
            <!-- 跳过自动提交 -->
        	<property name="skipSetAutoCommitOnClose" value="true" />
        </transactionManager>
        <!-- 数据源，不使用数据库连接池，也就不用配置最大连接数等 -->
        <dataSource type="UNPOOLED">
            <property name="driver" value="${driver}"/>
            <property name="url" value="${url}"/>
            <property name="username" value="${username}"/>
            <property name="password" value="${password}"/>
        </dataSource>
    </environment>
    
    <!-- 测试环境 -->
    <environment id="sit">
        ...
    </environment>
    
    <!-- 准生产环境 -->
    <environment id="uat">
        ...
    </environment>
    
    <!-- 生产环境 -->
    <environment id="prod">
        ...
    </environment>
</environments>

环境配置又分为两部分：事务管理器 和 数据源

事务管理器
1. 事务包含 3 个步骤，提交、回滚、关闭连接。为了统一，所有的数据库对应的数据管理器都会有这三个步骤，但是某些数据库不仅不需要，反而变麻烦了，比如 mysql 本身就是启用了自动提交，这里为了统一还是为启用事务、然后再提交。可以配置 skipSetAutoCommitOnClose = true 来跳过自动提交步骤
2. 可选的有 JDBC 和 MANAGED。JDBC：使用 JDBC 的事务管理器，MANAGED：自身不会实现事务管理，使用 web 容器（如 EJB，webLogic）来实现，如果是不是 web 项目，意味着事务会无效。 JDBC 和 MANAGED 其实是个别名，分别对应 JdbcTransaction 和 ManagedTransaction 两个类来实现的
3. 如果是 spring 项目，不用配置事务管理器了，因为 Spring 模块会使用自带的管理器来覆盖前面的配置，具体的实现类是 SpringManagedTransaction
数据源
1. 包含数据库连接信息、用户名、密码、超时、隔离级别
2. 可选的类型有三个：UNPOOLED、POOLED、JNDI 。UNPOOLED：不适用池化技术；POOLED：使用池化技术，意味着配置信息在 UNPOOLED 的基础上还能配置连接池信息，比如最大连接数、连接空闲存活时间等；JNDI：同事务管理的，也是兼容 EJB 这些容器的，现在的项目都没这些老古董了

1.7 mappers 映射器配置

mybatis 的全局配置已经 ok 了，现在就该轮到各个映射文件了，首先要知道这些文件在什么地方，多种方式来指定，如下：

<!-- 使用相对于类路径的资源引用 -->
<mappers>
  <mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
  <mapper resource="org/mybatis/builder/BlogMapper.xml"/>
  <mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>

<!-- 使用完全限定资源定位符（URL） -->
<mappers>
  <mapper url="file:///var/mappers/AuthorMapper.xml"/>
  <mapper url="file:///var/mappers/BlogMapper.xml"/>
  <mapper url="file:///var/mappers/PostMapper.xml"/>
</mappers>

<!-- 使用映射器接口实现类的完全限定类名 -->
<mappers>
  <mapper class="org.mybatis.builder.AuthorMapper"/>
  <mapper class="org.mybatis.builder.BlogMapper"/>
  <mapper class="org.mybatis.builder.PostMapper"/>
</mappers>

<!-- 将包内的映射器接口全部注册为映射器 -->
<mappers>
  <package name="org.mybatis.builder"/>
</mappers>