MyBatis之Mapper詳解及經常使用技巧

select

先看一個簡單的案例:

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

這個語句被稱做 selectPerson，接受一個 int（或 Integer）類型的參數，並返回一個 HashMap 類型的對象，其中的鍵是列名，值即是結果行中的對應值。注意參數#{id},相似與JDBC的語句:

String selectPerson = "SELECT * FROM PERSON WHERE ID=?";
PreparedStatement ps = conn.prepareStatement(selectPerson);
ps.setInt(1,id);

Select Attributes

屬性	描述
id	在命名空間中惟一的標識符，能夠被用來引用這條語句。
parameterType	將會傳入這條語句的參數類的徹底限定名或別名。這個屬性是可選的，由於 MyBatis 能夠經過 TypeHandler 推斷出具體傳入語句的參數，默認值爲 unset。
parameterMap	這是引用外部 parameterMap 的已經被廢棄的方法。使用內聯參數映射和 parameterType 屬性。
resultType	從這條語句中返回的指望類型的類的徹底限定名或別名。注意若是是集合情形，那應該是集合能夠包含的類型，而不能是集合自己。使用 resultType 或 resultMap，但不能同時使用。
resultMap	外部 resultMap 的命名引用。結果集的映射是 MyBatis 最強大的特性，對其有一個很好的理解的話，許多複雜映射的情形都能迎刃而解。使用 resultMap 或 resultType，但不能同時使用。
flushCache	將其設置爲 true，任什麼時候候只要語句被調用，都會致使本地緩存和二級緩存都會被清空，默認值：false。
useCache	將其設置爲 true，將會致使本條語句的結果被二級緩存，默認值：對 select 元素爲 true。
timeout	這個設置是在拋出異常以前，驅動程序等待數據庫返回請求結果的秒數。默認值爲 unset（依賴驅動）。
fetchSize	這是嘗試影響驅動程序每次批量返回的結果行數和這個設置值相等。默認值爲 unset（依賴驅動）。
statementType	STATEMENT，PREPARED 或 CALLABLE 的一個。這會讓 MyBatis 分別使用 Statement，PreparedStatement 或 CallableStatement，默認值：PREPARED。
resultSetType	FORWARD_ONLY，SCROLL_SENSITIVE 或 SCROLL_INSENSITIVE 中的一個，默認值爲 unset （依賴驅動）。
databaseId	若是配置了 databaseIdProvider，MyBatis 會加載全部的不帶 databaseId 或匹配當前 databaseId 的語句；若是帶或者不帶的語句都有，則不帶的會被忽略。
resultOrdered	這個設置僅針對嵌套結果 select 語句適用：若是爲 true，就是假設包含了嵌套結果集或是分組了，這樣的話當返回一個主結果行的時候，就不會發生有對前面結果集的引用的狀況。這就使得在獲取嵌套的結果集的時候不至於致使內存不夠用。默認值：false。
resultSets	這個設置僅對多結果集的狀況適用，它將列出語句執行後返回的結果集並每一個結果集給一個名稱，名稱是逗號分隔的。

select的模糊查詢:

<select id="getUserByName" parameterType="string" resultType="cn.itheima.mybatis.po.User">
    SELECT * FROM `user` WHERE username LIKE '%${value}%'
</select>

insert,update,delete的屬性接近:

Insert, Update, Delete 's Attributes

