MyBatis全局配置文件的使用

最新推荐文章于 2023-02-21 09:03:21 发布
最新推荐文章于 2023-02-21 09:03:21 发布
阅读量610 收藏 2
点赞数
CC 4.0 BY-SA版权
分类专栏： 框架 文章标签： MyBatis
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/asc_123456/article/details/94643552

0.前言

  MyBatis涉及两个xml文件，一个是全局配置文件，另一个是映射文件。在官方文档中也有详细的解释：MyBatis全局配置文件的官方文档。通过看文档和写代码来学习全局配置文件的使用，全局配置文件的配置主要有以下：
配置

1.properties(属性)

这个标签的作用是可以使用外部的properties文件，获取这他的子标签的配置，来对相应属性的赋值，通过OGNL表达式：${…}来获取。下面的图中，第一个红框是通过属性文件的方式配置，第二个红框是通过子标签的方式。加载顺序是先加载子标签，在加载属性文件，相同名将会被覆盖。
在这里插入图片描述

2.setting(设置)

从官方文档来看，setting中主要有这些

<settings>
        <setting name="cacheEnabled" value="true"/>
        <setting name="lazyLoadingEnabled" value="true"/>
        <setting name="multipleResultSetsEnabled" value="true"/>
        <setting name="useColumnLabel" value="true"/>
        <setting name="useGeneratedKeys" value="false"/>
        <setting name="autoMappingBehavior" value="PARTIAL"/>
        <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
        <setting name="defaultExecutorType" value="SIMPLE"/>
        <setting name="defaultStatementTimeout" value="25"/>
        <setting name="defaultFetchSize" value="100"/>
        <setting name="safeRowBoundsEnabled" value="false"/>
        <setting name="mapUnderscoreToCamelCase" value="false"/>
        <setting name="localCacheScope" value="SESSION"/>
        <setting name="jdbcTypeForNull" value="OTHER"/>
        <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
    </settings>
