MyBatis配置文件mybatis-config详解

MyBatis配置文件mybatis-config.xml内容详解

---

一、略解mybatis-config.xml

核心配置文件mybatis-config.xml头部要包含这个约束：

点开上面这个链接可以知道mybatis-config.xml文件的大致框架如下：

 


<configuration>

    <properties>
        <property>property>
        ...
    properties>

    <settings>
        <setting>setting>
        ...
    settings>

    <typeAliases>
        <package>package>
        ...
        <typeAlias>typeAlias>
        ...
    typeAliases>

    <typeHandlers>
        <package>package>
        ...
        <typeHandler>typeHandler>
        ...
    typeHandlers>

    <objectFactory>
        <property>property>
        ...
    objectFactory>

    <objectWrapperFactory>
        <property>property>
        ...
    objectWrapperFactory>

    <reflectorFactory>reflectorFactory>

    <plugins>
        <plugin>
            <property>property>
            ...
        plugin>
        ...
    plugins>

    <environments>
        <environment>
            <transactionManager>
                <property>property>
                ...
            transactionManager>

            <dataSource>
                <property>property>
                ...
            dataSource>
        environment>
        ...
    environments>

    <databaseIdProvider>
        <property>property>
        ...
    databaseIdProvider>

    <mappers>
        <package>package>
        ...
        <mapper>mapper>
        ...
    mappers>

configuration>

二、详解mybatis-config.xml

1. configuration

最外层标签，表示这里面的都是配置内容。

2. properties

properties用来定义变量，从而将配置值写死到mybatis-config.xml中，也可以具体到一个属性文件中，并且使用属性文件的key名作为占位符。
注意这个标签必须是configuration中最前面的子标签。

1. 将配置值写到property标签中，在之后的内容中可以用${}来获取该值：

<configuration>
    <properties>
        <property name="jdbc.username" value="test" /> 
        <property name="jdbc.password" value="test" /> 
    properties>

    <environments default="development"> 
        <environment id="development"> 
            <transactionManager type="JDBC" /> 
            <dataSource type="POOLED">
                <property name="username" value="${jdbc.username}" /> 
                <property name="password" value="${jdbc.password}" /> 
        dataSource> 
        environment> 
    environments>  
configuration>

2. 将配置值写到另外一个属性文件中，在之后的内容中可以用${}来获取该值:

新建db.properties文件，写入如下内容：

jdbc.driverClassName=oracle.jdbc.driver.OracleDriver 
jdbc.url=jdbc:oracle:thin:@127.0.0.1:1521:XE
jdbc.username=test 
jdbc.password=test

mybatis-config.xml写入如下内容：

<configuration>
    <properties resource="db.properties">properties>

    <environments default="development"> 
        <environment id="development"> 
            <transactionManager type="JDBC" /> 
            <dataSource type="POOLED">
                <property name="driver" value="${jdbc.driverClassName}" /> 
                <property name="url" value="${jdbc.url}" /> 
                <property name="username" value="${jdbc.username}" /> 
                <property name="password" value="${jdbc.password}" /> 
        dataSource> 
        environment> 
    environments>  
configuration>

3. 注意：如果两种方式都写了，那么文件中的配置优先级更高，也就是文件的配置会覆盖标签中的值。

3. settings

settings标签用来设置全局参数，大多数情况下，这些参数使用它们的默认值即可。为满足应用特定的需求，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="defaultExecutorType" value="SIMPLE" /> 

    
    <setting name="defaultStatementTimeout" value="25000" /> 

    
    <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" /> 

    
    
    <setting name="proxyFactory" value="JAVASSIST" /> 
    
    <setting name="aggressiveLazyLoading" value="true" /> 

    
    <setting name="logImpl" value="LOG4J " /> 

    
    <setting name="logPrefix" value="LOG4J " /> 

    
    <setting name="callSettersOnNulls" value="false " /> 
settings> 

4. typeAliases

这个标签里面的typeAlias标签可以定义别名，会在映射文件中使用。如果没有定义别名，那必须使用全限定名。配置别名有两种方法：

1. 直接写在typeAlias标签中：

<typeAliases> 
    <typeAlias alias="Student" type="com.au.bean.Student" />
typeAliases> 

