统计报表模块.doc

统计报表模块北京朗华世纪科技发展有限公司2007年6月使用统计报表模块 新朗华内容管理系统提供了功能强大的使用统计报表模块供用户直接使用或作为再次开发的基础。该模块在 JFreeChart 1.0.5 的基础上开发，可根据提供的数据显示图形以供决策参考。下面详细介绍该模块的使用。第一步: 确认系统已安装cn.langhua.opencms.jfreechart模块。确认的方法是打开模块管理，检查是否有“包名称”为cn.langhua.opencms.jfreechart的模块。如果有，那么可以进入下一步。如果没有，请向北京朗华世纪科技发展有限公司索取该模块，并安装到系统中，安装完毕以后请重起服务。第二步: 设置web.xml。更改项目的web.xml，在内添加： DrawPictruecn.langhua.jfreechart.DrawPictrue DrawPictrue/servlet/DrawPictrue 第三步：在JSP文件中添加chart标签库。 在朗华内容管理系统中，由于本模块是动态内容，所以被限定在JSP类型文件中使用，在JSP文件中添加下面这行语句声明chart标签库：chart标签库主要包括：xyline，pie，bar，multipie，line，area等标签。标签内部均无嵌套标签。注意：颜色的设置：颜色值都为 ”#000000” 格式，如：pointColor=#ff0000。 字体的设置： name - 字体名称。 style - Font 的样式常量 int值。size - Font 的点大小 int值。如：titleFont=name=宋体，style=0,size=20时间的格式(x_grid格式)，如：yyyy.MM.dd G at HH:mm:ss z 2001.07.04 AD at 12:08:56 PDT EEE, MMM d, yy Wed, Jul 4, 01 h:mm a 12:08 PM hh oclock a, zzzz 12 oclock PM, Pacific Daylight Time K:mm a, z 0:08 PM, PDT yyyyy.MMMMM.dd GGG hh:mm aaa 02001.July.04 AD 12:08 PM EEE, d MMM yyyy HH:mm:ss Z Wed, 4 Jul 2001 12:08:56 -0700 yyMMddHHmmssZ 010704120856-0700 yyyy-MM-ddTHH:mm:ss.SSSZ 2001-07-04T12:08:56.235-0700 3.1.chart:xyline标签标签的属性：属性描述必须set输入的数据，是保存在page范围的String 类型，详见下面示例是x_grid输入时间数据的格式。是linetitle设置坐标内每一条线的名字，名字间用逗号割开，如：linetitle=A,B。是width设置宽度， 默认400。否height设置长度， 默认400。否x_label横坐标名称。否y_label纵坐标名称，默认为空。否title设置标题，默认为空。否titleFont设置标题字体，默认Font(null, 0, 18)。否titleRE标题相对与坐标的位置取值：TOP,BOTTOM,LEFT,RIGHT默认为TOP。否titleHA标题的位置(水平方向)取值： CENTER,LEFT,RIGHT默认为CENTER。否textTitle设置文本，默认为空。否textTitleFont设置文本字体，默认Font(null, 0, 18)。否textTitleRE文本相对与坐标的位置取值：TOP，BOTTOM，LEFT，RIGHT。默认为TOP。否textTitleHA文本的位置(水平方向)取值: CENTER，LEFT，RIGHT。默认为CENTER。否point设置图形有无折点： false不显示点，true则显示，默认为不显示。否pointColor折点的添充颜色 ，默认为白色。否pointOutline折点有无外框：false无外框，true则有外框，默认无外框。否DRlines对于坐标内横纵格的显示设置： 0为都显示，1为只显示横轴，2为只显示纵轴，其它为都不显示。默认横纵格都显示。否Domainlines 坐标内横格的颜色，默认白色。否Rangelines坐标内纵格的颜色，默认白色。否bgcolor整个图片的背景色，默认白色。否foreColor图片横纵轴区域内的背景色，默认浅灰色。否borderColor图片外边框的颜色，默认无边框，设置后有它指定颜色的边框否3.2.chart: pie标签标签的属性：属性描述必须set输入的数据，是保存在page范围的String 类型，详见模块的例子testP.jsp是width设置宽度， 默认400。否height设置长度， 默认400。否title设置标题，默认为空。否titleFont设置标题字体，默认Font(null, 0, 18)。否titleRE标题相对与坐标的位置取值：TOP,BOTTOM,LEFT,RIGHT默认为TOP。否titleHA标题的位置(水平方向)取值： CENTER,LEFT,RIGHT默认为CENTER。否textTitle设置文本，默认为空。否textTitleFont设置文本字体，默认Font(null, 0, 18)。否textTitleRE文本相对与坐标的位置取值：TOP，BOTTOM，LEFT，RIGHT。默认为TOP。否textTitleHA文本的位置(水平方向)取值: CENTER，LEFT，RIGHT。默认为CENTER。否labelFont设置叶面标签的字体，默认Font(null, 0, 18)。否labelColor页面标签的字体的颜色。否labelOlColor页面标签的边框色，默认黑色。否labelBgColor页面标签的背景色，默认白色。否bgcolor整个图片的背景色，默认白色。否foreColor图片横纵轴区域内的背景色，默认浅灰色。否borderColor图片外边框的颜色，默认无边框，设置后有它指定颜色的边框否3.3.chart: bar标签标签的属性：属性描述必须set输入的数据，是保存在page范围的String 类型，详见模块的例子testBar.jsp是width设置宽度， 默认400。否height设置长度， 默认400。否x_label横坐标名称。否y_label纵坐标名称，默认为空。否title设置标题，默认为空。否titleFont设置标题字体，默认 Font(null, 0, 18)。否titleRE标题相对与坐标的位置取值：TOP,BOTTOM,LEFT,RIGHT默认为TOP。否titleHA标题的位置(水平方向)取值： CENTER,LEFT,RIGHT默认为CENTER。否textTitle设置文本，默认为空。否textTitleFont设置文本字体，默认Font(null, 0, 18)。否textTitleRE文本相对与坐标的位置取值：TOP，BOTTOM，LEFT，RIGHT。默认为TOP。否textTitleHA文本的位置(水平方向)取值: CENTER，LEFT，RIGHT。默认为CENTER。否DRlines对于坐标内横纵格的显示设置： 0为都显示，1为只显示横轴，2为只显示纵轴，其它为都不显示。默认横纵格都显示。否Domainlines 坐标内横格的颜色，默认白色。否Rangelines坐标内纵格的颜色，默认白色。否bgcolor整个图片的背景色，默认白色。否foreColor图片横纵轴区域内的背景色，默认浅灰色。否borderColor图片外边框的颜色，默认无边框，设置后有它指定颜色的边框否3.4.chart: multipie标签标签的属性：属性描述必须set输入的数据，是保存在page范围的String 类型，详见模块的例子testMulti.jsp是width设置宽度， 默认400。否height设置长度， 默认400。否title设置标题，默认为空。否titleFont设置标题字体，默认Font(null, 0, 18)。否titleRE标题相对与坐标的位置取值：TOP,BOTTOM,LEFT,RIGHT默认为TOP。否titleHA标题的位置(水平方向)取值： CENTER,LEFT,RIGHT默认为CENTER。否textTitle设置文本，默认为空。否textTitleFont设置文本字体，默认Font(null, 0, 18)。否textTitleRE文本相对与坐标的位置取值：TOP，BOTTOM，LEFT，RIGHT。默认为TOP。否textTitleHA文本的位置(水平方向)取值: CENTER，LEFT，RIGHT。默认为CENTER。否bgcolor整个图片的背景色，默认白色。否foreColor图片横纵轴区域内的背景色，默认浅灰色。否borderColor图片外边框的颜色，默认无边框，设置后有它指定颜色的边框否3.5.chart: line标签标签的属性：属性描述必须set输入的数据，是保存在page范围的String 类型，详见模块的例子testLin.jsp是width设置宽度， 默认400。否height设置长度， 默认400。否x_label横坐标名称。否y_label纵坐标名称，默认为空。否title设置标题，默认为空。否titleFont设置标题字体，默认Font(null, 0, 18)。否titleRE标题相对与坐标的位置取值：TOP,BOTTOM,LEFT,RIGHT默认为TOP。否titleHA标题的位置(水平方向)取值： CENTER,LEFT,RIGHT默认为CENTER。否textTitle设置文本，默认为空。否textTitleFont设置文本字体，默认Font(null, 0, 18)。否textTitleRE文本相对与坐标的位置取值：TOP，BOTTOM，LEFT，RIGHT。默认为TOP。否textTitleHA文本的位置(水平方向)取值: CENTER，LEFT，RIGHT。默认为CENTER。否point设置图形有无折点： false不显示点，true则显示，默认为不显示。否pointColor折点的添充颜色 ，默认为白色。否pointOutline折点有无外框：false无外框，true则有外框，默认无外框。否DRlines对于坐标内横纵格的显示设置： 0为都显示，1为只显示横轴，2为只显示纵轴，其它为都不显示。默认横纵格都显示。否Domainlines 坐标内横格的颜色，默认白色。否Rangelines坐标内纵格的颜色，默认白色。否bgcolor整个图片的背景色，默认白色。否foreColor图片横纵轴区域内的背景色，默认浅灰色。否borderColor图片外边框的颜色，默认无边框，设置后有它指定颜色的边框否3.6.chart: area标签标签的属性：属性描述必须set输入的数据，是保存在page范围的String 类型，详见模块的例子testXYChartArea.jsp是linetitle设置坐标内每一条线的名字，名字间用逗号割开，如：linetitle=A,B。是width设置宽度， 默认400。否height设置长度， 默认400。否x_label横坐标名称。否y_label纵坐标名称，默认为空。否title设置标题，默认为空。否titleFont设置标题字体，默认Font(null, 0, 18)。否titleRE标题相对与坐标的位置取值：TOP,BOTTOM,LEFT,RIGHT默认为TOP。否titleHA标题的位置(水平方向)取值： CENTER,LEFT,RIGHT默认为CENTER。否textTitle设置文本，默认为空。否textTitleFont设置文本字体，默认Font(null, 0, 18)。否textTitleRE文本相对与坐标的位置取值：TOP，BOTTOM，LEFT，RIGHT。默认为TOP。否textTitleHA文本的位置(水平方向)取值: CENTER，LEFT，RIGHT。默认为CENTER。否DRlines对于坐标内横纵格的显示设置： 0为都显示，1为只显示横轴，2为只显示纵轴，其它为都不显示。默认横纵格都显示。否Domainlines 坐标内横格的颜色，默认白色。否Rangelines坐标内纵格的颜色，默认白色。否bgcolor整个图片的背景色，默认白色。否foreColor图片横纵轴区域内的背景色，默认浅灰色。否borderColor图片外边框的颜色，默认无边框，设置后有它指定颜色的边框否第四步：示例 模块的/docs/目录下包含了大量详细的例子：testBar.jsp：根据产量，产地，品种三组数据由chart:bar标签形成柱状图。testLin.jsp：根据产量，品种，产地三组数据由chart:line标签形成线图。testMutli.jsp：根据产量，品种，产地 由chart:mutlipie