设置名描述有效值默认值
cacheEnabled全局地开启或关闭配置文件中的所有映射器已经配置的任何缓存。true|falsetrue
lazyLoadingEnabled延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态。true|falsefalse
aggressiveLazyLoading当开启时，任何方法的调用都会加载该对象的所有属性。 否则，每个属性会按需加载（参考 lazyLoadTriggerMethods)。true|falsefalse （在 3.4.1 及之前的版本默认值为 true）
multipleResultSetsEnabled是否允许单一语句返回多结果集（需要驱动支持）。true|falsetrue
useColumnLabel使用列标签代替列名。不同的驱动在这方面会有不同的表现，具体可参考相关驱动文档或通过测试这两种不同的模式来观察所用驱动的结果。true|falsetrue
useGeneratedKeys允许 JDBC 支持自动生成主键，需要驱动支持。 如果设置为 true 则这个设置强制使用自动生成主键，尽管一些驱动不能支持但仍可正常工作（比如 Derby）。true|falseFalse
autoMappingBehavior指定 MyBatis 应如何自动映射列到字段或属性。 NONE 表示取消自动映射；PARTIAL 只会自动映射没有定义嵌套结果集映射的结果集。 FULL 会自动映射任意复杂的结果集（无论是否嵌套）。NONE,PARTIAL,FULLPARTIAL
autoMappingUnknownColumnBehavior指定发现自动映射目标未知列（或者未知属性类型）的行为。NONE: 不做任何反应 *WARNING :输出提醒日志 (‘org.apache.ibatis.session.AutoMappingUnknownColumnBehavior’ 的日志等级必须设置为 WARN) FAILING: 映射失败 (抛出 SqlSessionException)NONE, WARNING, FAILINGNONE
autoMappingBehavior指定 MyBatis 应如何自动映射列到字段或属性。 NONE 表示取消自动映射；PARTIAL 只会自动映射没有定义嵌套结果集映射的结果集。 FULL 会自动映射任意复杂的结果集（无论是否嵌套）。NONE,PARTIAL,FULLPARTIAL
autoMappingUnknownColumnBehavior指定发现自动映射目标未知列（或者未知属性类型）的行为。NONE: 不做任何反应* WARNING:输出提醒日志 (‘org.apache.ibatis.session.AutoMappingUnknownColumnBehavior’ 的日志等级必须设置为 WARN)* FAILING:映射失败 (抛出 SqlSessionException)NONE, WARNING, FAILINGNONE
defaultExecutorType配置默认的执行器。SIMPLE 就是普通的执行器；REUSE 执行器会重用预处理语句（prepared statements）； BATCH 执行器将重用语句并执行批量更新。SIMPLE REUSE BATCHSIMPLE
defaultStatementTimeout设置超时时间，它决定驱动等待数据库响应的秒数。任意正整数未设置 (null)
defaultFetchSize为驱动的结果集获取数量（fetchSize）设置一个提示值。此参数只可以在查询设置中被覆盖。任意正整数未设置 (null)
safeRowBoundsEnabled允许在嵌套语句中使用分页（RowBounds）。如果允许使用则设置为 false。true|falseFalse
safeResultHandlerEnabled允许在嵌套语句中使用分页（ResultHandler）。如果允许使用则设置为 false。true | falseTrue
mapUnderscoreToCamelCase是否开启自动驼峰命名规则（camel case）映射，即从经典数据库列名 A_COLUMN 到经典 Java 属性名 aColumn 的类似映射。true|falseFalse
localCacheScopeMyBatis 利用本地缓存机制（Local Cache）防止循环引用（circular references）和加速重复嵌套查询。 默认值为 SESSION，这种情况下会缓存一个会话中执行的所有查询。 若设置值为 STATEMENT，本地会话仅用在语句执行上，对相同 SqlSession 的不同调用将不会共享数据。SESSION|STATEMENTSESSION
jdbcTypeForNull当没有为参数提供特定的 JDBC 类型时，为空值指定 JDBC 类型。 某些驱动需要指定列的 JDBC 类型，多数情况直接用一般类型即可，比如 NULL、VARCHAR 或 OTHER。JdbcType 常量，常用值：NULL, VARCHAR 或 OTHER。OTHER
lazyLoadTriggerMethods指定哪个对象的方法触发一次延迟加载。用逗号分隔的方法列表。equals,clone,hashCode,toString
defaultScriptingLanguage指定动态 SQL 生成的默认语言。一个类型别名或完全限定类名。org.apache.ibatis.scripting.xmltags.XMLLanguageDriver
defaultEnumTypeHandler指定 Enum 使用的默认 TypeHandler 。（新增于 3.4.5）一个类型别名或完全限定类名。org.apache.ibatis.type.EnumTypeHandler
callSettersOnNulls指定当结果集中值为 null 的时候是否调用映射对象的 setter（map 对象时为 put）方法，这在依赖于 Map.keySet() 或 null 值初始化的时候比较有用。注意基本类型（int、boolean 等）是不能设置成 null 的。true|falsefalse
returnInstanceForEmptyRow当返回行的所有列都是空时，MyBatis默认返回 null。 当开启这个设置时，MyBatis会返回一个空实例。 请注意，它也适用于嵌套的结果集 （如集合或关联）。（新增于 3.4.2）true | falsefalse
logPrefix指定 MyBatis 增加到日志名称的前缀。任何字符串未设置
logImpl指定 MyBatis 所用日志的具体实现，未指定时将自动查找。SLF4J|LOG4J|LOG4J2|JDK_LOGGING|COMMONS_LOGGING|STDOUT_LOGGING|NO_LOGGING未设置
proxyFactory指定 Mybatis 创建具有延迟加载能力的对象所用到的代理工具。CGLIB|JAVASSISTJAVASSIST （MyBatis 3.3 以上）
vfsImpl指定 VFS 的实现自定义 VFS 的实现的类全限定名，以逗号分隔。未设置
useActualParamName允许使用方法签名中的名称作为语句参数名称。 为了使用该特性，你的项目必须采用 Java 8 编译，并且加上 -parameters 选项。（新增于 3.4.1）true|falsetrue
configurationFactory指定一个提供 Configuration 实例的类。 这个被返回的 Configuration 实例用来加载被反序列化对象的延迟加载属性值。 这个类必须包含一个签名为static Configuration getConfiguration() 的方法。（新增于 3.2.3）类型别名或者全类名.未设置

3.类型别名（typeAliases）

类型别名是为 Java 类型设置一个短的名字。 它只和 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 会在包名下面搜索需要的 Java Bean，比如：

<typeAliases>
  <package name="domain.blog"/>
</typeAliases>

4.类型处理器（typeHandlers）

主要用于java的数据类型与JDBC数据类型的转换。比如java中的String和数据库中的char类型

类型处理器Java 类型JDBC 类型
BooleanTypeHandlerjava.lang.Boolean, boolean数据库兼容的 BOOLEAN
LongTypeHandlerjava.lang.Long, long数据库兼容的 NUMERIC 或 BIGINT

5.插件（plugins）

MyBatis 允许你在已映射语句执行过程中的某一点进行拦截调用。默认情况下，MyBatis 允许使用插件来拦截的方法调用包括：

  • Executor (update, query, flushStatements, commit, rollback, getTransaction, close, isClosed)
  • ParameterHandler (getParameterObject, setParameters)
  • ResultSetHandler (handleResultSets, handleOutputParameters)
  • StatementHandler (prepare, parameterize, batch, update, query)