2. package标签和@Alias注解配合使用：

<typeAliases> 
    <package name="com.au.bean" />
typeAliases> 

package com.au.bean;

@Alias("Student")   // 配合package标签起别名使用，别名默认为类名
public class Student {
    private Integer id;
    private String name;
    ...
}

在没有配别名之前的mapper.xml文件是下面这样写的，即resultType的值要写类的全限定名。

<select id="findStudentById" parameterType="int" resultType="com.au.bean.Student"> 
    SELECT STUD_ID AS ID, NAME, EMAIL, DOB  
    FROM STUDENTS WHERE STUD_ID=#{Id} 
select> 

配置之后就可以写成别名了：

<select id="findStudentById" parameterType="int" resultType="Student"> 
    SELECT STUD_ID AS ID, NAME, EMAIL, DOB  
    FROM STUDENTS WHERE STUD_ID=#{Id} 
select> 

注意：别名【不区分大小写】。

5. typeHandlers

typeHandlers标签用来设置类型处理器，在执行sql语句的时候，prepareStatement会设置sql语句中的 ? 值（如select * from student where id = ?），此时类型处理器帮prepareStatement找到对应的set方法，如setInt、setString或setDate等，但是如果是自定义的类型，类型处理器就找不到对应的set方法，所以要自定义类型处理器。

有关自定义类型处理器不详细介绍，移步我的其它文章：MyBatis自定义类型处理器（typeHandler）

假如我现在已经写好了一个类型处理器为PhoneTypeHandler，进行如下操作进行关联使用：

<configuration> 
    <typeHandlers> 
        <typeHandler handler="com.au.typehandlers.PhoneTypeHandler" /> 
    typeHandlers> 
configuration> 

6. objectFactory

用于指定结果集对象的实例是如何创建的。MyBatis 每次创建结果对象的新实例时，它都会使用一个对象工厂（ObjectFactory）实例来完成。默认的对象工厂需要做的仅仅是实例化目标类，要么通过默认构造方法，要么在参数映射存在的时候通过参数构造方法来实例化。默认情况下，我们不需要配置，mybatis会调用默认实现的objectFactory。 除非我们要自定义ObjectFactory的实现， 那么我们才需要去手动配置。自定义ObjectFactory只需要去继承DefaultObjectFactory（是ObjectFactory接口的实现类），并重写其方法即可。

7. objectWrapperFactory

8. reflectorFactory

9. plugins

MyBatis的插件，插件可以修改MyBatis内部的运行规则，如分页插件等。

10. environments

environments是配置mybatis当前工作的数据库环境的地方。整体结构为:

<environments default="db1">
    <environment id="db1">
        数据库连接四要素
        事务管理方式
    environment>
    
    <environment id="db2">
        数据库连接四要素
        事务管理方式
    environment>
    
    ...
environments>

a. dataSource

dataSource表示的是【数据源】：至少会包括该连接数据库的各种信息【注意： 在Java里面，数据源是一个对象】

<dataSource type="POOLED"> 
    <property name="driver" value="${jdbc.driverClassName}" /> 
    <property name="url" value="${jdbc.url}" /> 
    <property name="username" value="${jdbc.username}" /> 
    <property name="password" value="${jdbc.password}" /> 
dataSource> 

dataSource的类型type属性可以配置成其内置类型之一，如UNPOOLED，POOLED，JNDI(web使用)。如果将类型设置成UNPOOLED，MyBatis会为每一个数据库操作创建一个新的连接，使用完了并关闭它，该方式适用于只有小规模数量并发用户的简单应用程序上。

如果将属性设置成POOLED，MyBatis会【创建】一个【数据库连接池】，连接池中的一个连接将会被用作数据库操作。一旦数据库操作完成，MyBatis会将此连接返回给连接池。在开发或测试环境中，经常使用此种方式。

如果将类型设置成JNDI(Java Naming and Directory Interface , 【Java命名和目录接口】, 是SUN公司提供的一种标准的Java命名系统接口)，MyBatis从在应用服务器向配置好的JNDI数据源dataSource获取数据库连接。在生产环境中，优先考虑这种方式。

b. transcationManager

transcationManager是事务管理器，取值JDBC或MANAGED，JDBC表示手动控制，MANAGED被服务器管理。

