iBatis對映檔案詳解(一)

阿新 • • 發佈：2019-01-14

以下是iBatis對映檔案的一個簡單例子：

<?xml version="1.0"encoding="UTF-8" ?>

<!DOCTYPE sqlMap

PUBLIC "-//ibatis.apache.org//DTD SQL Map 2.0//EN"

"http://ibatis.apache.org/dtd/sql-map-2.dtd">

<cacheModelid=”productCache” type=”LRU”>

</cacheModel>

<resultproperty="sid" column="sid"/>

<resultproperty="sname" column="sname"/>

<resultproperty="major" column="major"/>

<resultproperty="birth" column="birth"/>

<resultproperty="sroce" column="sroce"/>

</resultMap>

<parameterproperty="sid" jdbcType="int" javaType="int"/>

<parameterproperty="sname" jdbcType="varchar"javaType="String"/>

</parameterMap>

select

sid,sname,major,birth,score

from

student;

</select>

select

sid,sname,major,birth,score

from

student

where

sid= #sid#;

</select>

insert into

student(sid,sname,major,birth,score)

values(#sid#,#sname#,#major#,#birth#,#score#);

</insert>

delete from

student

where

sid= #sid#;

</delete>

update student set

sname= #sname#,

major= #major#,

birth= #birth#,

score= #score#

wheresid = #sid#;

</update>

select

sid,sname,major,birth,score

from

student

where

snamelike '%$sname$%';

</select>

insert into

student(sname,major,birth,score)

values(#sname#,#major#,#birth#,#score#);

<!—Mysql中用到的-->

SELECT @@IDENTITY AS SID

</selectKey>

<!--以下在Oracle中用到

select studentPKSequence.nextVal as sid from dual;

</selectKey>

-->

</insert>

</sqlMap>

在這個例子中，xml的DTD和SqlMapConfig.xml配置檔案的不一樣要注意，不然會報錯。例子中包括了cacheModel、typeAlias、resultMap、parameterMap、以及增刪改，查詢全部、根據id查詢和模糊查詢。其中增刪改查都屬於statement元素，下表總結了statement 型別及其屬性：

Statement 型別	屬性
<statement>	id parameterClass resultClass parameterMap resultMap cacheModel xmlResultName
<insert>	id parameterClass parameterMap
<update>	id parameterClass parameterMap
<delete>	id parameterClass parameterMap
<select>	id parameterClass resultClass parameterMap resultMap cacheModel
<procedure>	id parameterClass resultClass parameterMap resultMap xmlResultName

SQL 語句

在statement元素中可以寫所有JDBC Driver所支援的sql語句。但是由於sql語句是鑲嵌在xml文件中，所以有些特殊符號不能直接使用，例如：<、>。iBatis這裡給出瞭解決辦法。

<![CDATA[

select * from student score >#score#

]]>

自動生成的主鍵

iBatis中唯一使用了自動生成主鍵的就是<insert>元素，使用子元素<selectKey>來支援自動生成的主鍵。它同時支援預生成（如Oracle）和後生成（MySQL）。下面是兩個例子：

<!—OracleSEQUENCE Example -->

<insertid="insertStudent-ORACLE" parameterClass="com.edifier.Student">

SELECT STOCKIDSEQUENCE.NEXTVAL ASID FROM DUAL

</selectKey>

insert into Student (SID,SName)

values (#id#,#name#)

</insert>

<!—Microsoft SQL Server IDENTITY Column Example -->

insert into Student ( SName)

values (#name #)

SELECT @@IDENTITY AS ID

</selectKey>

</insert>

儲存過程

通過<procedure>元素支援儲存過程。下面的例子說明如何使用具有輸出引數的儲存過程。

<parameterMapid="swapParameters" class="map" >

</parameterMap>

<procedureid="swapEmailAddresses" parameterMap="swapParameters" >

{call swap_email_address (?, ?)}

</procedure>

呼叫上面的儲存過程將同時互換兩個欄位（資料庫表）和引數物件（Map）中的兩個 email地址。如果引數的 mode 屬性設為 INOUT 或 OUT，則引數物件的值被修改。否則保持不變。

parameterClass

parameterClass 屬性的值是 Java 類的全限定名（即包括類的包名）。parameterClass 屬性是可選的，但強烈建議使用。它的目的是限制輸入引數的型別為指定的 Java 類，並優化框架的效能。如果您使用 parameterMap，則沒有必要使用 parameterClass 屬性。例如，如果要只允許 Java 類“com. edifier.Student”作為輸入引數，可以這樣作：

<statementid=”statementName” parameterClass=” com. edifier.Student”>

insert into PRODUCT values (#id#, #name#, #score#)

</statement>

parameterMap

屬性 parameterMap 的值等於一個預先定義的<parameterMap>元素的名稱。parameterMap屬性很少使用，更多的是使用上面的 parameterClass 和 inline parameter（接下來會討論）。parameterMap 的基本思想是定義一系列有次序的引數系列，用於匹配 JDBC PreparedStatement的值符號。例如：

<parameterMapid=”insert-student -param” class=”com. edifier. Student”>

</parameterMap>

<statementid=”insertStudent” parameterMap=”insert- student -param”>

insert into Student (SID, SNAME) values(?,?);

</statement>

上面的例子中，parameter map 的兩個引數按次序匹配 SQL 語句中的值符號（?）。因此，第一個“?”號將被“id”屬性的值替換，而第二個“?”號將被“name”屬性的值替換。

Inline Parameter簡介

現在簡單介紹一下 inline parameter，詳細討論見後面章節。Inline parameter 可以嵌在

mappedstatement 內部使用。例如：

<statementid=”insertStudent” >

insert into Student(SID, SNAME)

values (#id#, #name#);

</statement>

以上例子中，內嵌的引數是#id#和#name#。每個引數代表一個 Java Bean 屬性，用於給 SQL 語句中相應的位置賦值。上面例子中，Student 物件的 id 和 description 屬性的值將會替換 SQL 語句中相應的符號。因此，對於 id=5，name=‘Steven’的Student 物件，SQL語句變為：

insert into Student (SID, SNAME) values (5, ‘Steven’);

resultClass

resultClass 屬性的值是 Java 類的全限定名（即包括類的包名）。resultClass 屬性可以讓您指定一個 Java 類，根據 ResultSetMetaData 將其自動對映到 JDBC 的 ResultSet。只要是 JavaBean 的屬性名稱和 ResultSet 的列名匹配，屬性自動賦值給列值。這使得查詢 mappedstatement變得很短。例如：

<statementid="getPerson" parameterClass=”int” resultClass="com.edifier.Person">

SELECT PER_ID as id,

PER_FIRST_NAME as firstName,

PER_LAST_NAME as lastName,

PER_BIRTH_DATE as birthDate,

PER_WEIGHT_KG as weightInKilograms,

PER_HEIGHT_M as heightInMeters

FROM PERSON

WHERE PER_ID = #value#

</statement>

在上面的例子中，Person 類擁有屬性包括 id，firstName，lastName，birthDate，weightInKilograms和 heightInMeters。每一個屬性對應 SQL 查詢語句一個列的別名（使用“as”關鍵字－標準的 SQL 語法）。一般情況下，列名和屬性名稱不匹配，就需要使用“as”關鍵字。當執行 mapped statement 時，Person 類將被初始化，從結果集中得到的列值將根據屬性名和列名對映成 Person 物件的屬性值。正如以前所說，使用 resultClass 的自動對映存在一些限制，無法指定輸出欄位的資料型別（如果需要的話），無法自動裝入相關的資料（複雜屬性），並且因為需要 ResultSetMetaData的資訊，會對效能有輕微的不利影響。但使用 resultMap，這些限制都可以很容易解決。

resultMap

resultMap 是最常用和最重要的屬性。ResultMap 屬性的值等於預先定義的 resultMap 元素的 name 屬性值（參照下面的例子）。使用 resultMap 可以控制資料如何從結果集中取出，以及哪一個屬性匹配哪一個欄位。不象使用 resultClass 的自動對映方法，resultMap 屬性可以允許指定欄位的資料型別，NULL 的替代值複雜型別對映（包括其他 Java Bean，集合型別和基本型別包裝類）。關於 resultMap 的詳細討論放在以後的章節，這裡只給出一個相關 statement 的 resultMap的例子。

<resultMapid=”get-student-result” class=”com.edifier.Student”>

</resultMap>

<statementid=”getStudent” resultMap=”get- student -result”>

select * from Student

</statement>

上面的例子中，通過 resultMap 的定義，查詢語句得到的 ResultSet 被對映成Student物件。resultMap 定義的“id”屬性值將賦予“SID”欄位值，而“name”屬性值將賦予“SNAME”欄位值。注意 resultMap 支援“select *”，並不要求定義 ResultSet所有返回欄位的對映。

cacheModel

cacheModel 的屬性值等於指定的 cacheModel 元素的 name 屬性值。屬性 cacheModel 定義查詢 mapped statement 的快取。每一個查詢 mapped statement 可以使用不同或相同的cacheModel。以下只給出個例子。

<cacheModelid="student-cache" imlementation="LRU">

</cacheModel>

<statementid=”selectAllStudent” parameterClass=”int” cacheModel=”product-cache”>

select sid,sname,major,birth,score from student;

</statement>

上面例子中，“selectAllStudent”的快取使用 WEAK 引用型別，每 24 小時重新整理一次，或當更新的操作發生時重新整理。

Cache的型別有以下幾種：

“MEMORY”(com.ibatis.db.sqlmap.cache.memory.MemoryCacheController)

“LRU”(com.ibatis.db.sqlmap.cache.lru.LruCacheController) --Least Recently Used

“FIFO”(com.ibatis.db.sqlmap.cache.fifo.FifoCacheController) --First In First Out

“OSCACHE”(com.ibatis.db.sqlmap.cache.oscache.OSCacheController)

1.MEMORY 編碼結構：

</cacheModel>

取不到物件再利用的identifiable pattern或者應用程式的記憶體不足的時候選用。

reference-type的值可以是下面的3個：

WEAK (default)	當別的物件要用記憶體的時候，可以毫無保留的釋放自己的記憶體。
SOFT	當別的物件需要記憶體的時候，有可能不會釋放自己的記憶體。
STRONG	cache時間到達以前，肯定不會釋放記憶體。小的靜態的經常被使用的區域可以使用這個選項。缺點是如果記憶體不足也不會釋放記憶體。

2.LRU 編碼結構：

</cacheModel>

應用程式的一部分內容經常被多人多次使用的時候選用。

3.FIFO 編碼結構：

</cacheModel>

連續的短時間的參照，以後就再不參照的時候選用。

4.OSCACHE 編碼結構：

</cacheModel>

屬性名	說明
cache.memory	cache放在記憶體中，false的話放在硬盤裡
cache.key	ServletContext中存放cache的key名
cache.capacity	存放的大小（這個一直不知道單位是什麼，配置檔案裡寫的是條數，我怎麼感覺設成50都能顯示1000個）
cache.path	cache儲存的路徑
cache.unlimited.disk	無限cache，預設是false，這時候就會有限制，參照cache.capacity來分配硬碟空間

iBatis對映檔案詳解(一)

iBatis對映檔案詳解(一)

Hibernate 初相識（一）Hibernate API 詳解，配置檔案，對映檔案詳解。

Mybatis學習（三）————— 對映檔案詳解

jni.h標頭檔案詳解(一)

mybatis全域性配置檔案與對映檔案詳解

Mybatis學習筆記（二）-Mybatis配置檔案與對映檔案詳解

hibernate與資料庫表的對映檔案詳解（Customer.hbm.xml）

4.mapper.xml對映檔案詳解

MyBatis XML對映檔案詳解

SpringBoot第二篇：配置檔案詳解一

【Ibatis】（一）、sqlMapConfig.xml配置檔案詳解

三大框架（ssh）學習——配置檔案詳解（一)

Hibernate---實體配置（對映）檔案詳解例如：User.hbm.xml檔案

華為PAT埠地址對映配置詳解（一）

【SpringBoot學習之路】05.Springboot配置檔案詳解（一）

Hibernate---實體配置（對映）檔案詳解例如：User.hbm.xml檔案

AccessibilityService 服務配置檔案的內容詳解(一)

NTFS檔案系統詳解(一)之硬碟基本資訊

Hibernate之對映檔案和主配置檔案詳解

表空間資料檔案詳解（一）

iBatis對映檔案詳解(一)

相關推薦