JPivot标签库使用详解.docVIP

JPivot标签库使用详解 Introduce JPivot 是一套基于 Mondrian 的 OLAP 前端展现工具，它提供了一套标签库来解决的 OLAP 的展现层问题。 在一个 JSP 页面当中，如果要使用 JPivot 标签库，除了要配置相关的配置文件外，我们需要在 JSP 头的位置声明对 JPivot 标签库的引用，引用方法如下： %@ taglib uri = /jpivot prefix = jp % JPivot 标签库包含以下几个标签： ??????????chart ??????????chooseQuery ??????????clickable ??????????destroyQuery ??????????mondrianQuery ??????????navitator ??????????print ??????????scalarQuery ??????????setParam ??????????table ??????????testQuery ??????????xmlaQuery 接下来我们将详细介绍这些标签的具体用法及相关参数的含义。 chart 创建一个图表组件，这个图表组件的标签不能直接产生可见输出，它必须通过 WCF 的渲染标签才行。 chart 标签的主要属性如下： 属性名 必须 数据类型 是否能动态计算指定 描述 id 是 String 是 标签的 ID visible 否 boolean 是 用来设置该组件是否可见，当该属性为 false 时 WCF 标签半角不显示该组件。 role 否 String 是 Role 的名称，如： role=”tomcat” 就允许当前用户角色为 tomcat 的访问该控件， role=”!tomcat” 则就允许除角色为 tomcat 以外的所有的用户访问。 query 是 OlapModel 是 一个 mondrianQuery 标签的 ID 值 baseDisplayURL 否 String 是 显示图表的链接，链接的后面还要添加参数“ ?=filename=[ 临时图表文件的名称 ] ” controllerURL 否 String 是 链接到 JPivot Controller 的 URL ，该属性在一些复杂环境下比如 Portal 之类就很有用。 chooseQuery 从前面创建的若干个查询当中选择一个合适的查询（通过查询名称进行选择），例如： jp:mondrianQuery id=query01 queryName=name1 ?? SELECT ... /jp:mondrianQuery jp:mondrianQuery id=query01 queryName=name2 ?? SELECT ... /jp:mondrianQuery ... jp:chooseQuery id=query01 queryName=name1/ 它的属性比较简单，只有 id 和 queryName 两个，而且比较容易理解。 clickable 该标签的作用是给一个 dimension 或一个 level 里的所有的 members 加上超链，使得它们变的可以进行点击操作。生成的 URL 中包含这个 member 的唯一名称，这个标签必须要在一个 table 或一个 query 的标签里嵌套使用。 这个动作还依赖于该标签的 sessionParam 属性，如果该属性存在，那么参数值将在页面显示之前写到 com.tonbeller.jpivot.param.SessionParamPool 当中，如果不存在该属性，参数将会被编码到超链接当中。 例如： jp:mondrianQuery ... ? select .. from Sales ? jp:clickable urlPattern=/otherpage.jsp?param={0} uniqueName=[Customers]/ ? jp:clickable page=/yetotherpage.jsp uniqueName=[Products].[Category] sessionParam=Category/ /jp:mondrianQuery 该标签的主要属性如下： 属性名 必须 数据类型 是否能动态计算指定 描述 urlPattern 否 String 是 该属性已过时，使用 page 属性替代它。 page 否 String 是 目标页面的名称，该属性的值必须要以“ / ”开始，如果不设置，那么会采用