JDBC事务管理器的使用，是在【jdbc程序】负责管理数据库连接的生命周期（提交、回退等等）的时候。如果将TransactionManager 属性设置成JDBC，MyBatis内部将使用JdbcTransactionFactory类创建TransactionManager。例如，部署到ApacheTomcat的应用程序，需要应用程序自己管理事务。MANAGED 事务管理器的使用，是在【应用服务器】负责管理数据库连接生命周期的时候。如果将TransactionManager属性设置成MANAGED时，MyBatis内部使用ManagedTransactionFactory 类创建事务管理器TransactionManager。例如，当一个Java EE的【应用程序部署】在类似JBoss，WebLogic，GlassFish应用【服务器】上时，它们会使用EJB进行应用服务器的事务管理能力。在这些管理环境中，你可以使用MANAGED事务管理器。注：【Managed 是托管】的意思，即我们编写的应用程序本身不去管理事务，而是把事务管理交给应用所在的服务器进行管理。

c. 其它

MyBatis支持配置多个environment环境，可以将应用部署到不同的环境上，如DEV【开发环境】，TEST【测试环境】，QA【质量评估环境】，UAT【用户验收环境】,PRODUCTION【生产环境】，可以通过将默认environments的【default属性】设置成想要的environment的id值。有时候，我们可能需要在相同的应用下使用多个数据库,比如我们可能有【shoppingcart】数据库来存储所有的【订单明细】；使用【reports】数据库存储【订单明细】的合计，用作报告。(也就是如果系统在运行期间如果有切换数据库环境的需求,mybatis中也可以很轻松的实现)。如果你的【应用】需要连接【多个数据库】，你需要将每个数据库配置成独立的环境，并且为每一个数据库创建一个SqlSessionFactory。例如:

<environments default="shoppingcart"> 
    
    <environment id="shoppingcart"> 
    <transactionManager type="MANAGED" /> 
    <dataSource type="JNDI"> 
        <property name="data_source" value="java:comp/jdbc/ShoppingcartDS" /> 
    dataSource> 
    environment> 

    
    <environment id="reports"> 
    <transaction Managertype="MANAGED" /> 
    <dataSource type="JNDI"> 
        <property name="data_source" value="java:comp/jdbc/ReportsDS" /> 
    dataSource> 
    environment> 
environments> 

我们可以为以上每个环境创建一个SqlSessionFactory，java代码:

    inputStream = Resources.getResourceAsStream("mybatis-config.xml"); 
    //默认的环境
    defaultSqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

    //统计明细的环境 代码内部【通过参数】可以【切换数据库】
    cartSqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream, "shoppingcart"); 

    //统计报表的环境
    reportSqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream, "reports");

注意：对于environments，我们可以在其中配置多个environment子元素，同时还需要在environment中配置dataSource和transactionManager元素。

11. databaseIdProvider

12. mappers

mappers标签用来配置SQLMapper文件路径。mappers里面每一个mapper子标签都可以从不同类型的资源中加载映射mapper：

• resource属性：用来指定在classpath中的mapper文件。
• url属性：用来通过完全文件系统路径或者web中url地址来指向mapper文件。
• class属性：用来指向一个mapper接口。
• package属性：用来指向可以找到Mapper接口的包名。`

假如我在项目的src/com/au/mappers目录下有StudentMapper.xml文件，那么应该这样配置：

<configuration> 
    <mappers> 
        <mapper resource="com/au/mappers/StudentMapper.xml" /> 
    mappers> 
configuration>

假如我在电脑C盘有StudentMapper.xml文件，那么应该这样配置：

<configuration> 
    <mappers> 
        <mapper url="file:///C:/StudentMapper.xml" /> 
    mappers> 
configuration>

假如我没有写StudentMapper.xml文件，而是直接写sql注解（如@insert）在StudentMapper.java接口上，那么应该这样配置：

<configuration> 
    <mappers> 
        <mapper class="com.au.mappers.StudentMapper" /> 
    mappers> 
configuration>

还可以这样配置，前提是接口和xml文件的名字要一样：

<configuration> 
    <mappers> 
        <package name="com.au.mappers" /> 
    mappers> 
configuration>