SQL 映射文件的頂級(jí)元素（按照它們應(yīng)該被定義的順序）：

• cache – 給定命名空間的緩存配置。
• cache-ref – 其他命名空間緩存配置的引用。
• resultMap – 是最復(fù)雜也是最強(qiáng)大的元素，用來(lái)描述如何從數(shù)據(jù)庫(kù)結(jié)果集中來(lái)加載對(duì)象。
• parameterMap – 已廢棄！老式風(fēng)格的參數(shù)映射。內(nèi)聯(lián)參數(shù)是首選,這個(gè)元素可能在將來(lái)被移除，這里不會(huì)記錄。
• sql – 可被其他語(yǔ)句引用的可重用語(yǔ)句塊。
• insert – 映射插入語(yǔ)句
• update – 映射更新語(yǔ)句
• delete – 映射刪除語(yǔ)句
• select – 映射查詢(xún)語(yǔ)句

select

查詢(xún)語(yǔ)句的元素
例子：

<select id="selectPerson" parameterType="int" resultType="hashmap">
  SELECT * FROM PERSON WHERE ID = #{id}
</select>

這個(gè)語(yǔ)句被稱(chēng)作 selectPerson，接受一個(gè) int（或 Integer）類(lèi)型的參數(shù)，并返回一個(gè) HashMap 類(lèi)型的對(duì)象，其中的鍵是列名，值便是結(jié)果行中的對(duì)應(yīng)值。
注意：

#{id}

這是一個(gè)預(yù)處理語(yǔ)句參數(shù)，通過(guò)JDBC會(huì)被處理成：

// Similar JDBC code, NOT MyBatis…
String selectPerson = "SELECT * FROM PERSON WHERE ID=?";
PreparedStatement ps = conn.prepareStatement(selectPerson);
ps.setInt(1,id);

select 元素可以配置的例子：

<select
  id="selectPerson"
  parameterType="int"
  parameterMap="deprecated"
  resultType="hashmap"
  resultMap="personResultMap"
  flushCache="false"
  useCache="true"
  timeout="10000"
  fetchSize="256"
  statementType="PREPARED"
  resultSetType="FORWARD_ONLY">

select元素的屬性描述：

insert, update 和 delete

數(shù)據(jù)變更語(yǔ)句。
例子：

<insert
  id="insertAuthor"
  parameterType="domain.blog.Author"
  flushCache="true"
  statementType="PREPARED"
  keyProperty=""
  keyColumn=""
  useGeneratedKeys=""
  timeout="20">

<update
  id="updateAuthor"
  parameterType="domain.blog.Author"
  flushCache="true"
  statementType="PREPARED"
  timeout="20">

<delete
  id="deleteAuthor"
  parameterType="domain.blog.Author"
  flushCache="true"
  statementType="PREPARED"
  timeout="20">

屬性和描述

insert, update, delete 語(yǔ)句的示例：

