2.2 select
一個select 元素非常簡單。例如:
- <!-- 查詢學生,根據id -->
- <select id="getStudent" parameterType="String" resultMap="studentResultMap">
- SELECT ST.STUDENT_ID,
- ST.STUDENT_NAME,
- ST.STUDENT_SEX,
- ST.STUDENT_BIRTHDAY,
- ST.CLASS_ID
- FROM STUDENT_TBL ST
- WHERE ST.STUDENT_ID = #{studentID}
- </select>
這條語句就叫做‘getStudent,有一個String參數,並返回一個StudentEntity類型的對象。
注意參數的標識是:#{studentID}。
select 語句屬性配置細節:
屬性 | 描述 | 取值 | 默認 |
id | 在這個模式下唯一的標識符,可被其它語句引用 | ||
parameterType | 傳給此語句的參數的完整類名或別名 | ||
resultType | 語句返回值類型的整類名或別名。注意,如果是集合,那麼這裏填寫的是集合的項的整類名或別名,而不是集合本身的類名。(resultType 與resultMap 不能並用) | ||
resultMap | 引用的外部resultMap 名。結果集映射是MyBatis 中最強大的特性。許多複雜的映射都可以輕鬆解決。(resultType 與resultMap 不能並用) | ||
flushCache | 如果設爲true,則會在每次語句調用的時候就會清空緩存。select 語句默認設爲false | true|false | false |
useCache | 如果設爲true,則語句的結果集將被緩存。select 語句默認設爲false true|false false timeout 設置驅動器在拋出異常前等待迴應的最長時間,默認爲不設值,由驅動器自己決定 |
true|false | false |
timeout | 設置驅動器在拋出異常前等待迴應的最長時間,默認爲不設值,由驅動器自己決定 | 正整數 | 未設置 |
fetchSize | 設置一個值後,驅動器會在結果集數目達到此數值後,激發返回,默認爲不設值,由驅動器自己決定 | 正整數 | 驅動器決定 |
statementType | statement,preparedstatement,callablestatement。 預準備語句、可調用語句 |
STATEMENT PREPARED CALLABLE |
PREPARED |
resultSetType | forward_only,scroll_sensitive,scroll_insensitive 只轉發,滾動敏感,不區分大小寫的滾動 |
FORWARD_ONLY SCROLL_SENSITIVE SCROLL_INSENSITIVE |
驅動器決定 |
2.3 insert
一個簡單的insert語句:
- <!-- 插入學生 -->
- <insert id="insertStudent" parameterType="StudentEntity">
- INSERT INTO STUDENT_TBL (STUDENT_ID,
- STUDENT_NAME,
- STUDENT_SEX,
- STUDENT_BIRTHDAY,
- CLASS_ID)
- VALUES (#{studentID},
- #{studentName},
- #{studentSex},
- #{studentBirthday},
- #{classEntity.classID})
- </insert>
insert可以使用數據庫支持的自動生成主鍵策略,設置useGeneratedKeys=”true”,然後把keyProperty 設成對應的列,就搞定了。比如說上面的StudentEntity 使用auto-generated 爲id 列生成主鍵.
還可以使用selectKey元素。下面例子,使用mysql數據庫nextval('student')爲自定義函數,用來生成一個key。
- <!-- 插入學生 自動主鍵-->
- <insert id="insertStudentAutoKey" parameterType="StudentEntity">
- <selectKey keyProperty="studentID" resultType="String" order="BEFORE">
- select nextval('student')
- </selectKey>
- INSERT INTO STUDENT_TBL (STUDENT_ID,
- STUDENT_NAME,
- STUDENT_SEX,
- STUDENT_BIRTHDAY,
- CLASS_ID)
- VALUES (#{studentID},
- #{studentName},
- #{studentSex},
- #{studentBirthday},
- #{classEntity.classID})
- </insert>
insert語句屬性配置細節:
屬性 | 描述 | 取值 | 默認 |
id | 在這個模式下唯一的標識符,可被其它語句引用 | ||
parameterType | 傳給此語句的參數的完整類名或別名 | ||
flushCache | 如果設爲true,則會在每次語句調用的時候就會清空緩存。select 語句默認設爲false | true|false | false |
useCache | 如果設爲true,則語句的結果集將被緩存。select 語句默認設爲false true|false false timeout 設置驅動器在拋出異常前等待迴應的最長時間,默認爲不設值,由驅動器自己決定 |
true|false | false |
timeout | 設置驅動器在拋出異常前等待迴應的最長時間,默認爲不設值,由驅動器自己決定 | 正整數 | 未設置 |
fetchSize | 設置一個值後,驅動器會在結果集數目達到此數值後,激發返回,默認爲不設值,由驅動器自己決定 | 正整數 | 驅動器決定 |
statementType | statement,preparedstatement,callablestatement。 預準備語句、可調用語句 |
STATEMENT PREPARED CALLABLE |
PREPARED |
useGeneratedKeys |
告訴MyBatis 使用JDBC 的getGeneratedKeys 方法來獲取數據庫自己生成的主鍵(MySQL、SQLSERVER 等 關係型數據庫會有自動生成的字段)。默認:false |
true|false | false |
keyProperty |
標識一個將要被MyBatis 設置進getGeneratedKeys 的key 所返回的值,或者爲insert 語句使用一個selectKey 子元素。 |
selectKey語句屬性配置細節:
屬性 | 描述 | 取值 |
keyProperty | selectKey 語句生成結果需要設置的屬性。 | |
resultType | 生成結果類型,MyBatis 允許使用基本的數據類型,包括String 、int類型。 | |
order | 可以設成BEFORE 或者AFTER,如果設爲BEFORE,那它會先選擇主鍵,然後設置keyProperty,再執行insert語句;如果設爲AFTER,它就先運行insert 語句再運行selectKey 語句,通常是insert 語句中內部調用數據庫(像Oracle)內嵌的序列機制。 | BEFORE AFTER |
statementType | 像上面的那樣, MyBatis 支持STATEMENT,PREPARED和CALLABLE 的語句形式, 對應Statement ,PreparedStatement 和CallableStatement 響應 | STATEMENT PREPARED CALLABLE |
2.4 update、delete
一個簡單的update:
- <!-- 更新學生信息 -->
- <update id="updateStudent" parameterType="StudentEntity">
- UPDATE STUDENT_TBL
- SET STUDENT_TBL.STUDENT_NAME = #{studentName},
- STUDENT_TBL.STUDENT_SEX = #{studentSex},
- STUDENT_TBL.STUDENT_BIRTHDAY = #{studentBirthday},
- STUDENT_TBL.CLASS_ID = #{classEntity.classID}
- WHERE STUDENT_TBL.STUDENT_ID = #{studentID};
- </update>
一個簡單的delete:
- <!-- 刪除學生 -->
- <delete id="deleteStudent" parameterType="StudentEntity">
- DELETE FROM STUDENT_TBL WHERE STUDENT_ID = #{studentID}
- </delete>
update、delete語句屬性配置細節:
屬性 | 描述 | 取值 | 默認 |
id | 在這個模式下唯一的標識符,可被其它語句引用 | ||
parameterType | 傳給此語句的參數的完整類名或別名 | ||
flushCache | 如果設爲true,則會在每次語句調用的時候就會清空緩存。select 語句默認設爲false | true|false | false |
useCache | 如果設爲true,則語句的結果集將被緩存。select 語句默認設爲false true|false false timeout 設置驅動器在拋出異常前等待迴應的最長時間,默認爲不設值,由驅動器自己決定 |
true|false | false |
timeout | 設置驅動器在拋出異常前等待迴應的最長時間,默認爲不設值,由驅動器自己決定 | 正整數 | 未設置 |
fetchSize | 設置一個值後,驅動器會在結果集數目達到此數值後,激發返回,默認爲不設值,由驅動器自己決定 | 正整數 | 驅動器決定 |
statementType | statement,preparedstatement,callablestatement。 預準備語句、可調用語句 |
STATEMENT PREPARED CALLABLE |
PREPARED |
2.5 sql
Sql元素用來定義一個可以複用的SQL 語句段,供其它語句調用。比如:
- <!-- 複用sql語句 查詢student表所有字段 -->
- <sql id="selectStudentAll">
- SELECT ST.STUDENT_ID,
- ST.STUDENT_NAME,
- ST.STUDENT_SEX,
- ST.STUDENT_BIRTHDAY,
- ST.CLASS_ID
- FROM STUDENT_TBL ST
- </sql>
這樣,在select的語句中就可以直接引用使用了,將上面select語句改成:
- <!-- 查詢學生,根據id -->
- <select id="getStudent" parameterType="String" resultMap="studentResultMap">
- <include refid="selectStudentAll"/>
- WHERE ST.STUDENT_ID = #{studentID}
- </select>
2.6parameters
上面很多地方已經用到了參數,比如查詢、修改、刪除的條件,插入,修改的數據等,MyBatis可以使用的基本數據類型和Java的複雜數據類型。
基本數據類型,String,int,date等。
但是使用基本數據類型,只能提供一個參數,所以需要使用Java實體類,或Map類型做參數類型。通過#{}可以直接得到其屬性。
2.6.1基本類型參數
根據入學時間,檢索學生列表:
- <!-- 查詢學生list,根據入學時間 -->
- <select id="getStudentListByDate" parameterType="Date" resultMap="studentResultMap">
- SELECT *
- FROM STUDENT_TBL ST LEFT JOIN CLASS_TBL CT ON ST.CLASS_ID = CT.CLASS_ID
- WHERE CT.CLASS_YEAR = #{classYear};
- </select>
- List<StudentEntity> studentList = studentMapper.getStudentListByClassYear(StringUtil.parse("2007-9-1"));
- for (StudentEntity entityTemp : studentList) {
- System.out.println(entityTemp.toString());
- }
List<StudentEntity> studentList = studentMapper.getStudentListByClassYear(StringUtil.parse("2007-9-1"));
for (StudentEntity entityTemp : studentList) {
System.out.println(entityTemp.toString());
}
2.6.2Java實體類型參數
根據姓名和性別,檢索學生列表。使用實體類做參數:
- <!-- 查詢學生list,like姓名、=性別,參數entity類型 -->
- <select id="getStudentListWhereEntity" parameterType="StudentEntity" resultMap="studentResultMap">
- SELECT * from STUDENT_TBL ST
- WHERE ST.STUDENT_NAME LIKE CONCAT(CONCAT('%', #{studentName}),'%')
- AND ST.STUDENT_SEX = #{studentSex}
- </select>
- StudentEntity entity = new StudentEntity();
- entity.setStudentName("李");
- entity.setStudentSex("男");
- List<StudentEntity> studentList = studentMapper.getStudentListWhereEntity(entity);
- for (StudentEntity entityTemp : studentList) {
- System.out.println(entityTemp.toString());
- }
StudentEntity entity = new StudentEntity();
entity.setStudentName("李");
entity.setStudentSex("男");
List<StudentEntity> studentList = studentMapper.getStudentListWhereEntity(entity);
for (StudentEntity entityTemp : studentList) {
System.out.println(entityTemp.toString());
}
2.6.3Map參數
根據姓名和性別,檢索學生列表。使用Map做參數:
- <!-- 查詢學生list,=性別,參數map類型 -->
- <select id="getStudentListWhereMap" parameterType="Map" resultMap="studentResultMap">
- SELECT * from STUDENT_TBL ST
- WHERE ST.STUDENT_SEX = #{sex}
- AND ST.STUDENT_SEX = #{sex}
- </select>
- Map<String, String> map = new HashMap<String, String>();
- map.put("sex", "女");
- map.put("name", "李");
- List<StudentEntity> studentList = studentMapper.getStudentListWhereMap(map);
- for (StudentEntity entityTemp : studentList) {
- System.out.println(entityTemp.toString());
- }
Map<String, String> map = new HashMap<String, String>();
map.put("sex", "女");
map.put("name", "李");
List<StudentEntity> studentList = studentMapper.getStudentListWhereMap(map);
for (StudentEntity entityTemp : studentList) {
System.out.println(entityTemp.toString());
}
2.6.4多參數的實現
如果想傳入多個參數,則需要在接口的參數上添加@Param註解。給出一個實例:
接口寫法:
- public List<StudentEntity> getStudentListWhereParam(@Param(value = "name") String name, @Param(value = "sex") String sex, @Param(value = "birthday") Date birthdar, @Param(value = "classEntity") ClassEntity classEntity);
public List<StudentEntity> getStudentListWhereParam(@Param(value = "name") String name, @Param(value = "sex") String sex, @Param(value = "birthday") Date birthdar, @Param(value = "classEntity") ClassEntity classEntity);
SQL寫法:
- <!-- 查詢學生list,like姓名、=性別、=生日、=班級,多參數方式 -->
- <select id="getStudentListWhereParam" resultMap="studentResultMap">
- SELECT * from STUDENT_TBL ST
- <where>
- <if test="name!=null and name!='' ">
- ST.STUDENT_NAME LIKE CONCAT(CONCAT('%', #{name}),'%')
- </if>
- <if test="sex!= null and sex!= '' ">
- AND ST.STUDENT_SEX = #{sex}
- </if>
- <if test="birthday!=null">
- AND ST.STUDENT_BIRTHDAY = #{birthday}
- </if>
- <if test="classEntity!=null and classEntity.classID !=null and classEntity.classID!='' ">
- AND ST.CLASS_ID = #{classEntity.classID}
- </if>
- </where>
- </select>
進行查詢:
- List<StudentEntity> studentList = studentMapper.getStudentListWhereParam("", "",StringUtil.parse("1985-05-28"), classMapper.getClassByID("20000002"));
- for (StudentEntity entityTemp : studentList) {
- System.out.println(entityTemp.toString());
- }
List<StudentEntity> studentList = studentMapper.getStudentListWhereParam("", "",StringUtil.parse("1985-05-28"), classMapper.getClassByID("20000002"));
for (StudentEntity entityTemp : studentList) {
System.out.println(entityTemp.toString());
}
2.6.5字符串代入法
默認的情況下,使用#{}語法會促使MyBatis 生成PreparedStatement 屬性並且使用PreparedStatement 的參數(=?)來安全的設置值。儘量這些是快捷安全,也是經常使用的。但有時候你可能想直接未更改的字符串代入到SQL 語句中。比如說,對於ORDER BY,你可能會這樣使用:ORDER BY ${columnName}但MyBatis 不會修改和規避掉這個字符串。
注意:這樣地接收和應用一個用戶輸入到未更改的語句中,是非常不安全的。這會讓用戶能植入破壞代碼,所以,要麼要求字段不要允許客戶輸入,要麼你直接來檢測他的合法性 。
2.7 cache緩存
MyBatis 包含一個強在的、可配置、可定製的緩存機制。MyBatis 3 的緩存實現有了許多改進,既強勁也更容易配置。默認的情況,緩存是沒有開啓,除了會話緩存以外,它可以提高性能,且能解決全局依賴。開啓二級緩存,你只需要在SQL 映射文件中加入簡單的一行:<cache/>
這句簡單的語句的作用如下:
1. 所有在映射文件裏的select 語句都將被緩存。
2. 所有在映射文件裏insert,update 和delete 語句會清空緩存。
3. 緩存使用“最近很少使用”算法來回收
4. 緩存不會被設定的時間所清空。
5. 每個緩存可以存儲1024 個列表或對象的引用(不管查詢出來的結果是什麼)。
6. 緩存將作爲“讀/寫”緩存,意味着獲取的對象不是共享的且對調用者是安全的。不會有其它的調用
7. 者或線程潛在修改。
例如,創建一個FIFO 緩存讓60 秒就清空一次,存儲512 個對象結果或列表引用,並且返回的結果是隻讀。因爲在不用的線程裏的兩個調用者修改它們可能會導致引用衝突。
- <cache eviction="FIFO" flushInterval="60000" size="512" readOnly="true">
- </cache>
還可以在不同的命名空間裏共享同一個緩存配置或者實例。在這種情況下,你就可以使用cache-ref 來引用另外一個緩存。
- <cache-ref namespace="com.liming.manager.data.StudentMapper"/>
Cache 語句屬性配置細節:
屬性 | 說明 | 取值 | 默認值 |
eviction | 緩存策略: LRU - 最近最少使用法:移出最近較長週期內都沒有被使用的對象。 FIFI- 先進先出:移出隊列裏較早的對象 SOFT - 軟引用:基於軟引用規則,使用垃圾回收機制來移出對象 WEAK - 弱引用:基於弱引用規則,使用垃圾回收機制來強制性地移出對象 |
LRU FIFI SOFT WEAK |
LRU |
flushInterval | 代表一個合理的毫秒總計時間。默認是不設置,因此使用無間隔清空即只能調用語句來清空。 | 正整數 |
不設置 |
size | 緩存的對象的大小 | 正整數 | 1024 |
readOnly |
只讀緩存將對所有調用者返回同一個實例。因此都不能被修改,這可以極大的提高性能。可寫的緩存將通過序列 化來返回一個緩存對象的拷貝。這會比較慢,但是比較安全。所以默認值是false。 |
true|false | false |
原文 http://limingnihao.iteye.com/blog/781911