5 SqlMapConfig.xml
mybatis的全局配置文件SqlMapConfig.xml，配置内容如下：
properties（属性）
settings（全局配置参数）
typeAliases（类型别名）
typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins（插件）
environments（环境集合属性对象）
environment（环境子属性对象）
transactionManager（事务管理）
dataSource（数据源）
mappers（映射器）
5.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/数据库名称 jdbc.username=用户名 jdbc.password=密码
在sqlMapConfig.xml加载属性文件：
<!-- 加载属性文件 --> <properties resource="db.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特性：
注意： MyBatis 将按照下面的顺序来加载属性：
- 在 properties 元素体内定义的属性首先被读取。
- 然后会读取properties 元素中resource或 url 加载的属性，它会覆盖已读取的同名属性。
- 最后读取parameterType传递的属性，它会覆盖已读取的同名属性。
建议：
不要在properties元素体内添加任何属性值，只将属性值定义在properties文件中。
在properties文件中定义属性名要有一定的特殊性，如：XXXXX.XXXXX.XXXX
5.1 settings全局参数配置
mybatis框架在运行时可以调整一些运行参数。
比如：开启二级缓存、开启延迟加载。。
全局参数将会影响mybatis的运行行为。
|
Setting(设置) |
Description（描述） |
Valid Values(验证值组) |
Default(默认值) |
|
cacheEnabled |
在全局范围内启用或禁用缓存配置任何映射器在此配置下。 |
true | false |
TRUE |
|
lazyLoadingEnabled |
在全局范围内启用或禁用延迟加载。禁用时，所有协会将热加载。 |
true | false |
TRUE |
|
aggressiveLazyLoading |
启用时，有延迟加载属性的对象将被完全加载后调用懒惰的任何属性。否则，每一个属性是按需加载。 |
true | false |
TRUE |
|
multipleResultSetsEnabled |
允许或不允许从一个单独的语句（需要兼容的驱动程序）要返回多个结果集。 |
true | false |
TRUE |
|
useColumnLabel |
使用列标签，而不是列名。在这方面，不同的驱动有不同的行为。参考驱动文档或测试两种方法来决定你的驱动程序的行为如何。 |
true | false |
TRUE |
|
useGeneratedKeys |
允许JDBC支持生成的密钥。兼容的驱动程序是必需的。此设置强制生成的键被使用，如果设置为true，一些驱动会不兼容性，但仍然可以工作。 |
true | false |
FALSE |
|
autoMappingBehavior |
指定MyBatis的应如何自动映射列到字段/属性。NONE自动映射。 PARTIAL只会自动映射结果没有嵌套结果映射定义里面。 FULL会自动映射的结果映射任何复杂的（包含嵌套或其他）。 |
NONE, PARTIAL, FULL |
PARTIAL |
|
defaultExecutorType |
配置默认执行人。SIMPLE执行人确实没有什么特别的。 REUSE执行器重用准备好的语句。 BATCH执行器重用语句和批处理更新。 |
SIMPLE REUSE BATCH |
SIMPLE |
|
defaultStatementTimeout |
设置驱动程序等待一个数据库响应的秒数。 |
Any positive integer |
Not Set (null) |
|
safeRowBoundsEnabled |
允许使用嵌套的语句RowBounds。 |
true | false |
FALSE |
|
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 |
|
lazyLoadTriggerMethods |
指定触发延迟加载的对象的方法。 |
A method name list separated by commas |
equals,clone,hashCode,toString |
|
defaultScriptingLanguage |
指定所使用的语言默认为动态SQL生成。 |
A type alias or fully qualified class name. |
org.apache.ibatis.scripting.xmltags.XMLDynamicLanguageDriver |
|
callSettersOnNulls |
指定如果setter方法或地图的put方法时，将调用检索到的值是null。它是有用的，当你依靠Map.keySet（）或null初始化。注意原语（如整型，布尔等）不会被设置为null。 |
true | false |
FALSE |
|
logPrefix |
指定的前缀字串，MyBatis将会增加记录器的名称。 |
Any String |
Not set |
|
logImpl |
指定MyBatis的日志实现使用。如果此设置是不存在的记录的实施将自动查找。 |
SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING |
Not set |
|
proxyFactory |
指定代理工具，MyBatis将会使用创建懒加载能力的对象。 |
CGLIB | JAVASSIST |
|
5.3 typeAliases（别名）重点
5.3.1 需求
在mapper.xml中，定义很多的statement，statement需要parameterType指定输入参数的类型、需要resultType指定输出结果的映射类型。
如果在指定类型时输入类型全路径，不方便进行开发，可以针对parameterType或resultType指定的类型定义一些别名，在mapper.xml中通过别名定义，方便开发。
5.3.2 mybatis默认支持别名
|
别名 |
映射的类型 |
|
_byte |
byte |
|
_long |
long |
|
_short |
short |
|
_int |
int |
|
_integer |
int |
|
_double |
double |
|
_float |
float |
|
_boolean |
boolean |
|
string |
String |
|
byte |
Byte |
|
long |
Long |
|
short |
Short |
|
int |
Integer |
|
integer |
Integer |
|
double |
Double |
|
float |
Float |
|
boolean |
Boolean |
|
date |
Date |
|
decimal |
BigDecimal |
|
bigdecimal |
BigDecimal |
5.3.3 自定义别名
5.3.3.1 单个别名定义
<!-- 别名定义 --> <typeAliases> <!-- 针对单个别名定义 type：类型的路径 alias：别名 --> <typeAlias type="cn.mybatis.po.User" alias="user"/> </typeAliases>
引用别名：
<select id="findUserById" parameterType="int" resultType="user">
SELECT * FROM USER WHERE id=#{value}
</select>
5.3.3.2 批量定义别名（常用）
<!-- 批量别名定义 指定包名，mybatis自动扫描包中的po类，自动定义别名，别名就是类名（首字母大写或小写都可以） --> <package name="cn.itcast.mybatis.po"/>
5.4 typeHandlers（类型处理器）
mybatis中通过typeHandlers完成jdbc类型和java类型的转换。
通常情况下，mybatis提供的类型处理器满足日常需要，不需要自定义.
mybatis支持类型处理器：
|
类型处理器 |
Java类型 |
JDBC类型 |
|
BooleanTypeHandler |
Boolean，boolean |
任何兼容的布尔值 |
|
ByteTypeHandler |
Byte，byte |
任何兼容的数字或字节类型 |
|
ShortTypeHandler |
Short，short |
任何兼容的数字或短整型 |
|
IntegerTypeHandler |
Integer，int |
任何兼容的数字和整型 |
|
LongTypeHandler |
Long，long |
任何兼容的数字或长整型 |
|
FloatTypeHandler |
Float，float |
任何兼容的数字或单精度浮点型 |
|
DoubleTypeHandler |
Double，double |
任何兼容的数字或双精度浮点型 |
|
BigDecimalTypeHandler |
BigDecimal |
任何兼容的数字或十进制小数类型 |
|
StringTypeHandler |
String |
CHAR和VARCHAR类型 |
|
ClobTypeHandler |
String |
CLOB和LONGVARCHAR类型 |
|
NStringTypeHandler |
String |
NVARCHAR和NCHAR类型 |
|
NClobTypeHandler |
String |
NCLOB类型 |
|
ByteArrayTypeHandler |
byte[] |
任何兼容的字节流类型 |
|
BlobTypeHandler |
byte[] |
BLOB和LONGVARBINARY类型 |
|
DateTypeHandler |
Date（java.util） |
TIMESTAMP类型 |
|
DateOnlyTypeHandler |
Date（java.util） |
DATE类型 |
|
TimeOnlyTypeHandler |
Date（java.util） |
TIME类型 |
|
SqlTimestampTypeHandler |
Timestamp（java.sql） |
TIMESTAMP类型 |
|
SqlDateTypeHandler |
Date（java.sql） |
DATE类型 |
|
SqlTimeTypeHandler |
Time（java.sql） |
TIME类型 |
|
ObjectTypeHandler |
任意 |
其他或未指定类型 |
|
EnumTypeHandler |
Enumeration类型 |
VARCHAR-任何兼容的字符串类型，作为代码存储（而不是索引）。 |
5.5 mappers（映射配置）
5.5.1 通过resource加载单个映射文件
<mapper resource="sqlmap/User.xml"/>
5.5.2 通过mapper接口加载单个mapper
<!-- 通过mapper接口加载单个XML映射文件
遵循一些规范：需要将mapper接口类名和mapper.xml映射文件名称保持一致，且在一个目录 中
上边规范的前提是：使用的是mapper代理方法
-->
<mapper class="cn.mybatis.mapper.UserMapper"/>
按照上边的规范，将mapper.java和mapper.xml放在一个目录 ，且同名。
5.5.3 批量加载mapper(推荐使用)
<!-- 批量加载mapper 指定mapper接口的包名，mybatis自动扫描包下边所有mapper接口进行加载 遵循一些规范：需要将mapper接口类名和mapper.xml映射文件名称保持一致，且在一个目录 中 上边规范的前提是：使用的是mapper代理方法 --> <package name="cn.mybatis.mapper"/>