<insert id="insertAuthor">
  insert into Author (id,username,password,email,bio)
  values (#{id},#{username},#{password},#{email},#{bio})
</insert>

<update id="updateAuthor">
  update Author set
    username = #{username},
    password = #{password},
    email = #{email},
    bio = #{bio}
  where id = #{id}
</update>

<delete id="deleteAuthor">
  delete from Author where id = #{id}
</delete>

如果數(shù)據(jù)庫(kù)支持自動(dòng)生成主鍵的字段，可以設(shè)置useGenaratedKeys="true"，再將keyProperty設(shè)置到目標(biāo)屬性。例如，下例中，Author表對(duì)id屬性使用了自動(dòng)生成的類(lèi)型:

<insert id="insertAuthor" useGeneratedKeys="true"
    keyProperty="id">
  insert into Author (username,password,email,bio)
  values (#{username},#{password},#{email},#{bio})
</insert>

對(duì)于多行插入（需要數(shù)據(jù)庫(kù)支持），傳入一個(gè)Authors數(shù)組或集合，并返回自動(dòng)生成的主鍵：

<insert id="insertAuthor" useGeneratedKeys="true"
    keyProperty="id">
  insert into Author (username, password, email, bio) values
  <foreach item="item" collection="list" separator=",">
    (#{item.username}, #{item.password}, #{item.email}, #{item.bio})
  </foreach>
</insert>

如果數(shù)據(jù)庫(kù)不支持自動(dòng)主鍵（方法不建議。但是沒(méi)有提出更好的解決辦法）：

<insert id="insertAuthor">
  <?-- selectKey 元素將會(huì)首先運(yùn)行，Author 的 id 會(huì)被設(shè)置，然后插入語(yǔ)句會(huì)被調(diào)用。這給你了一個(gè)和數(shù)據(jù)庫(kù)中來(lái)處理自動(dòng)生成的主鍵類(lèi)似的行為，避免了使 Java 代碼變得復(fù)雜。-->
  <selectKey keyProperty="id" resultType="int" order="BEFORE">
    select CAST(RANDOM()*1000000 as INTEGER) a from SYSIBM.SYSDUMMY1
  </selectKey>
  insert into Author
    (id, username, password, email,bio, favourite_section)
  values
    (#{id}, #{username}, #{password}, #{email}, #{bio}, #{favouriteSection,jdbcType=VARCHAR})
</insert>

selectKey 元素描述如下：

<selectKey
  keyProperty="id"
  resultType="int"
  order="BEFORE"
  statementType="PREPARED">

sql

這個(gè)元素可以被用來(lái)定義可重用的 SQL 代碼段，可以包含在其他語(yǔ)句中。它可以被靜態(tài)地(在加載參數(shù)) 參數(shù)化. 不同的屬性值通過(guò)包含的實(shí)例變化. 比如：

<sql id="userColumns"> ${alias}.id,${alias}.username,${alias}.password </sql>

這個(gè) SQL 片段可以被包含在其他語(yǔ)句中，例如：

<select id="selectUsers" resultType="map">
  select
    <include refid="userColumns"><property name="alias" value="t1"/></include>,
    <include refid="userColumns"><property name="alias" value="t2"/></include>
  from some_table t1
    cross join some_table t2
</select>

屬性值也可以被用在 include 元素的 refid 屬性里（
<include refid="${include_target}"/>
）或 include 內(nèi)部語(yǔ)句中（
${prefix}Table
），例如：

<sql id="sometable">
  ${prefix}Table
</sql>

<sql id="someinclude">
  from
    <include refid="${include_target}"/>
</sql>
<select id="select" resultType="map">
  select
    field1, field2, field3
  <include refid="someinclude">
    <property name="prefix" value="Some"/>
    <property name="include_target" value="sometable"/>
  </include>
</select>

參數(shù)（Parameters）

參數(shù)也可以指定一個(gè)特殊的數(shù)據(jù)類(lèi)型。

#{property,javaType=int,jdbcType=NUMERIC}

javaType 通常可以由參數(shù)對(duì)象確定，除非該對(duì)象是一個(gè) HashMap。這時(shí)所使用的 TypeHandler 應(yīng)該明確指明 javaType。

NOTE 如果一個(gè)列允許 null 值，并且會(huì)傳遞值 null 的參數(shù)，就必須要指定 JDBC Type。

定制類(lèi)型處理方式，可以指定一個(gè)特殊的類(lèi)型處理器類(lèi)（或別名），比如：

#{age,javaType=int,jdbcType=NUMERIC,typeHandler=MyTypeHandler}

對(duì)于數(shù)值類(lèi)型，可以設(shè)置小數(shù)保留位數(shù)，來(lái)確定小數(shù)點(diǎn)后保留的位數(shù)。

#{height,javaType=double,jdbcType=NUMERIC,numericScale=2}

mode 屬性允許你指定 IN，OUT 或 INOUT 參數(shù)。如果參數(shù)為 OUT 或 INOUT，參數(shù)對(duì)象屬性的真實(shí)值將會(huì)被改變，就像你在獲取輸出參數(shù)時(shí)所期望的那樣。
如果 mode 為 OUT（或 INOUT），而且 jdbcType 為 CURSOR(也就是 Oracle 的 REFCURSOR)，你必須指定一個(gè) resultMap 來(lái)映射結(jié)果集 ResultMap 到參數(shù)類(lèi)型。要注意這里的 javaType 屬性是可選的，如果留空并且 jdbcType 是 CURSOR，它會(huì)被自動(dòng)地被設(shè)為 ResultMap。

#{department, mode=OUT, jdbcType=CURSOR, javaType=ResultSet, resultMap=departmentResultMap}

MyBatis 也支持很多高級(jí)的數(shù)據(jù)類(lèi)型，比如結(jié)構(gòu)體，但是當(dāng)注冊(cè) out 參數(shù)時(shí)你必須告訴它語(yǔ)句類(lèi)型名稱(chēng)。比如（再次提示，在實(shí)際中要像這樣不能換行）：

#{middleInitial, mode=OUT, jdbcType=STRUCT, jdbcTypeName=MY_TYPE, resultMap=departmentResultMap}

盡管所有這些選項(xiàng)很強(qiáng)大，但大多時(shí)候你只須簡(jiǎn)單地指定屬性名，其他的事情 MyBatis 會(huì)自己去推斷，頂多要為可能為空的列指定 jdbcType。

#{firstName}
#{middleInitial,jdbcType=VARCHAR}
#{lastName}

字符串替換

默認(rèn)情況下,使用 #{} 格式的語(yǔ)法會(huì)導(dǎo)致 MyBatis 創(chuàng)建 PreparedStatement 參數(shù)并安全地設(shè)置參數(shù)（就像使用 ? 一樣）。這樣做更安全，更迅速，通常也是首選做法，不過(guò)有時(shí)你就是想直接在 SQL 語(yǔ)句中插入一個(gè)不轉(zhuǎn)義的字符串。比如，像 ORDER BY，你可以這樣來(lái)使用：

ORDER BY ${columnName}

這里 MyBatis 不會(huì)修改或轉(zhuǎn)義字符串。

NOTE 用這種方式接受用戶(hù)的輸入，并將其用于語(yǔ)句中的參數(shù)是不安全的，會(huì)導(dǎo)致潛在的 SQL 注入攻擊，因此要么不允許用戶(hù)輸入這些字段，要么自行轉(zhuǎn)義并檢驗(yàn)。

Result Maps

ResultMap 的設(shè)計(jì)思想是，簡(jiǎn)單的語(yǔ)句不需要明確的結(jié)果映射，而復(fù)雜一點(diǎn)的語(yǔ)句只需要描述它們的關(guān)系就行了。

簡(jiǎn)單的映射語(yǔ)句中沒(méi)有明確的resultMap：

<?--這里只是簡(jiǎn)單地將所有的列映射到 HashMap 的鍵上，這由 resultType 屬性指定。-->
<select id="selectUsers" resultType="map">
  select id, username, hashedPassword
  from some_table
  where id = #{id}
</select>

如果，一個(gè)基于 JavaBean 的規(guī)范的，有 3 個(gè)屬性：id,username 和 hashedPassword的User類(lèi)。
這樣的一個(gè) JavaBean 可以被映射到 ResultSet，就像映射到 HashMap 一樣簡(jiǎn)單。

<select id="selectUsers" resultType="com.someapp.model.User">
  select id, username, hashedPassword
  from some_table
  where id = #{id}
</select>

可以使用類(lèi)別名來(lái)簡(jiǎn)化；

<!-- In mybatis-config.xml file -->
<typeAlias type="com.someapp.model.User" alias="User"/>

<!-- In SQL Mapping XML file -->
<select id="selectUsers" resultType="User">
  select id, username, hashedPassword
  from some_table
  where id = #{id}
</select>

這些情況下，MyBatis 會(huì)在幕后自動(dòng)創(chuàng)建一個(gè) ResultMap，再基于屬性名來(lái)映射列到 JavaBean 的屬性上。如果列名和屬性名沒(méi)有精確匹配，可以在 SELECT 語(yǔ)句中對(duì)列使用別名（這是一個(gè) 基本的 SQL 特性）來(lái)匹配標(biāo)簽。比如：。比如：

<select id="selectUsers" resultType="User">
  select
    user_id             as "id",
    user_name           as "userName",
    hashed_password     as "hashedPassword"
  from some_table
  where id = #{id}
</select>

還可以使用外部的resultMap：

<resultMap id="userResultMap" type="User">
  <id property="id" column="user_id" />
  <result property="username" column="user_name"/>
  <result property="password" column="hashed_password"/>
</resultMap>

這樣，引用他的語(yǔ)句使用resultMap屬性就可以了（注意去掉了 resultType 屬性）。比如：
<select id="selectUsers" resultMap="userResultMap">
select user_id, user_name, hashed_password
from some_table
where id = #{id}
</select>

高級(jí)結(jié)果映射

一個(gè)復(fù)雜的映射：

<resultMap id="detailedBlogResultMap" type="Blog">
<constructor>
  <idArg column="blog_id" javaType="int"/>
</constructor>
<result property="title" column="blog_title"/>
<association property="author" javaType="Author">
  <id property="id" column="author_id"/>
  <result property="username" column="author_username"/>
  <result property="password" column="author_password"/>
  <result property="email" column="author_email"/>
  <result property="bio" column="author_bio"/>
  <result property="favouriteSection" column="author_favourite_section"/>
</association>
<collection property="posts" ofType="Post">
  <id property="id" column="post_id"/>
  <result property="subject" column="post_subject"/>
  <association property="author" javaType="Author"/>
  <collection property="comments" ofType="Comment">
    <id property="id" column="comment_id"/>
  </collection>
  <collection property="tags" ofType="Tag" >
    <id property="id" column="tag_id"/>
  </collection>
  <discriminator javaType="int" column="draft">
    <case value="1" resultType="DraftPost"/>
  </discriminator>
</collection>
</resultMap>

resultMap：

• constructor - 用于在實(shí)例化類(lèi)時(shí)，注入結(jié)果到構(gòu)造方法中
  • idArg - ID 參數(shù);標(biāo)記出作為 ID 的結(jié)果可以幫助提高整體性能
  • arg - 將被注入到構(gòu)造方法的一個(gè)普通結(jié)果
• id – 一個(gè) ID 結(jié)果;標(biāo)記出作為 ID 的結(jié)果可以幫助提高整體性能
• result – 注入到字段或 JavaBean 屬性的普通結(jié)果
• association – 一個(gè)復(fù)雜類(lèi)型的關(guān)聯(lián);許多結(jié)果將包裝成這種類(lèi)型
  • 嵌套結(jié)果映射 – 關(guān)聯(lián)可以指定為一個(gè) resultMap 元素，或者引用一個(gè)
• collection – 一個(gè)復(fù)雜類(lèi)型的集合
  • 嵌套結(jié)果映射 – 集合可以指定為一個(gè) resultMap 元素，或者引用一個(gè)
• discriminator* – 使用結(jié)果值來(lái)決定使用哪個(gè) resultMap
  • case – 基于某些值的結(jié)果映射
    • 嵌套結(jié)果映射 – 一個(gè) case 也是一個(gè)映射它本身的結(jié)果,因此可以包含很多相 同的元素，或者它可以參照一個(gè)外部的 resultMap。

ResultMap 屬性描述

id & result

<id property="id" column="post_id"/>
<result property="subject" column="post_subject"/>

id 和 result 都將一個(gè)列的值映射到一個(gè)簡(jiǎn)單數(shù)據(jù)類(lèi)型(字符串,整型,雙精度浮點(diǎn)數(shù),日期等)的屬性或字段。
id 表示的結(jié)果將是對(duì)象的標(biāo)識(shí)屬性，這會(huì)在比較對(duì)象實(shí)例時(shí)用到。 這樣可以提高整體的性能，尤其是緩存和嵌套結(jié)果映射(也就是聯(lián)合映射)的時(shí)候。

Id 和 Result 的屬性

構(gòu)造方法（Constructor）

constructor 元素可以使構(gòu)造方法注入允許你在初始化時(shí)為類(lèi)設(shè)置屬性的值，而不用暴露出公有方法。
例如如下構(gòu)造方法：

public class User {
   //...
   public User(Integer id, String username, int age) {
     //...
  }
//...
}

可以構(gòu)建如下constructor元素：

<constructor>
   <idArg column="id" javaType="int"/>
   <arg column="username" javaType="String"/>
   <arg column="age" javaType="_int"/>
</constructor>

對(duì)于帶有多個(gè)形參的構(gòu)造方法，可以在指定參數(shù)名稱(chēng)的前提下，以任意順序編寫(xiě) arg 元素。 為了通過(guò)名稱(chēng)來(lái)引用構(gòu)造方法參數(shù)，你可以添加 @Param 注解，或者使用 '-parameters' 編譯選項(xiàng)并啟用 useActualParamName 選項(xiàng)（默認(rèn)開(kāi)啟）來(lái)編譯項(xiàng)目。 下面的例子對(duì)于同一個(gè)構(gòu)造方法依然是有效的，盡管第二和第三個(gè)形參順序與構(gòu)造方法中聲明的順序不匹配。

<constructor>
   <idArg column="id" javaType="int" name="id" />
   <arg column="age" javaType="_int" name="age" />
   <arg column="username" javaType="String" name="username" />
</constructor>

如果類(lèi)中存在名稱(chēng)和類(lèi)型相同的屬性，那么可以省略 javaType 。

屬性規(guī)則

關(guān)聯(lián)（association）

<association property="author" column="blog_author_id" javaType="Author">
  <id property="id" column="author_id"/>
  <result property="username" column="author_username"/>
</association>

關(guān)聯(lián)元素處理“有一個(gè)”類(lèi)型的關(guān)系。
MyBatis 有兩種不同的方式加載關(guān)聯(lián):

• 嵌套查詢(xún)：通過(guò)執(zhí)行另外一個(gè) SQL 映射語(yǔ)句來(lái)返回預(yù)期的復(fù)雜類(lèi)型。
• 嵌套結(jié)果：使用嵌套結(jié)果映射來(lái)處理重復(fù)的聯(lián)合結(jié)果的子集。

association的屬性描述

association的嵌套查詢(xún)

例如：

<resultMap id="blogResult" type="Blog">
  <association property="author" column="author_id" javaType="Author" select="selectAuthor"/>
</resultMap>

<select id="selectBlog" resultMap="blogResult">
  SELECT * FROM BLOG WHERE ID = #{id}
</select>

<select id="selectAuthor" resultType="Author">
  SELECT * FROM AUTHOR WHERE ID = #{id}
</select>

associate的嵌套結(jié)果

以下例子講博客表和作者表聯(lián)合：

<select id="selectBlog" resultMap="blogResult">
  select
    B.id            as blog_id,
    B.title         as blog_title,
    B.author_id     as blog_author_id,
    A.id            as author_id,
    A.username      as author_username,
    A.password      as author_password,
    A.email         as author_email,
    A.bio           as author_bio
  from Blog B left outer join Author A on B.author_id = A.id
  where B.id = #{id}
</select>

將上面的結(jié)果映射

<resultMap id="blogResult" type="Blog">
  <id property="id" column="blog_id" />
  <result property="title" column="blog_title"/>
  <association property="author" column="blog_author_id" javaType="Author" resultMap="authorResult"/>
</resultMap>

<resultMap id="authorResult" type="Author">
  <id property="id" column="author_id"/>
  <result property="username" column="author_username"/>
  <result property="password" column="author_password"/>
  <result property="email" column="author_email"/>
  <result property="bio" column="author_bio"/>
</resultMap>

上面的例子的Author結(jié)果可以重用，如果不需要重用，僅僅引用所有的結(jié)果映射合到一個(gè)單獨(dú)描述的結(jié)果映射中。可以做如下例子的結(jié)果映射：

<resultMap id="blogResult" type="Blog">
  <id property="id" column="blog_id" />
  <result property="title" column="blog_title"/>
  <association property="author" javaType="Author">
    <id property="id" column="author_id"/>
    <result property="username" column="author_username"/>
    <result property="password" column="author_password"/>
    <result property="email" column="author_email"/>
    <result property="bio" column="author_bio"/>
  </association>
</resultMap>

如果需要有一個(gè)co-author，select語(yǔ)句為：

<select id="selectBlog" resultMap="blogResult">
  select
    B.id            as blog_id,
    B.title         as blog_title,
    A.id            as author_id,
    A.username      as author_username,
    A.password      as author_password,
    A.email         as author_email,
    A.bio           as author_bio,
    CA.id           as co_author_id,
    CA.username     as co_author_username,
    CA.password     as co_author_password,
    CA.email        as co_author_email,
    CA.bio          as co_author_bio
  from Blog B
  left outer join Author A on B.author_id = A.id
  left outer join Author CA on B.co_author_id = CA.id
  where B.id = #{id}
</select>

再次調(diào)用的Author的resultMap定義和之前一樣。僅僅是結(jié)果中的列名不同。需要指定columnPrefix去重用映射co-author結(jié)果的resultMap

<resultMap id="blogResult" type="Blog">
  <id property="id" column="blog_id" />
  <result property="title" column="blog_title"/>
  <association property="author"
    resultMap="authorResult" />
  <association property="coAuthor"
    resultMap="authorResult"
    columnPrefix="co_" />
</resultMap>

association元素用來(lái)解決“有一個(gè)類(lèi)”關(guān)聯(lián)，“有很多個(gè)”關(guān)聯(lián)，就是用集合（collection）元素解決的。

集合（collection）

簡(jiǎn)單例子：

<collection property="posts" ofType="domain.blog.Post">
  <id property="id" column="post_id"/>
  <result property="subject" column="post_subject"/>
  <result property="body" column="post_body"/>
</collection>

collection和association很多部分相同，以下僅介紹有哪些不同。

根據(jù)association中的例子，一個(gè)博客有一個(gè)作者，有很多文章：

private List<Post> posts;

collection的嵌套查詢(xún)

嵌套查詢(xún)?yōu)椴┛图虞d文章。

<resultMap id="blogResult" type="Blog">
  <?--在 Post 類(lèi)型的 ArrayList 中的 posts 的集合。ArrayList屬性可以省略-->
  <collection property="posts" javaType="ArrayList" column="id" ofType="Post" select="selectPostsForBlog"/>
</resultMap>

<select id="selectBlog" resultMap="blogResult">
  SELECT * FROM BLOG WHERE ID = #{id}
</select>

<select id="selectPostsForBlog" resultType="Post">
  SELECT * FROM POST WHERE BLOG_ID = #{id}
</select>

collection的嵌套結(jié)果

collection和association使用方法相同，除了應(yīng)用了一個(gè)“ofType”屬性。
SQL：

<select id="selectBlog" resultMap="blogResult">
  select
  B.id as blog_id,
  B.title as blog_title,
  B.author_id as blog_author_id,
  P.id as post_id,
  P.subject as post_subject,
  P.body as post_body,
  from Blog B
  left outer join Post P on B.id = P.blog_id
  where B.id = #{id}
</select>

映射：

<resultMap id="blogResult" type="Blog">
  <id property="id" column="blog_id" />
  <result property="title" column="blog_title"/>
  <collection property="posts" ofType="Post">
    <id property="id" column="post_id"/>
    <result property="subject" column="post_subject"/>
    <result property="body" column="post_body"/>
  </collection>
</resultMap>

需要對(duì)結(jié)果進(jìn)行重用，可以抽離成resultMap：

<resultMap id="blogResult" type="Blog">
  <id property="id" column="blog_id" />
  <result property="title" column="blog_title"/>
  <collection property="posts" ofType="Post" resultMap="blogPostResult" columnPrefix="post_"/>
</resultMap>

<resultMap id="blogPostResult" type="Post">
  <id property="id" column="id"/>
  <result property="subject" column="subject"/>
  <result property="body" column="body"/>
</resultMap>

鑒別器（discriminator）

簡(jiǎn)單例子：

<discriminator javaType="int" column="draft">
  <case value="1" resultType="DraftPost"/>
</discriminator>

鑒別器用于單獨(dú)的數(shù)據(jù)庫(kù)返回不同的數(shù)據(jù)類(lèi)型的結(jié)果集。指定了 column 和 javaType 屬性。 列是 MyBatis 查找比較值的地方。 JavaType 是需要被用來(lái)保證等價(jià)測(cè)試的合適類(lèi)型(盡管字符串在很多情形下都會(huì)有用)：

<resultMap id="vehicleResult" type="Vehicle">
  <id property="id" column="id" />
  <result property="vin" column="vin"/>
  <result property="year" column="year"/>
  <result property="make" column="make"/>
  <result property="model" column="model"/>
  <result property="color" column="color"/>
  <discriminator javaType="int" column="vehicle_type">
    <case value="1" resultMap="carResult"/>
    <case value="2" resultMap="truckResult"/>
    <case value="3" resultMap="vanResult"/>
    <case value="4" resultMap="suvResult"/>
  </discriminator>
</resultMap>

在這個(gè)示例中, MyBatis 會(huì)從結(jié)果集中得到每條記錄, 然后比較它的 vehicle 類(lèi)型的值。 如果它匹配任何一個(gè)鑒別器的實(shí)例,那么就使用這個(gè)實(shí)例指定的結(jié)果映射。換句話說(shuō),這樣 做完全是剩余的結(jié)果映射被忽略(除非它被擴(kuò)展,這在第二個(gè)示例中討論) 。如果沒(méi)有任何 一個(gè)實(shí)例相匹配,那么 MyBatis 僅僅使用鑒別器塊外定義的結(jié)果映射。所以,如果 carResult 按如下聲明：

<resultMap id="carResult" type="Car">
  <result property="doorCount" column="door_count" />
</resultMap>

那么只有 doorCount 屬性會(huì)被加載。這步完成后完整地允許鑒別器實(shí)例的獨(dú)立組,盡管 和父結(jié)果映射可能沒(méi)有什么關(guān)系。這種情況下,我們當(dāng)然知道 cars 和 vehicles 之間有關(guān)系, 如 Car 是一個(gè) Vehicle 實(shí)例。以下方式使vehicleResult 和 carResult 的屬性都會(huì)被加載：

<resultMap id="carResult" type="Car" extends="vehicleResult">
  <result property="doorCount" column="door_count" />
</resultMap>

可以按如下方式進(jìn)行嵌套映射：

<resultMap id="vehicleResult" type="Vehicle">
  <id property="id" column="id" />
  <result property="vin" column="vin"/>
  <result property="year" column="year"/>
  <result property="make" column="make"/>
  <result property="model" column="model"/>
  <result property="color" column="color"/>
  <discriminator javaType="int" column="vehicle_type">
    <case value="1" resultType="carResult">
      <result property="doorCount" column="door_count" />
    </case>
    <case value="2" resultType="truckResult">
      <result property="boxSize" column="box_size" />
      <result property="extendedCab" column="extended_cab" />
    </case>
    <case value="3" resultType="vanResult">
      <result property="powerSlidingDoor" column="power_sliding_door" />
    </case>
    <case value="4" resultType="suvResult">
      <result property="allWheelDrive" column="all_wheel_drive" />
    </case>
  </discriminator>
</resultMap>

自動(dòng)映射

當(dāng)自動(dòng)映射查詢(xún)結(jié)果時(shí)，MyBatis會(huì)獲取sql返回的列名并在java類(lèi)中查找相同名字的屬性（忽略大小寫(xiě)）。 這意味著如果Mybatis發(fā)現(xiàn)了ID列和id屬性，Mybatis會(huì)將ID的值賦給id。

通常數(shù)據(jù)庫(kù)列使用大寫(xiě)單詞命名，單詞間用下劃線分隔；而java屬性一般遵循駝峰命名法。 為了在這兩種命名方式之間啟用自動(dòng)映射，需要將 mapUnderscoreToCamelCase設(shè)置為true。

自動(dòng)映射在特定的result map下也能工作。在這種情況下，對(duì)于每一個(gè)result map,所有的ResultSet提供的列， 如果沒(méi)有被手工映射，則將被自動(dòng)映射。自動(dòng)映射處理完畢后手工映射才會(huì)被處理。 在接下來(lái)的例子中， id 和 userName列將被自動(dòng)映射， hashed_password 列將根據(jù)配置映射：

<select id="selectUsers" resultMap="userResultMap">
  select
    user_id             as "id",
    user_name           as "userName",
    hashed_password
  from some_table
  where id = #{id}
</select>

<resultMap id="userResultMap" type="User">
  <result property="password" column="hashed_password"/>
</resultMap>

有三種映射等級(jí)，默認(rèn)值是PARTIAL：

• NONE - 禁用自動(dòng)映射。僅設(shè)置手動(dòng)映射屬性。
• PARTIAL - 將自動(dòng)映射結(jié)果除了那些有內(nèi)部定義內(nèi)嵌結(jié)果映射的(joins).
• FULL - 自動(dòng)映射所有。

通過(guò)添加autoMapping屬性可以忽略自動(dòng)映射等級(jí)配置，你可以啟用或者禁用自動(dòng)映射指定的ResultMap。

<resultMap id="userResultMap" type="User" autoMapping="false">
  <result property="password" column="hashed_password"/>
</resultMap>

緩存

默認(rèn)情況下是沒(méi)有開(kāi)啟緩存的,除了局部的 session 緩存。要開(kāi)啟二級(jí)緩存,你需要在你的 SQL 映射文件中添加一行:

<cache/>

作用為：

• 映射語(yǔ)句文件中的所有 select 語(yǔ)句將會(huì)被緩存。
• 映射語(yǔ)句文件中的所有 insert,update 和 delete 語(yǔ)句會(huì)刷新緩存。
• 緩存會(huì)使用 Least Recently Used(LRU,最近最少使用的)算法來(lái)收回。
• 根據(jù)時(shí)間表(比如 no Flush Interval,沒(méi)有刷新間隔), 緩存不會(huì)以任何時(shí)間順序 來(lái)刷新。
• 緩存會(huì)存儲(chǔ)列表集合或?qū)ο?無(wú)論查詢(xún)方法返回什么)的 1024 個(gè)引用。
• 緩存會(huì)被視為是 read/write(可讀/可寫(xiě))的緩存,意味著對(duì)象檢索不是共享的,而 且可以安全地被調(diào)用者修改,而不干擾其他調(diào)用者或線程所做的潛在修改。

所有的這些屬性都可以通過(guò)緩存元素的屬性來(lái)修改。比如:

<cache
  eviction="FIFO"
  flushInterval="60000"
  size="512"
  readOnly="true"/>

這個(gè)更高級(jí)的配置創(chuàng)建了一個(gè) FIFO 緩存,并每隔 60 秒刷新,存數(shù)結(jié)果對(duì)象或列表的 512 個(gè)引用,而且返回的對(duì)象被認(rèn)為是只讀的,因此在不同線程中的調(diào)用者之間修改它們會(huì) 導(dǎo)致沖突。

可用的收回策略有:

• LRU – 最近最少使用的:移除最長(zhǎng)時(shí)間不被使用的對(duì)象。
• FIFO – 先進(jìn)先出:按對(duì)象進(jìn)入緩存的順序來(lái)移除它們。
• SOFT – 軟引用:移除基于垃圾回收器狀態(tài)和軟引用規(guī)則的對(duì)象。
• WEAK – 弱引用:更積極地移除基于垃圾收集器狀態(tài)和弱引用規(guī)則的對(duì)象。
  默認(rèn)的是 LRU。

flushInterval(刷新間隔)可以被設(shè)置為任意的正整數(shù),而且它們代表一個(gè)合理的毫秒 形式的時(shí)間段。默認(rèn)情況是不設(shè)置,也就是沒(méi)有刷新間隔,緩存僅僅調(diào)用語(yǔ)句時(shí)刷新。

size(引用數(shù)目)可以被設(shè)置為任意正整數(shù),要記住你緩存的對(duì)象數(shù)目和你運(yùn)行環(huán)境的 可用內(nèi)存資源數(shù)目。默認(rèn)值是 1024。

readOnly(只讀)屬性可以被設(shè)置為 true 或 false。只讀的緩存會(huì)給所有調(diào)用者返回緩 存對(duì)象的相同實(shí)例。因此這些對(duì)象不能被修改。這提供了很重要的性能優(yōu)勢(shì)。可讀寫(xiě)的緩存 會(huì)返回緩存對(duì)象的拷貝(通過(guò)序列化) 。這會(huì)慢一些,但是安全,因此默認(rèn)是 false。

自定義緩存

可以通過(guò)實(shí)現(xiàn)自定義緩存或?yàn)槠渌谌骄彺娣桨竸?chuàng)建適配器來(lái)完全覆蓋緩存行為。

