jpivot标签.docx

Introduce JPivot 是一套基于 Mondrian 的 OLAP 前端展现工具，它提供了一套标签库来解决的 OLAP 的展现层问题。 在一个 JSP 页面当中，如果要使用 JPivot 标签库，除了要配置相关的配置文件外，我们需要在 JSP 头的位置声明对 JPivot 标签库的引用，引用方法如下： %@tagliburi=/jpivotprefix=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:mondrianQueryjp: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:clickableurlPattern=/otherpage.jsp?param={0} uniqueName=[Customers]/? jp:clickable page=/yetotherpage.jsp uniqueName=[Products].[Category] sessionParam=Category//jp:mondrianQuery 该标签的主要属性如下： 属性名 必须 数据类型 是否能动态计算指定 描述 urlPattern否 String 是 该属性已过时，使用 page 属性替代它。 page 否 String 是 目标页面的名称，该属性的值必须要以“ / ”开始，如果不设置，那么会采用当前页面的名称。 uniqueName否 String 是 一个 dimension 或 hierarchy 或 level 的唯一名称，用来标识哪个 member 将可以点击。 menuLabel否 String 是 如果多次定义 clickable ，那么它将通过一个右键来进行显