Mybatis的配置文件參數詳解

1.Myatis配置文件主要是mybatis-config.xml

我們來看一下這里的詳細的配置和需要注意的地方：

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

    <!-- 參數設置 -->
    <settings>
        <!-- 這個配置使全局的映射器啟用或禁用緩存 -->
        <setting name="cacheEnabled" value="true" />
        <!-- 全局啟用或禁用延遲加載。當禁用時，所有關聯對象都會即時加載 -->
        <setting name="lazyLoadingEnabled" value="true" />
        <!-- 當啟用時，有延遲加載屬性的對象在被調用時將會完全加載任意屬性。否則，每種屬性將會按需要加載 -->
        <setting name="aggressiveLazyLoading" value="true" />
        <!-- 允許或不允許多種結果集從一個單獨的語句中返回（需要適合的驅動） -->
        <setting name="multipleResultSetsEnabled" value="true" />
        <!-- 使用列標簽代替列名。不同的驅動在這方便表現不同。參考驅動文檔或充分測試兩種方法來決定所使用的驅動 -->
        <setting name="useColumnLabel" value="true" />
        <!-- 允許JDBC支持生成的鍵。需要適合的驅動。如果設置為true則這個設置強制生成的鍵被使用，盡管一些驅動拒絕兼容但仍然有效（比如Derby） -->
        <setting name="useGeneratedKeys" value="true" />
        <!-- 指定MyBatis如何自動映射列到字段/屬性。PARTIAL只會自動映射簡單，沒有嵌套的結果。FULL會自動映射任意復雜的結果（嵌套的或其他情況） -->
        <setting name="autoMappingBehavior" value="PARTIAL" />
        <!--當檢測出未知列（或未知屬性）時，如何處理，默認情況下沒有任何提示，這在測試的時候很不方便，不容易找到錯誤。 NONE : 不做任何處理 
            (默認值) WARNING : 警告日志形式的詳細信息 FAILING : 映射失敗，拋出異常和詳細信息 -->
        <setting name="autoMappingUnknownColumnBehavior" value="WARNING" />
        <!-- 配置默認的執行器。SIMPLE執行器沒有什么特別之處。REUSE執行器重用預處理語句。BATCH執行器重用語句和批量更新 -->
        <setting name="defaultExecutorType" value="SIMPLE" />
        <!-- 設置超時時間，它決定驅動等待一個數據庫響應的時間 -->
        <setting name="defaultStatementTimeout" value="25000" />
        <!--設置查詢返回值數量，可以被查詢數值覆蓋 -->
        <setting name="defaultFetchSize" value="100" />
        <!-- 允許在嵌套語句中使用分頁 -->
        <setting name="safeRowBoundsEnabled" value="false" />
        <!--是否開啟自動駝峰命名規則（camel case）映射，即從經典數據庫列名 A_COLUMN 到經典 Java 屬性名 aColumn 
            的類似映射。 -->
        <setting name="mapUnderscoreToCamelCase" value="false" />
        <!--MyBatis 利用本地緩存機制（Local Cache）防止循環引用（circular references）和加速重復嵌套查詢。 
            默認值為 SESSION，這種情況下會緩存一個會話中執行的所有查詢。 若設置值為 STATEMENT，本地會話僅用在語句執行上，對相同 SqlSession 
            的不同調用將不會共享數據。 -->
        <setting name="localCacheScope" value="SESSION" />
        <!-- 當沒有為參數提供特定的 JDBC 類型時，為空值指定 JDBC 類型。 某些驅動需要指定列的 JDBC 類型，多數情況直接用一般類型即可，比如 
            NULL、VARCHAR OTHER。 -->
        <setting name="jdbcTypeForNull" value="OTHER" />
        <!-- 指定哪個對象的方法觸發一次延遲加載。 -->
        <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString" />
    </settings>

    <!-- 別名定義 -->
    <typeAliases>
        <typeAlias alias="pageAccessURL" type="com.lgm.mybatis.model.PageAccessURL" />
    </typeAliases>

    <!--自定義類型處理器 -->
    <typeHandlers>
        <!-- <typeHandler handler="com.xhm.util.BooleanTypeHandlder" /> -->
        <!--掃描整個包下的自定義類型處理器 -->
        <package name="com.xhm.util" />
    </typeHandlers>

    <!--plugins插件之 分頁攔截器 -->
    <plugins>
        <plugin interceptor="com.xhm.util.PageInterceptor"></plugin>
    </plugins>

    <!--配置environment環境 -->
    <environments default="development">
        <!-- 環境配置1，每個SqlSessionFactory對應一個環境 -->
        <environment id="development1">
            <!-- 事務配置 type= JDBC、MANAGED 1.JDBC:這個配置直接簡單使用了JDBC的提交和回滾設置。它依賴於從數據源得到的連接來管理事務范圍。 
                2.MANAGED:這個配置幾乎沒做什么。它從來不提交或回滾一個連接。而它會讓容器來管理事務的整個生命周期（比如Spring或JEE應用服務器的上下文）。 
                默認情況下它會關閉連接。然而一些容器並不希望這樣，因此如果你需要從連接中停止它，將closeConnection屬性設置為false -->
            <transactionManager type="JDBC" />
            <!-- <transactionManager type="MANAGED"> <property name="closeConnection" 
                value="false"/> </transactionManager> -->
            <!-- 數據源類型：type = UNPOOLED、POOLED、JNDI 1.UNPOOLED：這個數據源的實現是每次被請求時簡單打開和關閉連接。它有一點慢，這是對簡單應用程序的一個很好的選擇，因為它不需要及時的可用連接。 
                不同的數據庫對這個的表現也是不一樣的，所以對某些數據庫來說配置數據源並不重要，這個配置也是閑置的 2.POOLED：這是JDBC連接對象的數據源連接池的實現，用來避免創建新的連接實例時必要的初始連接和認證時間。 
                這是一種當前Web應用程序用來快速響應請求很流行的方法。 3.JNDI：這個數據源的實現是為了使用如Spring或應用服務器這類的容器，容器可以集中或在外部配置數據源，然后放置一個JNDI上下文的引用 -->
            <dataSource type="UNPOOLED">
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <property name="url" value="jdbc:mysql://localhost:3306/xhm" />
                <property name="username" value="root" />
                <property name="password" value="root" />
                <!-- 默認連接事務隔離級別 <property name="defaultTransactionIsolationLevel" value="" 
                    /> -->
            </dataSource>
        </environment>

        <!-- 環境配置2 -->
        <environment id="development2">
            <transactionManager type="JDBC" />
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <property name="url" value="jdbc:mysql://localhost:3306/xhm" />
                <property name="username" value="root" />
                <property name="password" value="root" />
                <!-- 在任意時間存在的活動（也就是正在使用）連接的數量 -->
                <property name="poolMaximumActiveConnections" value="10" />
                <!-- 任意時間存在的空閑連接數 -->
                <property name="poolMaximumIdleConnections" value="5" />
                <!-- 在被強制返回之前，池中連接被檢查的時間 -->
                <property name="poolMaximumCheckoutTime" value="20000" />
                <!-- 這是給連接池一個打印日志狀態機會的低層次設置，還有重新嘗試獲得連接，這些情況下往往需要很長時間（為了避免連接池沒有配置時靜默失敗） -->
                <property name="poolTimeToWait" value="20000" />
                <!-- 發送到數據的偵測查詢，用來驗證連接是否正常工作，並且准備接受請求。 -->
                <property name="poolPingQuery" value="NO PING QUERY SET" />
                <!-- 這是開啟或禁用偵測查詢。如果開啟，你必須用一個合法的SQL語句（最好是很快速的）設置poolPingQuery屬性 -->
                <property name="poolPingEnabled" value="false" />
                <!-- 這是用來配置poolPingQuery多次時間被用一次。這可以被設置匹配標准的數據庫連接超時時間，來避免不必要的偵測 -->
                <property name="poolPingConnectionsNotUsedFor" value="0" />
            </dataSource>
        </environment>

        <!-- 環境配置3 -->
        <environment id="development3">
            <transactionManager type="JDBC" />
            <dataSource type="JNDI">
                <property name="data_source" value="java:comp/env/jndi/mybatis" />
                <property name="env.encoding" value="UTF8" />
                <!-- <property name="initial_context" value=""/> <property name="env.encoding" 
                    value="UTF8"/> -->
            </dataSource>
        </environment>
    </environments>

    <!-- 映射文件，mapper的配置文件 -->
    <mappers>
        <!--直接映射到相應的mapper文件 -->
        <mapper resource="com/xhm/mapper/UserMapper.xml" />
        <!--掃描包路徑下所有xxMapper.xml文件 -->
        <package name="com.xhm.mapper" />
    </mappers>

