mybatis入门基础(三)----SqlMapConfig.xml全局配置文件解析

阅读目录

• 一：SqlMapConfig.xml配置文件的内容和配置顺序如下
• 二：properties属性
• 三:settings全局参数配置
• 四:typeAiases(别名)--重点掌握
• 五：typeHandlers(类型处理器)
• 六：mappers(映射配置)

回到顶部

一：SqlMapConfig.xml配置文件的内容和配置顺序如下

1. properties(属性)
2. settings(全局配置参数)
3. typeAiases(类型别名)
4. typeHandlers(类型处理器)
5. objectFactory(对象工厂)
6. plugins(插件)
7. environments(环境集合属性对象)mappers(映射器)
   1. environment(环境子属性对象)
   2. transactionManager(事物管理)
   3. datesource(数据源
8. mappers(映射器)

回到顶部

二：properties属性

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

db.properties的内容：

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis
jdbc.username=root
jdbc.password=root

在SqlMapConfig.xml中加载db.properties

<!-- 加载数据库文件db.properties -->
<properties resource="db.properties">
        <!-- properties中还可以配置一些属性名和属性值,此处的优先加载 -->
        <!-- <property name="driver" value=""/> -->
    </properties>
    <!-- 和spring整合后 environments配置将废除-->
    <environments default="development">
        <environment id="development">
        <!-- 使用jdbc事务管理,事务控制由mybatis管理-->
            <transactionManager type="JDBC" />
        <!-- 数据库连接池,由mybatis管理-->
            <dataSource type="POOLED">
                <property name="driver" value="${jdbc.driver}" />
                <property name="url" value="${jdbc.url}" />
                <property name="username" value="${jdbc.username}" />
                <property name="password" value="${jdbc.password}" />
            </dataSource>
        </environment>
    </environments>

properties特性：

注意：

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

建议：

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

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

回到顶部

三: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>

四:typeAiases(别名)--重点掌握

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

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

4.1.mybatis默认支持的别名

4.2.自定义别名

　　4.2.1:单个别名定义(在SqlMapConfig.xml)　　

<!-- 别名定义：针对单个别名定义 type:类型的路径; alias:别名 -->
    <typeAliases><typeAlias type="com.mybatis.entity.User" alias="user"/></typeAliases>

　　UserMapper.xml引用别名:

<select id="findUserById" parameterType="int" resultType="user" >
    　　select * from t_user where id=#{id}
</select>

　4.2.2:批量定义别名(常用)　

<!-- 批量别名的定义:
        package:指定包名，mybatis会自动扫描包中的pojo类，自动定义别名，别名就是类名(首字母大写或小写都可以)
 -->
     <typeAliases>
         <package name="com.mybatis.entity"/>
         <package name="其它包"/>
    </typeAliases>

五：typeHandlers(类型处理器)

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

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

mybatis支持类型处理器：

回到顶部

六：mappers(映射配置)

6.1:通过resource加载单个映射文件

<!-- 加载映射文件 -->
    <mappers>
    <!--通过resource方法一次加载一个映射文件  -->
        <mapper resource="sqlmap/User.xml"/>
        <mapper resource="mapper/UserMapper.xml"/>
    </mappers>

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

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

按照上边的规范，将mapper.java和mapper.xml放在一个目录 ，且同名。

6.3:批量加载mapper(推荐使用)

    <!-- 批量加载映射配置文件,mybatis自动扫描包下面的mapper接口进行加载
        遵循一定的规范：需要将mapper接口类名和mapper.xml映射文件名称保持一致，且在一个目录中；
            上边规范的前提是：使用的是mapper代理方法;
      -->
    <package name="com.mybatis.mapper"/>