MyBatis 的配置文件包含了影响 MyBatis 行为甚深的设置(settings)和属性(properties)信息。文档的顶层结构如下:configuration 配置properties 属性
settings 设置
typeAliases 类型命名
typeHandlers 类型处理器
objectFactory 对象工厂
plugins 插件
environments 环境environment 环境变量transactionManager 事务管理器
dataSource 数据源
databaseIdProvider 数据库厂商标识
mappers 映射器properties
属性
这些属性都是可外部配置且可动态替换的,既可以在典型的 Java 属性文件中配置,亦可通过 properties 元素的子元素来传递,配置示例:
配置
properties
后,可以在其他配置中使用
property,示例如下:
这个例子中的 username 和 password 将会由 properties 元素中设置的相应值来替换。
如果属性在不只一个地方进行了配置,那么 MyBatis 将按照下面的顺序来加载:在 properties 元素体内指定的属性首先被读取。
然后根据 properties 元素中的 resource 属性读取类路径下属性文件或根据 url 属性指定的路径读取属性文件,并覆盖已读取的同名属性。
最后读取作为方法参数传递的属性,并覆盖已读取的同名属性。
因此,通过方法参数传递的属性具有最高优先级,resource/url 属性中指定的配置文件次之,最低优先级的是 properties 属性中指定的属性
MyBatis
3.4.2
增加了默认值,可以通过 ${username:ut_user} 来设置默认值,可以通过配置
property
来启用默认值,或者设置默认值的分隔符,如下配置:
settings
属性
这是 MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为,完整属性及说明表可以参考链接。一个配置完整的示例如下:
typeAliases
属性
类型别名是为 Java 类型设置一个短的名字。它只和 XML 配置有关,存在的意义仅在于用来减少类完全限定名的冗余。指定别名配置如下:
也可以指定一个包名,MyBatis
会搜索包名下面的需要的
Java
Bean
,比如:
每一个在包 domain.blog 中的 Java Bean,在没有注解的情况下,会使用 Bean 的首字母小写的非限定类名来作为它的别名。 比如 domain.blog.Author 的别名为 author;若有注解,则别名为其注解值。看下面的例子:
@Alias("author")
public classAuthor {
...
}
已经为许多常见的 Java 类型内建了相应的类型别名。它们都是大小写不敏感的,需要注意的是由基本类型名称重复导致的特殊处理,内建相应的类型表参见链接
。
typeHandlers
属性
无论是 MyBatis 在预处理语句(PreparedStatement)中设置一个参数时,还是从结果集中取出一个值时, 都会用类型处理器将获取的值以合适的方式转换成 Java 类型,默认的类型处理器参考链接。可以重写类型处理器或创建自己的类型处理器来处理不支持的或非标准的类型。 具体做法为:实现 org.apache.ibatis.type.TypeHandler 接口, 或继承一个很便利的类 org.apache.ibatis.type.BaseTypeHandler, 然后可以选择性地将它映射到一个 JDBC 类型,示例代码:自定义TypeHandler 代码
packageorg.mybatisExamples.simple;
importjava.sql.*;
importorg.apache.ibatis.type.BaseTypeHandler;
importorg.apache.ibatis.type.JdbcType;
//
继承基类重写方法,通过类型处理器的泛型,MyBatis 可以得知该类型处理器处理的 Java 类型
public classStringTypeHandler extendsBaseTypeHandler {
@Override
publicString getNullableResult(R