Mybatis3配置文件解析

来源:互联网 发布:单片机计数器实验报告 编辑:程序博客网 时间:2024/05/01 15:35


2.1配置文件的基本结构

  • configuration —— 根元素 
    • properties —— 定义配置外在化
    • settings —— 一些全局性的配置
    • typeAliases —— 为一些类定义别名
    • typeHandlers —— 定义类型处理,也就是定义java类型与数据库中的数据类型之间的转换关系
    • objectFactory
    • plugins —— Mybatis的插件,插件可以修改Mybatis内部的运行规则
    • environments —— 配置Mybatis的环境 
      • environment 
        • transactionManager —— 事务管理器
        • dataSource —— 数据源
    • 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的一些全局配置属性

设置参数描述有效值默认值cacheEnabled这个配置使全局的映射器启用或禁用 缓存。true | falsetruelazyLoadingEnabled全局启用或禁用延迟加载。当禁用时, 所有关联对象都会即时加载。true | falsetrueaggressiveLazyLoading当启用时, 有延迟加载属性的对象在被 调用时将会完全加载任意属性。否则, 每种属性将会按需要加载。true | falsetruemultipleResultSetsEnabled允许或不允许多种结果集从一个单独 的语句中返回(需要适合的驱动)true | falsetrueuseColumnLabel使用列标签代替列名。 不同的驱动在这 方便表现不同。 参考驱动文档或充分测 试两种方法来决定所使用的驱动。true | falsetrueuseGeneratedKeys允许 JDBC 支持生成的键。 需要适合的 驱动。 如果设置为 true 则这个设置强制 生成的键被使用, 尽管一些驱动拒绝兼 容但仍然有效(比如  Derby)true | falseFalseautoMappingBehavior指定 MyBatis 如何自动映射列到字段/ 属性。PARTIAL 只会自动映射简单, 没有嵌套的结果。FULL 会自动映射任  意复杂的结果(嵌套的或其他情况) 。NONE, PARTIAL, FULLPARTIALdefaultExecutorType配置默认的执行器。SIMPLE 执行器没 有什么特别之处。REUSE 执行器重用 预处理语句。BATCH 执行器重用语句 和批量更新SIMPLE REUSE BATCHSIMPLEdefaultStatementTimeout设置超时时间, 它决定驱动等待一个数 据库响应的时间。Any positive integerNot Set (null)safeRowBoundsEnabledAllows using RowBounds on nested statements.true | falseFalsemapUnderscoreToCamelCaseEnables automatic mapping from classic database column names A_COLUMN to  camel case classic Java property names aColumn.true | falseFalselocalCacheScopeMyBatis uses local cache to prevent circular references and speed up  repeated nested queries. By default (SESSION) all queries executed during a  session are cached. If localCacheScope=STATEMENT local session will be used just  for statement execution, no data will be shared between two different calls to  the same SqlSession.SESSION | STATEMENTSESSIONjdbcTypeForNullSpecifies the JDBC type for null values when no specific JDBC type was  provided for the parameter. Some drivers require specifying the column JDBC type  but others work with generic values like NULL, VARCHAR or OTHER.JdbcType enumeration. Most common are: NULL, VARCHAR and OTHEROTHERlazyLoadTriggerMethodsSpecifies which Object's methods trigger a lazy loadA method name list separated by commasequals,clone,hashCode,toString

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还内置了一些类型别名:

别名映射的类型_bytebyte_longlong_shortshort_intint_integerint_doubledouble_floatfloat_booleanbooleanstringStringbyteBytelongLongshortShortintIntegerintegerIntegerdoubleDoublefloatFloatbooleanBooleandateDatedecimalBigDecimalbigdecimalBigDecimalobjectObjectmapMaphashmapHashMaplistListarraylistArrayListcollectionCollectioniteratorIterator

2.5 typeHandlers元素

每当MyBatis 设置参数到PreparedStatement 或者从ResultSet 结果集中取得值时,就会使用TypeHandler  来处理数据库类型与java 类型之间转换。

2.5.1 自定义typeHandlers

  1. 实现TypeHandler接口
    View Code
  2. 在配置文件中声明自定义的TypeHandler
    View Code

2.5.2 Mybatis内置的TypeHandler

