深入淺出Mybatis系列（七）---mapper映射文件配置之insert、update、delete

上篇文章《深入淺出Mybatis系列（六）---objectFactory、plugins、mappers簡介與配置》簡單地給mybatis的配置畫上了一個句號。那么從本篇文章開始，將會介紹mapper映射文件的配置， 這是mybatis的核心之一，一定要學好。在mapper文件中，以mapper作為根節點，其下面可以配置的元素節點有： select, insert, update, delete, cache, cache-ref, resultMap, sql 。

本篇文章將簡單介紹 insert, update, delete 的配置及使用，以后會對mybatis的源碼進行深入講解。

相信，看到insert, update, delete， 我們就知道其作用了，顧名思義嘛，myabtis 作為持久層框架，必須要對CRUD啊。

好啦，咱們就先來看看 insert, update, delete 怎么配置， 能配置哪些元素吧：

<?xml version="1.0" encoding="UTF-8" ?>   
<!DOCTYPE mapper   
PUBLIC "-//ibatis.apache.org//DTD Mapper 3.0//EN"  
"http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd"> 

<!-- mapper 為根元素節點， 一個namespace對應一個dao -->
<mapper namespace="com.dy.dao.UserDao">

    <insert
      <!-- 1. id （必須配置）
        id是命名空間中的唯一標識符，可被用來代表這條語句。 
        一個命名空間（namespace） 對應一個dao接口, 
        這個id也應該對應dao里面的某個方法（相當於方法的實現），因此id 應該與方法名一致 -->
      
      id="insertUser"
      
      <!-- 2. parameterType （可選配置, 默認為mybatis自動選擇處理）
        將要傳入語句的參數的完全限定類名或別名， 如果不配置，mybatis會通過ParameterHandler 根據參數類型默認選擇合適的typeHandler進行處理
        parameterType 主要指定參數類型，可以是int, short, long, string等類型，也可以是復雜類型（如對象） -->
      
      parameterType="com.demo.User"
      
      <!-- 3. flushCache （可選配置，默認配置為true）
        將其設置為 true，任何時候只要語句被調用，都會導致本地緩存和二級緩存都會被清空，默認值：true（對應插入、更新和刪除語句） -->
      
      flushCache="true"
      
      <!-- 4. statementType （可選配置，默認配置為PREPARED）
        STATEMENT，PREPARED 或 CALLABLE 的一個。這會讓 MyBatis 分別使用 Statement，PreparedStatement 或 CallableStatement，默認值：PREPARED。 -->
      
      statementType="PREPARED"
      
      <!-- 5. keyProperty (可選配置， 默認為unset)
        （僅對 insert 和 update 有用）唯一標記一個屬性，MyBatis 會通過 getGeneratedKeys 的返回值或者通過 insert 語句的 selectKey 子元素設置它的鍵值，默認：unset。如果希望得到多個生成的列，也可以是逗號分隔的屬性名稱列表。 -->
      
      keyProperty=""
      
      <!-- 6. keyColumn     (可選配置)
        （僅對 insert 和 update 有用）通過生成的鍵值設置表中的列名，這個設置僅在某些數據庫（像 PostgreSQL）是必須的，當主鍵列不是表中的第一列的時候需要設置。如果希望得到多個生成的列，也可以是逗號分隔的屬性名稱列表。 -->
      
      keyColumn=""
      
      <!-- 7. useGeneratedKeys (可選配置， 默認為false)
        （僅對 insert 和 update 有用）這會令 MyBatis 使用 JDBC 的 getGeneratedKeys 方法來取出由數據庫內部生成的主鍵（比如：像 MySQL 和 SQL Server 這樣的關系數據庫管理系統的自動遞增字段），默認值：false。  -->
      
      useGeneratedKeys="false"
      
      <!-- 8. timeout  (可選配置， 默認為unset, 依賴驅動)
        這個設置是在拋出異常之前，驅動程序等待數據庫返回請求結果的秒數。默認值為 unset（依賴驅動）。 -->
      timeout="20">

    <update
      id="updateUser"
      parameterType="com.demo.User"
      flushCache="true"
      statementType="PREPARED"
      timeout="20">

    <delete
      id="deleteUser"
      parameterType="com.demo.User"
      flushCache="true"
      statementType="PREPARED"
      timeout="20">
</mapper>

以上就是一個模板配置， 哪些是必要配置，哪些是根據自己實際需求，看一眼就知道了。

 

下面， 還是用第一篇文章《深入淺出Mybatis系列（一）---Mybatis入門》里面的demo來示例吧：

數據庫 （user表）：

 

我項目結構：

 

User.java:

package com.dy.entity;

public class User {

    private int id;
    private String name;
    private String password;
    private int age;
    private int deleteFlag;
    
    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public String getPassword() {
        return password;
    }
    public void setPassword(String password) {
        this.password = password;
    }
    public int getAge() {
        return age;
    }
    public void setAge(int age) {
        this.age = age;
    }
    public int getDeleteFlag() {
        return deleteFlag;
    }
    public void setDeleteFlag(int deleteFlag) {
        this.deleteFlag = deleteFlag;
    }
    
}

UserDao.java:

package com.dy.dao;

import com.dy.entity.User;

public interface UserDao {

    public void insertUser (User user);
    
    public void updateUser (User user);
    
    public void deleteUser (User user);
    
}

userDao.xml:

