一、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>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>                     <!--加载驱动：com.mysql.jdbc.Driver-->
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis_01_user"/>  <!--数据库名称：mybatis_01_user-->
                <property name="username" value="root"/>                                    <!--用户名-->
                <property name="password" value=""/>                                        <!--密码-->

            </dataSource>
        </environment>
    </environments>
    <mappers>
        <!-- 注册studentMapper.xml文件studentMapper.xml位于mapper这个目录下，所以resource写成mapper/studentMapper.xml-->
        <mapper resource="mapper/studentMapper.xml"/>
    </mappers>
</configuration>

MyBatis核心配置文件的内容和顺序如下：

1. properties(属性)
2. settings(全局配置参数)
3. typeAiases(类型别名)
4. typeHandlers(类型处理器)
5. objectFactory(对象工厂)
6. plugins(插件)

environments(环境集合属性对象)

1. environment(环境子属性对象)
2. transactionManager(事物管理)
3. datesource(数据源
7. mappers(映射器)

二、MyBatis配置文件详解

2.1、properties属性

作用：将数据连接单独配置在db.properties中，只需要在conf.xml中加载db.properties的属性值，在conf.xml中就不需要对数据库连接参数进行硬编码。数据库连接参数只配置在db.properties中，方便对参数进行统一管理，其它xml可以引用该db.properties。

db.properties的内容：

##MySQL连接字符串
#驱动
driver=com.mysql.jdbc.Driver
#地址
url=jdbc:mysql://localhost:3306/mybatis_01_user?characterEncoding=UTF-8
#用户名
username=root
#密码
password=

在conf.xml中加载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>
    <!--导入db.properties文件中的所有key-value数据-->
    <properties resource="db.properties" ></properties>

    <!--设置日志-->
    <settings>
        <!--设置是否允许缓存-->
        <setting name="cacheEnabled" value="true"/>
        <!--设置日志输出的目标-->
        <setting name="logImpl" value="STDOUT_LOGGING"/>
    </settings>

    <!--别名-->
    <typeAliases>
        <!--方法一：包名+实体类（message.java）-->
        <!--定义单个别名，指定名称为message，对应的类型为com.dinghuoqin.vo.message-->
        <!--<typeAlias type="com.dinghuoqin.vo.message" alias="message"></typeAlias>-->

        <!--方法二：包名-->
        <!--指定包名下所有的类被自动扫描并定义默认别名,mybatis会自动扫描包中的pojo类，自动定义别名，别名就是类名(首字母大写或小写都可以)-->
        <package name="com.dinghuoqin.vo" ></package>
    </typeAliases>

    <!--环境配置，default为默认选择的环境-->
    <environments default="development">
        <!--开发-->
        <environment id="development">
            <!--事务管理-->
            <transactionManager type="JDBC"/>
            <!--连接池-->
            <dataSource type="POOLED">
                <!--引用属性${Key}-->
                <property name="driver" value="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <!--
            根据路径注册一个基于XML的映射器
            注册studentMapper.xml文件studentMapper.xml位于mapper这个目录下，所以resource写成mapper/studentMapper.xml
         -->
        <mapper resource="mapper/studentMapper.xml"/>
    </mappers>
</configuration>

properties特性：

注意：

• 在properties元素体内定义的属性优先读取。
• 然后读取properties元素中resource或url加载的属性，它会覆盖已读取的同名属性。
• 最后读取parameterType传递的属性，它会覆盖已读取的同名属性

建议：

　　不要在properties元素体内添加任何属性值，只将属性值定义在properties文件中。

　　在properties文件中定义属性名要有一定的特殊性，如xxxx.xxxx(jdbc.driver)

2.2、settings全局参数配置

mybatis框架运行时可以调整一些运行参数。比如，开启二级缓存，开启延迟加载等等。全局参数会影响mybatis的运行行为。

mybatis-settings的配置属性以及描述

 官方文档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="defaultExecutorType" value="SIMPLE"/>
    <setting name="defaultStatementTimeout" value="25"/>
    <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>

示例：

这里设置MyBatis的日志输出到控制台：

    <!--设置日志-->
    <settings>
        <!--设置是否允许缓存-->
        <setting name="cacheEnabled" value="true"/>
        <!--设置日志输出的目标-->
        <setting name="logImpl" value="STDOUT_LOGGING"/>
    </settings>

结果 ：

2.3、typeAiases(别名)

在mapper.xml中，定义很多的statement，statement需要parameterType指定输入参数的类型、需要resultType指定输出结果的映射类型。

如果在指定类型时输入类型全路径，不方便进行开发，可以针对parameterType或resultType指定的类型定义一些别名，在mapper.xml中通过别名定义，方便开发。

如下所示类型com.dinghuoqin.vo.message会反复出现，冗余：

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

<mapper namespace="com.dinghuoqin.dao.studentMapper">

    <!-- 在select标签中编写查询的SQL语句， 设置select标签的id属性为selectStudentById，id属性值必须是唯一的，不能够重复
         使用parameterType属性指明查询时使用的参数类型，resultType属性指明查询返回的结果集类型
         resultType="com.dinghuoqin.vo.message"就表示将查询结果封装成一个message类的对象返回
         message类就是message表所对应的实体类
     -->

    <!--查询-->
    <!--查询所有数据-->
    <select id="selectStudent"  resultType="com.dinghuoqin.vo.message">
        select id,username,password,name,email,state from  user
    </select>
    <!--根据id查询数据-->
    <select id="selectStudentById" resultType="com.dinghuoqin.vo.message">
        select id,username,password,name,email,state from  user where id = #{id}
    </select>
    <!--根据姓名模糊查询数据-->
    <select id="selectStudentByName" resultType="com.dinghuoqin.vo.message">
        select id,username,password,name,email,state from  user where name  like ‘%${value}%‘;
    </select>
    <!--分页查询-->
    <select id="selectStudentFY" resultType="com.dinghuoqin.vo.message" parameterType="java.lang.Integer">
        select id,username,password,name,email,state from  user limit #{page},#{number};
    </select>

    <!--根据id删除数据-->
    <delete id="deleteStudentById" parameterType="java.lang.Integer">
        delete  from user  where id=#{id}
    </delete>

    <!--添加数据-->
    <insert id="insertStudent" parameterType="com.dinghuoqin.vo.message" >
    <selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer" >
        SELECT LAST_INSERT_ID() AS id;
    </selectKey>
        insert into user(username,password,name,email,state) values(#{username},#{password},#{name},#{email},#{state});
    </insert>

    <!--根据id修改数据修改-->
    <update id="updateStudent" parameterType="com.dinghuoqin.vo.message">
        update user set username=#{username},password=#{password},name=#{name},email=#{email},state=#{state} where id=#{id}
    </update>
</mapper>

2.3.1.MyBatis默认支持的别名

2.3.2.自定义别名

（一）、单个别名定义(在conf.xml)　

    <!--别名-->
    <typeAliases>
        <!--定义单个别名，指定名称为message，对应的类型为com.dinghuoqin.vo.message-->
       <typeAlias type="com.dinghuoqin.vo.message" alias="message"></typeAlias>
    </typeAliases>

studentMapper.xml引用别名

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

<mapper namespace="com.dinghuoqin.dao.studentMapper">

    <!--查询-->
    <!--查询所有数据-->
    <select id="selectStudent"  resultType="message">
        select id,username,password,name,email,state from  user
    </select>
    <!--根据id查询数据-->
    <select id="selectStudentById" resultType="Message">
        select id,username,password,name,email,state from  user where id = #{id}
    </select>
    <!--根据姓名模糊查询数据-->
    <select id="selectStudentByName" resultType="message">
        select id,username,password,name,email,state from  user where name  like ‘%${value}%‘;
    </select>
    <!--分页查询-->
    <select id="selectStudentFY" resultType="message" parameterType="java.lang.Integer">
        select id,username,password,name,email,state from  user limit #{page},#{number};
    </select>

    <!--根据id删除数据-->
    <delete id="deleteStudentById" parameterType="java.lang.Integer">
        delete  from user  where id=#{id}
    </delete>

    <!--
        添加数据
    -->
    <insert id="insertStudent" parameterType="message" >
    <selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer" >
        SELECT LAST_INSERT_ID() AS id;
    </selectKey>
        insert into user(username,password,name,email,state) values(#{username},#{password},#{name},#{email},#{state});
    </insert>

    <!--根据id修改数据修改-->
    <update id="updateStudent" parameterType="message">
        update user set username=#{username},password=#{password},name=#{name},email=#{email},state=#{state} where id=#{id}
    </update>
</mapper>

（二）批量定义别名，扫描指定的包

定义单个别名的缺点很明显，如果项目中有很多别名则需要一个一个定义，且修改类型了还要修改配置文件非常麻烦，可以指定一个包，将下面所有的类都按照一定的规则定义成别名：

<!--别名-->
    <typeAliases>
        <!--方法一：包名+实体类（message.java）-->
        <!--定义单个别名，指定名称为message，对应的类型为com.dinghuoqin.vo.message-->
        <!--<typeAlias type="com.dinghuoqin.vo.message" alias="message"></typeAlias>-->

        <!--方法二：包名-->
        <!--指定包名下所有的类被自动扫描并定义默认别名,mybatis会自动扫描包中的pojo类，自动定义别名，别名就是类名(首字母大写或小写都可以)-->
        <package name="com.dinghuoqin.vo" ></package>
    </typeAliases>

如果com.dinghuoqin.vo包下有一个名为message的类，则使用别名时可以是：message，或Message。

如果两个名称相同时的冲突问题，可以使用注解解决

2.4、typeHandlers(类型处理器)

mybatis中通过typeHandlers完成jdbc类型和java类型的转换。

通常情况下，mybatis提供的类型处理器满足日常需要，不需要自定义.

mybatis支持类型处理器：

2.5、mappers(映射配置)

映射配置可以有多种方式，如下XML配置所示：

<!-- 将sql映射注册到全局配置中-->
    <mappers>

        <!--
            mapper 单个注册（mapper如果多的话，不太可能用这种方式）
            resource：引用类路径下的文件
            url：引用磁盘路径下的资源
            class，引用接口
            package 批量注册（基本上使用这种方式）
            name：mapper接口与mapper.xml所在的包名
        -->

        <!-- 第一种：注册sql映射文件-->
        <mapper resource="com/ding/mapper/UserMapper.xml" />

        <!-- 第二种：注册接口sql映射文件必须与接口同名，并且放在同一目录下-->
        <mapper class="com.ding.mapper.UserMapper"/>
        <!-- 第三种：注册基于注解的接口  基于注解   没有sql映射文件，所有的sql都是利用注解写在接口上-->
        <mapper class="com.ding.mapper.TeacherMapper"/>
        <!-- 第四种：批量注册  需要将sql配置文件和接口放到同一目录下-->
        <package name="com.ding.mapper"/>
    </mappers>

2.5.1、通过resource加载单个映射文件

    <mappers>
        <!--
            根据路径注册一个基于XML的映射器
            注册studentMapper.xml文件studentMapper.xml位于mapper这个目录下，所以resource写成mapper/studentMapper.xml
         -->
        <mapper resource="mapper/studentMapper.xml"/>
    </mappers>

2.5.2:通过mapper接口加载单个映射文件

    <mappers>
        <!-- 通过mapper接口加载单个映射配置文件
           遵循一定的规范：需要将mapper接口类名和mapper.xml映射文件名称保持一致，且在一个目录中；
           上边规范的前提是：使用的是mapper代理方法;
        -->
        <mapper class="com.dinghuoqin.daoPort.StudentDaoI"></mapper>
    </mappers>

原文地址：https://www.cnblogs.com/huoqin/p/9715411.html