</configuration>  

2.Mybatis配合文件節點詳細解釋

下面我們看看關於參數的配置情況，下面的信息是在mybatis配置文件中的每個配置大節點的詳細解釋（標注是紅色的，需要重點知道的）

3.Mybatie配置文件中的setting節點下面配置信息的詮釋。

 

4.Mybatis中environments配置信息解釋

•  environment 元素是配置一個數據源的開始，屬性id是它的唯一標識
• transactionManager 元素配置數據庫事務，其中type屬性有三種配置方式
  •  jdbc，采用jdbc的方式管理事務；
  •  managed，采用容器的方式管理事務，在JNDI數據源中使用；
  •  自定義，自定義數據庫事務管理辦法；
• dataSource 元素配置數據源連接信息，type屬性是連接數據庫的方式配置，有四種配置方式
  • UNPOOLED 非連接池方式連接
  • POOLED 使用連接池連接
  • JNDI 使用JNDI數據源
  • 自定義數據源

5.數據庫字段和java中bean的對應的類是：TypeHandlerReigser

6.Mapper.xml配置文件講解

6.1具體標簽的使用（這里的標簽，需要都知道，既然學了，就要記住）

 cache – 給定命名空間的緩存配置。
 cache-ref – 其他命名空間緩存配置的引用。
 resultMap – 是最復雜也是最強大的元素，用來描述如何從數據庫結果集中來加載對象。
 sql – 可被其他語句引用的可重用語句塊。
 insert – 映射插入語句
 update – 映射更新語句
 delete – 映射刪除語句
 select – 映射查詢語句

