MyBatis的全局配置文件

概述

MyBatis的全局配置文件可以配置的屬性如下

• properties 屬性
• settings 設(shè)置
• typeAliases 類型別名
• typeHandlers 類型處理器
• objectFactory 對象工廠
• plugins 插件
• environments 環(huán)境
  • environment 環(huán)境變量
    • transactionManager 事務(wù)管理器
    • dataSource 數(shù)據(jù)源
• databaseIdProvider 數(shù)據(jù)庫廠商標(biāo)識
• mappers 映射器

properties屬性

MyBatis使用properties來引入外部properties配置文件的內(nèi)容，resource：引入類路徑下的資源，url引入網(wǎng)絡(luò)路徑或者磁盤路徑下的資源?？梢杂糜趯?shù)據(jù)源連接信息放在properties文件中，與Spring整合后就寫在Spring的配置文件中。

引入外部properties文件

<properties resource="org/mybatis/example/config.properties"></properties>

使用引入的properties文件

<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>

settings運(yùn)行時(shí)設(shè)置

這是 MyBatis 中極為重要的調(diào)整設(shè)置，它們會(huì)改變 MyBatis 的運(yùn)行時(shí)行為。下表描述了設(shè)置中各項(xiàng)的意圖、默認(rèn)值等。

常用的Setting設(shè)置

Settings設(shè)置示例

<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>

typeAliases別名

類型別名是為 Java 類型設(shè)置一個(gè)短的名字。它只和 XML 配置有關(guān)，存在的意義僅在于用來減少類完全限定名的冗余,但是往往我們不會(huì)使用別名，是為了方便查看代碼。

<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>

指定一個(gè)包名，MyBatis 會(huì)在包名下面搜索需要的 Java Bean，給包和子包下的所有類起一個(gè)默認(rèn)的別名（類名小寫）

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

每一個(gè)在包 domain.blog 中的 Java Bean，在沒有注解的情況下，會(huì)使用 Bean 的首字母小寫的非限定類名來作為它的別名。 比如 domain.blog.Author 的別名為 author；若有注解，則別名為其注解值。

@Alias("author")
public class Author {}

typeHandlers 類型處理器

無論是 MyBatis 在預(yù)處理語句（PreparedStatement）中設(shè)置一個(gè)參數(shù)時(shí)，還是從結(jié)果集中取出一個(gè)值時(shí)， 都會(huì)用類型處理器將獲取的值以合適的方式轉(zhuǎn)換成 Java 類型。下表描述了一些默認(rèn)的類型處理器。

plugins插件

MyBatis 允許你在已映射語句執(zhí)行過程中的某一點(diǎn)進(jìn)行攔截調(diào)用。默認(rèn)情況下，MyBatis 允許使用插件來攔截的方法調(diào)用

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

environments環(huán)境配置

MyBatis可以配置多種環(huán)境，default代表指定使用某種環(huán)境，這樣就可以快速切換環(huán)境，盡管可以配置多個(gè)環(huán)境，每個(gè) SqlSessionFactory 實(shí)例只能選擇其一 ，所以，如果你想連接兩個(gè)數(shù)據(jù)庫，就需要?jiǎng)?chuàng)建兩個(gè) SqlSessionFactory 實(shí)例，每個(gè)數(shù)據(jù)庫對應(yīng)一個(gè)。而如果是三個(gè)數(shù)據(jù)庫，就需要三個(gè)實(shí)例 。每個(gè)數(shù)據(jù)庫對應(yīng)一個(gè) SqlSessionFactory 實(shí)例

環(huán)境配置實(shí)例

<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>

環(huán)境配置說明

• 默認(rèn)的環(huán)境 ID（比如:default="development"）。
• 每個(gè) environment 元素定義的環(huán)境 ID（比如:id="development"）。
• 事務(wù)管理器的配置（比如:type="JDBC"）。
• 數(shù)據(jù)源的配置（比如:type="POOLED"）。