本章主要介绍通用查询控件的原理、用途及详细说明。
实例请参考TAG实例 / 通用查询控件
原理和用途:
通用查询控件是一个页面控件,针对单表做查询,可以拖拽选出字段、用日历、下拉树、选择按钮设置查询条件,设置字段聚合方式进行分组查询。这个界面以JSON格式输入表、字段信息,同样以JSON格式输出查询细节,输入输出JSON由业务系统的程序员动态控制,方便控制权限,给后续查询出数据、生成报表提供支持。
详细说明:
通用查询控件在JSP文件中用<prefix:commonQuery >标签来发布,prefix是用户在JSP文件头指定tag定义文件时指定的前缀名。该定义语句如下所示:
<%@ taglib uri="/WEB-INF/raqsoftCommonQuery.tld" prefix="raqsoft" %>
此定义语句必须写在JSP的开头,其中prefix的值可以自己指定,但tag标签中的前缀必须与其保持一致。
最后就可以写tag标签的内容了:
然后在要展现界面的地方用上面介绍的tag标签来发布,如:
<raqsoft: commonQuery metadata="…" …/>
此标签的属性说明见下表:
(属性名都是大小写相关,属性值必须放在双引号中)
属性名 |
是否必填 |
属性含义 |
属性取值 |
默认值 |
metadata |
是 |
元数据,包含字段相关的一些信息,是最初始的输入。 |
json串、*.json、*.spl文件、*.splx文件或 *.dfx文件 |
|
params |
否 |
spl里的参数 |
参数名称 |
|
cqx |
否 |
初始化查询界面 |
json串 |
|