本站不再更新，欢迎光临 java开发技术网
随笔-230  评论-230  文章-8  trackbacks-0
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，并拥有某些

Statement 类型

属性

子元素

方法

<statement>

 

id parameterClass resultClass parameterMap resultMap cacheModel xmlResultName

 

所有的动态元素

 

insert update delete 所有的查询方法

 

<insert>

 

id parameterClass parameterMap

 

所有的动态元素 <selectKey>

 

insert

update

 delete

 

<update>

 

id

parameterClass parameterMap

 

所有的动态元素

 

Insert

Update

delete

 

<delete>

 

id parameterClass resultClass parameterMap resultMap cacheModel

 

所有的动态元素

 

所有的查询方法

 

<select>

 

id parameterClass resultClass parameterMap resultMap cacheModel

 

所有的动态元素

 

所有的查询方法

 

<procedure>

 

id parameterClass resultClass parameterMap resultMap xmlResultName

 

所有的动态元素

 

insert update delete 所有的查询方法

 



二、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）

二元条件元系的属性

<isEqual>

比较属性值和静态值或另一个属性值是否相等。

<isNotEqual>

比较属性值和静态值或另一个属性值是否不相等。

<isGreaterThan>

比较属性值是否大于静态值或另一个属性值。

<isGreaterEqual>

比较属性值是否大于等于静态值或另一个属性值。

<isLessThan>

比较属性值是否小于静态值或另一个属性值。

<isLessEqual>

比较属性值是否小于等于静态值或另一个属性值。 例子： <isLessEqual prepend=”AND” property=”age” compareValue=”18”> ADOLESCENT = ‘TRUE’ </isLessEqual>

 


一元条件元素
一元条件元素检查属性的状态是否符合特定的条件。
一元条件元素的属性：
prepend － 可被覆盖的SQL语句组成部分，添加在语句的前面（可选）
property － 被比较的属性（必选）

<isPropertyAvailable>

检查是否存在该属性（存在parameter bean的属性）。

<isNotPropertyAvailable>

检查是否不存在该属性（不存在parameter bean的属性）。

<isNull>

检查属性是否为null。

<isNotNull>

检查属性是否不为null。

<isEmpty>

 

检查Collection.size()的值，属性的String或String.valueOf()值,是否为null或空（“”或size() < 1）。

 

<isNotEmpty>

 

检查Collection.size()的值，属性的String或String.valueOf()值,是否不为null或不为空（“”或size() > 0）。 例子：

 <isNotEmpty prepend=”AND” property=”firstName” > FIRST_NAME=#firstName# </isNotEmpty>

 

还有两个其它的条件元素，<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来个方法吧，有空看看



posted on 2007-01-04 21:31 有猫相伴的日子 阅读(11819) 评论(5)  编辑  收藏 所属分类: ibatis/hibernate/持久层技术

评论:
# re: Ibatis学习随笔 2008-03-11 15:42 | wangpan
请教：
如何调用一个带多个条件的查询语句？  回复  更多评论
  
# re: Ibatis学习随笔 2008-03-11 15:43 | wangpan
请教：
如何调用一个带多个条件的查询语句？

如这个
<select id="selectVenues" parameterClass ="int" resutlMap="account-result">
select
id,
serviceitem,
trade,
pro,
city,
vcname,
vename,
caddress,
eaddress,
gamecname,
gameename,
collecter,
batch
from o_venues

<dynamic prepend="where">
<isNotEmpty prepend="and" property="city">
(city = #city#)
</isNotEmpty>
<isNotEmpty prepend="and" property="vcname">
(vcname = #vcname#)
</isNotEmpty>
</dynamic>
</select>  回复  更多评论
  
# re: Ibatis学习随笔 2008-05-06 11:44 | 请教问题
我用ibatis读tomcat下的数据库连接池，报这个错是什么原因Cause: com.ibatis.sqlmap.engine.transaction.TransactionException: JdbcTransaction initialization failed. DataSource was null.
有人能帮解决下吗？我的qq327362894
  回复  更多评论
  
# re: Ibatis学习随笔 2009-04-30 16:15 | 56
体育  回复  更多评论
  
# re: Ibatis学习随笔 2009-12-17 21:39 | 团派家园
ibaits会如何呢？  回复  更多评论
  

只有注册用户登录后才能发表评论。
网站导航:
 
Powered by: 博客园 模板提供：沪江博客 Copyright ©2024 有猫相伴的日子
本站不再更新，欢迎光临 java开发技术网