SqlMapConfig.xml 是 MyBatis 的全局配置文件,配置内容如下:
- properties(属性)
- settings(全局配置参数)
- typeAliases(类型别名)
- typeHandlers(类型处理器)
- objectFactory(对象工厂)
- plugins(插件)
- environments(环境集合属性对象)
- environment(环境子属性对象)
- transactionManager(事务管理)
- dataSource(数据源)
- environment(环境子属性对象)
- mappers(映射器)
properties
将数据库连接参数单独配置在 db.properties 中,放在类路径下。这样只需要在 SqlMapConfig.xml 中加载 db.properties 的属性值。这样在 SqlMapConfig.xml 中就不需要对数据库连接参数硬编码。
将数据库连接参数只配置在 db.properties 中。原因:方便对参数进行统一管理,其它 xml 可以引用该 db.properties。
// mysql 版本为 8.0 之前的配置
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis
//mysql 版本为 8.0 之后的配置
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/edu1?characterEncoding=utf8&useUnicode=true&useSSL=false&serverTimezone=UTC
jdbc.username=root
jdbc.password=123
相应在 SqlMapConfig.xml 中的配置:
<properties resource="db.properties">
<environments default="development">
<environment id="development">
<transactionManager type="JDBC" />
<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
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="autoMappingUnknownColumnBehavior" value="WARNING"/>
<setting name="defaultExecutorType" value="SIMPLE"/>
<setting name="defaultStatementTimeout" value="25"/>
<setting name="defaultFetchSize" value="100"/>
<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>
typeAliases
在 mapper.xml 中,定义很多的 statement,statement 需要 parameterType
指定输入参数的类型、需要 resultType
指定输出结果的映射类型
如果在指定类型时输入类型全路径,不方便进行开发,可以针对 parameterType
或 resultType
指定的类型定义一些别名,在 mapper.xml 中通过别名定义,方便开发
设置别名:
<typeAliases>
<typeAlias type="model.User" alias="yuser"></typeAlias>
</typeAliases>
在 mapper.xml 里面引用:
<select id="getUser" resultType="yuser">
select * FROM user;
</select>
typeHandlers
无论是 MyBatis 在预处理语句(PreparedStatement)中设置一个参数时,还是从结果集中取出一个值时, 都会用类型处理器将获取的值以合适的方式转换成 Java 类型
也就是将参数从 Java 类型(javaType)转换为 jdbcType
;或者从数据库取出结果把 jdbcType
转化为 javaType
typeHandler
和 typeAliases
(类型别名)一样,分为系统定义及用户自定义
mappers
通过 resource 加载单个映射文件:
<mapper resource="mapper/UserMapper.xml"/>
通过 mapper 接口加载单个 mapper:
<mapper class="com.iot.mybatis.mapper.UserMapper"/>
批量加载 mapper:
<package name="com.iot.mybatis.mapper"/>