【MyBatis】基本使用配置文件 mybatis-conf.xml 详解

在上一篇【Mybatis】编程式使用（单用）及核心对象声明周期 我们说了使用 mybatis，但是还有一个问题解决，就是 MyBatis 的配置文件到底能配什么？怎么配？本篇我们就一起来看看。

大部分时候我们只需要很少的配置就可以让 MyBatis 运行起来。其实 MyBatis 里面提供的配置项非常多，我们没有配置的时候使用的是系统的默认值。

mybatis源码地址…

下面是一个 mybatis-conf.xml 示例，包括了我们下来要说的的标签

<?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><!-- 数据源设置，dp.propeties配置了数据源信息，可通过${}获取 --><propertiesresource="db.properties"></properties><settings><!-- 打印查询语句 --><settingname="logImpl"value="STDOUT_LOGGING"/><!-- 控制全局缓存（二级缓存）--><settingname="cacheEnabled"value="true"/><!-- 延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。默认 false  --><settingname="lazyLoadingEnabled"value="true"/><!-- 开启时，任何方法调用都会加载该对象所有属性(默认 false)，可通过select标签fetchType来覆盖 --><settingname="aggressiveLazyLoading"value="false"/><!--  Mybatis 创建具有延迟加载能力的对象所用到的代理工具，默认JAVASSIST --><settingname="proxyFactory"value="CGLIB"/><!-- STATEMENT级别的缓存，使一级缓存，只针对当前执行的这一statement有效 --><!--
                <setting name="localCacheScope" value="STATEMENT"/>
        --><settingname="localCacheScope"value="SESSION"/></settings><!-- 类别名，用来mapper.xml中简化参数长度--><typeAliases><typeAliasalias="blog"type="com.my.domain.Blog"/></typeAliases><!-- 类型处理器，用来对数据库类型与java类型转换 --><typeHandlers><typeHandlerhandler="com.my.type.MyTypeHandler"></typeHandler></typeHandlers><!-- 对象工厂，用来对查询结果创建java对象 --><!-- 注：调用时都走这个工厂，不过只有指定类型才会特殊处理--><objectFactorytype="com.my.objectfactory.MyObjectFactory"><propertyname="userName"value="666"/></objectFactory><plugins><plugininterceptor="com.my.interceptor.SQLInterceptor"><propertyname="gupao"value="betterme"/></plugin><plugininterceptor="com.my.interceptor.MyPageInterceptor"></plugin></plugins><environmentsdefault="development"><environmentid="development"><transactionManagertype="JDBC"/><!-- 单独使用时配置成MANAGED没有事务 --><dataSourcetype="POOLED"><propertyname="driver"value="${jdbc.driver}"/><propertyname="url"value="${jdbc.url}"/><propertyname="username"value="${jdbc.username}"/><propertyname="password"value="${jdbc.password}"/></dataSource></environment></environments><mappers><mapperresource="BlogMapper.xml"/><mapperresource="BlogMapperExt.xml"/><packagename="com.my.dao"/><!-- <mapper class="com.my.dao.BlogMapper"/>  --></mappers></configuration>

根标签configuration

configuration 是整个配置文件的根标签，实际上也对应着 MyBatis 里面最重要的配置类 Configuration。它贯穿 MyBatis执行流程的每一个环节。

注意：MyBatis全局配置文件顺序是固定的，否则启动的时候会报错。

1.properties

properties 标签用来配置参数信息，既可以是内部也可以死是外部的，比如最常见的数据库连接信息。

为了避免直接把参数写死在 xml 配置文件中，我们可以把这些参数单独放在 properties 文件中，用 properties 标签引入进来，然后在xml 配置文件中用 ${} 引用就可以了。引入配置文件时可以用 resource 引用应用里面的相对路径，也可以用 url 指定本地服务器或者网络的绝对路径。

<!-- 数据源设置，dp.propeties配置了数据源信息，可通过${}获取 --><propertiesresource="db.properties"></properties>

我们为什么要把这些配置独立出来？有什么好处？或者说，项目在打包的时候，有没有把 properties 文件打包进去？

• 利于多处引用，维护简单；
• 把配置文件放在外部，避免修改后重新编译打包，只需要重启应用；
• 程序和配置分离，提升数据的安全性，比如生产环境的密码只有运维人员掌握。

2.environments

environments 标签用来管理数据库的环境，比如我们可以有开发环境、测试环境、生产环境的数据库。可以在不同的环境中使用不同的数据库地址或者类型。