类型处理器Java 类型JDBC 类型BooleanTypeHandlerjava.lang.Booleanboolean任何兼容的布尔值ByteTypeHandlerjava.lang.Byte, byte任何兼容的数字或字节类型ShortTypeHandlerjava.lang.Shortshort任何兼容的数字或短整型IntegerTypeHandlerjava.lang.Integerint任何兼容的数字和整型LongTypeHandlerjava.lang.Longlong任何兼容的数字或长整型FloatTypeHandlerjava.lang.Float, float任何兼容的数字或单精度浮点型DoubleTypeHandlerjava.lang.Doubledouble任何兼容的数字或双精度浮点型BigDecimalTypeHandlerjava.math.BigDecimal任何兼容的数字或十进制小数类型StringTypeHandlerjava.lang.StringCHAR 和 VARCHAR 类型ClobTypeHandlerjava.lang.StringCLOB 和 LONGVARCHAR 类型NStringTypeHandlerjava.lang.StringNVARCHAR 和 NCHAR 类型NClobTypeHandlerjava.lang.StringNCLOB 类型ByteArrayTypeHandlerbyte[]任何兼容的字节流类型BlobTypeHandlerbyte[]BLOB 和 LONGVARBINARY 类型DateTypeHandlerjava.util.DateTIMESTAMP 类型DateOnlyTypeHandlerjava.util.DateDATE 类型TimeOnlyTypeHandlerjava.util.DateTIME 类型SqlTimestampTypeHandlerjava.sql.TimestampTIMESTAMP 类型SqlDateTypeHandlerjava.sql.DateDATE 类型SqlTimeTypeHandlerjava.sql.TimeTIME 类型ObjectTypeHandlerAny其他或未指定类型EnumTypeHandlerEnumeration TypeVARCHAR-任何兼容的字符串类型, 作为代码存储(而不是索引)EnumOrdinalTypeHandlerEnumeration TypeAny compatible NUMERIC or DOUBLE, as the position is  stored (not the code itself).

2.6 objectFactory元素——用于指定结果集对象的实例是如何创建的。

下面演示了如何自定义ObjectFactory

1.继承DefaultObjectFactory

View Code
复制代码
// ExampleObjectFactory.javapublic class ExampleObjectFactory extends DefaultObjectFactory {public Object create(Class type) {return super.create(type);}public Object create(
复制代码

2.在配置文件中配置自定义的ObjectFactory

View Code
// 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示例:

  1. 实现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) {}}
    复制代码
  2. 在配置文件中声明插件
    View Code

2.8 Environments元素

可以配置多个运行环境,但是每个SqlSessionFactory 实例只能选择一个运行环境。

2.8.1 Environments配置示例:

View Code
复制代码
<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>

自定义事务管理器:

  1. 实现TranscactionFactory,它的接口定义如下:
    View Code
  2. 实现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>
0 0
原创粉丝点击
热门问题 老师的惩罚 人脸识别 我在镇武司摸鱼那些年 重生之率土为王 我在大康的咸鱼生活 盘龙之生命进化 天生仙种 凡人之先天五行 春回大明朝 姑娘不必设防,我是瞎子 没上专科线怎么办福建 联考没过本科线怎么办 拍婚纱拍的脸歪怎么办? 老婆彻底寒心要离婚怎么办 手机被同学偷了怎么办 钱被同学偷了怎么办 上班穿皮鞋脚疼怎么办 高跟靴子买大了怎么办 我怀了第三个小孩怎么办? 离婚前把钱花了怎么办 对谈对象有压力怎么办 和对象感情淡了怎么办 孩子处对象学习下降怎么办 孩子高三成绩差怎么办 老妈怨气太重怎么办 广东小高考有d怎么办 高考考生档案袋有个小洞怎么办 江苏省考生出省后小高考成绩怎么办 江苏小高考三D怎么办 小高考补考没过怎么办 理科高考200多分怎么办 高考没考过200分怎么办 电子手表指针不走了怎么办 家长说你教的不好怎么办 小升初分班考试考砸了怎么办 老公不给老婆看病怎么办 孕妈妈涨奶严重怎么办 90岁老头尿不下尿怎么办 妻子要离婚丈夫不离怎么办 弟媳妇天天在家吵架怎么办 弟媳妇不和我说话怎么办 我想和弟媳妇做一次怎么办 老公对弟媳妇有非分之想怎么办 跟弟媳妇有矛盾怎么办 学生考试前不认真怎么办 有人雇凶要杀我怎么办 高考理综数学英语都没考好怎么办 母亲判刑孩子未成年无人监管怎么办 高三了数学30分怎么办 母猪发烧耳朵放血止不住了怎么办? 青春期孩子动手打父母该怎么办