<cache  type="com.domain.something.MyCustomCache"/>

這個(gè)示例展 示了如何使用一個(gè)自定義的緩存實(shí)現(xiàn)。type屬性指定的類(lèi)必須實(shí)現(xiàn) org.mybatis.cache.Cache 接口。

public interface Cache {
  String getId();
  int getSize();
  void putObject(Object key, Object value);
  Object getObject(Object key);
  boolean hasKey(Object key);
  Object removeObject(Object key);
  void clear();
}

要配置你的緩存, 僅僅添加公有的 JavaBeans 屬性來(lái)配置緩存實(shí)現(xiàn), 然后通過(guò) cache 元素來(lái)傳遞屬性, 比如, 下面代碼會(huì)在你的緩存實(shí)現(xiàn)中調(diào)用一個(gè)稱(chēng)為 “setCacheFile(String file)” 的方法:

<cache type="com.domain.something.MyCustomCache">
  <property name="cacheFile" value="/tmp/my-custom-cache.tmp"/>
</cache>

可以在所有屬性設(shè)置完畢以后可以調(diào)用一個(gè)初始化方法。如果你想要使用這個(gè)特性，請(qǐng)?jiān)谀愕淖远x緩存類(lèi)里實(shí)現(xiàn) org.apache.ibatis.builder.InitializingObject接口。

