Mybatis3配置文件解析
来源:互联网 发布:单片机计数器实验报告 编辑:程序博客网 时间:2024/05/01 15:35
2.1配置文件的基本结构
- configuration —— 根元素
- properties —— 定义配置外在化
- settings —— 一些全局性的配置
- typeAliases —— 为一些类定义别名
- typeHandlers —— 定义类型处理,也就是定义java类型与数据库中的数据类型之间的转换关系
- objectFactory
- plugins —— Mybatis的插件,插件可以修改Mybatis内部的运行规则
- environments —— 配置Mybatis的环境
- environment
- transactionManager —— 事务管理器
- dataSource —— 数据源
- environment
- databaseIdProvider
- mappers —— 指定映射文件或映射类
2.2 properties元素——定义配置外在化
<!--样例--><properties resource="org/mybatis/example/config.properties"><property name="username" value="dev_user"/><property name="password" value="F2Fa3!33TYyg"/></properties>
配置外在化的属性还可以通过SqlSessionFactoryBuilder.build()方法提供,如:
SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, props);
配置外在化的优先级是 build方法->resource属性指定的文件->property元素
2.3 settings元素——Mybatis的一些全局配置属性
2.4 typeAliases元素——定义类别名,简化xml文件的配置,如:
<typeAliases><typeAlias alias="Author" type="domain.blog.Author"/><typeAlias alias="Blog" type="domain.blog.Blog"/><typeAlias alias="Comment" type="domain.blog.Comment"/><typeAlias alias="Post" type="domain.blog.Post"/><typeAlias alias="Section" type="domain.blog.Section"/><typeAlias alias="Tag" type="domain.blog.Tag"/></typeAliases>
Mybatis还内置了一些类型别名:
2.5 typeHandlers元素
每当MyBatis 设置参数到PreparedStatement 或者从ResultSet 结果集中取得值时,就会使用TypeHandler 来处理数据库类型与java 类型之间转换。
2.5.1 自定义typeHandlers
- 实现TypeHandler接口View Code
- 在配置文件中声明自定义的TypeHandlerView Code
2.5.2 Mybatis内置的TypeHandler
2.6 objectFactory元素——用于指定结果集对象的实例是如何创建的。
下面演示了如何自定义ObjectFactory
1.继承DefaultObjectFactory
// ExampleObjectFactory.javapublic class ExampleObjectFactory extends DefaultObjectFactory {public Object create(Class type) {return super.create(type);}public Object create(
2.在配置文件中配置自定义的ObjectFactory
// MapperConfig.xml<objectFactory type="org.mybatis.example.ExampleObjectFactory"><property name="someProperty" value="100"/></objectFactory>
2.7 plugins元素
MyBatis 允许您在映射语句执行的某些点拦截方法调用。默认情况下,MyBatis 允许插件(plugins)拦截下面的方法:
- Executor (update, query, flushStatements, commit, rollback, getTransaction, close, isClosed)
- ParameterHandler (getParameterObject, setParameters)
- ResultSetHandler (handleResultSets, handleOutputParameters)
- StatementHandler (prepare, parameterize, batch, update, query)
下面是自定义plugin示例:
- 实现Interceptor接口,并用注解声明要拦截的方法
// ExamplePlugin.java@Intercepts({@Signature(type= Executor.class,method = "update",args = {MappedStatement.class,Object.class})})public class ExamplePlugin implements Interceptor {public Object intercept(Invocation invocation) throws Throwable {return invocation.proceed();}public Object plugin(Object target) {return Plugin.wrap(target, this);}public void setProperties(Properties properties) {}}
- 在配置文件中声明插件View Code
2.8 Environments元素
可以配置多个运行环境,但是每个SqlSessionFactory 实例只能选择一个运行环境。
2.8.1 Environments配置示例:
<environments default="development"><environment id="development"><transactionManager type="JDBC"><property name="..." value="..."/></transactionManager><dataSource type="POOLED"><property name="driver" value="${driver}"/><property name="url" value="${url}"/><property name="username" value="${username}"/><property name="password" value="${password}"/></dataSource></environment></environments>
2.8.2 transactionManager事务管理器
MyBatis 有两种事务管理类型(即type=”[JDBC|MANAGED]”):
- JDBC – 这个配置直接简单使用了 JDBC 的提交和回滚设置。 它依赖于从数据源得 到的连接来管理事务范围。
- MANAGED – 这个配置几乎没做什么。它从来不提交或回滚一个连接。而它会让 容器来管理事务的整个生命周期(比如 Spring 或 JEE 应用服务器的上下文) 默认 情况下它会关闭连接。 然而一些容器并不希望这样, 因此如果你需要从连接中停止 它,将 closeConnection 属性设置为 false。例如:
<transactionManager type="MANAGED"><property name="closeConnection" value="false"/></transactionManager>
自定义事务管理器:
- 实现TranscactionFactory,它的接口定义如下:View Code
- 实现TransactionFactory,它的接口定义如下:
public interface Transaction {Connection getConnection();void commit() throws SQLException;void rollback() throws SQLException;void close() throws SQLException;}
2.8.3 dataSource数据源
dataSource 元素使用标准的JDBC 数据源接口来配置JDBC 连接对象源。
MyBatis 内置了三种数据源类型:
UNPOOLED – 这个数据源的实现是每次被请求时简单打开和关闭连接。它有一点慢, 这是对简单应用程序的一个很好的选择, 因为它不需要及时的可用连接。 不同的数据库对这 个的表现也是不一样的, 所以对某些数据库来说配置数据源并不重要, 这个配置也是闲置的。 UNPOOLED 类型的数据源仅仅用来配置以下 5 种属性:
- driver – 这是 JDBC 驱动的 Java 类的完全限定名(如果你的驱动包含,它也不是 数据源类)。
- url – 这是数据库的 JDBC URL 地址。
- username – 登录数据库的用户名。
- password – 登录数据库的密码。
- defaultTransactionIsolationLevel – 默认的连接事务隔离级别。
作为可选项,你可以传递数据库驱动的属性。要这样做,属性的前缀是以“driver.”开 头的,例如:
- driver.encoding=UTF8
这 样 就 会 传 递 以 值 “ UTF8 ” 来 传 递 属 性 “ encoding ”, 它 是 通 过 DriverManager.getConnection(url,driverProperties)方法传递给数据库驱动。
POOLED – 这是 JDBC 连接对象的数据源连接池的实现,用来避免创建新的连接实例 时必要的初始连接和认证时间。这是一种当前 Web 应用程序用来快速响应请求很流行的方 法。
除了上述(UNPOOLED)的属性之外,还有很多属性可以用来配置 POOLED 数据源:
- poolMaximumActiveConnections – 在任意时间存在的活动(也就是正在使用)连 接的数量。默认值:10
- poolMaximumIdleConnections – 任意时间存在的空闲连接数。
- poolMaximumCheckoutTime – 在被强制返回之前,池中连接被检查的时间。默认 值:20000 毫秒(也就是 20 秒)
- poolTimeToWait – 这是给连接池一个打印日志状态机会的低层次设置,还有重新 尝试获得连接, 这些情况下往往需要很长时间 为了避免连接池没有配置时静默失 败)。默认值:20000 毫秒(也就是 20 秒)
- poolPingQuery – 发送到数据的侦测查询,用来验证连接是否正常工作,并且准备 接受请求。默认是“NO PING QUERY SET” ,这会引起许多数据库驱动连接由一 个错误信息而导致失败。
- poolPingEnabled – 这是开启或禁用侦测查询。如果开启,你必须用一个合法的 SQL 语句(最好是很快速的)设置 poolPingQuery 属性。默认值:false。
- poolPingConnectionsNotUsedFor – 这是用来配置 poolPingQuery 多次时间被用一次。 这可以被设置匹配标准的数据库连接超时时间, 来避免不必要的侦测。 默认值: 0(也就是所有连接每一时刻都被侦测-但仅仅当 poolPingEnabled 为 true 时适用)。
JNDI – 这个数据源的实现是为了使用如 Spring 或应用服务器这类的容器, 容器可以集 中或在外部配置数据源,然后放置一个 JNDI 上下文的引用。这个数据源配置只需要两个属 性:
- initial_context – 这 个 属 性 用 来 从 初 始 上 下 文 中 寻 找 环 境 ( 也 就 是 initialContext.lookup(initial——context) 。这是个可选属性,如果被忽略,那么 data_source 属性将会直接以 initialContext 为背景再次寻找。
- data_source – 这是引用数据源实例位置的上下文的路径。它会以由 initial_context 查询返回的环境为背景来查找,如果 initial_context 没有返回结果时,直接以初始 上下文为环境来查找。
和其他数据源配置相似, 它也可以通过名为 “env.” 的前缀直接向初始上下文发送属性。 比如:
- env.encoding=UTF8
在初始化之后,这就会以值“UTF8”向初始上下文的构造方法传递名为“encoding” 的属性。
2.9 mappers元素
既然 MyBatis 的行为已经由上述元素配置完了,我们现在就要定义 SQL 映射语句了。 但是, 首先我们需要告诉 MyBatis 到哪里去找到这些语句。 Java 在这方面没有提供一个很好 的方法, 所以最佳的方式是告诉 MyBatis 到哪里去找映射文件。 你可以使用相对于类路径的 资源引用,或者字符表示,或 url 引用的完全限定名(包括 file:///URLs) 。例如:
<!-- Using classpath relative resources --><mappers> <mapper resource="org/mybatis/builder/AuthorMapper.xml"/> <mapper resource="org/mybatis/builder/BlogMapper.xml"/> <mapper resource="org/mybatis/builder/PostMapper.xml"/></mappers>
<!-- Using url fully qualified paths --><mappers> <mapper url="file:///var/mappers/AuthorMapper.xml"/> <mapper url="file:///var/mappers/BlogMapper.xml"/> <mapper url="file:///var/mappers/PostMapper.xml"/></mappers>
<!-- Using mapper interface classes --><mappers> <mapper class="org.mybatis.builder.AuthorMapper"/> <mapper class="org.mybatis.builder.BlogMapper"/> <mapper class="org.mybatis.builder.PostMapper"/></mappers>
<!-- Register all interfaces in a package as mappers --><mappers> <package name="org.mybatis.builder"/></mappers>
- mybatis3 配置文件解析
- mybatis3 配置文件解析
- Mybatis3配置文件解析
- mybatis3 配置文件解析
- mybatis3 配置文件解析
- Mybatis3源码分析(三):解析mapper的xml配置文件
- Mybatis3源码分析(三):解析mapper的xml配置文件
- MyBatis3+Spring3+Struts2配置文件
- mybatis3--4.全局配置文件
- mybatis3--5.映射配置文件
- Spring4+MyBatis3整合配置文件详解
- 三、Mybatis3的XML配置文件介绍
- c3p0+spring3+mybatis3的整合配置文件示例
- mybatis3与spirng3配置文件中的一个坑
- Mybatis3
- 解析配置文件
- Mybatis3源码分析(12)-Sql解析执行-MetaObject
- Mybatis3源码分析(14)-Sql解析执行-StatementHandler
- java SSLContext
- sqlite数据库详解
- mac 下终端的颜色配置
- 黑马程序员——网络编程
- ios电话号码验证
- Mybatis3配置文件解析
- Solr主从配置
- Linux那些事儿 之 戏说USB(12)接口是设备的接口(一)
- java细节,你注意到了多少?
- android端调用服务端的webservice接口,报错总结。
- Android:自定义toast
- NSNotificationCenter 编程简介
- struct自然边界上的内存对齐
- 自行控制LoadRunner的socket协议性能测试