这些类中方法的细节可以通过查看每个方法的签名来发现，或者直接查看 MyBatis 发行包中的源代码。 如果你想做的不仅仅是监控方法的调用，那么你最好相当了解要重写的方法的行为。 因为如果在试图修改或重写已有方法的行为的时候，你很可能在破坏 MyBatis 的核心模块。 这些都是更低层的类和方法，所以使用插件的时候要特别当心。

6.环境配置（environments）

  MyBatis可以配置多个环境。开发、测试等使用不同的数据库，可以通过environments标签配置不同的环境。

<environments default="development">
        <environment id="test">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>

这里配置了两个环境， < environment id=“test” >和< environment id=“development” >是环境配置的唯一标识。通过< environments default=“development” >中的default来选择默认使用什么。事务管理器（transactionManager）：有两个值JDBC和MANAGED。事务管理器一般交给spring来做。数据源（dataSource）：共有UNPOOLED（不使用连接池）、POOLED（使用连接池）、JNDI 。也可以自定义。

7.数据库厂商标识（databaseIdProvider）

MyBatis 可以根据不同的数据库厂商执行不同的语句，这种多厂商的支持是基于映射语句中的 databaseId 属性。

<databaseIdProvider type="DB_VENDOR">
  <property name="SQL Server" value="sqlserver"/>
  <property name="MySQL" value="mysql"/>
  <property name="Oracle" value="oracle" />
</databaseIdProvider>

前面的name是数据库厂商的标识，通过value来为他们取一个别名。那么怎么来使用呢，我们在编写映射文件的时候使用databaseID来指定使用什么数据库厂商。
在这里插入图片描述

8.映射器（mappers）

将映射文件注册到全局配置文件中：

<mappers>
    <mapper resource="....xml"/>
</mappers>

还可以通过url的方式来配置网络文件。
此外，通过mapper的class属性配置接口的全类名也可以但是，同样需要映射文件，而且映射文件和接口文件的名要相同，并且在同一个包下。另外一种不需要映射文件的方式，就是直接在接口方法中添加写sql语句的注解。

另外需要注意的是这些标签的配置都是有顺序的。

9.结束语

全局配置文件在官方文档中有详细的使用说明：http://www.mybatis.org/mybatis-3/zh/configuration.html
里面也有中文版。
不对之处，请多指教！

【Mybatis】全局配置文件
青苔小榭
02-25 757
 1.mybatis 可以使用properties来引入外properties配置文件的内容   resource：引入类路径下的资源  url：引入网络路径或者磁盘路径下的资源   &lt;properties resource="dbconfig.properties"/&gt;       2.settings包含很多重要的设置项  setting:用来设置每一个设置项...
