Mybatis知识小汇（3）——配置解析

配置解析

configuration（配置）

• properties（属性）
• settings（设置）
• typeAliases（类型别名）
• typeHandlers（类型处理器）
• objectFactory（对象工厂）
• plugins（插件）
• environments（环境配置）
  • environment（环境变量）
    • transactionManager（事务管理器）
    • dataSource（数据源）
• databaseIdProvider（数据库厂商标识）
• mappers（映射器）

environments（环境配置）

1. MyBatis 可以配置成适应多种环境，这种机制有助于将 SQL 映射应用于多种数据库之中，现实情况下有多种理由需要这么做。
2. 不过要记住：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。
3. 每个数据库对应一个 SqlSessionFactory 实例

<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>
    <environment id="test">
        ...
    </environment>
</environments>

事务管理器（transactionManager）

在 MyBatis 中有两种类型的事务管理器（也就是 type="[JDBC|MANAGED]"）

1. JDBC – 这个配置直接使用了 JDBC 的提交和回滚设施，它依赖从数据源获得的连接来管理事务作用域。
2. MANAGED – 这个配置几乎没做什么。

数据源（dataSource）

dataSource 元素使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。

• 大多数 MyBatis 应用程序会按示例中的例子来配置数据源。虽然数据源配置是可选的，但如果要启用延迟加载特性，就必须配置数据源。

有三种内建的数据源类型（也就是 type="[UNPOOLED|POOLED|JNDI]"）

属性（properties）

这些属性可以在外部进行配置，并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性，也可以在 properties 元素的子元素中设置。

"configuration" 的内容必须匹配 “(properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,reflectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?)”。

db.properties

driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8&useSSL=true
username=root
password=123456

mybatis-config.xml

<?xml version="1.0" encoding="UTF8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<!--        configuration核心配置-->
<configuration>
    <!--外部配置文件-->
    <properties resource="db.properties">
        <!--可以使用property也可以不使用-->
        <property name="username" value="root"/>
        <!--密码时错误的,当存在与db.properties有相同字段时，优先寻找使用外部文件db.properties-->
        <property name="password" value="111111"/> 
    </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都需要在配置文件中注册-->
    <mappers>
        <mapper resource="com/wjq/dao/UserMapper.xml"/>
    </mappers>
</configuration>

类型别名（typeAliases）

类型别名可为 Java 类型设置一个缩写名字。它仅用于 XML 配置，意在降低冗余的全限定类名书写。

1. 当实体类比较少的时候

<typeAliases>
    <typeAlias type="com.wjq.pojo.User" alias="User"/>
</typeAliases>

2. 也可以指定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean,会使用Bean 的首字母小写的非限定类名来作为它的别名即别名默认为user，但是User也不会报错。当实体类比较多的时候

<typeAliases>
    <package name="com.wjq.pojo"/>
</typeAliases>

3. 通过注解

@Alias("User")

设置（settings）

这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。

设置名	描述	有效值	默认值
cacheEnabled	全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。	true | false	true
lazyLoadingEnabled	延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。特定关联关系中可通过设置 fetchType属性来覆盖该项的开关状态。	true | false	false
useGeneratedKeys	允许 JDBC 支持自动生成主键，需要数据库驱动支持。如果设置为true，将强制使用自动生成主键。尽管一些数据库驱动不支持此特性，但仍可正常工作（如 Derby）。	true | false	False
logImpl	指定 MyBatis 所用日志的具体实现，未指定时将自动查找。	SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING	未设置
mapUnderscoreToCamelCase	是否开启驼峰命名自动映射，即从经典数据库列名 A_COLUMN 映射到经典 Java 属性名 aColumn。	true | false	False

映射器（mappers）

注册绑定我们的Mapper文件

1. resource

<mappers>
    <mapper resource="com/wjq/dao/UserMapper.xml"/>
</mappers>

2. class

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

注意点：

• 接口必须和Mapper的配置文件必须在同一个包下
• 接口必须和Mapper的配置文件必须有相同的名字

3. package

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

注意点：

• 接口必须和Mapper的配置文件必须在同一个包下
• 接口必须和Mapper的配置文件必须有相同的名字
  上一节—>实现增删改查
  下一节—>作用域（Scope）和生命周期、ResultMap结果映射集
  如有不对的地方欢迎指出，共同进步！