MyBatis xml配置文件详解

MyBatis配置文件主要包含properties、settings、typeAliases、typeHandlers、objectFactory、plugins、environments、databaseIdProvider和mappers等部分。properties用于配置外部属性,如数据库连接。settings配置全局设置,如缓存、懒加载。typeAliases定义类型别名,简化类引用。typeHandlers处理Java类型与数据库类型转换。objectFactory自定义对象工厂。plugins允许插件修改MyBatis行为。environments配置事务管理和数据源。databaseIdProvider提供数据库厂商标识。mappers注册映射文件或映射类。
摘要由CSDN通过智能技术生成

一、MyBatis 配置文件基本结构

       在使用mybatis框架时,首先导入其对应的jar包,并进行相应的配置,所以得对配置文件的每个参数都得了解。一个完全的mybatis配置文件结构如下:

[html]  view plain   copy
  1. <?xml version="1.0" encoding="UTF-8" ?>  
  2. <!DOCTYPE configuration  
  3. PUBLIC "-//mybatis.org//DTD Config 3.0//EN"  
  4. "http://mybatis.org/dtd/mybatis-3-config.dtd">  
  5. <!-- 配置文件的根元素 -->  
  6. <configuration>  
  7.     <!-- 属性:定义配置外在化 -->  
  8.     <properties></properties>  
  9.     <!-- 设置:定义mybatis的一些全局性设置 -->  
  10.     <settings>  
  11.        <!-- 具体的参数名和参数值 -->  
  12.        <setting name="" value=""/>   
  13.     </settings>  
  14.     <!-- 类型名称:为一些类定义别名 -->  
  15.     <typeAliases></typeAliases>  
  16.     <!-- 类型处理器:定义Java类型与数据库中的数据类型之间的转换关系 -->  
  17.     <typeHandlers></typeHandlers>  
  18.     <!-- 对象工厂 -->  
  19.     <objectFactory type=""></objectFactory>  
  20.     <!-- 插件:mybatis的插件,插件可以修改mybatis的内部运行规则 -->  
  21.     <plugins>  
  22.        <plugin interceptor=""></plugin>  
  23.     </plugins>  
  24.     <!-- 环境:配置mybatis的环境 -->  
  25.     <environments default="">  
  26.        <!-- 环境变量:可以配置多个环境变量,比如使用多数据源时,就需要配置多个环境变量 -->  
  27.        <environment id="">  
  28.           <!-- 事务管理器 -->  
  29.           <transactionManager type=""></transactionManager>  
  30.           <!-- 数据源 -->  
  31.           <dataSource type=""></dataSource>  
  32.        </environment>   
  33.     </environments>  
  34.     <!-- 数据库厂商标识 -->  
  35.     <databaseIdProvider type=""></databaseIdProvider>  
  36.     <!-- 映射器:指定映射文件或者映射类 -->  
  37.     <mappers></mappers>  
  38. </configuration>  

properties

properties元素主要是用来定义配置外在化,比如数据库的连接属性等。这些属性都是可外部配置且可动态替换的,既可以在典型的Java属性文件中配置,亦可以通过properties元素的子元素来传递。例如:

[html]  view plain   copy
  1. <properties resource="org/mybatis/example/config.properties">  
  2.   <property name="username" value="dev_user"/>  
  3.   <property name="password" value="F2Fa3!33TYyg"/>  
  4. </properties>  
其中的属性就可以在整个配置文件中使用来替换需要动态配置的属性值。比如在数据源中使用的例子:

[html]  view plain   copy
  1. <dataSource type="POOLED">  
  2.   <property name="driver" value="${driver}"/>  
  3.   <property name="url" value="${url}"/>  
  4.   <property name="username" value="${username}"/>  
  5.   <property name="password" value="${password}"/>  
  6. </dataSource>  
这个例子中的username和password将会由properties元素中设置的相应值来替换。driver和url属性将会由config.properties文件中对应的值来替换。这样就为配置提供了诸多灵活选择。属性也可以被传递到SqlSessionBuilder.build()方法中。例如:

[html]  view plain   copy
  1. SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, props);  
  2.   
  3.   
  4. // ... or ...  
  5.   
  6.   
  7. SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, environment, props);  
但是,这也就涉及到了优先级的问题,如果属性不只在一个地方配置,那么mybatis将会按照下面的顺序来加载:

  • 在properties元素体内指定的属性首先被读取。
  • 然后根据properties元素中的resource属性读取类路径下属性文件或根据url属性指定的路径读取属性文件,并覆盖已读取的同名属性。
  • 最后读取作为方法参数传递的属性,并覆盖已读取的同名属性。
