,在此空间外要引用此空间的元素,则需要加上命名空间" />
ibatis使用总结SqlMap的配置是iBatis中应用的核心。
这部分任务占据了iBatis开发的70的工作量。
1、命名空间:<sqlMap namespace="Account">,在此空间外要引用此空间的元素,则需要加上命名空间名。
2、实体的别名:<typeAlias alias="Account" type="vasoft.ibatissut.simple.domain.entity.Account"/>如果有用到的全名的地方,可以用别名代替,受命名空间约束。
3、插入操作对于自增主键的表,插入可以不配置插入的主键列。
否则是必须的。
4、获取主键插入语句之前配置:主要是针对Sequence主键而言,插入前必须指定一个主键值给要插入的记录。
Oracle、DB2亦如此,方法是在插入语句标签<insert....>之前配置上:<insert id="insertAccount" parameterClass="Account"><selectKey resultClass="long" keyProperty="sctId">SELECT SEQ_TEST.NEXTVAL FROM DUAL</selectKey>insert into .... ........</insert>插入语句之后配置:主要是针对自增主键的表而言,这类表在插入时不需要主键,而是在插入过程自动获取一个自增的主键。
比如MySQL<insert id="insertAccount" parameterClass="Account"><selectKey resultClass="long" keyProperty="sctId">SELECT LAST_INSERT_ID()</selectKey>insert into .... ........</insert>当然,是否需要配置<selectKey>根据情况,只要能保证记录有主键即可。
一旦配置了<selectKey>,就可以在执行插入操作时获取到新增记录的主键。
6、SQL入参parameterClass插入语句入参:parameterClass="类别名" 来设定。
查询语句入参:可以设定类别名,也可以设定为map,也可以设定为iBatis支持的原生类型(比如string、int、long等),当只有一个原生类型入参时,使用#value#来引用,这个value 是不是关键字,可变。
比如:<select id="getById" parameterClass="long" resultMap="result_base">select * from customer where id = #value#</select>map是最强大的入参方式,任何入参方式都可以转换为这种入参方式,因为iBatis仅接受一个入参,当几个参数分布在不同对象中的时候,将这些对象的属性(或者对象本身put)到map中,然后一次传递给sql语句是非常有效。
可以自己写一个将对象或者对象集合转换为map的工具(我已经实现一个了)。
另外,map的中的元素(比如pobj)是个复杂对象,则还可以在SQL中以#pobj.protyename#的格式来引用其中内嵌的属性。
当然不推荐这么干。
7、返回值参数类型返回值参数也同样有两种类型,一种是对象类型resultClass="Account",一种是resultMap="AccountResult"。
这两种类型的选择常常会令人迷惑不解,一言明其理:当结果集列名和类属性名完全对应的时候,则应该使用resultClass来指定查询结果类型。
当然有些列明不对应,可以在sql中使用as重命名达到一致的效果。
当查询结果列名和类属性名对应不上的时候,应该选择resultMap指定查询结果集类型。
否则,则查询出来填充的对象属性为空(数字的为0,对象的为null)。
但是实际上resultMap是对一个Java Bean的映射,需要先定义xml的映射后,才可以引用,例如:<resultMap id="AccountResult" class="Account"><result property="id" column="ACC_ID"/><result property="firstName" column="ACC_FIRST_NAME"/><result property="lastName" column="ACC_LAST_NAME"/><result property="emailAddress" column="ACC_EMAIL"/></resultMap>resultMap映射的结果的目的就是要将查询的结果集绑定到映射对象的属性上。
不管使用哪种返回值参数类型,其最终目的就是要把每条记录映射到一个类的对象或者对象集合上,如果有某个类属性映射不上,则在得到的这个对象或对象集合中这个属性为空。
映射的属性可以是表与实体中的一部分。
不要同时使用两种返回值参数类型,这样只会令人迷惑。
8、查询结果集分组查询结果集排序有两种方式:一是在结果集映射上定义<resultMap id="result" class="bar" groupBy="id">,另一种就是在SQL语句中分组。
建议在SQL语句中分组,以获得更大的可控制性。
9、SQL中参数的引用SQL中引用parameterClass的参数有三种方式:iBatis内置支持的类型,比如int、string,使用#value#来引用,这个value是不是关键字,可变。
map类型的参数,使用#keyName#来引用,keyName为键名。
复杂对象的参数,使用#propertyName#来引用,propertyName类属性的名字。
10、模糊查询中参数的引用模糊查询是针对字符串而言的,如果遇到两个单引号要包含一个参数,则不能再用#来引用变量了,而应该改为$,比如:"%$varName$%",当然,也可以使用"%" || #varname# || "%" 来绕过此问题。
11、SQL片段可以通过<sql id="sql_xxx">...</sql>定义SQL片段,然后<include refid="sql_xxx"/>来在各种语句中引用,达到复用目的。
12、动态SQL可以通过使用动态SQL来组织灵活性更大的更通用的SQL,这样极大减少了编码量,是iBatis应用的第二大亮点。
比如:一个动态的where条件<dynamic prepend="where"><isNotEmpty prepend="and" property="$$$$$">$name like "%"|| #$name# ||"%"</isNotEmpty><isGreaterThan prepend="and" property="$$$$$" compareValue="$$$number">$code like "%"|| #$code# ||"%"</isGreaterThan></dynamic>当然,prepend表示链接关键字,可以为任何字符串,当为sql关键字时,iBatis自动判断是否应该添加该关键字。
该语法也很简单,关键是要会用心思考组织动态SQL。
这里面有一点要注意:区别<isNotEmpty>和<isNotNull>区别,当为空空串时<isNotEmpty>返回true,当为空串时<isNotNull>返回真。
哈哈,自己体会吧,说了反而啰嗦。
13、结果集映射继承结果集映射的继承的目的是为了映射定义的复用,比如下面定义了两个映射,AccountResult 继承了base:<resultMap id="base" class="Account"><result property="id" column="ACC_ID"/><result property="firstName" column="ACC_FIRST_NAME"/><result property="lastName" column="ACC_LAST_NAME"/></resultMap><resultMap id="AccountResult" class="Account" extends="Account.base"><result property="emailAddress" column="ACC_EMAIL"/></resultMap>这样,就很容易扩展了一个映射策略。
14、查询注入查询注入是在一个查询中嵌入另外一个查询,这样做的目的是为了实现实体对象之间的关联关联关系(一对一、一对多、多对多)分单项双向。