<environmentsdefault="development"><environmentid="development"><transactionManagertype="JDBC"/><!-- 单独使用时配置成MANAGED没有事务 --><dataSourcetype="POOLED"><propertyname="driver"value="${jdbc.driver}"/><propertyname="url"value="${jdbc.url}"/><propertyname="username"value="${jdbc.username}"/><propertyname="password"value="${jdbc.password}"/></dataSource></environment></environments>

一个environment标签就是一个数据源，代表一个数据库。这里面有两个关键的标签，一个是事务管理器，一个是数据源

• transactionManager：事务配置，这里有两个选项
  • JDBC，则会使用 Connection 对象的 commit()、rollback()、close() 管理事务。
  • MANAGED，会把事务交给容器来管理，比如 JBOSS，Weblogic。因为我们跑的是本地程序，如果配置成 MANAGE不会有任何事务。
• dataSource：在跟Spring集成的时候，事务和数据源都会交给Spring来管理。

PS：如果是 Spring + MyBatis ， 则没有必要配置transactionManager， 因为我们会直接在 applicationContext.xml 里面配置数据源，覆盖MyBatis的配置。

3.settings【重点】

setttings 里面是MyBatis的一些核心配置，下面只列出一些关键配置

4.typeAliases

TypeAlias是类型的别名，跟Linux系统里面的alias一样，主要用来简化全路径类名的拼写。

比如我们的参数类型和返回值类型都可能会用到我们的Bean，如果每个地方都配置全路径的话，那么内容就比较多，还可能会写错。我们可以单独指定某个Bean的别名，也可以指定一个package，自动转换。配置了别名以后，只需要写别名就可以了，比如com.my.domain.Blog都只要写blog就可以了。

MyBatis 里面有系统预先定义好的类型别名，在TypeAliasRegistry中。

5.typeHandlers【重点】

由于Java类型和数据库的 JDBC 类型不是一一对应的（比如String与varchar），所以我们把Java对象转换为数据库的值，和把数据库的值转换成 Java 对象，需要经过一定的转换，这两个方向的转换就要用到 TypeHandler。

1.默认转换器

我们可能会有疑问，我没有做任何的配置，为什么实体类对象里面的一个String属性，可以保存成数据库里面的 varchar 字段，或者保存成 char 字段？

这是因为 MyBatis 已经内置了很多 TypeHandler（在 type 包下），

它们全部全部注册在 TypeHandlerRegistry 中，并且继承了抽象类 BaseTypeHandler，泛型就是要处理的Java数据类型。

当我们做数据类型转换的时候，就会自动调用对应的TypeHandler的方法。

2.自定义转换器

如果我们需要自定义一些类型转换规则，或者要在处理类型的时候做一些特殊的动作，就可以编写自己的TypeHandler。

跟系统自定义的TypeHandler一样，继承抽象类BaseTypeHandler。有4个抽象方法必须实现，我们把它分成两类：

• set方法：Java类型 --> JDBC类型的
• get方法：JDBC类型 --> Java类型的。

比如我们想要在获取或者设置String类型的时候做一些特殊处理，我们可以写一个String类型的TypeHandler。步骤如下：

第一步，创建 MyTypeHandler继承BaseHandler

publicclassMyTypeHandlerextendsBaseTypeHandler<String>{@Override// Java类型 -->JDBC类型，设置 String 类型的参数的时候调用// 注意：只有在字段上添加typeHandler属性才会生效，sql字段上publicvoidsetNonNullParameter(PreparedStatement ps,int i, String parameter,
                                    JdbcType jdbcType)throws SQLException{// insertBlog name字段
        System.out.println("---------------setNonNullParameter1："+parameter);
        ps.setString(i, parameter);}@Override// JDBC类型 --> java类型，根据列名获取 String 类型的参数的时候调用// 注意：只有在字段上添加typeHandler属性才会生效，返回结果字段上public StringgetNullableResult(ResultSet rs, String columnName)throws SQLException{
        
        System.out.println("---------------getNullableResult1："+columnName);return rs.getString(columnName);}@Override// 根据下标获取 String 类型的参数的时候调用public StringgetNullableResult(ResultSet rs,int columnIndex)throws SQLException{
        System.out.println("---------------getNullableResult2："+columnIndex);return rs.getString(columnIndex);}@Overridepublic StringgetNullableResult(CallableStatement cs,int colIdx)throws SQLException{
        System.out.println("---------------getNullableResult3：");return cs.getString(colIdx);}}

第二步，注册到mybatis-config.xml中

<typeHandlers><typeHandlerhandler="com.my.type.MyTypeHandler"></typeHandler></typeHandlers>

第三步，在使用的字段上指定自定义TypeHandler