下面我們看一個Mapper.xml的詳細配置信息

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.youy.mybatis.mapper.TUserMapper">
  <resultMap id="BaseResultMap" type="com.youy.mybatis.entity.TUser">
    <!--
      WARNING - @mbggenerated
      This element is automatically generated by MyBatis Generator, do not modify.
    -->
    <id column="id" jdbcType="INTEGER" property="id" />
    <result column="user_name" jdbcType="VARCHAR" property="userName" />
    <result column="real_name" jdbcType="VARCHAR" property="realName" />
    <result column="sex" jdbcType="TINYINT" property="sex" />
    <result column="mobile" jdbcType="VARCHAR" property="mobile" />
    <result column="email" jdbcType="VARCHAR" property="email" />
    <result column="note" jdbcType="VARCHAR" property="note" />
    <result column="position_id" jdbcType="INTEGER" property="positionId" />
  </resultMap>
  <sql id="Base_Column_List">
    <!--
      WARNING - @mbggenerated
      This element is automatically generated by MyBatis Generator, do not modify.
    -->
    id, user_name, real_name, sex, mobile, email, note, position_id
  </sql>
  <resultMap id="userAndPosition1" type="com.youy.mybatis.entity.TUser" extends="BaseResultMap">
    <association property="tPosition" columnPrefix="post_"
                 javaType="com.youy.mybatis.entity.TPosition">
      <id column="id" property="id"/>
      <result column="name" property="postName"/>
      <result column="note" property="note"/>
    </association>
  </resultMap>
  <resultMap id="userAndPosition2" type="com.youy.mybatis.entity.TUser" extends="BaseResultMap">
    <!-- property TUser 對象中的屬性
         fetchType 加載的方式
         column 關聯的字段
         select 關聯到另外的mapper.xml的方法-->
    <association property="tPosition" fetchType="lazy" column="position_id" select="com.youy.mybatis.mapper.TPositionMapper.selectByPrimaryKey"/>
  </resultMap>
  <select id="selectUserPosition1" resultMap="userAndPosition1">
    select
      a.id,
      a.user_name,
      a.real_name,
      a.sex,
      a.mobile,
      a.email,
      a.note,
      b.id post_id,
      b.post_name,
      b.note post_note
    from
      t_user a,t_position b
    where
      a.position_id = b.id
  </select>
  <select id="selectUserPosition2" resultMap="userAndPosition2">
    select
      a.id,
      a.user_name,
      a.real_name,
      a.sex,
      a.mobile,
      a.email,
      a.note,
      a.position_id
    from
     t_user a
  </select>
  <select id="selectBeanByNameOrEmail" resultMap="BaseResultMap">
    select
    <include refid="Base_Column_List"/>
    from t_user
    <where>
      <choose>
        <when test="userName != null and userName != ''">
          and user_name = #{userName,jdbcType=VARCHAR}
        </when>
        <when test="email != null and email!= ''">
          and email like CONCAT('%',#{email,jdbcType=VARCHAR},'%')
        </when>
        <otherwise>
          and 1 = 1
        </otherwise>
      </choose>
    </where>
  </select>
  <select id="selectByPrimaryKey" parameterType="java.lang.Integer" resultMap="BaseResultMap">
    <!--
      WARNING - @mbggenerated
      This element is automatically generated by MyBatis Generator, do not modify.
    -->
    select 
    <include refid="Base_Column_List" />
    from t_user
    where id = #{id,jdbcType=INTEGER}
  </select>
  <resultMap id="userRoleInfo" extends= "BaseResultMap" type="com.youy.mybatis.entity.TUser">
    <collection property="roleList" column="id" columnPrefix="role_" ofType="com.youy.mybatis.entity.TRole">
      <id column="id" property="id"/>
      <result column="name" property="roleName"/>
      <result column="note" property="note"/>
    </collection>
  </resultMap>
  <select id="selectUserRole" resultMap="userRoleInfo">
    select a.id,
              a.user_name,
              a.real_name,
              a.sex,
              a.mobile,
              a.note,
              b.role_id,
              c.role_name,
              c.note role_note
        from t_user a,
             t_user_role b,
             t_role c
        where a.id = b.user_id AND
              b.role_id = c.id
  </select>
  <delete id="deleteByPrimaryKey" parameterType="java.lang.Integer">
    <!--
      WARNING - @mbggenerated
      This element is automatically generated by MyBatis Generator, do not modify.
    -->
    delete from t_user
    where id = #{id,jdbcType=INTEGER}
  </delete>
  <insert id="insert" parameterType="com.youy.mybatis.entity.TUser">
    <!--
      WARNING - @mbggenerated
      This element is automatically generated by MyBatis Generator, do not modify.
    -->
    <selectKey keyProperty="id" order="BEFORE" resultType="java.lang.Integer">
      SELECT LAST_INSERT_ID()
    </selectKey>
    insert into t_user (id, user_name, real_name, 
      sex, mobile, email, 
      note, position_id)
    values (#{id,jdbcType=INTEGER}, #{userName,jdbcType=VARCHAR}, #{realName,jdbcType=VARCHAR}, 
      #{sex,jdbcType=TINYINT}, #{mobile,jdbcType=VARCHAR}, #{email,jdbcType=VARCHAR}, 
      #{note,jdbcType=VARCHAR}, #{positionId,jdbcType=INTEGER})
  </insert>
  <insert id="insertSelective" parameterType="com.youy.mybatis.entity.TUser">
    <!--
      WARNING - @mbggenerated
      This element is automatically generated by MyBatis Generator, do not modify.
    -->
    <selectKey keyProperty="id" order="BEFORE" resultType="java.lang.Integer">
      SELECT LAST_INSERT_ID()
    </selectKey>
    insert into t_user
    <trim prefix="(" suffix=")" suffixOverrides=",">
      id,
      <if test="userName != null">
        user_name,
      </if>
      <if test="realName != null">
        real_name,
      </if>
      <if test="sex != null">
        sex,
      </if>
      <if test="mobile != null">
        mobile,
      </if>
      <if test="email != null">
        email,
      </if>
      <if test="note != null">
        note,
      </if>
      <if test="positionId != null">
        position_id,
      </if>
    </trim>
    <trim prefix="values (" suffix=")" suffixOverrides=",">
      #{id,jdbcType=INTEGER},
      <if test="userName != null">
        #{userName,jdbcType=VARCHAR},
      </if>
      <if test="realName != null">
        #{realName,jdbcType=VARCHAR},
      </if>
      <if test="sex != null">
        #{sex,jdbcType=TINYINT},
      </if>
      <if test="mobile != null">
        #{mobile,jdbcType=VARCHAR},
      </if>
      <if test="email != null">
        #{email,jdbcType=VARCHAR},
      </if>
      <if test="note != null">
        #{note,jdbcType=VARCHAR},
      </if>
      <if test="positionId != null">
        #{positionId,jdbcType=INTEGER},
      </if>
    </trim>
  </insert>
  <update id="updateByPrimaryKeySelective" parameterType="com.youy.mybatis.entity.TUser">
    <!--
      WARNING - @mbggenerated
      This element is automatically generated by MyBatis Generator, do not modify.
    -->
    update t_user
    <set>
      <if test="userName != null">
        user_name = #{userName,jdbcType=VARCHAR},
      </if>
      <if test="realName != null">
        real_name = #{realName,jdbcType=VARCHAR},
      </if>
      <if test="sex != null">
        sex = #{sex,jdbcType=TINYINT},
      </if>
      <if test="mobile != null">
        mobile = #{mobile,jdbcType=VARCHAR},
      </if>
      <if test="email != null">
        email = #{email,jdbcType=VARCHAR},
      </if>
      <if test="note != null">
        note = #{note,jdbcType=VARCHAR},
      </if>
      <if test="positionId != null">
        position_id = #{positionId,jdbcType=INTEGER},
      </if>
    </set>
    where id = #{id,jdbcType=INTEGER}
  </update>
  <update id="updateByPrimaryKey" parameterType="com.youy.mybatis.entity.TUser">
    <!--
      WARNING - @mbggenerated
      This element is automatically generated by MyBatis Generator, do not modify.
    -->
    update t_user
    set user_name = #{userName,jdbcType=VARCHAR},
      real_name = #{realName,jdbcType=VARCHAR},
      sex = #{sex,jdbcType=TINYINT},
      mobile = #{mobile,jdbcType=VARCHAR},
      email = #{email,jdbcType=VARCHAR},
      note = #{note,jdbcType=VARCHAR},
      position_id = #{positionId,jdbcType=INTEGER}
    where id = #{id,jdbcType=INTEGER}
  </update>
</mapper>

6.1.1 select 標簽的使用

我們看一下該標簽里面涉及到的屬性

關於這個標簽，我們需要西湖一的點

1. 我們首先需要注意的是resultType返回是集合的時候，返回的是集合的元素類型。不是list。
2. 使用自動映射的時候，也就是 resultType = "com.youy.mybatis.entity.TUser" ,這樣的話，需要將setting配置節點中的屬性                                                  <setting name="mapUnderscoreToCamelCase" value="true" /> 否則的話。帶有下划線的列明，不能正常的對應高bean里面；
3. 如果使用的是resultMap的話，在節點里面將屬性對應好，不用配置駝峰信息的話，也是可以的；

總結：1.請求參數，如果參數少於 5個 的話，我們需要傳遞固定的參數

           2.傳入的參數要是大於5 個的話，就要使用的是bean，不要使用 map 作為入參，因為不好維護；

           3.resultType，要是使用這個參數的話，返回值耦合性比較大，需要動地方比較多。

           4.所以使用resultMap，這樣的配置信息，易於維護。便於解耦。