<?xml version="1.0" encoding="UTF-8" ?>   
<!DOCTYPE mapper   
PUBLIC "-//ibatis.apache.org//DTD Mapper 3.0//EN"  
"http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd"> 

<mapper namespace="com.dy.dao.UserDao">
   
   <!-- 對應userDao中的insertUser方法，  -->
   <insert id="insertUser" parameterType="com.dy.entity.User">
           insert into user(id, name, password, age, deleteFlag) 
               values(#{id}, #{name}, #{password}, #{age}, #{deleteFlag})
   </insert>
   
   <!-- 對應userDao中的updateUser方法 -->
   <update id="updateUser" parameterType="com.dy.entity.User">
           update user set name = #{name}, password = #{password}, age = #{age}, deleteFlag = #{deleteFlag}
               where id = #{id};
   </update>
    
   <!-- 對應userDao中的deleteUser 方法 --> 
   <delete id="deleteUser" parameterType="com.dy.entity.User">
           delete from user where id = #{id};
   </delete>
</mapper>

這樣，一個簡單的映射關系就建立了。仔細觀察上面parameterType,  "com.dy.entity.User"，包名要是再長點呢，每次都這樣寫，寫得蛋疼了。別忘了之前講的 typeAliases（別名）， 那么這個地方，用上別名，豈不是技能跟蛋疼的長長的包名說拜拜了。好啦，咱們配上別名，在哪兒配？ 當然是在mybatis 的全局配置文件（我這兒名字是mybatis-conf.xml）， 不要認為是在mapper的配置文件里面配置哈。

mybatis-conf.xml:

<typeAliases>
      <!--
      通過package, 可以直接指定package的名字， mybatis會自動掃描你指定包下面的javabean,
      並且默認設置一個別名，默認的名字為： javabean 的首字母小寫的非限定類名來作為它的別名。
      也可在javabean 加上注解@Alias 來自定義別名， 例如： @Alias(user) 
      <package name="com.dy.entity"/>
       -->
      <typeAlias alias="user" type="com.dy.entity.User"/>
  </typeAliases>

 這樣，一個別名就取好了，咱們可以把上面的 com.dy.entity.User 都直接改為user 了。 這多方便呀！

我這兒數據庫用的是mysql, 我把user表的主鍵id 設置了自動增長， 以上代碼運行正常， 那么問題來了（當然，我不是要問學挖掘機哪家強），我要是換成oracle數據庫怎么辦？ oracle 可是不支持id自增長啊？ 怎么辦？請看下面：

<!-- 對應userDao中的insertUser方法，  -->
   <insert id="insertUser" parameterType="com.dy.entity.User">
           <!-- oracle等不支持id自增長的，可根據其id生成策略，先獲取id 
           
        <selectKey resultType="int" order="BEFORE" keyProperty="id">
              select seq_user_id.nextval as id from dual
        </selectKey>
        
        -->   
           insert into user(id, name, password, age, deleteFlag) 
               values(#{id}, #{name}, #{password}, #{age}, #{deleteFlag})
   </insert>

同理，如果我們在使用mysql的時候，想在數據插入后返回插入的id, 我們也可以使用 selectKey 這個元素：

<!-- 對應userDao中的insertUser方法，  -->
   <insert id="insertUser" parameterType="com.dy.entity.User">
           <!-- oracle等不支持id自增長的，可根據其id生成策略，先獲取id 
           
        <selectKey resultType="int" order="BEFORE" keyProperty="id">
              select seq_user_id.nextval as id from dual
        </selectKey>
        
        --> 
        
        <!-- mysql插入數據后，獲取id -->
        <selectKey keyProperty="id" resultType="int" order="AFTER" >
               SELECT LAST_INSERT_ID() as id
           </selectKey>
          
           insert into user(id, name, password, age, deleteFlag) 
               values(#{id}, #{name}, #{password}, #{age}, #{deleteFlag})
   </insert>

 

這兒，我們就簡單提一下 <selectKey> 這個元素節點吧:

<selectKey
        <!-- selectKey 語句結果應該被設置的目標屬性。如果希望得到多個生成的列，也可以是逗號分隔的屬性名稱列表。 -->
        keyProperty="id"
        <!-- 結果的類型。MyBatis 通常可以推算出來，但是為了更加確定寫上也不會有什么問題。MyBatis 允許任何簡單類型用作主鍵的類型，包括字符串。如果希望作用於多個生成的列，則可以使用一個包含期望屬性的 Object 或一個 Map。 -->
        resultType="int"
        <!-- 這可以被設置為 BEFORE 或 AFTER。如果設置為 BEFORE，那么它會首先選擇主鍵，設置 keyProperty 然后執行插入語句。如果設置為 AFTER，那么先執行插入語句，然后是 selectKey 元素 - 這和像 Oracle 的數據庫相似，在插入語句內部可能有嵌入索引調用。 -->
        order="BEFORE"
        <!-- 與前面相同，MyBatis 支持 STATEMENT，PREPARED 和 CALLABLE 語句的映射類型，分別代表 PreparedStatement 和 CallableStatement 類型。 -->
        statementType="PREPARED">

 

好啦，本篇文章主要介紹了insert, update, delete的配置及用法。 下篇文章將介紹復雜的 select相關的配置及用法， 待這些都講完后，會先根據源碼分析一下mybatis的整個運行流程，然后再深入mybatis的用法。

本篇文章到此結束！

附上demo 下載地址：http://pan.baidu.com/s/1gdtKf5L

需要的可以下載。