Mybatis学习总结（三）:SqlMapConfig.xml全局配置文件解析详解编程语言

  经过上两篇博文的总结，对mybatis中的dao开发方法和流程基本掌握了，这一节主要来总结一下mybatis中的全局配置文件SqlMapConfig.xml在开发中的一些常用配置，首先看一下该全局配置文件中都有哪些可以配置的东西：

 

  从前面的博文中可以看出， environments 是用来配置mybatis的环境的，在和Spring整合前是由mybatis自己管理的，但是和Spring整合后，这些配置都将被废弃掉， environments 部分在前面已经有提到过，这里就不再赘述了。然后objectFactory和plugins一般我们不用，所以在这里就不总结了， typeHandlers 类型处理器是mybatis中用来完成jdbc类型和java类型之间转换的，mybatis默认支持的类型处理器基本够我们使用了，一般不需要自定义。这篇博文主要来总结一下剩下的几个配置的用法。

1、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特性：
注意：
  （1）在properties元素体内定义的属性优先读取。
  （2）然后读取properties元素中resource或url加载的属性，它会覆盖已读取的同名属性。
  （3）最后读取parameterType传递的属性，它会覆盖已读取的同名属性。
建议：
（1）不要在properties元素体内添加任何属性值，只将属性值定义在properties文件中。
  （2）在properties文件中定义属性名要有一定的特殊性，如xxxx.xxxx(jdbc.driver)。

2、settings全局参数设置

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

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

aggressiveLazyLoading 启用时，有延迟加载属性的对象将被完全加载后调用懒惰的任何属性。否则，每一个属性是按需加载。 true | false
multipleResultSetsEnabled 允许或不允许从一个单独的语句（需要兼容的驱动程序）要返回多个结果集。 true | false
useColumnLabel 使用列标签，而不是列名。在这方面，不同的驱动有不同的行为。参考驱动文档或测试两种方法来决定你的驱动程序的行为如何。 true | false
useGeneratedKeys 允许JDBC支持生成的密钥。兼容的驱动程序是必需的。此设置强制生成的键被使用，如果设置为true，一些驱动会不兼容性，但仍然可以工作。 true | false FALSE
autoMappingBehavior 指定MyBatis的应如何自动映射列到字段/属性。NONE自动映射。 PARTIAL只会自动映射结果没有嵌套结果映射定义里面。 FULL会自动映射的结果映射任何复杂的（包含嵌套或其他）。

NONE,PARTIAL,FULL

PARTIAL
defaultExecutorType 配置默认执行人。SIMPLE执行人确实没有什么特别的。 REUSE执行器重用准备好的语句。 BATCH执行器重用语句和批处理更新。

SIMPLE,REUSE,BATCH

SIMPLE
mapUnderscoreToCamelCase 从经典的数据库列名A_COLUMN启用自动映射到骆驼标识的经典的Java属性名aColumn。 true | false FALSE
localCacheScope MyBatis的使用本地缓存，以防止循环引用，并加快反复嵌套查询。默认情况下（SESSION）会话期间执行的所有查询缓存。如果localCacheScope=STATMENT本地会话将被用于语句的执行，只是没有将数据共享之间的两个不同的调用相同的SqlSession。

SESSION

STATEMENT

SESSION
dbcTypeForNull 指定为空值时，没有特定的JDBC类型的参数的JDBC类型。有些驱动需要指定列的JDBC类型，但其他像NULL，VARCHAR或OTHER的工作与通用值。 JdbcType enumeration. Most common are: NULL, VARCHAR and OTHER OTHER
callSettersOnNulls 指定如果setter方法​​或地图的put方法时，将调用检索到的值是null。它是有用的，当你依靠Map.keySet（）或null初始化。注意原语（如整型，布尔等）不会被设置为null。 true | false FALSE
指定MyBatis的日志实现使用。如果此设置是不存在的记录的实施将自动查找。 SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING Not set

 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 

3、typeAiases(别名)——重点掌握

  这是配置中的一个重点，我们知道，在mapper.xml中，定义很多的statement，statement需要parameterType指定输入参数的类型、需要resultType指定输出结果的映射类型。如果在指定类型时输入类型全路径，有时候会很长，不方便进行开发，那么我们就可以针对parameterType或resultType指定的类型定义一些别名，在mapper.xml中通过别名 typeAliases 来定义，方便开发。

3.1、Mybatis默认支持的别名

3.2.1、单个别名定义（在SqlMapConfig.xml）

上面讲的是Mybatis默认支持的一些别名，但是针对pojo的需要我们就要自定义别名了，比如我们将自己定义的User对象取个别名为user，如下：

 !-- 别名定义：针对单个别名定义 type:类型的路径; alias:别名 -- 

 typeAliases typeAlias type="com.mybatis.entity.User" alias="user"/ /typeAliases 

UserMapper.xml中引用别名（输入参数或者输出结果为com.mybatis.entity.User时，就可以用user来代替了）：

 select id="findUserById" parameterType="int" resultType="user" 

 select * from t_user where id=#{id} 

 /select 

3.2.2、批量定义别名（常用）

但是问题来了，如果工程中有很多pojo，那岂不是要一个一个定义……这得定义多少个啊，所以mybatis帮我们解决了这个问题，它提供了批量别名的定义，如下：

 !-- 批量别名的定义: 

 package:指定包名，mybatis会自动扫描包中的pojo类，自动定义别名，别名就是类名(首字母大写或小写都可以) 

 typeAliases 

 package name="com.mybatis.entity"/ 

 package name="其它包"/ 

 /typeAliases 

这就爽了，如果进行了上面这样设置，那么所有放在com.mybatis.entity包下的pojo都可以不用定义了，直接使用类名就可以了，所以我们直接使用user即可。毫无疑问，开发中肯定使用这个批量的别名定义。

4、mappers（映射配置）

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

 !-- 加载映射文件 -- 

 mappers 

 !--通过resource方法一次加载一个映射文件 -- 

 mapper resource="sqlmap/User.xml"/ 

 mapper resource="mapper/UserMapper.xml"/ 

 /mappers 

4.2、通过mapper接口加载单个映射文件

 !-- 通过mapper接口加载单个映射配置文件 

遵循一定的规范：需要将mapper接口类名和mapper.xml映射文件名称保持一致，且在一个目录中； 

上边规范的前提是：使用的是mapper代理方法; -- 

 mapper / 

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

4.3、批量加载mapper（推荐使用）

但是还是有个弊端，就跟上面那个别名的配置一样，如果现在有好多个mapper怎么办，所以mybatis也给我们提供了批量加载方法：我们只要指定mapper接口的包名，mybatis自动扫描包下面所有的mapper接口进行加载。当然，还是要遵循上面的那个规范。配置如下：

 !-- 批量加载映射配置文件,mybatis自动扫描包下面的mapper接口进行加载 

 遵循一定的规范：需要将mapper接口类名和mapper.xml映射文件名称保持一致，且在一个目录中； 

 上边规范的前提是：使用的是mapper代理方法; 

 package name="com.mybatis.mapper"/ 

这样com.mybatis.mapper包下的所有mapper.xml映射文件都可以加载了，这就更加简洁了。在开发中推荐使用这种批量加载映射文件的方法。

关于SqlMapConfig.xml文件中的配置就总结这么多吧~

原创文章，作者：Maggie-Hunter，如若转载，请注明出处：https://blog.ytso.com/17272.html

cjavamysqlxml