Mybatis velocity脚本的使用教程详解(推荐)
可能很多童鞋都还不是很清楚在mybatis可以使用各种脚本语言来定义Mapper文件里面的动态SQL;目前mybatis支持的脚本语言有XML(默认的);Velocity和Freemarker三种。使用不同的脚本语言来完成Mapper文件的编写,第一是使用自己熟悉的脚本语言,第二是能够定义更多丰富的自定义指令来简化Mapper的开发,关于MyBatis支持脚本的原理分析,自定义脚本指令后面再写文章分析,本文先介绍mybatis中velocity脚本的使用方式。
mybatis-velocity项目可以允许你方便的使用velocity作为脚本语言来完成Mapper文件中各种动态sql的编写。
注意,在脚本中大量使用velocity开发,如果不熟悉,可以先去看看velocity脚本;
安装
在maven中添加
<dependency> <groupId>org.mybatis.scripting</groupId> <artifactId>mybatis-velocity</artifactId> <version>1.2</version> </dependency>
注意我们使用的是mybatis-velocity1.2版本,该版本需要mybatis3.3支持;
在mybatis配置文件中,将velocity脚本引擎设置为默认的mapper文件引擎:
<typeAliases> ...<typeAliastype="org.mybatis.scripting.velocity.Driver"alias="velocity"/> </typeAliases> <settings> ... <settingname="defaultScriptingLanguage"value="velocity"/> </settings>
配置即完成。
接下来就可以在mapper文件中使用velocity脚本了:
<selectid="findPerson"lang="velocity"> #set($pattern=$_parameter.name+'%') SELECT*FROMpersonWHEREnameLIKE@{pattern,jdbcType=VARCHAR} </select>
注意:
如果使用了velocity,参数要使用@{}来引用,因为velocity的指令就是以#开头的,比如#set#if等;
使用velocity脚本,在参数中也可以配置对应的javaType和jdbcType;配置格式为:@{property,attr1=val1,attr2=val2,...};可配置项有javaType,jdbcType,mode,numericScale,resultMap,typeHandler,jdbcTypeName;
在velocity的指令中使用context中的变量,需要使用$_parameter来作为前缀引用,比如
#if($_parameter.name) #set($_name='%'+$_parameter.name+'%') ANDnameLIKE@{_name} #end
mybatis-velocity内建的指令
除了velocity的指令,mybatis-velocity项目为mybatis定义了一些内建的velocity指令:
trim
#trim(prefixprefixOverridessuffixsuffixOverrides)body#end
其中的参数含义同XML的trim参数含义相同;
一个例子:
#trim("WHERE""AND|OR") #if($_parameter.name) #set($_name='%'+$_parameter.name+'%') ANDnameLIKE@{_name} #end #end
where
#where()body#end #where()同XML中的<where>相同,可以替换条件前的AND/OR,替换为WHERE;注意一定是\where()有括号的;
mset
#mset()body#end #mset前面加一个m,为的是和velocity本身的#set指令区别,#mset等同于XML中的<set>元素,可以在条件前加上set语句,并且去掉set块最后的分号;
一个例子:
<updateid="update"> UPDATEUSER #mset() #if($_parameter.name)name=@{name},#end #if($_parameter.age)age=@{age},#end #if($_parameter.bornDate)borndate=@{bornDate}#end #end WHEREid=@{id} </update>
repeat
#repeat(collectionvarseparatoropenclose)body#end #repeat指令和XML中的<foreach>元素相同,能够方便的遍历集合/数组类型元素,并使用其中的每一个元素:
一个例子:
SELECT*FROMCity #where() #repeat($_parameter.ids$id",""state_idIN("")") @{id} #end #end
in
#in(collectionvarfield)body#end
#in指令是一个新的指令,能够快速的专门针对SQL中的IN条件生成对应的fieldIN()语句;参数列表中,collection代表要遍历的IN中的内容;var代表遍历中的每一个对象的临时引用名称;field代表在IN语句之前生成的字段名称;
一个例子:
SELECT*FROMCity #where() #in($_parameter.ids$id"state_id") @{id} #end #end
自定义指令
mybatis-velocity允许你方便的自定义自己的指令用于简化开发,自定义指令的步骤为:
在classpath中添加一个mybatis-velocity.properties配置文件;
创建自己的Velocity指令解析类;
将自己创建的Velocity指令解析类添加到配置文件中;
在mapper.xml文件中使用指令;
一个例子:
//Userdefineddirectivepackagecom.myproject.directives; //自定义的指令类需要继承Directive类; publicclassMyDirectiveextendsDirective{} //mybatis-velocity.properties //如果有多个自定义指令类,使用分号隔开; userdirective=com.myproject.directives.MyDirective; //mapperxmlfile SELECT*FROMCity #myDirective()......#end
综合使用
如果使用velocity-mybatis,一个典型的CRUD的mapper就可以看起来是这个样子:
<mappernamespace="mybatis.com._520it.mybatis.UserMapper"> <resultMaptype="User"id="user_mapping"> <idcolumn="id"property="id"/> <resultcolumn="name"property="name"/> <resultcolumn="age"property="age"/> <resultcolumn="borndate"property="bornDate"/> </resultMap> <insertid="add"keyColumn="id"keyProperty="id"useGeneratedKeys="true"> INSERTINTOUSER(name,age,borndate)VALUES(@{name,javaType=string,jdbcType=VARCHAR},@{age},@{bornDate}) </insert> <updateid="update"> UPDATEUSER #mset() #if($_parameter.name)name=@{name},#end #if($_parameter.age)age=@{age},#end #if($_parameter.bornDate)borndate=@{bornDate}#end #end WHEREid=@{id} </update> <deleteid="delete"parameterType="long"> DELETEFROMUSERWHEREid=@{id} </delete> <sqlid="user_column"> id,name,age,borndate </sql> <selectid="get"resultMap="user_mapping"> SELECT<includerefid="user_column"/> FROMUSERWHEREid=@{id} </select> <selectid="list"resultMap="user_mapping"> SELECT<includerefid="user_column"/> FROMUSER </select> <selectid="listByName"resultMap="user_mapping"parameterType="string"> SELECT<includerefid="user_column"/> FROMUSERWHEREname=@{name} </select> <selectid="queryBy"resultMap="user_mapping"> SELECTid,name,age,borndate FROMUSER #where() #if($_parameter.name) #set($_name='%'+$_parameter.name+'%') ANDnameLIKE@{_name} #end #end #if($_parameter.orderBy) ORDERBY@{orderBy}@{orderType} #end #if($_parameter.pageSize>-1) LIMIT@{start},@{pageSize} #end </select> </mapper>
以上所述是小编给大家介绍的Mybatisvelocity脚本的使用教程详解(推荐),希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对毛票票网站的支持!