通用查询的调用
产品提供了通用查询调用接口,开发者可以在自己的程序中或jsp页面调用指定的通用查询。
SR模式调用
如果是调用SR模块展现通用查询与报表,SR模块封装了相应参数,用于设置需要调用的通用查询。
传通用查询资源ID调用
SR模块封装了参数cmq_id,可以通过该参数传入通用查询资源ID,完成对指定通用查询的调用。
例如,调用系统中某个单独定义好的通用查询资源,其资源ID为10456,设置cmq_id的值为10456即可。
传通用查询定义文件调用
SR模块还封装了一个参数commonQueryPath,可以通过该参数传入通用查询定义文件(.json文件)所在路径,完成对指定通用查询的调用。
例如,某个通用查询的定义文件位于:/mis2/commonQuery/json/11644.json,那么设置commonQueryPath的值为该路径即可。
具体SR参数设置方式可参考:报表展现客户化。
标签调用
可以通过通用查询提供的标签,在自定义的jsp中调用通用查询。
首先在jsp中引入通用查询标签库文件:
<%@ taglib uri="/WEB-INF/tld/commonQuery.tld" prefix="commTag" %>
然后,就可以在jsp中需要展现通用查询的位置,通过标签调用指定的通用查询:
<commTag:commQryTag
jsObjectName="query1"
jsonContent="<%=commonQueryText%>"
/>
标签属性说明:
- jsObjectName - 通用查询标签唯一的id,一个页面有多个commtag也就是调用了多个通用查询,需要通过id进行区分
- jsonContent - 要调用的通用查询的配置信息,即通用查询的定义,格式为json串,需自行从通用查询定义文件中读取
注意jsonContent的值必须为json串格式,其内容是通用查询的配置信息,开发者可以在jsp中自行通过程序从所需调用的通用查询定义文件中读取,然后设置给jsonContent属性。例如下面代码所示:
<%@ page import="com.runqianapp.commonquery.utils.ReadFile %>
……
<%
String jsonStr= ReadFile.getJsonContent(filePath); //从指定路径读取通用查询json文件中的配置信息
%>
……
<commTag:commQryTag
jsObjectName="query2"
jsonContent="<%=jsonStr%>"
/>
……