因此,通过方法参数传递的属性具有最高优先级,resource/url属性中指定的配置文件次之,最低优先级的是properties属性中指定的属性。

 settings

setting是指定MyBatis的一些全局配置属性,这是MyBatis中极为重要的调整设置,它们会改变MyBatis的运行时行为,所以我们需要清楚的知道这些属性的作用及默认值。

设置参数 描述 有效值 默认值
cacheEnabled 该配置影响的所有映射器中配置的缓存的全局开关 true | false true
lazyLoadingEnabled 延迟加载的全局开关。当开启时,所有关联对象都会延迟加载。 特定关联关系中可通过设置fetchType属性来覆盖该项的开关状态 true | false false
aggressiveLazyLoading 当启用时,对任意延迟属性的调用会使带有延迟加载属性的对象完整加载;反之,每种属性将会按需加载。 true | false true
multipleResultSetsEnabled 是否允许单一语句返回多结果集(需要兼容驱动)。 true | false true
useColumnLabel 使用列标签代替列名。不同的驱动在这方面会有不同的表现, 具体可参考相关驱动文档或通过测试这两种不同的模式来观察所用驱动的结果。 true | false true
useGeneratedKeys 允许 JDBC 支持自动生成主键,需要驱动兼容。 如果设置为 true 则这个设置强制使用自动生成主键,尽管一些驱动不能兼容但仍可正常工作(比如 Derby)。 true | false False
autoMappingBehavior 指定 MyBatis 应如何自动映射列到字段或属性。 NONE 表示取消自动映射;PARTIAL 只会自动映射没有定义嵌套结果集映射的结果集。 FULL 会自动映射任意复杂的结果集(无论是否嵌套)。 NONE, PARTIAL, FULL PARTIAL
defaultExecutorType 配置默认的执行器。SIMPLE 就是普通的执行器;REUSE 执行器会重用预处理语句(prepared statements); BATCH 执行器将重用语句并执行批量更新。 SIMPLE REUSE BATCH SIMPLE
defaultStatementTimeout 设置超时时间,它决定驱动等待数据库响应的秒数。 Any positive integer Not Set (null)
defaultFetchSize Sets the driver a hint as to control fetching size for return results. This parameter value can be override by a query setting. Any positive integer Not Set (null)
safeRowBoundsEnabled 允许在嵌套语句中使用分页(RowBounds)。 true | false False
mapUnderscoreToCamelCase 是否开启自动驼峰命名规则(camel case)映射,即从经典数据库列名 A_COLUMN 到经典 Java 属性名 aColumn 的类似映射。 true | false False
localCacheScope MyBatis 利用本地缓存机制(Local Cache)防止循环引用(circular references)和加速重复嵌套查询。 默认值为 SESSION,这种情况下会缓存一个会话中执行的所有查询。 若设置值为 STATEMENT,本地会话仅用在语句执行上,对相同 SqlSession 的不同调用将不会共享数据。 SESSION | STATEMENT SESSION
jdbcTypeForNull 当没有为参数提供特定的 JDBC 类型时,为空值指定 JDBC 类型。 某些驱动需要指定列的 JDBC 类型,多数情况直接用一般类型即可,比如 NULL、VARCHAR 或 OTHER。 JdbcType enumeration. Most common are: NULL, VARCHAR and OTHER OTHER
lazyLoadTriggerMethods 指定哪个对象的方法触发一次延迟加载。 A method name list separated by commas equals,clone,hashCode,toString
defaultScriptingLanguage 指定动态 SQL 生成的默认语言。 A type alias or fully qualified class name. org.apache.ibatis.scripting.xmltags.XMLDynamicLanguageDriver
callSettersOnNulls 指定当结果集中值为 null 的时候是否调用映射对象的 setter(map 对象时为 put)方法,这对于有 Map.keySet() 依赖或 null 值初始化的时候是有用的。注意基本类型(int、boolean等)是不能设置成 null 的。 true | false false
logPrefix 指定 MyBatis 增加到日志名称的前缀。 Any String Not set
logImpl 指定 MyBatis 所用日志的具体实现,未指定时将自动查找。 SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING Not set
proxyFactory 指定 Mybatis 创建具有延迟加载能力的对象所用到的代理工具。 CGLIB | JAVASSIST JAVASSIST (MyBatis 3.3 or above)

一个完整的settings元素示例如下:

[html]  view plain   copy
  • 24
    点赞
  • 164
    收藏
    觉得还不错? 一键收藏
  • 9
    评论
评论 9
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值