public interface InitializingObject {
  void initialize() throws Exception;
}

It's important to remember that a cache configuration and the cache instance are bound to the namespace of the SQL Map file. Thus, all statements in the same namespace as the cache are bound by it. Statements can modify how they interact with the cache, or exclude themselves completely by using two simple attributes on a statement-by-statement basis. By default, statements are configured like this:

<select ... flushCache="false" useCache="true"/>
<insert ... flushCache="true"/>
<update ... flushCache="true"/>
<delete ... flushCache="true"/>

不能明確地以這種方式來(lái)配置一條語(yǔ)句。相反,如果你想改變默認(rèn)的行為,只能設(shè)置 flushCache 和 useCache 屬性。比如,在一些情況下你也許想排除 從緩存中查詢(xún)特定語(yǔ)句結(jié)果,或者你也許想要一個(gè)查詢(xún)語(yǔ)句來(lái)刷新緩存。相似地,你也許有 一些更新語(yǔ)句依靠執(zhí)行而不需要刷新緩存。

參照緩存

回想一下上一節(jié)內(nèi)容, 這個(gè)特殊命名空間的唯一緩存會(huì)被使用或者刷新相同命名空間內(nèi) 的語(yǔ)句。也許將來(lái)的某個(gè)時(shí)候,你會(huì)想在命名空間中共享相同的緩存配置和實(shí)例。在這樣的 情況下你可以使用 cache-ref 元素來(lái)引用另外一個(gè)緩存。

<cache-ref  namespace="com.someone.application.data.SomeMapper"/>