带你学习Mybatis之Mybatis全局配置文件
最新发布
Lxn2zh的博客
05-31 1210
如果想覆盖对象工厂的默认行为，可以通过创建自己的对象工厂来实现。mybatis可以配置多个环境，可以连接多个数据源，每一个数据源分为两部分：一个是数据源的配置，一个是数据库事务的配置，但是每个SqlSessionFactory实例只可以选择一种环境，如在开发环境、测试环境、生产环境等所用的配置可能不同，如果想要连接两个数据库，则需要创建两个SqlSessionFactory实例。mybatis中有很多默认的配置，可以使用settings来进行mybatis的自定义设置，覆盖掉mybatis中的默认配置。
MyBatis全局配置文件介绍
点滴记录
03-10 370
一、properties properties标签可以用于引入外部的配置文件，也可以用于定义全局变量。 比如我们在配置数据源的时候习惯把相关的信息单独的放在一个配置文件中，方便修改。 数据库配置信息dbconfig.properties jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/myba...
MyBatis-2 全局配置文件
04-13
全局配置文件中各个标签的具体测试使用
【MyBatis学习02】全局配置文件
程序老兵的博客
03-18 2425
本文博客地址：http://blog.youkuaiyun.com/soonfly/article/details/63352180 （转载请注明出处）在入门实例中，最先接触的是Mybatis全局配置文件。该配置文件的顶级标签是：configuration。在它之下，有以下子标签： 普通开发过程中（如入门实例）我们用四个标签就能完成配置工作。它们分别是： properties、 typeAliases、
Mybatis 全局配置文件详解
m0_53698336的博客
09-19 524
全部配置内容 MyBatis 配置文件的结构如下。 <?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 />&
深入探索MyBatis：全局配置文件解析及应用优化策略
12-13
通过理解并熟练掌握MyBatis全局配置文件的解析和各个元素的作用，开发者可以更好地利用MyBatis的优势，避免传统JDBC的弊端，例如硬编码SQL、资源管理不当等问题，从而提升应用的性能和可维护性。在实际项目中，应...
MyBatis全局配置文件详解
qq_45796208的博客
12-03 2366
MyBatis全局配置文件 MyBatis 的配置文件包含了影响 MyBatis 行为甚深的设置（settings）和属性（properties）信息。文档的 顶层结构如下： configuration 配置 • properties 属性 • settings 设置 • typeAliases 类型命名 • typeHandlers 类型处理器 • objectFactory 对象工厂 • plugins 插件 • environments 环境 • environment 环境变量
MyBatis | 全局配置文件
NULL的博客
08-03 498
按照 MyBatis 官方文档的介绍顺序，接下来记录关于全局配置文件的内容。从这一章开始我决定使用 Maven 工具来进行配置，但是整体的架构是不变的 首先先罗列一下需要介绍的几个配置参数，由于使用频率问题，我只会对其中几个比较常用的作介绍 * properties：用来加载属性文件 * settings：设置全局参数 * typeAliases：用来设置类型的别名 * type...
mybatis--全局配置文件
odelia的博客
03-24 685
前言上节课最后我们提到了两个重要的配置文件, 今天我们就先来讲讲mybatis的全局配置文件这个配置文件包含了影响mybatis行为的设置和属性.文档的顶层结构如下:propertiesmybatis可以使用properties来引入外部properties配置文件的内容;Resource:引入类路径下的资源url:引入网络/磁盘路径下的资源如果属性不只一个地方进行了配置,那么在propertie...
MyBatis-全局配置文件
笔记别偷看
03-28 208
mybatis-config.xml MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。 configuration（配置） properties（属性） settings（设置） typeAliases（类型别名） typeHandlers（类型处理器） objectFactory（对象工厂） plugins（插件） environments（环境配置） environment（环境变量） transactionManager（事务管理器） dataSource（数据
Mybatis 全局配置文件
dingd1234的博客
02-19 1282
一、环境搭建 环境搭建已经在 “搭建 Mybatis 工作环境“ 中介绍了，这里不再过多介绍。 二、Mybatis 全局配置文件 1、properties 标签 用于引入外部properties文件 <!-- properties: 引入外部properties文件 必须放在最前面,否则会报错 resource: 类路径下 url: 磁盘路径或网络路径 --> <properties resource="jdbc.properties"></p
Mybatis全局配置文件
m0_51505198的博客
03-05 654
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD com.Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> <!--1、mybatis可以使用properties来引入外部propert.
mybatis全局配置文件
z020315的博客
02-21 234
mybatis的配置文件推荐为命名mybatis-config.xml，其内容包含了会深深影响mybatis行为的设置和属性信息。使用者掌握方面有properties、settings、typeAliases、enveronments、mappers；--环境信息集合：起步学习只需要关注一下此处配置-->--单个环境信息-->--数据库厂商标识-->--全局参数设置-->--类型处理器-->
一、Mybatis全局配置文件
weixin_46203713的博客
10-12 118
一、Mybatis全局配置文件 1、Mybatis概述 Mybatis是支持定制化sql，存储过程以及高级映射的优秀的持久层框架 Mybatis避免了几乎所有JDBC代码和手动设置参数以及获取结果集 Mybatis可以使用简单的xml或注解用于配置和原始映射，将接口和java中POJO映射成数据库中的记录 2、环境搭建 相关驱动jar包 <dependences> <!-- 数据库驱动--> <dependency>
3、mybatis的全局配置文件mybatis-config.xml
chaizepeng的博客
08-11 5742
对于初学者，如果进行mybatis的学习呢？我总结了几点，会慢慢的更新出来。首先大家需要了解mybatis是什么、用mybatis来做什么、为什么要用mybatis、有什么优缺点；当知道了为什么的时候就开始了解如何用的问题，如何使用mybatis、有几种使用方式、各种方式的优缺点，在这个阶段也会学习mybatis涉及到的一些标签的用法；当知道了基础用法之后，就开始接触一些高级的用法，例如动态sql的使用、mybatis的缓存使用等；至此，在实战项目中使用mybatis进行开发已经没有问题了。 接下来就开始
mybatis全局配置文件详解
awodwde的博客
08-25 495
mybatis配置的两个文件： 1）、全局配置文件：mybatis-config.XML；指导mybatis正确运行的一些全局设置 2）、SQL映射文件：EmployeeDao.xml；相当于是对Dao接口的一个实现描述 获取到的接口是代理对象，mybatis自动创建的 SQLsessionfactory和SQLsession： SQLSessionFactory创建SqlSession对象，Factory只new一次就行 SQLsession：相当于connection和数据库进行交互的，和数据库的一次会
深入理解MyBatis全局配置文件的标签使用
以上是对MyBatis全局配置文件各个标签的详细介绍，它们共同定义了MyBatis的运行参数和行为。通过合理配置这些标签，可以使MyBatis框架按照用户的需求灵活地运行，同时也能确保应用在不同环境下都能保持良好的性能和...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值