MyBatis的配置文件包含了影响MyBatis行为甚深的设置(settings)和属性(properties)信息。文档的顶层结果如下:
configuration配置
properties属性
setting设置
typeAliases类型命名
typeHandlers类型处理器
objectFactory对象工厂
plugins插件
environments环境
environment环境变量
transactionManager事务管理器
dataSource数据源
databaseIdProyider数据库厂商标识
mappers映射
属性都是可外部配置且可动态替换的,既可以在典型的Java属性文件中配置,亦可通过properties元素的子元素来传递。
例如:
其中的属性就可以在整个配置文件中使用来替换需要动态配置的属性值。
比如:
properties属性:将数据库连接参数单独配置在jdbc.properties中,只需要在mybatis.xml文件中加载jdbc.properties的属性值。 在mybatis.xml中就不需要对数据库连接参数硬编码(硬编码是指将可变变量用一个固定值来代替的方法)。在properties 元素体内定义的属性首先被读取。然后会读取properties元素中resource或url加载属性,它会覆盖已读取的同名属性。
注意:如果在properties标签里面定义的属性被${}所引用了,对#{}不管用。那么它不会读取parameterType里面的参数值。比如properties里面定义了id属性,值为40,在映射文件中引用该值,${id}那么我从parameterType里面传值时,不管我传基本类型还是引用类型进去都不会覆盖这个${id}值。始终都会读取40.
例如:
SqlSessionFactoryBuilder源码:
public SqlSessionFactory build(Reader reader, Properties properties) {
return build(reader, null, properties);
}
public SqlSessionFactory build(Reader reader, String environment, Properties properties) {
try {
XMLConfigBuilder parser = new XMLConfigBuilder(reader, environment, properties);
return build(parser.parse());
} catch (Exception e) {
throw ExceptionFactory.wrapException("Error building SqlSession.", e);
} finally {
ErrorContext.instance().reset();
try {
reader.close();
} catch (IOException e) {
// Intentionally ignore. Prefer previous error.
}
}
}
类型别名是为Java类型设置一个短的名字。它只和XML配置有关,存在意义仅在于用来减少类完全限定名的冗余。
例如:
当这样配置时,Blog可以用在任何使用domain.blog.Blog的地方。
也可以指定一个包名,MyBatis会在包名下面搜索需要的Java Bean
比如:
每一个包domain.blog中的Java Bean,在没有注解的情况下,会使用Bean的首字母小写的非限定类名来作为它的别名。比如domain.blog.Author的别名为author;若有注解,则别名为其注解值。看下面的例子:
@Alias("author") public class Author { ... }
mapper标签(映射配置):加载映射文件
MyBatis的真正强大在于他的映射语句,也是它的魔力所在,由于它的异常强大,映射器的XML文件就显得相对简单。如果拿它跟具有相同功能的JDBC代码进行对比,你会立即发现省掉了将近95%的代码。MyBatis就是针对SQL构建的,并且比普通的方法做的更好。
mapper标签:映射文件的根节点,在根节点中支持九个元素。
namespace是用于绑定Dao接口的,当你的namespace绑定接口后,你可以不用写接口实现类,mybatis会通过该绑定自动帮你找到对应要执行的SQL语句
注意:接口中的方法与映射文件中的SQL语句的ID一一对应
SQL映射文件有很少的几个顶级元素(按照它们应该被定义的顺序):
cache:给定命名空间的缓存配置
cache-ref:其命名空间缓存配置的引用。
resultMap:是最复杂也是最强大的元素,用来描述如何从数据库结果集中来加载对象。
parameterMap:已废弃,老式风格的参数映射。内联参数是首选,这个元素可能在将来被移除,这里不会记录。
sql:可被其他语句引用的可重用语句块。
insert:映射插入语句
update:映射更新语句
delete:映射更新语句
select:映射查询语句
比如
这个语句被称作selectPerson,接收一个int(或Integer)类型的参数,并返回一个HashMap类型的对象,其中的键是列名,值便是结果行中的对应值。
注意参数符号:#{id}
select元素有很多属性允许你配置,来决定每条语句的作用细节。
parameterType用于传递参数多参数可以使用传入对象以及map的方式传递多个参数。
#{}表示传递的参数值 类同jdbc的? ${}表示直接将参数值替换类同'%值%'
比如:
Map中必须存在id和name的键值对
SELECT调用存储过程
创建存储过程prg_add(p1 in number,p2 in number,p3 out number)
Mybatis映射文件中使用select调用存储过程
Map param = new HashMap();
param.put(“p1”, 1); param.put(“p2”, 2);
String returnValue = (String) session.selectOne(" prgAdd ", param);
System.out.println("result=" + param.get("result"));
System.out.println("returnValue=" + returnValue);
数据更变语句insert、update和delete的实现非常接近
parameterType:入参的全限定类名或类型别名
keyColumn:设置数据表自动生成的主键名。对特定数据库(如PostgreSQL),若自动生成的主键不是第一个字段则必须设置
keyProperty:默认值unset,用于设置getGeneratedKeys方法或selectKey子元素返回值将赋值到领域模型的哪个属性中
useGeneratedKey:取值范围true|false(默认值)设置是否使用JDBC的getGenereatedKeys方法获取主键并赋值到keyProperty设置的领域模型属性中。
MySQL和SQLServer执行auto-generated key field,因此当数据库设置好自增长主键后,可通过JDBC的getGeneratedKeys方法获取。但像Oralce等不支持auto-generated key field的数据库就不能用这种方法获取主键了
flushCache:取值范围true(默认值)|false,设置执行该操作后是否会清空二级缓存和本地缓存
timeout:默认为unset(依赖jdbc驱动器的设置),设置执行该操作的最大时限,超时将抛异常
databaseId:取值范围oracle|mysql等,表示数据库厂家,元素内部可通过`
对于不支持自动生成类型的数据库或可能不支持自动生成主键JDBC驱动来说,MyBatis有另外一种方法来生成主键。
这里有一个简单的示例,它可以生成一个随机ID(最好不要这么做,但这里展示了MyBatis处理问题的灵活性及其所关心的广度):
select FOOD_SEC.Nextval from dual
insert into food values(#{foodId},#{foodName},#{price})
在上面的示例中,selectKey元素将会首先运行,food的id会被设置,然后插入语句会被调用,这给了你一个和数据库中来处理自动生成的主键类似的行为,避免了使Java代码变得复杂
SQL
这个元素可以被用来定义可重用的SQL代码段,可以包含在其他语句中,它可以被静态地(在加载参数)参数化,不同的属性值太高包含的实例变化。
比如:
${alias}.id,${alias}.username,${alias}.password
这个SQL片段可以被包含在其他语句中,例如:
属性值可以用于包含的refid属性或者包含的字句里面的属性值。
Result Map
resultMap 元素时MyBatis中最重要最强大的元素。它就是让你远离90%的需要从结果集中取出数据的JDBC代码的那个东西,而且在一些情形下允许你做一些JDBC不支持的事情。事实上,编写相似于对复杂语句联合映射这些等同的代码,也许可以跨过上千行的代码。ResultMap的设计就是简单语句不需要明确的结果映射,而很多复杂语句确实需要描述它们的关系。