Mybatis 系列7
上篇系列6中 簡單地給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 怎麽配置, 能配置哪些元素吧:
1 <?xml version="1.0" encoding="UTF-8" ?> 2 <!DOCTYPE mapper 3 PUBLIC "-//ibatis.apache.org//DTD Mapper 3.0//EN" 4 "http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd"> 5 6 <!-- mapper 為根元素節點, 一個namespace對應一個dao --> 7 <mapper namespace="com.dy.dao.UserDao"> 89 <insert 10 <!-- 1. id (必須配置) 11 id是命名空間中的唯一標識符,可被用來代表這條語句。 12 一個命名空間(namespace) 對應一個dao接口, 13 這個id也應該對應dao裏面的某個方法(相當於方法的實現),因此id 應該與方法名一致 --> 14 15 id="insertUser" 16 17 <!-- 2. parameterType (可選配置, 默認為mybatis自動選擇處理) 18 將要傳入語句的參數的完全限定類名或別名, 如果不配置,mybatis會通過ParameterHandler 根據參數類型默認選擇合適的typeHandler進行處理19 parameterType 主要指定參數類型,可以是int, short, long, string等類型,也可以是復雜類型(如對象) --> 20 21 parameterType="com.demo.User" 22 23 <!-- 3. flushCache (可選配置,默認配置為true) 24 將其設置為 true,任何時候只要語句被調用,都會導致本地緩存和二級緩存都會被清空,默認值:true(對應插入、更新和刪除語句) --> 25 26 flushCache="true" 27 28 <!-- 4. statementType (可選配置,默認配置為PREPARED) 29 STATEMENT,PREPARED 或 CALLABLE 的一個。這會讓 MyBatis 分別使用 Statement,PreparedStatement 或 CallableStatement,默認值:PREPARED。 --> 30 31 statementType="PREPARED" 32 33 <!-- 5. keyProperty (可選配置, 默認為unset) 34 (僅對 insert 和 update 有用)唯一標記一個屬性,MyBatis 會通過 getGeneratedKeys 的返回值或者通過 insert 語句的 selectKey 子元素設置它的鍵值,默認:unset。如果希望得到多個生成的列,也可以是逗號分隔的屬性名稱列表。 --> 35 36 keyProperty="" 37 38 <!-- 6. keyColumn (可選配置) 39 (僅對 insert 和 update 有用)通過生成的鍵值設置表中的列名,這個設置僅在某些數據庫(像 PostgreSQL)是必須的,當主鍵列不是表中的第一列的時候需要設置。如果希望得到多個生成的列,也可以是逗號分隔的屬性名稱列表。 --> 40 41 keyColumn="" 42 43 <!-- 7. useGeneratedKeys (可選配置, 默認為false) 44 (僅對 insert 和 update 有用)這會令 MyBatis 使用 JDBC 的 getGeneratedKeys 方法來取出由數據庫內部生成的主鍵(比如:像 MySQL 和 SQL Server 這樣的關系數據庫管理系統的自動遞增字段),默認值:false。 --> 45 46 useGeneratedKeys="false" 47 48 <!-- 8. timeout (可選配置, 默認為unset, 依賴驅動) 49 這個設置是在拋出異常之前,驅動程序等待數據庫返回請求結果的秒數。默認值為 unset(依賴驅動)。 --> 50 timeout="20"> 51 52 <update 53 id="updateUser" 54 parameterType="com.demo.User" 55 flushCache="true" 56 statementType="PREPARED" 57 timeout="20"> 58 59 <delete 60 id="deleteUser" 61 parameterType="com.demo.User" 62 flushCache="true" 63 statementType="PREPARED" 64 timeout="20"> 65 </mapper>
以上就是一個模板配置, 哪些是必要配置,哪些是根據自己實際需求,看一眼就知道了。
下面, 還是用第一篇文章《深入淺出Mybatis系列(一)---Mybatis入門》裏面的demo來示例吧:
數據庫 (user表):
項目結構:
User.java:
1 package com.dy.entity; 2 3 public class User { 4 5 private int id; 6 private String name; 7 private String password; 8 private int age; 9 private int deleteFlag; 10 11 public int getId() { 12 return id; 13 } 14 public void setId(int id) { 15 this.id = id; 16 } 17 public String getName() { 18 return name; 19 } 20 public void setName(String name) { 21 this.name = name; 22 } 23 public String getPassword() { 24 return password; 25 } 26 public void setPassword(String password) { 27 this.password = password; 28 } 29 public int getAge() { 30 return age; 31 } 32 public void setAge(int age) { 33 this.age = age; 34 } 35 public int getDeleteFlag() { 36 return deleteFlag; 37 } 38 public void setDeleteFlag(int deleteFlag) { 39 this.deleteFlag = deleteFlag; 40 } 41 42 }
UserDao.java:
1 package com.dy.dao; 2 3 import com.dy.entity.User; 4 5 public interface UserDao { 6 7 public void insertUser (User user); 8 9 public void updateUser (User user); 10 11 public void deleteUser (User user); 12 13 }
userDao.xml:
1 <?xml version="1.0" encoding="UTF-8" ?> 2 <!DOCTYPE mapper 3 PUBLIC "-//ibatis.apache.org//DTD Mapper 3.0//EN" 4 "http://ibatis.apache.org/dtd/ibatis-3-mapper.dtd"> 5 6 <mapper namespace="com.dy.dao.UserDao"> 7 8 <!-- 對應userDao中的insertUser方法, --> 9 <insert id="insertUser" parameterType="com.dy.entity.User"> 10 insert into user(id, name, password, age, deleteFlag) 11 values(#{id}, #{name}, #{password}, #{age}, #{deleteFlag}) 12 </insert> 13 14 <!-- 對應userDao中的updateUser方法 --> 15 <update id="updateUser" parameterType="com.dy.entity.User"> 16 update user set name = #{name}, password = #{password}, age = #{age}, deleteFlag = #{deleteFlag} 17 where id = #{id}; 18 </update> 19 20 <!-- 對應userDao中的deleteUser 方法 --> 21 <delete id="deleteUser" parameterType="com.dy.entity.User"> 22 delete from user where id = #{id}; 23 </delete> 24 </mapper>
這樣,一個簡單的映射關系就建立了。
仔細觀察上面parameterType, "com.dy.entity.User",包名要是再長點呢,每次都這樣寫,寫得蛋疼了。別忘了之前講的 typeAliases(別名), 那麽這個地方,用上別名,豈不是技能跟蛋疼的長長的包名說拜拜了。
在哪兒配? 當然是在mybatis 的全局配置文件(我這兒名字是mybatis-conf.xml), 不要認為是在mapper的配置文件裏面配置哈。 mybatis-conf.xml:
1 <typeAliases> 2 <!-- 3 通過package, 可以直接指定package的名字, mybatis會自動掃描你指定包下面的javabean, 4 並且默認設置一個別名,默認的名字為: javabean 的首字母小寫的非限定類名來作為它的別名。 5 也可在javabean 加上註解@Alias 來自定義別名, 例如: @Alias(user) 6 <package name="com.dy.entity"/> 7 --> 8 <typeAlias alias="user" type="com.dy.entity.User"/> 9 </typeAliases>
這樣,一個別名就取好了,咱們可以把上面的 com.dy.entity.User 都直接改為user 了。 這多方便呀! 我這兒數據庫用的是mysql, 我把user表的主鍵id 設置了自動增長, 以上代碼運行正常,
那麽問題來了,我要是換成oracle數據庫怎麽辦?
oracle 可是不支持id自增長啊? 怎麽辦?請看下面:
1 <!-- 對應userDao中的insertUser方法, --> 2 <insert id="insertUser" parameterType="com.dy.entity.User"> 3 <!-- oracle等不支持id自增長的,可根據其id生成策略,先獲取id 4 5 <selectKey resultType="int" order="BEFORE" keyProperty="id"> 6 select seq_user_id.nextval as id from dual 7 </selectKey> 8 9 --> 10 insert into user(id, name, password, age, deleteFlag) 11 values(#{id}, #{name}, #{password}, #{age}, #{deleteFlag}) 12 </insert>
同理,如果我們在使用mysql的時候,想在數據插入後返回插入的id, 我們也可以使用 selectKey 這個元素:
1 <!-- 對應userDao中的insertUser方法, --> 2 <insert id="insertUser" parameterType="com.dy.entity.User"> 3 <!-- oracle等不支持id自增長的,可根據其id生成策略,先獲取id 4 5 <selectKey resultType="int" order="BEFORE" keyProperty="id"> 6 select seq_user_id.nextval as id from dual 7 </selectKey> 8 9 --> 10 11 <!-- mysql插入數據後,獲取id --> 12 <selectKey keyProperty="id" resultType="int" order="AFTER" > 13 SELECT LAST_INSERT_ID() as id 14 </selectKey> 15 16 insert into user(id, name, password, age, deleteFlag) 17 values(#{id}, #{name}, #{password}, #{age}, #{deleteFlag}) 18 </insert>
這兒,我們就簡單提一下 <selectKey> 這個元素節點吧:
1 <selectKey 2 <!-- selectKey 語句結果應該被設置的目標屬性。如果希望得到多個生成的列,也可以是逗號分隔的屬性名稱列表。 --> 3 keyProperty="id" 4 <!-- 結果的類型。MyBatis 通常可以推算出來,但是為了更加確定寫上也不會有什麽問題。MyBatis 允許任何簡單類型用作主鍵的類型,包括字符串。如果希望作用於多個生成的列,則可以使用一個包含期望屬性的 Object 或一個 Map。 --> 5 resultType="int" 6 <!-- 這可以被設置為 BEFORE 或 AFTER。如果設置為 BEFORE,那麽它會首先選擇主鍵,設置 keyProperty 然後執行插入語句。如果設置為 AFTER,那麽先執行插入語句,然後是 selectKey 元素 - 這和像 Oracle 的數據庫相似,在插入語句內部可能有嵌入索引調用。 --> 7 order="BEFORE" 8 <!-- 與前面相同,MyBatis 支持 STATEMENT,PREPARED 和 CALLABLE 語句的映射類型,分別代表 PreparedStatement 和 CallableStatement 類型。 --> 9 statementType="PREPARED">
本篇文章主要介紹了insert, update, delete的配置及用法。
下篇文章將介紹復雜的 select相關的配置及用法, 待這些都講完後,會先根據源碼分析一下mybatis的整個運行流程,然後再深入mybatis的用法。
Mybatis 系列7