MyBatis–主配置文件详解
主配置文件可以随便命名,其主要完成以下几个功能:
- 注册存放DB连接四要素的属性文件
- 注册实体类的权限定性类名的别名
- 配置MyBatis运行环境,即数据源与事务管理器
- 注册映射文件
MyBatis.xml:
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!-- 注册属性文件 -->
<properties resource="jdbc.properties"/>
<!-- 配置MyBatis运行环境 -->
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"></transactionManager>
<dataSource type="POOLED">
<property name="driver" value="${jdbc.dirver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.user}"/>
<property name="password" value="${jdbc.password}"/>
</dataSource>
</environment>
</environments>
<!-- 注册映射文件 -->
<mappers>
<mapper resource="com/hcx/dao/mapper.xml"/>
<!-- <mapper resource="com/hcx/dao/mapper2.xml"/> -->
</mappers>
</configuration>
一、注册DB连接四要素属性文件
<!-- 注册DB连接四要素的属性文件 -->
<properties resource="jdbc.properties"/>
二、指定实体类权限定性类名的别名
1.方式
一般使用方式,这样做的好处是会将该包中年所有实体类的简单类名指定为别名。
<!--配置别名-->
<typeAliases>
<package name="com.hcx.beans"/>
</typeAliases>
2.通过指定。
- type:权限定性类名
- alias:别名
该方式的好处是,可以指定别名为简单类名以外的其他名称。当然,弊端是,必须逐个指定,比较繁琐。
<!-- 注册类的别名 -->
<typeAliases>
<typeAlias type="com.hcx.beans.Student" alias="Student"/>
</typeAliases>
3.使用MyBatis内置的类型别名
基本类型:
常用包装类型:
三、配置MyBatis的运行环境
主要是配置数据源和事务管理器
1.标签
在中可以包含多个运行环境,但其default属性指定了当前MyBatis运行时所选择使用的环境。
2.标签
<!-- 使用jdbc事务管理 -->
<transactionManager type="JDBC" />
该标签用于指定MyBatis所使用的事务管理器。MyBatis支持两种事务管理器;JDBC与MANAGED
- JDBC:使用jdbc事务管理机制。即,通过connection的commit()方法提交,通过rollback方法回滚。但默认情况下,MyBatis将自动提交功能关闭了,改为了手动提交。即程序中需要显式的对事务进行提交或回滚。
- MANAGED:由容器来管理事务的整个生命周期(如Spring容器)
3.标签
该标签用于配置MyBatis使用的数据源类型与数据库连接基本属性。常见类型有:UNPOOLED、POOLED、JDNI等
- UNPOOLED:不使用连接池。即每次请求,都会为其创建一个DB连接,使用完毕后,会马上将此连接关闭。
- POOLED:使用数据库连接池来维护连接
- JDNI:数据源可以定义到应用的外部,通过JDNI容器获取数据库连接。
代码:
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/test"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
若要从属性文件中读取DB连接四要素信息,则使用如下方式:
<!-- 数据库连接池 -->
<dataSource type="POOLED">
<property name="driver" value="${jdbc.dirver}"/>
<property name="url" value="${jdbc.url}"/>
<property name="username" value="${jdbc.user}"/>
<property name="password" value="${jdbc.password}"/>
</dataSource>
四、指定映射文件
指定映射文件的方式有多种,但所有的方式,都是指定在标签中的。
1.方式
<!-- 注册映射文件 -->
<mappers>
<mapper resource="com/hcx/dao/mapper.xml"/>
<mapper resource="com/hcx/dao/mapper2.xml"/>
</mappers>
2.方式
<mappers>
<mapper url="file:///E:\workspace\mybatisPrimary\src\com\hcx\dao\IStudentDao.xml"/>
</mappers>
该方式的好处是,可以将映射文件放在本地或网络的任意位置,通过url地址即可直接访问。当通常映射文件是存放在当前应用中的,所以该方式不常用。
3.方式
class属性值为dao接口的全类名
<mappers>
<mapper class="com.hcx.dao.IStudentDao"/>
</mappers>
该方式的使用,需要满足以下几个要求:
- 映射文件名要与dao接口名相同
- 映射文件要与接口在同一包中
- 映射文件中的namespace属性值为dao接口的全类名
4.方式
当映射文件较多时,也可以使用如下形式。其中package的naem属性指定映射文件所存放的包。
<mappers>
<mapper class="com.hcx.dao.IStudentDao"/>
</mappers>
但,这种方式的使用需要满足以下条件:
- dao使用mapper动态代理实现
- 映射文件名要与dao几口名相同
- 映射文件要与接口在同一包中
- 映射文件中的namespace属性值为dao接口的全类名