Mybatis學習總結(三)——SqlMapConfig.xml全局配置文件解析


     經過上兩篇博文的總結,對mybatis中的dao開發方法和流程基本掌握了,這一節主要來總結一下mybatis中的全局配置文件SqlMapConfig.xml在開發中的一些常用配置,首先看一下該全局配置文件中都有哪些可以配置的東西:

配置內容 作用
<properties> 用來加載屬性文件
<settings> 用來設置全局參數
<typeAliases> 用來設置類型的別名
<typeHandlers> 用來設置類型處理器
<objectFactory> 用來設置對象工廠
<plugins> 用來設置插件
<environments> 用來設置mybatis的環境
<mappers> 用來配置映射文件

 

 

 

 

 

 

 

 

 

      從前面的博文中可以看出,<environments>是用來配置mybatis的環境的,在和Spring整合前是由mybatis自己管理的,但是和Spring整合后,這些配置都將被廢棄掉,<environments>部分在前面已經有提到過,這里就不再贅述了。然后objectFactory和plugins一般我們不用,所以在這里就不總結了,<typeHandlers>類型處理器是mybatis中用來完成jdbc類型和java類型之間轉換的,mybatis默認支持的類型處理器基本夠我們使用了,一般不需要自定義。這篇博文主要來總結一下剩下的幾個配置的用法。

1、properties屬性

作用:將數據連接單獨配置在db.properties中,只需要在SqlMapConfig.xml中加載db.properties的屬性值,在SqlMapConfig.xml中就不需要對數據庫連接參數進行硬編碼。數據庫連接參數只配置在db.properties中,方便對參數進行統一管理,其它xml可以引用該db.properties。

db.properties的內容:

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis
jdbc.username=root
jdbc.password=root

在SqlMapConfig.xml中加載db.properties

<!-- 加載數據庫文件db.properties -->
<properties resource="db.properties">
        <!-- properties中還可以配置一些屬性名和屬性值,此處的優先加載 -->
        <!-- <property name="driver" value=""/> -->
    </properties>
    <!-- 和spring整合后 environments配置將廢除-->
    <environments default="development">
        <environment id="development">
        <!-- 使用jdbc事務管理,事務控制由mybatis管理-->
            <transactionManager type="JDBC" />
        <!-- 數據庫連接池,由mybatis管理-->
            <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>
        </environment>
    </environments>

properties特性:
注意:
   (1)在properties元素體內定義的屬性優先讀取。
   (2)然后讀取properties元素中resource或url加載的屬性,它會覆蓋已讀取的同名屬性。
   (3)最后讀取parameterType傳遞的屬性,它會覆蓋已讀取的同名屬性。
建議:
 (1)不要在properties元素體內添加任何屬性值,只將屬性值定義在properties文件中。
   (2)在properties文件中定義屬性名要有一定的特殊性,如xxxx.xxxx(jdbc.driver)。

2、settings全局參數設置

mybatis框架運行時可以調整一些運行參數。比如,開啟二級緩存,開啟延遲加載等等。全局參數會影響mybatis的運行行為。

                          mybatis-settings的配置屬性以及描述

setting(設置) Description(描述) valid Values(驗證值組) Default(默認值)
cacheEnabled 在全局范圍內啟用或禁用緩存配置 任何映射器在此配置下。 true | false TRUE
lazyLoadingEnabled 在全局范圍內啟用或禁用延遲加載。禁用時,所有相關聯的將熱加載。 true | false TRUE
aggressiveLazyLoading 啟用時,有延遲加載屬性的對象將被完全加載后調用懶惰的任何屬性。否則,每一個屬性是按需加載。 true | false TRUE
multipleResultSetsEnabled 允許或不允許從一個單獨的語句(需要兼容的驅動程序)要返回多個結果集。 true | false TRUE
useColumnLabel 使用列標簽,而不是列名。在這方面,不同的驅動有不同的行為。參考驅動文檔或測試兩種方法來決定你的驅動程序的行為如何。 true | false TRUE
useGeneratedKeys 允許JDBC支持生成的密鑰。兼容的驅動程序是必需的。此設置強制生成的鍵被使用,如果設置為true,一些驅動會不兼容性,但仍然可以工作。 true | false FALSE
autoMappingBehavior 指定MyBatis的應如何自動映射列到字段/屬性。NONE自動映射。 PARTIAL只會自動映射結果沒有嵌套結果映射定義里面。 FULL會自動映射的結果映射任何復雜的(包含嵌套或其他)。

NONE,PARTIAL,FULL

PARTIAL
defaultExecutorType 配置默認執行人。SIMPLE執行人確實沒有什么特別的。 REUSE執行器重用准備好的語句。 BATCH執行器重用語句和批處理更新。

SIMPLE,REUSE,BATCH

