Ibatis学习随笔
2007-10-29 13:21
295 查看
Ibatis学习随笔
< person >
< id > 1 </ id >
< firstName > Clinton </ firstName >
< lastName > Begin </ lastName >
< birthDate > 1900-01-01 </ birthDate >
< weightInKilograms > 89 </ weightInKilograms >
< heightInMeters > 1.77 </ heightInMeters >
</ person >
一、SQL MAP Statement
一个简单的sql map statement。它通过最简单的方式实现了对数据库的添加、删除、修改。
<? xml version="1.0" encoding="UTF-8" ?>
<! DOCTYPE sqlMap PUBLIC "-//iBATIS.com//DTD SQL Map 2.0//EN" "http://www.ibatis.com/dtd/sql-map-2.dtd" >
< sqlMap namespace ="Tuser" >
< typeAlias alias ="tuser" type ="com.ibatis.pojo.TuserPO" />
< select id ="getTuser" resultClass ="tuser" >
<![CDATA[
select id,vname from tuser where id=#value#
]]>
</ select >
< insert id ="insrtTuser" parameterClass ="tuser" >
<![CDATA[
insert into tuser values(#id#,#vname#)
]]>
</ insert >
< update id ="updateTuser" parameterClass ="tuser" >
<![CDATA[
update tuser set id=#id# ,vname=#vname# where id=#id#
]]>
</ update >
< delete id ="deleteTuser" >
<![CDATA[
delete from tuser where id=#id#
]]>
</ delete >
</ sqlMap >
再看下面这个较复杂点的SQL Map Statement
< sqlMap id =”Product”>
<cacheModel id =”productCache” type =”LRU”>
<flushInterval hours =”24”/>
<property name =”size” value =”1000” />
</ cacheModel >
< typeAlias alias =”product” type =”com.ibatis.example.Product” />
< parameterMap id =”productParam” class =”product”>
<parameter property =”id”/>
</parameterMap >
< resultMap id =”productResult” class =”product”>
<result property =”id” column =”PRD_ID”/>
<result property =”description” column =”PRD_DESCRIPTION”/>
</resultMap >
< select id =”getProduct” parameterMap =”productParam” resultMap =”productResu t” cacheModel =”product-cache”>
select * from PRODUCT where PRD_ID = ?
</select >
</ sqlMap >
对比两个不同的定义文件，第二个的定义比较麻烦，但运行效率却比第一个要高。因为第一个定义文件使用了Ibatis框架的自动映射特性。
在一个Sql map XML映射击文件可以包含多个Mapped Statement ,Parameter Map和ResultMap，但它们的名称在该SQL Map XML文件中必须是唯一的
Mapped Statements
SQL Map的核心概念是Mapped Statement。Mapped Statement可以使用任意的SQL语句，并拥有parameter map（输入）和result map（输出）。如果是简单情况，Mapped Statement可以使用Java类来作为parameter和result。Mapped Statement也可以使用缓存模型，在内存中缓存常用的数据。Mapped Statement的结构如下所示：
<statement id=”statementName”
[parameterClass=”some.class.Name”]
[resultClass=”some.class.Name”]
[parameterMap=”nameOfParameterMap”]
[resultMap=”nameOfResultMap”]
[cacheModel=”nameOfCache”] >
select * from PRODUCT where PRD_ID = [?|#propertyName#] order by
[$simpleDynamic$]
</statement>
在上面的表达式中，括号[]里的部分时可选的属性，并且在某些情况下只有特定的组合才是合法的。因此下面这个简单的例子也是正确的：
<statement id=”insertTestProduct” >
insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (1, “Shih Tzu”)
</statement>
上面的例子不太可能出现，但如果只是简单地想用SQL Map架构来执行任意地的SQL语句，这种写法就派上用场了。但常见的用法还是通过Parameter Map和Result Map，来实现Java Bean映射的特性，这是SQL Map真正有价值的地方。
Statements类型
<statement>元素是个通用声明，可以用于任何类型的SQL语句。通常，使用具体的statement类型是个好主意。具体statement类型提供了更直观的XML DTD，并拥有某些
二、SQL语句
SQL语句在mapped statement 中最重要的部份，可以使用符合数据库或JDBC的任意SQL语句，对于语句有特殊途同归符号的，可以把SQL语句写在<![ ]]>里面。如
< statement id ="getPersonsByAge" parameterClass =”int” resultClass ="examples.domain.Person" >
<![CDATA[
SELECT * FROM PERSON WHERE AGE > #value#
]]>
</ statement >
自动生成的主键
很多数据库支持自动生成主键的数据类型。不过这通常（并不总是）是个私有的特性。SQL Map通过<insert>的子元素<selectKey>来支持自动生成的键值。它同时支持预生成（如Oracle）和后生成两种类型（如MS-SQL Server）。下面是两个例子：
< insert id ="insertProduct-ORACLE" parameterClass ="com.domain.Product" >
< selectKey resultClass ="int" keyProperty ="id" >
SELECT STOCKIDSEQUENCE.NEXTVAL AS ID FROM DUAL </ selectKey >
insert into PRODUCT (PRD_ID,PRD_DESCRIPTION) values (#id#,#description#)
</ insert >
<! — Microsoft SQL Server IDENTITY Column Example -- >
< insert id ="insertProduct-MS-SQL" parameterClass ="com.domain.Product" >
insert into PRODUCT (PRD_DESCRIPTION) values (#description#)
< selectKey resultClass ="int" keyProperty ="id" >
SELECT @@IDENTITY AS ID
</ selectKey >
</ insert >
存储过程
SQL Map通过<procedure>元素支持存储过程。下面的例子说明如何使用具有输出参数的存储过程。
< parameterMap id ="swapParameters" class ="map" >
< parameter
property ="email1" jdbcType ="VARCHAR" javaType ="java.lang.String" mode ="INOUT" />
< parameter
property ="email2" jdbcType ="VARCHAR" javaType ="java.lang.String" mode ="INOUT" />
</ parameterMap >
< procedure id ="swapEmailAddresses" parameterMap ="swapParameters" >
{call swap_email_address (?, ?)}
</ procedure >
支持标准的JDBC格式调用存储过程方法。如果存储过程回的是游标那又怎么定义的。
parameterClass
parameterClass属性的值是Java类的全限定名（即包括类的包名）。parameterClass属性是可选的，但强烈建议使用。它的目的是限制输入参数的类型为指定的Java类，并优化框架的性能。如果您使用parameterMap，则没有必要使用parameterClass属性。例如，如果要只允许Java类“examples.domain.Product”作为输入参数，可以这样作：
< statement id =”statementName” parameterClass =” examples.domain.Product” > insert into PRODUCT values (#id#, #description#, #price#)
</ statement >
parameterMap
属性parameterMap的值等于一个预先定义的<parameterMap>元素的名称。parameterMap属性很少使用，更多的是使用上面的parameterClass和inline parameter（接下来会讨论）。 注意！动态mapped statement只支持inline parameter，不支持parameter map。 parameterMap的基本思想是定义一系列有次序的参数系列，用于匹配JDBC PreparedStatement的值符号。例如：
< parameterMap id =”insert-product-param” class =”com.domain.Product”>
<parameter property =”id”/>
<parameter property =”description”/>
</parameterMap >
< statement id =”insertProduct” parameterMap =”insert-product-param”> insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (?,?);
</statement >
如上所述，parameterMap负责将Java Bean的属性映射成statement的参数。
虽然parameterMap的外部形式很少使用，理解它如何工作对于理解inline parameter还是很有帮助。本节以下部分将详细讨论inline parameter。 <parameterMap id=”parameterMapName” [class=”com.domain.Product”]> <parameter property =”propertyName” [jdbcType=”VARCHAR”] [javaType=”string”] [nullValue=”NUMERIC”] [null=”-9999999”]/> <parameter …… />
<parameter …… />
</parameterMap>
括号[]是可选的属性。parameterMap元素只要求属性id作为唯一标识。属性class是可选的但强烈推荐使用。和parameterClass类似，class属性可以框架检查输入参数的类型并优化性能。
一个<parameterMap>的例子
< parameterMap id =”insert-product-param” class =”com.domain.Product”>
<parameter property =”id” jdbcType =”NUMERIC” javaType =”int” nullValue =”-9999999”/>
<parameter property =”description” jdbcType =”VARCHAR” nullValue =”NO_ENTRY”/>
</parameterMap >
< statement id =”insertProduct” parameterMap =”insert-product-param”>
insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (?,?);
</statement >
注意！
parameterMap并不自动地绑定到特定的Java类。因此在上面的例子中，任何拥有“id”和“description”属性的Java Bean对象，都可以作为parameterMap的输入。如果需要将输入绑定到特定的Java类，可以使用mapped-statement的resultClass属性。
注意！
Parameter Map的名称（name）局部的，只在定义它的SQL Map XML文件中有效。不过，加上SQL Map的名称（即在<sqlMap>根元素中的名称）作为前缀，您可以在另一个SQL Map XML文件中引用它。例如，要在另一个文件中引用以上的parameterMap，可以使用名称“Product.insert-product-param”。
Inline Parameter简介
parameterMap的语法虽然简单，但很繁琐。还有一种更受欢迎更灵活的方法，可以大大简化定义和减少代码量。这种方法把Java Bean的属性名称嵌在Mapped Statement的定义中（即直接写在SQL语句中）。缺省情况下，任何没有指定parameterMap的Mapped Statement都会被解析成inline parameter（内嵌参数）。用上面的例子（即Product）来说，就是：
< statement id =”insertProduct” parameterClass =”com.domain.Product”>
insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (#id#, #description#);
</statement >
在内嵌参数中指定数据类型可以用下面的语法：
< statement id =”insertProduct” parameterClass =”com.domain.Product”>
insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (#id:NUMERIC#, #description:VARCHAR#);
</statement >
在内嵌参数中指定数据类型和NULL的替代值可以用这样的语法：
<statement id=”insertProduct” parameterClass=”com.domain.Product”>
insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (#id:NUMERIC:-999999#, #description:VARCHAR:NO_ENTRY#);
</statement>
注意！在内嵌参数中，要指定NULL的替代值，必须要先指定数据类型。 注意！如需要在查询时也使用NULL替代值，必须同时在resultMap中定义（如下说明）。
注意！如果您需要指定很多的数据类型和NULL替代值，可以使用外部的parameterMap
resultClass
resultClass属性的值是Java类的全限定名（即包括类的包名）。resultClass属性可以让您指定一个Java类，根据ResultSetMetaData将其自动映射到JDBC的ResultSet。只要是Java Bean的属性名称和ResultSet的列名匹配，属性自动赋值给列值。这使得查询mapped statement变得很短。例如：
< statement id ="getPerson" parameterClass =”int” resultClass ="examples.domain.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 >
resultMap
resultMap是最常用和最重要的属性。ResultMap属性的值等于预先定义的resultMap元素的name属性值（参照下面的例子）。使用resultMap可以控制数据如何从结果集中取出，以及哪一个属性匹配哪一个字段。不象使用resultClass的自动映射方法，resultMap属性可以允许指定字段的数据类型，NULL的替代值复杂类型映射（包括其他Java Bean，集合类型和基本类型包装类）。
< resultMap id =”get-product-result” class =”com.ibatis.example.Product”>
<result property =”id” column =”PRD_ID”/>
<result property =”description” column =”PRD_DESCRIPTION”/>
</resultMap >
< statement id =”getProduct” resultMap =”get-product-result”>
select * from PRODUCT
</statement >
xmlResultName
当直接把查询结果映射成XML document时，属性xmlResultName的值等于XML document根元素的名称。例如：
< select id ="getPerson" parameterClass =”int” resultClass ="xml" xmlResultName =”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#
</select >
上面的查询结果将产生一个XML document，结构如下：
< person >
< id > 1 </ id >
< firstName > Clinton </ firstName >
< lastName > Begin </ lastName >
< birthDate > 1900-01-01 </ birthDate >
< weightInKilograms > 89 </ weightInKilograms >
< heightInMeters > 1.77 </ heightInMeters >
</ person >
基本类型输入参数
很简单就是使用JAVA基础类型来做为参数了。
< statement id =”insertProduct” parameter =”java.lang.Integer”>
select * from PRODUCT where PRD_ID = #value# </statement >
Map类型输入参数
< statement id =”insertProduct” parameterClass =”java.util.Map”>
select * from PRODUCT where PRD_CAT_ID = #catId# and PRD_CODE = #code#
</statement >
可以注意到mapped statement的形式完全没有区别！上面的例子中，如果把Map对象作为输入参数去调用mapped statement，Map对象必须包含键值“catId”和“code”。键值引用的对象必须是合适的类型，以上面的例子来说，必须是Integer和String。Result Map（参见以下章节）也支持使用Map类型作为结果参数。要获得更多信息，请参见“Result Map”和“使用SQL Map API编程”部分。 Map类型也可以使用别名。例如，可以用“map”来代替“java.util.Map”。这些别名参见下面的“支持Parameter Map和Result Map的数据类型”表格。
三、动态 MAP Statement
作用是动态构建SQL语句，根据不同的一元或二元运算条件构建复杂的SQL语句，这功能非常好，这样就可以把写的BO层的SQL语句构造移值到SQL MAP 文件里。这里例举一些例子：
< select id ="dynamicGetAccountList" cacheModel ="account-cache" resultMap ="account-result" >
select * from ACCOUNT
< isGreaterThan prepend ="and" property ="id" compareValue ="0" >
where ACC_ID = #id#
</ isGreaterThan >
order by ACC_LAST_NAME
</ select > 上面语句中可以根据参数id的不同值能构造出两条SQL查询语句，下面是一个比较复杂的例子：
<statement id="dynamicGetAccountList" resultMap="account-result" >
select * from ACCOUNT
<dynamic prepend="WHERE">
<isNotNull prepend="AND" property="firstName">
(ACC_FIRST_NAME = #firstName#
<isNotNull prepend="OR" property="lastName">
ACC_LAST_NAME = #lastName#
</isNotNull>
)
</isNotNull>
<isNotNull prepend="AND" property="emailAddress">
ACC_EMAIL like #emailAddress#
</isNotNull>
<isGreaterThan prepend="AND" property="id" compareValue="0">
ACC_ID = #id#
</isGreaterThan>
</dynamic>
order by ACC_LAST_NAME
</statement>
上面的例子中，<dynamic>元素划分出SQL语句的动态部分。动态部分可以包含任意多的条件标签元素，条件标签决定是否在语句中包含其中的SQL代码。所有的条件标签元素将根据传给动态查询Statement的参数对象的情况来工作。<dynamic>元素和条件元素都有“prepend”属性，它是动态SQL代码的一部分，在必要情况下，可以被父元素的“prepend”属性覆盖。上面的例子中，prepend属性“where”将覆盖第一个为“真”的条件元素。这对于确保生成正确的SQL语句是有必要的。例如，在第一个为“真”的条件元素中，“AND”是不需要的，事实上，加上它肯定会出错。以下小节讨论不同的条件元素，包括二元条件元素，一元条件元素和其他动态元素。
二元条件元素
二元条件元素将一个属性值和一个静态值或另一个属性值比较，如果条件为“真”，元素体的内容将被包括在查询SQL语句中。
二元条件元素的属性：
prepend － 可被覆盖的SQL语句组成部分，添加在语句的前面（可选）property － 被比较的属性（必选）
compareProperty － 另一个用于和前者比较的属性（必选或选择compareValue）
compareValue － 用于比较的值（必选或选择compareProperty）
二元条件元系的属性
一元条件元素
一元条件元素检查属性的状态是否符合特定的条件。
一元条件元素的属性：
prepend － 可被覆盖的SQL语句组成部分，添加在语句的前面（可选）
property － 被比较的属性（必选）
还有两个其它的条件元素，<isParameterPresent>，<iterate>就不说了，用到的时候可以再查。
简单的动态SQL元素
虽然动态Mapped Statement API功能强大，但有时仅需要一小部分的动态SQL即可。为此，SQL statement和statement都可以包含简单的动态SQL元素，以帮助实现动态的order by子句，动态的查询字段或SQL语句的其他动态部分。简单动态SQL元素的概念有点象inline parameter的映射，但使用了稍微不同的语法。考虑下面的例子：
<statement id=”getProduct” resultMap=”get-product-result”>
select * from PRODUCT order by $preferredOrder$
</statement>
简单动态元素可以包含在<dynamic-mapped-statement>中，当要修改SQL语句本身时它能派上用场。例如：
<statement id=”getProduct” resultMap=”get-product-result”>
SELECT * FROM PRODUCT
<dynamic prepend=”WHERE”>
<isNotEmpty property=”description”>
PRD_DESCRIPTION $operator$ #description# </isNotEmpty>
</dynamic>
</statement>
三、使用SQL Map API编程
那那10来个方法吧，有空看看
< person >
< id > 1 </ id >
< firstName > Clinton </ firstName >
< lastName > Begin </ lastName >
< birthDate > 1900-01-01 </ birthDate >
< weightInKilograms > 89 </ weightInKilograms >
< heightInMeters > 1.77 </ heightInMeters >
</ person >
一、SQL MAP Statement
一个简单的sql map statement。它通过最简单的方式实现了对数据库的添加、删除、修改。
<? xml version="1.0" encoding="UTF-8" ?>
<! DOCTYPE sqlMap PUBLIC "-//iBATIS.com//DTD SQL Map 2.0//EN" "http://www.ibatis.com/dtd/sql-map-2.dtd" >
< sqlMap namespace ="Tuser" >
< typeAlias alias ="tuser" type ="com.ibatis.pojo.TuserPO" />
< select id ="getTuser" resultClass ="tuser" >
<![CDATA[
select id,vname from tuser where id=#value#
]]>
</ select >
< insert id ="insrtTuser" parameterClass ="tuser" >
<![CDATA[
insert into tuser values(#id#,#vname#)
]]>
</ insert >
< update id ="updateTuser" parameterClass ="tuser" >
<![CDATA[
update tuser set id=#id# ,vname=#vname# where id=#id#
]]>
</ update >
< delete id ="deleteTuser" >
<![CDATA[
delete from tuser where id=#id#
]]>
</ delete >
</ sqlMap >
再看下面这个较复杂点的SQL Map Statement
< sqlMap id =”Product”>
<cacheModel id =”productCache” type =”LRU”>
<flushInterval hours =”24”/>
<property name =”size” value =”1000” />
</ cacheModel >
< typeAlias alias =”product” type =”com.ibatis.example.Product” />
< parameterMap id =”productParam” class =”product”>
<parameter property =”id”/>
</parameterMap >
< resultMap id =”productResult” class =”product”>
<result property =”id” column =”PRD_ID”/>
<result property =”description” column =”PRD_DESCRIPTION”/>
</resultMap >
< select id =”getProduct” parameterMap =”productParam” resultMap =”productResu t” cacheModel =”product-cache”>
select * from PRODUCT where PRD_ID = ?
</select >
</ sqlMap >
对比两个不同的定义文件，第二个的定义比较麻烦，但运行效率却比第一个要高。因为第一个定义文件使用了Ibatis框架的自动映射特性。
在一个Sql map XML映射击文件可以包含多个Mapped Statement ,Parameter Map和ResultMap，但它们的名称在该SQL Map XML文件中必须是唯一的
Mapped Statements
SQL Map的核心概念是Mapped Statement。Mapped Statement可以使用任意的SQL语句，并拥有parameter map（输入）和result map（输出）。如果是简单情况，Mapped Statement可以使用Java类来作为parameter和result。Mapped Statement也可以使用缓存模型，在内存中缓存常用的数据。Mapped Statement的结构如下所示：
<statement id=”statementName”
[parameterClass=”some.class.Name”]
[resultClass=”some.class.Name”]
[parameterMap=”nameOfParameterMap”]
[resultMap=”nameOfResultMap”]
[cacheModel=”nameOfCache”] >
select * from PRODUCT where PRD_ID = [?|#propertyName#] order by
[$simpleDynamic$]
</statement>
在上面的表达式中，括号[]里的部分时可选的属性，并且在某些情况下只有特定的组合才是合法的。因此下面这个简单的例子也是正确的：
<statement id=”insertTestProduct” >
insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (1, “Shih Tzu”)
</statement>
上面的例子不太可能出现，但如果只是简单地想用SQL Map架构来执行任意地的SQL语句，这种写法就派上用场了。但常见的用法还是通过Parameter Map和Result Map，来实现Java Bean映射的特性，这是SQL Map真正有价值的地方。
Statements类型
<statement>元素是个通用声明，可以用于任何类型的SQL语句。通常，使用具体的statement类型是个好主意。具体statement类型提供了更直观的XML DTD，并拥有某些
| [align=left]Statement 类型 [/b][/b][/align] | [align=left]属性 [/b][/b][/align] | [align=left]子元素 [/b][/b][/align] | [align=left]方法 [/b][/align] |
| [align=left]<statement> [/align] | [align=left]id parameterClass resultClass parameterMap resultMap cacheModel xmlResultName [/align] | [align=left]所有的动态元素 [/align] | [align=left]insert update delete 所有的查询方法 [/align] |
| [align=left]<insert> [/align] | [align=left]id parameterClass parameterMap [/align] | [align=left]所有的动态元素 <selectKey> [/align] | [align=left]insert [/align] [align=left]update [/align] [align=left] delete [/align] |
| [align=left]<update> [/align] | [align=left]id [/align] [align=left]parameterClass parameterMap [/align] | [align=left]所有的动态元素 [/align] | [align=left]Insert [/align] [align=left]Update [/align] [align=left]delete [/align] |
| [align=left]<delete> [/align] | [align=left]id parameterClass resultClass parameterMap resultMap cacheModel [/align] | [align=left]所有的动态元素 [/align] | [align=left]所有的查询方法 [/align] |
| [align=left]<select> [/align] | [align=left]id parameterClass resultClass parameterMap resultMap cacheModel [/align] | [align=left]所有的动态元素 [/align] | [align=left]所有的查询方法 [/align] |
| [align=left]<procedure> [/align] | [align=left]id parameterClass resultClass parameterMap resultMap xmlResultName [/align] | [align=left]所有的动态元素 [/align] | [align=left]insert update delete 所有的查询方法 [/align] |
SQL语句在mapped statement 中最重要的部份，可以使用符合数据库或JDBC的任意SQL语句，对于语句有特殊途同归符号的，可以把SQL语句写在<![ ]]>里面。如
< statement id ="getPersonsByAge" parameterClass =”int” resultClass ="examples.domain.Person" >
<![CDATA[
SELECT * FROM PERSON WHERE AGE > #value#
]]>
</ statement >
自动生成的主键
很多数据库支持自动生成主键的数据类型。不过这通常（并不总是）是个私有的特性。SQL Map通过<insert>的子元素<selectKey>来支持自动生成的键值。它同时支持预生成（如Oracle）和后生成两种类型（如MS-SQL Server）。下面是两个例子：
< insert id ="insertProduct-ORACLE" parameterClass ="com.domain.Product" >
< selectKey resultClass ="int" keyProperty ="id" >
SELECT STOCKIDSEQUENCE.NEXTVAL AS ID FROM DUAL </ selectKey >
insert into PRODUCT (PRD_ID,PRD_DESCRIPTION) values (#id#,#description#)
</ insert >
<! — Microsoft SQL Server IDENTITY Column Example -- >
< insert id ="insertProduct-MS-SQL" parameterClass ="com.domain.Product" >
insert into PRODUCT (PRD_DESCRIPTION) values (#description#)
< selectKey resultClass ="int" keyProperty ="id" >
SELECT @@IDENTITY AS ID
</ selectKey >
</ insert >
存储过程
SQL Map通过<procedure>元素支持存储过程。下面的例子说明如何使用具有输出参数的存储过程。
< parameterMap id ="swapParameters" class ="map" >
< parameter
property ="email1" jdbcType ="VARCHAR" javaType ="java.lang.String" mode ="INOUT" />
< parameter
property ="email2" jdbcType ="VARCHAR" javaType ="java.lang.String" mode ="INOUT" />
</ parameterMap >
< procedure id ="swapEmailAddresses" parameterMap ="swapParameters" >
{call swap_email_address (?, ?)}
</ procedure >
支持标准的JDBC格式调用存储过程方法。如果存储过程回的是游标那又怎么定义的。
parameterClass
parameterClass属性的值是Java类的全限定名（即包括类的包名）。parameterClass属性是可选的，但强烈建议使用。它的目的是限制输入参数的类型为指定的Java类，并优化框架的性能。如果您使用parameterMap，则没有必要使用parameterClass属性。例如，如果要只允许Java类“examples.domain.Product”作为输入参数，可以这样作：
< statement id =”statementName” parameterClass =” examples.domain.Product” > insert into PRODUCT values (#id#, #description#, #price#)
</ statement >
parameterMap
属性parameterMap的值等于一个预先定义的<parameterMap>元素的名称。parameterMap属性很少使用，更多的是使用上面的parameterClass和inline parameter（接下来会讨论）。 注意！动态mapped statement只支持inline parameter，不支持parameter map。 parameterMap的基本思想是定义一系列有次序的参数系列，用于匹配JDBC PreparedStatement的值符号。例如：
< parameterMap id =”insert-product-param” class =”com.domain.Product”>
<parameter property =”id”/>
<parameter property =”description”/>
</parameterMap >
< statement id =”insertProduct” parameterMap =”insert-product-param”> insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (?,?);
</statement >
如上所述，parameterMap负责将Java Bean的属性映射成statement的参数。
虽然parameterMap的外部形式很少使用，理解它如何工作对于理解inline parameter还是很有帮助。本节以下部分将详细讨论inline parameter。 <parameterMap id=”parameterMapName” [class=”com.domain.Product”]> <parameter property =”propertyName” [jdbcType=”VARCHAR”] [javaType=”string”] [nullValue=”NUMERIC”] [null=”-9999999”]/> <parameter …… />
<parameter …… />
</parameterMap>
括号[]是可选的属性。parameterMap元素只要求属性id作为唯一标识。属性class是可选的但强烈推荐使用。和parameterClass类似，class属性可以框架检查输入参数的类型并优化性能。
一个<parameterMap>的例子
< parameterMap id =”insert-product-param” class =”com.domain.Product”>
<parameter property =”id” jdbcType =”NUMERIC” javaType =”int” nullValue =”-9999999”/>
<parameter property =”description” jdbcType =”VARCHAR” nullValue =”NO_ENTRY”/>
</parameterMap >
< statement id =”insertProduct” parameterMap =”insert-product-param”>
insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (?,?);
</statement >
注意！
parameterMap并不自动地绑定到特定的Java类。因此在上面的例子中，任何拥有“id”和“description”属性的Java Bean对象，都可以作为parameterMap的输入。如果需要将输入绑定到特定的Java类，可以使用mapped-statement的resultClass属性。
注意！
Parameter Map的名称（name）局部的，只在定义它的SQL Map XML文件中有效。不过，加上SQL Map的名称（即在<sqlMap>根元素中的名称）作为前缀，您可以在另一个SQL Map XML文件中引用它。例如，要在另一个文件中引用以上的parameterMap，可以使用名称“Product.insert-product-param”。
Inline Parameter简介
parameterMap的语法虽然简单，但很繁琐。还有一种更受欢迎更灵活的方法，可以大大简化定义和减少代码量。这种方法把Java Bean的属性名称嵌在Mapped Statement的定义中（即直接写在SQL语句中）。缺省情况下，任何没有指定parameterMap的Mapped Statement都会被解析成inline parameter（内嵌参数）。用上面的例子（即Product）来说，就是：
< statement id =”insertProduct” parameterClass =”com.domain.Product”>
insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (#id#, #description#);
</statement >
在内嵌参数中指定数据类型可以用下面的语法：
< statement id =”insertProduct” parameterClass =”com.domain.Product”>
insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (#id:NUMERIC#, #description:VARCHAR#);
</statement >
在内嵌参数中指定数据类型和NULL的替代值可以用这样的语法：
<statement id=”insertProduct” parameterClass=”com.domain.Product”>
insert into PRODUCT (PRD_ID, PRD_DESCRIPTION) values (#id:NUMERIC:-999999#, #description:VARCHAR:NO_ENTRY#);
</statement>
注意！在内嵌参数中，要指定NULL的替代值，必须要先指定数据类型。 注意！如需要在查询时也使用NULL替代值，必须同时在resultMap中定义（如下说明）。
注意！如果您需要指定很多的数据类型和NULL替代值，可以使用外部的parameterMap
resultClass
resultClass属性的值是Java类的全限定名（即包括类的包名）。resultClass属性可以让您指定一个Java类，根据ResultSetMetaData将其自动映射到JDBC的ResultSet。只要是Java Bean的属性名称和ResultSet的列名匹配，属性自动赋值给列值。这使得查询mapped statement变得很短。例如：
< statement id ="getPerson" parameterClass =”int” resultClass ="examples.domain.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 >
resultMap
resultMap是最常用和最重要的属性。ResultMap属性的值等于预先定义的resultMap元素的name属性值（参照下面的例子）。使用resultMap可以控制数据如何从结果集中取出，以及哪一个属性匹配哪一个字段。不象使用resultClass的自动映射方法，resultMap属性可以允许指定字段的数据类型，NULL的替代值复杂类型映射（包括其他Java Bean，集合类型和基本类型包装类）。
< resultMap id =”get-product-result” class =”com.ibatis.example.Product”>
<result property =”id” column =”PRD_ID”/>
<result property =”description” column =”PRD_DESCRIPTION”/>
</resultMap >
< statement id =”getProduct” resultMap =”get-product-result”>
select * from PRODUCT
</statement >
xmlResultName
当直接把查询结果映射成XML document时，属性xmlResultName的值等于XML document根元素的名称。例如：
< select id ="getPerson" parameterClass =”int” resultClass ="xml" xmlResultName =”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#
</select >
上面的查询结果将产生一个XML document，结构如下：
< person >
< id > 1 </ id >
< firstName > Clinton </ firstName >
< lastName > Begin </ lastName >
< birthDate > 1900-01-01 </ birthDate >
< weightInKilograms > 89 </ weightInKilograms >
< heightInMeters > 1.77 </ heightInMeters >
</ person >
基本类型输入参数
很简单就是使用JAVA基础类型来做为参数了。
< statement id =”insertProduct” parameter =”java.lang.Integer”>
select * from PRODUCT where PRD_ID = #value# </statement >
Map类型输入参数
< statement id =”insertProduct” parameterClass =”java.util.Map”>
select * from PRODUCT where PRD_CAT_ID = #catId# and PRD_CODE = #code#
</statement >
可以注意到mapped statement的形式完全没有区别！上面的例子中，如果把Map对象作为输入参数去调用mapped statement，Map对象必须包含键值“catId”和“code”。键值引用的对象必须是合适的类型，以上面的例子来说，必须是Integer和String。Result Map（参见以下章节）也支持使用Map类型作为结果参数。要获得更多信息，请参见“Result Map”和“使用SQL Map API编程”部分。 Map类型也可以使用别名。例如，可以用“map”来代替“java.util.Map”。这些别名参见下面的“支持Parameter Map和Result Map的数据类型”表格。
三、动态 MAP Statement
作用是动态构建SQL语句，根据不同的一元或二元运算条件构建复杂的SQL语句，这功能非常好，这样就可以把写的BO层的SQL语句构造移值到SQL MAP 文件里。这里例举一些例子：
< select id ="dynamicGetAccountList" cacheModel ="account-cache" resultMap ="account-result" >
select * from ACCOUNT
< isGreaterThan prepend ="and" property ="id" compareValue ="0" >
where ACC_ID = #id#
</ isGreaterThan >
order by ACC_LAST_NAME
</ select > 上面语句中可以根据参数id的不同值能构造出两条SQL查询语句，下面是一个比较复杂的例子：
<statement id="dynamicGetAccountList" resultMap="account-result" >
select * from ACCOUNT
<dynamic prepend="WHERE">
<isNotNull prepend="AND" property="firstName">
(ACC_FIRST_NAME = #firstName#
<isNotNull prepend="OR" property="lastName">
ACC_LAST_NAME = #lastName#
</isNotNull>
)
</isNotNull>
<isNotNull prepend="AND" property="emailAddress">
ACC_EMAIL like #emailAddress#
</isNotNull>
<isGreaterThan prepend="AND" property="id" compareValue="0">
ACC_ID = #id#
</isGreaterThan>
</dynamic>
order by ACC_LAST_NAME
</statement>
上面的例子中，<dynamic>元素划分出SQL语句的动态部分。动态部分可以包含任意多的条件标签元素，条件标签决定是否在语句中包含其中的SQL代码。所有的条件标签元素将根据传给动态查询Statement的参数对象的情况来工作。<dynamic>元素和条件元素都有“prepend”属性，它是动态SQL代码的一部分，在必要情况下，可以被父元素的“prepend”属性覆盖。上面的例子中，prepend属性“where”将覆盖第一个为“真”的条件元素。这对于确保生成正确的SQL语句是有必要的。例如，在第一个为“真”的条件元素中，“AND”是不需要的，事实上，加上它肯定会出错。以下小节讨论不同的条件元素，包括二元条件元素，一元条件元素和其他动态元素。
二元条件元素
二元条件元素将一个属性值和一个静态值或另一个属性值比较，如果条件为“真”，元素体的内容将被包括在查询SQL语句中。
二元条件元素的属性：
prepend － 可被覆盖的SQL语句组成部分，添加在语句的前面（可选）property － 被比较的属性（必选）
compareProperty － 另一个用于和前者比较的属性（必选或选择compareValue）
compareValue － 用于比较的值（必选或选择compareProperty）
二元条件元系的属性
| [align=left]<isEqual> [/align] | [align=left]比较属性值和静态值或另一个属性值是否相等。 [/align] |
| [align=left]<isNotEqual> [/align] | [align=left]比较属性值和静态值或另一个属性值是否不相等。 [/align] |
| [align=left]<isGreaterThan> [/align] | [align=left]比较属性值是否大于静态值或另一个属性值。 [/align] |
| [align=left]<isGreaterEqual> [/align] | [align=left]比较属性值是否大于等于静态值或另一个属性值。 [/align] |
| [align=left]<isLessThan> [/align] | [align=left]比较属性值是否小于静态值或另一个属性值。 [/align] |
| [align=left]<isLessEqual> [/align] | [align=left]比较属性值是否小于等于静态值或另一个属性值。 例子： <isLessEqual prepend=”AND” property=”age” compareValue=”18”> ADOLESCENT = ‘TRUE’ </isLessEqual> [/align] |
一元条件元素检查属性的状态是否符合特定的条件。
一元条件元素的属性：
prepend － 可被覆盖的SQL语句组成部分，添加在语句的前面（可选）
property － 被比较的属性（必选）
| [align=left]<isPropertyAvailable>[/align] | [align=left]检查是否存在该属性（存在parameter bean的属性）。[/align] |
| [align=left]<isNotPropertyAvailable>[/align] | [align=left]检查是否不存在该属性（不存在parameter bean的属性）。[/align] |
| [align=left]<isNull>[/align] | [align=left]检查属性是否为null。[/align] |
| [align=left]<isNotNull>[/align] | [align=left]检查属性是否不为null。[/align] |
| [align=left]<isEmpty>[/align] [align=left] [/align] | [align=left]检查Collection.size()的值，属性的String或String.valueOf()值,是否为null或空（“”或size() < 1）。[/align] [align=left] [/align] |
| [align=left]<isNotEmpty>[/align] [align=left] [/align] | [align=left]检查Collection.size()的值，属性的String或String.valueOf()值,是否不为null或不为空（“”或size() > 0）。 例子：[/align] [align=left] <isNotEmpty prepend=”AND” property=”firstName” > FIRST_NAME=#firstName# </isNotEmpty>[/align] |
简单的动态SQL元素
虽然动态Mapped Statement API功能强大，但有时仅需要一小部分的动态SQL即可。为此，SQL statement和statement都可以包含简单的动态SQL元素，以帮助实现动态的order by子句，动态的查询字段或SQL语句的其他动态部分。简单动态SQL元素的概念有点象inline parameter的映射，但使用了稍微不同的语法。考虑下面的例子：
<statement id=”getProduct” resultMap=”get-product-result”>
select * from PRODUCT order by $preferredOrder$
</statement>
简单动态元素可以包含在<dynamic-mapped-statement>中，当要修改SQL语句本身时它能派上用场。例如：
<statement id=”getProduct” resultMap=”get-product-result”>
SELECT * FROM PRODUCT
<dynamic prepend=”WHERE”>
<isNotEmpty property=”description”>
PRD_DESCRIPTION $operator$ #description# </isNotEmpty>
</dynamic>
</statement>
三、使用SQL Map API编程
那那10来个方法吧，有空看看
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 
相关文章推荐
- Ibatis学习随笔 --转载http://www.blogjava.net/pdw2009/archive/2007/01/04/91844.html
- 深度学习(DL)与卷积神经网络(CNN)学习笔记随笔-03-基于Python的LeNet之LR
- 异常（J2SE学习随笔四）
- BaseServlet<学习随笔>
- bpel学习随笔
- 随笔：JQuery学习一：
- ibatis（学习1）--sqlMapConfig sqlMap的配置，和sqlMap中的各种语法
- IBatis连接数据库学习笔记
- ibatis源码学习(二)初始化和配置文件解析
- 深度学习(DL)与卷积神经网络(CNN)学习笔记随笔-04-基于Python的LeNet之MLP
- ARM学习随笔（12）定时器查询方式和中断方式
- iBatis学习小结
- ibatis源码学习(四)动态SQL的实现原理
- Python学习随笔---进程和线程
- 学习C指针的心得随笔
- C#程序集Assembly学习随笔(第一版)_AX
- linux学习随笔第二天
- Sql 学习随笔（数字转换成字符串）
- Android学习随笔(14)------手机多媒体
- android 学习随笔十一(网络：HttpClient框架)