02、MyBatis XML 全局配置文件
MyBatis-全局配置文件
在MyBatis中全局配置文件有着重要的地位,里面有9类行为信息;如果我们要想将MyBatis运用的熟练,配置全局配置文件是必不可少的步骤,所以我们一定要啃下这一块硬骨头。该文章是结合MyBatis配置文件网页加个人理解做的笔记,如果有的地方写的不够好或者有错误。恳请大家多多给我指出,因为我也是在摸索中进步。下面将对9大行为信息和属性信息配置进行解释.
1. MyBatis配置
注:MyBatis的标签是有顺序的,如果不按照顺序会出现The content of element type "configuration" must match 错误.标签的顺序为:
在Eclipse中引入XML的dtd约束文件,方便编写XML的时候有提示
1)属性(properties)
(1)dbconfig.properties
jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/mybatis jdbc.username=root jdbc.password=root123
(2)properties属性
<!-- properties:引入外部properties配置文件的内容 --> <!-- url:引入网络路径或者磁盘路径下的资源 --> <!-- resource:引入类路径下的资源 --> <properties resource="dbconfig.properties" ></properties>
(3)使用properties配置mybatis-config.xml
<!-- properties:引入外部properties配置文件的内容 --> <!-- url:引入网络路径或者磁盘路径下的资源 --> <!-- resource:引入类路径下的资源 --> <properties resource="dbconfig.properties" ></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>
2)设置(settings)
(1)mapUnderscoreToCamelCase
<!-- settings:包含很多设置项 --> <!-- setting:用来选择设置中各项设置 --> <!-- name:设置项名 --> <!-- value:设置项取值 --> <settings> <setting name="mapUnderscoreToCamelCase" value="true"/> </settings>
3)类型别名(typeAliases)
注意:MyBatis已经为许多常见的 Java 类型内建了相应的类型别名。它们都是大小写不敏感的,我们在起别名的时候千万不要占用已有的别名。
我们目前最新的mybatis推荐使用全限定类名书写。
<!-- typeAliases:别名处理器,可以为java类型起别名.别名不区分大小写 emp 和 Emp是一样的 --> <!-- typeAlias:为java类型起别名 --> <!-- type:指定要起别名的类型全类名;默认别名就是类名小写 --> <!-- alias:指定新的别名 --> <!-- package:指定一个包名,为该包下所有类批量起别名 --> <!-- 批量起别名的情况下,使用@Alias注解为某个类型指定新的别名 如:@Alias("empp") 起别名为empp--> <typeAliases> <!-- <typeAlias type="com.atguigu.mybatis.bean.Employee" alias="emp"/> --> <package name="com.atguigu.mybatis.bean" /> </typeAliases>
4)类型处理器(typeHandlers)
无论是 MyBatis 在预处理语句(PreparedStatement)中设置一个参数时,还是从结果集中取出一个值时, 都会用类型处理器将获取的值以合适的方式转换成 Java 类型。
• 日期和时间的处理,JDK1.8以前一直是个头疼的问题。我们通常使用JSR310规范领导者Stephen Colebourne创建的Joda-Time来操作。1.8已经实现全部的JSR310规范了。
• 日期时间处理上,我们可以使用MyBatis基于JSR310(Date and Time API)编写的各种日期时间类型处理器。
• MyBatis3.4以前的版本需要我们手动注册这些处理器,以后的版本都是自动注册的
5)对象工厂(objectFactory)
6)插件(plugins)
插件是MyBatis提供的一个非常强大的机制,我们可以通过插件来修改MyBatis的一些核心行为。插件通过动态代理机制,可以介入四大对象的任何一个方法的执行。
7)环境配置(environments)
<!-- environments:配置多种环境;default标签可以指定使用的环境,可以达到快速切换环境的效果 --> <!-- environment 配置一个具体的环境信息;id代表当前环境的唯一标识;必须有两个标签transactionManager/type --> <!-- transactionManager:事务管理器 --> <!-- type:事务管理器的类型;JDBC(JdbcTransactionFactory)|MANAGED(ManagedTransactionFactory)|自定义事务管理器(实现TransactionFactory接口.type指定为全类名) --> <!-- JDBC:使用了 JDBC 的提交和回滚设置,依赖于从数据源得到的连接来管理事务范围 --> <!-- MANAGED:不提交或回滚一个连接、让容器来管理事务的整个生命周期(比如 JEE 应用服务器的上下文) --> <!-- 自定义:实现TransactionFactory接口,type=全类名/别名 --> <!-- dataSource:数据源 --> <!-- type:数据源类型;UNPOOLED(UnpooledDataSourceFactory)|POOLED(PooledDataSourceFactory)|JNDI(JndiDataSourceFactory)|自定义数据源(实现DataSourceFactory接口,type是全类名) --> <!-- UNPOOLED:不使用连接池 --> <!-- POOLED:使用连接池 --> <!-- JNDI: 在EJB 或应用服务器这类容器中查找指定的数据源 --> <!-- 自定义:实现DataSourceFactory接口,定义数据源的获取方式 --> <!-- 实际开发中我们使用Spring管理数据源,并进行事务控制的配置来覆盖上述配置 --> <environments default="development"> <environment id="test"> <transactionManager type="JDBC" /> <dataSource type=""> <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> <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>
8)数据库厂商标识(databaseIdProvider)
MyBatis 可以根据不同的数据库厂商执行不同的语句.
(1)添加select
<select id="getEmpById" resultType="com.atguigu.mybatis.bean.Employee" > select * from tbl_employee where id = #{id} </select> <select id="getEmpById" resultType="com.atguigu.mybatis.bean.Employee" databaseId="mysql" > select id,email from tbl_employee where id = #{id} </select> <select id="getEmpById" resultType="com.atguigu.mybatis.bean.Employee" databaseId="oracle"> select * from tbl_employee where id = #{id} </select>
(2)添加databaseIdProvider
<!-- databaseIdProvider:持多数据库厂商 --> <!-- type="DB_VENDOR":VendorDatabaseIdProvider --> <!-- type:得到数据库厂商的标识(驱动getDatabaseProductName()),mybatis就能根据数据库厂商标识来执行不同的sql --> <databaseIdProvider type="DB_VENDOR"> <!-- 为不同的数据库厂商起别名 --> <property name="MySQL" value="mysql"/> <property name="Oracle" value="oracle"/> <property name="SQL Server" value="sqlserver"/> </databaseIdProvider>
(3)配置properties(数据库链接信息)
#Mysql jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/mybatis jdbc.username=root jdbc.password=root123 #Oracle orcl.driver=oracle.jdbc.OracleDriver orcl.url=jdbc:oracle:thin:@localhost:1521:orcl orcl.username=scott orcl.password=123456
(4)配置environments
<environments default="dev_mysql"> <environment id="dev_mysql"> <transactionManager type="JDBC"></transactionManager> <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> <environment id="dev_oracle"> <transactionManager type="JDBC" /> <dataSource type="POOLED"> <property name="driver" value="${orcl.driver}" /> <property name="url" value="${orcl.url}" /> <property name="username" value="${orcl.username}" /> <property name="password" value="${orcl.password}" /> </dataSource> </environment> </environments>
9)映射器(mappers)
(1)mybatis-config.xml
<!-- !!!!!!!!!非常重要!!!!!!!!!!!! --> <!-- 将我们写好的sql映射文件<EmployeeMapper.xml>一定要注册到全局配置文件中 --> <!-- mappers:将sql映射注册到全局配置中 --> <!-- mapper:注册一个sql映射 --> <!-- resource(使用相对于类路径的资源引用):引用类路径下的sql映射文件 org/mybatis/builder/AuthorMapper.xml--> <!-- url(使用完全限定资源定位符):引用网路路径或者磁盘路径下的sql映射文件 file:///var/mappers/AuthorMapper.xml --> <!-- class(使用映射器接口实现类的完全限定类名):引用(注册)接口 org.mybatis.builder.AuthorMapper --> <!-- 存在sql映射文件:映射文件名必须和接口同名,需配置文件与接口文件同一目录下(com.atguigu.mybatis.dao.EmployeeMapper.java)和(com.atguigu.mybatis.dao.EmployeeMapper.xml --> <!-- 不存在sql映射文件:所有的sql都是利用注解写在接口上(com.atguigu.mybatis.dao.EmployeeMapperAnnotation) --> <!-- package:批量注册sql映射 --> <mappers> <!-- <mapper resource="com/batis/mapper/EmployeeMapper.xml" /> --> <!-- <mapper class="com.atguigu.mybatis.dao.EmployeeMapperAnnotation"/> --> <package name="com.atguigu.mybatis.dao"/> </mappers>
(2)select注解
public interface EmployeeMapperAnnotation { @Select("select * from tbl_employee where id=#{id}") public Employee getEmpById(Integer id); }