<insertid="insertBlog"parameterType="com.my.domain.Blog">
    insert into blog (bid, name, author_id) values (#{bid,jdbcType=INTEGER},<!-- 插入值的时候，从Java类型到JDBC类型，在字段属性中指定typehandler -->
    #{name,jdbcType=VARCHAR,typeHandler=com.my.type.MyTypeHandler},
    #{authorId,jdbcType=INTEGER})</insert>

返回值的时候，从JDBC类型到Java类型，在resultMap的列上指定typehandler

<resultcolumn="name"property="name"jdbcType="VARCHAR"typeHandler="com.my.type.MyTypeHandler"/>

应用场景举例：如果我们的对象里面有复杂对象，比如Blog里面包括了一个Comment对象，这个时候Comment对象的全部属性不能直接映射到数据库的一个字段。
==> 创建一个TypeHandler，可以将任意的对象转换为json字符串，保存到数据库的VARCHAR类型中。在从数据库查询的时候，再转换为原来的Java对象

6.objectFactory【重点】

当我们把数据库返回的结果集转换为实体类的时候，需要创建对象的实例，由于我们不知道需要处理的类型是什么，有哪些属性，所以不能用 new 的方式去创建。

在MyBatis里面，它提供了一个工厂类接口，叫做ObjectFactory，专门用来创建对象实例，里面定义了4个方法。

1.默认对象工厂

ObjectFactory 有一个默认的实现类 DefaultObjectFactory，创建对象的方法最终都调用了instantiateClass()，是通过反射来实现的。

2.自定义对象工厂

如果想要修改对象工厂在初始化实体类的时候的行为，就可以通过创建自己的对象工厂，继承 DefaultObjectFactory 来实现（不需要再实现ObjectFactory 接口）

/**
 * 自定义ObjectFactory，通过反射的方式实例化对象
 * 一种是有参构造函数，一种是无参构造函数第（实际调用了无参构造）
 */publicclassMYObjectFactoryextendsDefaultObjectFactory{@Overridepublic Objectcreate(Classtype){
        System.out.println("创建对象方法："+ type);
        Object result=super.create(type);// 如果是Blog，按如下规则创建// 1.调用父类的create方法，按照数据库数据创建对象（已经实现了反射实例化）// 2.对创建好的对象的属性进行自定义设置if(type.equals(Blog.class)){
            Blog blog=(Blog) result;
            blog.setName("object factory");
            blog.setBid(1111);
            blog.setAuthorId(2222);return blog;}// 不是指定类型，则依旧按照默认规则创建return result;}}

我们可以直接用自定义的工厂类来创建对象

publicclassObjectFactoryTest{publicstaticvoidmain(String[] args){
        MYObjectFactory factory=newMyObjectFactory();// 通过MYObjectFactory获取对象
        Blog myBlog=(Blog) factory.create(Blog.class);
        System.out.println(myBlog);}}

和类型处理器一样，写好我们的对象工厂后，要把它配置到全局配置文件中去，在创建对象的时候会被自动调用。另外，property 标签里我们可以设置一些参数，它会对这个参数 userName 做修改。

<objectFactorytype="org.mybatis.example.MyObjectFactory"><!-- 对象工厂注入的参数化 --><!-- 注：调用时都走这个工厂，不过只有指定类型才会特殊处理--><propertyname="userName"value="666"/></objectFactory>

几个问题：

1. 什么时候调用了objectFactory.create()？

   创建DefaultResultSetHandler的时候，和创建对象的时候。

2. 创建对象后，已有的属性为什么被覆盖了？

   在DefaultResultSetHandler类的395行getRowValue()方法里面里面调用了applyPropertyMappings()。

3. 返回结果的时候，ObjectFactory和TypeHandler哪个先工作？

   先是ObjectFactory，再是TypeHandler。肯定是先创建对象。

应用场景举例：比如有一个手机品牌在一个电商平台上面卖货，为了让预约数量好看一点，只要有人预约，预约数量就自动乘以3。这个时候就可以创建一个ObjectFactory，只要是查询销量，就把它的预约数乘以3返回这个实体类。

7.plugins

插件是MyBatis的一个很强大的机制，跟很多其他的框架一样，MyBatis预留了插件的接口，让MyBatis更容易扩展。
根据官方的定义，插件可以拦截这四个对象的这些方法，我们把这四个对象称作MyBatis的四大对象。

8.mappers

mappers标签配置的是我们的映射器，也就是Mapper.xml的路径。这里配置的目的是让MyBatis在启动的时候去扫描这些映射器，创建映射关系。

我们有四种指定Mapper文件的方式：

• 使用相对于类路径的资源引用（resource）
• 使用完全限定资源定位符（绝对路径）（url）
• 使用映射器接口实现类的完全限定类名（class）
• 将包内的映射器接口实现全部注册为映射器（最常用）

总结