fastquery 1.0.11 发布了。 fastquery 1.0.11 最新特性:
SQL中的变量用命名式1 2 | @Query("select name,age from UserInfo u where u.name = :name or u.age = :age")
UserInfo[] findUserInfoByNameOrAge(@Param("name") String name, @Param("age")Integer age);
|
其中:name对应@Param("name")所指定的方法变量值;:age对应@Param("age")所指定的方法变量值.当然SQL中的变量也可以用?N(N={正整数})的形式来表达,且不用标识@Param. 1 | select name,age from UserInfo u where u.name = :name or u.age = :age
|
最终会编译成 1 | select name,age from UserInfo u where u.name=? or u.age=?
|
因此很好地解决了SQL注入问题.
SQL中的变量采用${name}表达式实现原样替换.不过请注意避免SQL注入问题. 1 2 3 4 5 6 | @Query("select * from `userinfo` where ${one} ${orderby}")
UserInfo findUserInfo(@Param("orderby") String orderby, @Param("one") int i);
|
采用${name}时请注意:传递null值,模板变量默认取"" 参数模板仅仅用来辅助开发者构建SQL语句 请堤防使用不当,引发SQL注入问题 请避免模板参数的值完全来源于用户层的输入 请确保参数值可控.
通过defaultVal属性指定:若参数接受到null值,应该采用的默认值(该属性不是必须的,默认为"").例如: 1 2 3 | @Query("select * from `userinfo` ${orderby}")
JSONArray findUserInfo(@Param(value="orderby",defaultVal="order by age desc") String orderby);
|
@QueryByNamed命名式查询就是把SQL语句写在配置文件里,然后用@QueryByNamed绑定配置文件中的id值,以便引用到SQL.
配置文件的命名格式:类的长名称(包含包地址).queries.xml,每个类文件对应一个配置文件.
配置文件里的SQL代码段,会被Velocity的模板引擎所渲染,因此,很方便写出复杂的动态SQL语句. 例如:org.fastquery.dao.QueryByNamedDBExample.queries.xml 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 | <?xml version="1.0" encoding="UTF-8"?>
<queries>
<query id="findUserInfoAll">
select id,name,age from UserInfo
</query>
<query id="findUserInfoOne">
<value>
## :id 最终会替换成 ?
## ${id} 不会替换还成"?",引用的是参数源值
select id,name,age from UserInfo where id = :id
</value>
</query>
<query id="findUserInfoByNameAndAge">
<value>
select id,name,age from UserInfo where 1 #{#condition}
</value>
<parts>
<part name="condition">
#if(${name})
and name = :name
#end
#if(${age})
and age = :age
#end
</part>
</parts>
</query>
</queries>
|
如果想把一些公用的SQL代码片段提取出来,以便重复使用,通过定义<parts>元素(零件集)可以达到效果. 在<value>,<countQuery>元素中,可以通过#{#name}表达式引用到名称相匹配的零件.如:#{#condition}表示引用name="condition"的零件. 1 2 3 4 5 6 7 8 9 10 11 12 | public interface QueryByNamedDBExample extends QueryRepository {
@QueryByNamed("findUserInfoAll")
JSONArray findUserInfoAll();
@QueryByNamed("findUserInfoOne")
UserInfo findUserInfoOne(@Param("id")Integer id);
@QueryByNamed("findUserInfoByNameAndAge")
JSONArray findUserInfoByNameAndAge(@Param("name") String name, @Param("age")Integer age);
}
|
分页通过@QueryByNamed实现分页 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 | <query id="findPage">
<value>
select no, name, sex from Student where 1 #{#condition} #{#order}
</value>
<countQuery>
select count(no) from Student where 1 #{#condition}
</countQuery>
<parts>
<part name="condition">
#if($no)
or no like :no
#end
#if($name)
or name like :name
#end
#if($age)
or age > :age
#end
</part>
<part name="order">
order by age desc
</part>
</parts>
</query>
|
注意: #{#limit}是分页模板的内置零件,表示分页区间,#{#limit}可以放在SQL语句中的任何地方,不过,前提是:必须符合SQL语法.#{#limit}可以不用指定,默认在尾部.
DB接口: 1 2 | @QueryByNamed("findPage")
Page<Student> findPage(Pageable pageable, @Param("no") String no, @Param("name") String name,@Param("age") Integer age);
|
详细文档请参阅: https://git.oschina.net/xixifeng.com/fastquery https://github.com/xixifeng/fastquery | 