屬性	描述
id	命名空間中的惟一標識符，可被用來表明這條語句。
parameterType	將要傳入語句的參數的徹底限定類名或別名。這個屬性是可選的，由於 MyBatis 能夠經過 TypeHandler 推斷出具體傳入語句的參數，默認值爲 unset。
parameterMap	這是引用外部 parameterMap 的已經被廢棄的方法。使用內聯參數映射和 parameterType 屬性。
flushCache	將其設置爲 true，任什麼時候候只要語句被調用，都會致使本地緩存和二級緩存都會被清空，默認值：true（對應插入、更新和刪除語句）。
timeout	這個設置是在拋出異常以前，驅動程序等待數據庫返回請求結果的秒數。默認值爲 unset（依賴驅動）。
statementType	STATEMENT，PREPARED 或 CALLABLE 的一個。這會讓 MyBatis 分別使用 Statement，PreparedStatement 或 CallableStatement，默認值：PREPARED。
useGeneratedKeys	（僅對 insert 和 update 有用）這會令 MyBatis 使用 JDBC 的 getGeneratedKeys 方法來取出由數據庫內部生成的主鍵（好比：像 MySQL 和 SQL Server 這樣的關係數據庫管理系統的自動遞增字段），默認值：false。
keyProperty	（僅對 insert 和 update 有用）惟一標記一個屬性，MyBatis 會經過 getGeneratedKeys 的返回值或者經過 insert 語句的 selectKey 子元素設置它的鍵值，默認：unset。若是但願獲得多個生成的列，也能夠是逗號分隔的屬性名稱列表。
keyColumn	（僅對 insert 和 update 有用）經過生成的鍵值設置表中的列名，這個設置僅在某些數據庫（像 PostgreSQL）是必須的，當主鍵列不是表中的第一列的時候須要設置。若是但願獲得多個生成的列，也能夠是逗號分隔的屬性名稱列表。
databaseId	若是配置了 databaseIdProvider，MyBatis 會加載全部的不帶 databaseId 或匹配當前 databaseId 的語句；若是帶或者不帶的語句都有，則不帶的會被忽略。

insert:

useGenerateKeys="true"和keyProperty="id"配合使用,表示id是自增加的字段.注意:參數是UserInfo中的變量,不是數據庫中的字段

<insert id="insertUser" parameterType="com.shadow.foretaste.entity.UserInfo" useGeneratedKeys="true" keyProperty="id">
        insert into user_info (nickname, phone_num) values (#{nickname}, #{phoneNum})
</insert>

sql:

這個元素能夠被用來定義可重用的 SQL 代碼段，能夠包含在其餘語句中。它能夠被靜態地(在加載參數) 參數化. 不一樣的屬性值經過包含的實例變化. 好比：

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

這個 SQL 片斷能夠被包含在其餘語句中，例如：

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

參數:

User 類型的參數對象傳遞到了語句中，id、username 和 password 屬性將會被查找，而後將它們的值傳入預處理語句的參數中。

<insert id="insertUser" parameterType="User">
  insert into users (id, username, password)
  values (#{id}, #{username}, #{password})
</insert>

指定參數的類型:

#{property,javaType=int,jdbcType=NUMERIC,typeHandler=MyTypeHandler,mode=OUT,resultMap=User}

 property:屬性名，即代碼傳入的變量名。
 javaType：該字段在JAVA中的類型，好比int。
 jdbcType：該字段在JDBC中的類型，好比NUMERIC。
 typeHandler:類型處理器
 mode：參數類型爲IN，OUT或INOUT參數

 resultMap：結果。

下面列幾個經常使用的參數類型:

List

public List<Area> findUserListByIdList(List<Long> idList) {  
        return getSqlSession().selectList("com.liulanghan.findUserListByIdList", idList);  
    }

<select id="findUserListByIdList" parameterType="java.util.ArrayList" resultType="User">  
    select * from user   
    <where>  
        user.ID in (  
        <foreach item="guard" index="index" collection="list"  
            separator=","> #{guard} </foreach>  
        )  
    </where>  
</select>

Array

public List<Area> findUserListByIdList(int[] ids) {  
        return getSqlSession().selectList("com.liulanghan.findUserListByIdList", ids);  
    }

<select id="findUserListByIdList" parameterType="java.util.HashList" resultType="User">  
    select * from user user  
    <where>  
        user.ID in (  
        <foreach item="guard" index="index" collection="array"  
            separator=","> #{guard} </foreach>  
        )  
    </where>  
</select>

Map

public boolean exists(Map<String, Object> map){  
        Object count = getSqlSession().selectOne("com.liulanghan.exists", map);  
        int totalCount = Integer.parseInt(count.toString());  
        return totalCount > 0 ? true : false;  
    }

<select id="exists" parameterType="java.util.HashMap" resultType="java.lang.Integer">  
        SELECT COUNT(*) FROM USER user  
        <where>  
            <if test="code != null">   
                and user.CODE = #{code}   
            </if>  
            <if test="id != null">   
                and user.ID = #{id}   
            </if>  
            <if test="idList !=null ">  
                and user.ID in (  
                <foreach item="guard" index="index" collection="idList"  
                    separator=","> #{guard} </foreach>  
                )  
            </if>  
        </where>  
</select>

字符串替換:

 ORDER BY ${columnName}將值直接替換到sql語句中.