SIMPLE
safeRowBoundsEnabled 允許使用嵌套的語句RowBounds。 true | false FALSE
mapUnderscoreToCamelCase 從經典的數據庫列名A_COLUMN啟用自動映射到駱駝標識的經典的Java屬性名aColumn。 true | false FALSE
localCacheScope MyBatis的使用本地緩存,以防止循環引用,並加快反復嵌套查詢。默認情況下(SESSION)會話期間執行的所有查詢緩存。如果localCacheScope=STATMENT本地會話將被用於語句的執行,只是沒有將數據共享之間的兩個不同的調用相同的SqlSession。

SESSION

STATEMENT

SESSION
dbcTypeForNull 指定為空值時,沒有特定的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 指定如果setter方法​​或地圖的put方法時,將調用檢索到的值是null。它是有用的,當你依靠Map.keySet()或null初始化。注意原語(如整型,布爾等)不會被設置為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  CGLIB

官方文檔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="defaultExecutorType" value="SIMPLE"/>
    <setting name="defaultStatementTimeout" value="25"/>
    <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>

3、typeAiases(別名)——重點掌握

      這是配置中的一個重點,我們知道,在mapper.xml中,定義很多的statement,statement需要parameterType指定輸入參數的類型、需要resultType指定輸出結果的映射類型。如果在指定類型時輸入類型全路徑,有時候會很長,不方便進行開發,那么我們就可以針對parameterType或resultType指定的類型定義一些別名,在mapper.xml中通過別名<typeAliases>來定義,方便開發。

3.1、Mybatis默認支持的別名

別名

映射的類型

_byte 

byte 

_long 

long 

_short 

short 

_int 

int 

_integer 

int 

_double 

double 

_float 

float 

_boolean 

boolean 

string 

String 

byte 

Byte 

long 

Long 

short 

Short 

int 

Integer 

integer 

Integer 

double 

Double 

float 

Float 

boolean 

Boolean 

date 

Date 

decimal 

BigDecimal 

bigdecimal 

BigDecimal 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

3.2、自定義別名

3.2.1、單個別名定義(在SqlMapConfig.xml)

上面講的是Mybatis默認支持的一些別名,但是針對pojo的需要我們就要自定義別名了,比如我們將自己定義的User對象取個別名為user,如下:

<!-- 別名定義:針對單個別名定義 type:類型的路徑; alias:別名 -->
<typeAliases><typeAlias type="com.mybatis.entity.User" alias="user"/></typeAliases>

UserMapper.xml中引用別名(輸入參數或者輸出結果為com.mybatis.entity.User時,就可以用user來代替了):

<select id="findUserById" parameterType="int" resultType="user" >
      select * from t_user where id=#{id}
</select>

3.2.2、批量定義別名(常用)

但是問題來了,如果工程中有很多pojo,那豈不是要一個一個定義……這得定義多少個啊,所以mybatis幫我們解決了這個問題,它提供了批量別名的定義,如下:

<!-- 批量別名的定義:
        package:指定包名,mybatis會自動掃描包中的pojo類,自動定義別名,別名就是類名(首字母大寫或小寫都可以)
 -->
<typeAliases>
      <package name="com.mybatis.entity"/>
      <package name="其它包"/>
</typeAliases>

這就爽了,如果進行了上面這樣設置,那么所有放在com.mybatis.entity包下的pojo都可以不用定義了,直接使用類名就可以了,所以我們直接使用user即可。毫無疑問,開發中肯定使用這個批量的別名定義。

4、mappers(映射配置)

4.1、通過resource加載單個映射文件

<!-- 加載映射文件 -->
    <mappers>
    <!--通過resource方法一次加載一個映射文件  -->
        <mapper resource="sqlmap/User.xml"/>
        <mapper resource="mapper/UserMapper.xml"/>
    </mappers>

4.2、通過mapper接口加載單個映射文件

<!-- 通過mapper接口加載單個映射配置文件
遵循一定的規范:需要將mapper接口類名和mapper.xml映射文件名稱保持一致,且在一個目錄中;
上邊規范的前提是:使用的是mapper代理方法; -->

<mapper class="com.mybatis.mapper.UserMapper"/> 

按照上邊的規范,將mapper.javamapper.xml放在一個目錄,且同名。

4.3、批量加載mapper(推薦使用)

但是還是有個弊端,就跟上面那個別名的配置一樣,如果現在有好多個mapper怎么辦,所以mybatis也給我們提供了批量加載方法:我們只要指定mapper接口的包名,mybatis自動掃描包下面所有的mapper接口進行加載。當然,還是要遵循上面的那個規范。配置如下:

<!-- 批量加載映射配置文件,mybatis自動掃描包下面的mapper接口進行加載
    遵循一定的規范:需要將mapper接口類名和mapper.xml映射文件名稱保持一致,且在一個目錄中;
        上邊規范的前提是:使用的是mapper代理方法;
  -->
<package name="com.mybatis.mapper"/> 

這樣com.mybatis.mapper包下的所有mapper.xml映射文件都可以加載了,這就更加簡潔了。在開發中推薦使用這種批量加載映射文件的方法。

關於SqlMapConfig.xml文件中的配置就總結這么多吧~


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM