本文主要是介绍基于JavaReport的Web报表开发【1】,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
JavaReport可从网上免费下载得到,网址如下:http://www.javareport.com.cn/download.htm
一、 JavaReport介绍
JavaReport主要有如下优点。
(1)支持实时的、动态的Web统计报表
JavaReport所展示的报表是动态的报表。所有的数据都是实时的数据;所有的统计图也是动态生成的。报表里面的数据源可从数据库中即时查询产生,适合于对实时统计要求高的应用系统。
(2)接口丰富,对图表提供良好的支持
JavaReport提供了丰富的应用程序接口、减少代码复用、灵活的图表形式、即时图表生成、更短的生成时间等。Java报表对图表有良好的支持,可以生成柱图、饼图和折线图等十几种图表。
(3)报表可导出成各种格式的文档
JavaReport在报表展现方面表现优异,能实现Word,Excel,PDF,CSV等格式精确导出等功能,并提供了全部的页面与打印控制。
(4)开发简便,程序员只须编写少量程序代码
有许多的问题在JavaReport组件内已经解决,如报表的导出功能、打印功能和数据的分页处理等。在很多B/S结构体系的系统开发时,分页是开发过程中要重点考虑的问题。但在JavaReport中,就不需要考虑上下翻页,跨页分页,因为这些问题报表引擎已经实现了。在设计报表的过程中,把Report类当作容器类,统计图类,表格类,标签类,图片类等,把它们当作组件类。至于跨页分页,上下翻页由报表引擎自动完成。JavaReport系统中有自动跨页分页的功能,当表格超过当前页的大小时,系统会自动把接着部分放到下一页。报表设计在开发过程中是感觉不到要跨页的存在,只有一个全部数据完整的表格对象。
如果把引入图片文件加入到报表中,可使用报表系统的Report类,通过这个类的addImage()方法把Image对象加进来,如果需要自定义图像,可通过第三方画图程序(例如是JFreeChart程序)生产需要的统计图/图片,然后再把图像加到报表中去。
本书中使用的JavaReport版本是V3.0,JavaReport根据客户的应用需要,按照功能和性能的等级,分成三个版本:专业版,服务器版,企业版。本书使用企业版。
JavaReport三个版本产品都是免费使用的。也就是说这三个版本都不需要购买License许可,可以自由使用JavaReport的所有功能。免费提供报表在Web展示功能,表和图怎样混合功能,跨页分页功能,导出电子文档Word,PDF,Excel,CSV,HTML等诸多功能。
专业版客户(Client)的IP最大连接数限制为10个,也就是JavaReport同时并行处理线程的最大数受限制。限制是为了避免系统资源占用过大,使系统反应迟钝。该版本适合中小型的应用系统,保障应用系统正常运行。
服务器版在最大连接数没有受限,它能充分发挥服务器的个部分硬件设备的作用;相对要求服务器的设备配置高,保障最优性能效率。该版本适合大中型的应用系统使用。
企业版提供垃圾回收机制管理,自动处理在内存中无用对象的引用;支持多服务器处理模式,提供在多个服务器的集群功能和服务器之间负载均衡功能。提高服务器群的负载能力和和快速响应能力。该版本适合负载繁重的应用系统使用。
二、 安装JavaReport
找到JavaReport-V3-Enterprise-Released.jar这个Jar文件,把这个文件的路径加入到classpath系统变量中,或拷贝到当前Web应用的WEB-INF/lib目录下,或拷贝到Tomcat5的安装目录的common/lib目录中;第一种方法和第三种方法对所有Web应用有效,而第二种方法仅对当前Web应用有效。
好了,至此,JavaReport就算安装完毕了。接下来,继续介绍JavaReport。
三、 相关类介绍
下面给出Web报表显示时的情况,如图17-11所示。
在这个图中,对报表的显示情况一目了然,再介绍常用的类理解起来就会比较清晰了。
JavaReport的组件包中有许多的类,体系庞大而复杂,在这里无法一一介绍,仅列出一些常用的类来作出说明,有兴趣的可参考详细的API手册。
(1)WebReportEngine类
即com.javareport.http.WebReportEngine,这个类是整个JavaReport中的Web引擎的开发接口。所有的JSP或Servlet从这个类继承下来,覆盖createReport()函数就实现基本的报表开发工作。
WebReportEngine是JavaReport的Servlet或JSP的开发接口,是JSP或Servlet的父类,报表系统在应用中的程序从此处继承下来,可以根据需要调整接口内容。部分函数可以适当删除。在开发中一般是实现createReport()函数就可以,形成实时动态报表就是在这个函数里实现的。剩下的工作(怎样在Web上显示,怎样形成Work,PDF文件,等)交给报表引擎自动实现。
如果是在JSP中,在页头部分应加入如下语句:
<%@ page extends="com.javareport.http.WebReportEngine"%>
如果是Servlet,相应的Servlet类声明时语句如下:
public class Servlet类名称 extends WebReportEngine{
……
}
? createReport()
方法原型如下:
public Report createReport(javax.servlet.http.HttpServletRequest request)
throws java.lang.Exception
此方法用于建立报表,并返回报表的实例。这个报表实例可以在Web上显示,同时也可以导出Word, Excel, PDF, CSV, HTML等格式的文档以供使用。
参数request可用于获取所有的动态请求的数据。
? validate()
此方法用于对上一个页面Form提交的参数进行检查,由于实时报表需要动态的参数,在这里进行数据校验。方法原型如下:
public java.lang.String validate(javax.servlet.http.HttpServletRequest request)
其中,参数request可用于获取所有的动态请求的数据;方法的返回值为null时代表通过,其他内容则为参数错误的提示信息。
? getStartScript()
方法用于构造报表内容在Web页面上显示之前执行的JavaScript或VBScript脚本,如果要定制则要重载这个方法。方法原型如下:
public java.lang.String getStartScript(javax.servlet.http.HttpServletRequest request)
其中,参数request可用于获取所有的动态请求的数据;方法返回值为null时代表没有脚本内容。
? getEndScript()
方法用于构造报表内容在Web页面上显示之后执行的JavaScript或VBScript脚本,如果要定制则要重载这个方法。方法原型如下:
public java.lang.String getEndScript(javax.servlet.http.HttpServletRequest request)
其中,参数request可用于获取所有的动态请求的数据;方法返回值为null时代表没有脚本内容。
? getToolbarScript()
方法用于定制Web报表在页面首部显示的工具栏为标准的样式(上下翻页,导出文件),可以在此扩展工具栏的内容,如:添加公司主页的链接,返回上一层链接的“返回”按钮,如果要定制则要重载这个方法。方法原型如下:
public java.lang.String getToolbarScript(javax.servlet.http.HttpServletRequest request)
其中,参数request可用于获取所有的动态请求的数据;方法返回值为null时代表不添加内容。
? isShowToolbar()
如果不想在页面上显示报表工具栏,可重载这个方法,并设定返回值为false。需要注意的是,如果是多页报表,上下翻页按钮就无法使用。方法原型如下:
public boolean isShowToolbar()
方法的返回值是是否显示工具栏的布尔值标志。
? getAllEchoButton()
方法用于自定义显示在Web页面中的报表导出文件的按钮,比如应用中只导出PDF文件,其他的不需要,就可以这里设定。按钮值从Word按钮开始是(1,2,4,8,...),需要显示的按钮则将它们的值相加就可以了。默认情况下工具栏上的按钮如图17-12所示:
图17-12 默认情况下工具栏上的按钮
方法原型如下:
public int getAllEchoButton()
方法的返回值是显示按钮对应的和值。要作自定义,需要重载这个方法,并将返回值设为要显示的按钮对应的和值。
(2)Report类
即com.javareport.beans.Report,报表类。这个类的对象用于代表一张报表,是所有报表元素的容器,这是整个系统的核心,也是在浏览器上显示和生成电子文档(Word,Excel,PDF,Html等)的基础。
? addHeaderSeparator()
方法用于在报表的页眉添加一条横直线。方法原型如下:
public java.lang.String addHeaderSeparator(int num)
其中,参数num表示横直线的粗细程度,以自然数表示,数字越大表示线越粗。
? addHeaderSpace()
此方法用于在页眉中添加若干个空格。方法原型如下:
public java.lang.String addHeaderSpace(int num)
其中,参数num是要添加的空格的个数。
? addHeaderTab()
方法用于在页眉中添加若干个【Tab】键,【Tab】键跟空格键一样是不可见的,默认每个【Tab】为8个空格。方法原型如下:
public java.lang.String addHeaderTab(int num)
其中,参数num是要添加的【Tab】键的个数。
? addHeaderBreak()
在页眉中添加一个换行符号,紧跟后面的内容则从下行第一个字符的位置开始。方法原型如下:
public java.lang.String addHeaderBreak()
? addHeaderText()
在页眉中添加文本信息内容,紧跟后面的内容则从下行第一个字符的位置开始。方法原型如下:
public java.lang.String addHeaderText(java.lang.String text)
其中,参数text是要添加的文本信息内容。其中,{P}代表当前页,{N}代表总页数,如:“第{P}页,共{N}页”。
? addChart()
在报表中添加图表信息内容。方法原型如下:
public java.lang.String addChart(ChartImpl chart)
其中,参数chart是要添加的图表,图表类ChartImpl是JavaReport的核心模块,各种各样统计图由图表类生成。
? setCurrentFont()
设置报表当前的字体。原型如下:
public void setCurrentFont(java.awt.Font font)
其中,参数是要设置的字体对象,为Java中java.awt.*包中的Font对象。
? setCurrentBackground()
设置报表当前的背景颜色。原型如下:
public void setCurrentBackground(java.awt.Color color)
其中,参数color是要添加的图形对象,为Java中java.awt.*包中的color对象。
? setCurrentForeground()
设置报表当前的前景颜色。原型如下:
public void setCurrentForeground(java.awt.Color color)
其中,参数color是要添加的图形对象,为Java中java.awt.*包中的color对象。
? addImage()
在报表中添加图片信息内容。原型如下:
public java.lang.String addImage(java.awt.Image image)
其中,参数image是要添加的图形对象,为Java中java.awt.*包中的Image对象。
? addBullet()
这个方法有两种形式:
public java.lang.String addBullet() 或
public java.lang.String addBullet(java.awt.Image image)
该方法用于添加项目符号的表示符号。第一种形式添加默认的项目符号(圆点)的表示符号,第二种形式用自定义的图片内容代替默认的圆点内容。参数image是要添加的图形对象,为Java中java.awt.*包中的Image对象。
? addNewline()
方法用于在报表中添加一个换行符号,紧跟后面的内容则从下行第一个字符的位置开始。方法原型如下:
public java.lang.String addNewline(int num)
其中,参数num代表换行的数量,即多次换行。
? addPageBreak()
方法用于在报表中添加换页的标识符号,当报表系统做分页显示时,遇到这个符号时,则紧跟后面的内容在新的一页开始显示。方法原型如下:
public java.lang.String addPageBreak()
? addSeparator()
在报表中添加一条横直线。方法原型如下:
public java.lang.String addSeparator(int num)
其中,参数num表示横直线的粗细程度,以自然数表示,数字越大表示线越粗。
? addSpace()
添加若干个空格。方法原型如下:
public java.lang.String addSpace(int num)
其中,参数num代表空格的个数。
? addTab()
在报表中添加若干个【Tab】键,【Tab】键跟空格键一样是不可见的,默认每个【Tab】键为8个空格。方法原型如下:
public java.lang.String addTab(int num)
其中,参数num是要添加的【Tab】键的个数。
? addText()
在报表中添加文本信息内容,紧跟后面的内容则从下行第一个字符的位置开始。方法原型如下:
public java.lang.String addText(java.lang.String text)
其中,参数text为要添加的文本信息内容。
? addTable()
添加报表中的表格信息内容。方法原型如下:
public java.lang.String addTable(Table table)
其中,参数table是要添加的表格,有关Table类的内容详见本节中(3)中的内容。
? addFooterSeparator()
在页尾添加一条横直线。方法的原型如下:
public java.lang.String addFooterSeparator(int num)
其中,参数num为横直线的粗细程度,以自然数表示,数字越大表示线越粗。
? addFooterSpace()
在页尾添加若干个空格。方法的原型如下:
public java.lang.String addFooterSpace(int num)
其中,参数num代表要添加的空格的个数。
? addFooterTab()
在页尾添加若干个【Tab】键,【Tab】键跟空格键一样是不可见的,默认每个【Tab】键为8个空格。方法的原型如下:
public java.lang.String addFooterTab(int num)
其中,参数num为要添加的【Tab】键的个数。
? addFooterTab()
在页尾添加一个换行符号,紧跟后面的内容则从下行第一个字符的位置开始。
public java.lang.String addFooterBreak()
? addFooterText()
在页尾添加文本信息内容,紧跟后面的内容则从下行第一个字符的位置开始。方法的原型如下:
public java.lang.String addFooterText(java.lang.String text)
其中,参数text是要添加的文本信息内容。其中,{P}代表当前页,{N}代表总页数,如:“第{P}页,共{N}页”。
(3)Table类
即com.javareport.beans.Table,表格类。这个类的对象属于报表对象Report中的元素。表格在报表中是不可缺少的,整齐排列着数据内容。表格单元里面的内容可以是文本内容,也可以是图形和其他元素,同时这个对象也是表套表的基础。JavaReport会自动处理表格的跨页、分页问题和新页中的表头显示问题,开发过程中把它想象成连续的就可以了。
? Table()
Table类的构造函数,用于实例化一个表格对象,方法的原型如下:
public Table(java.lang.Object[][] data)
其中,参数data为填充表格内容的二维数组。
? setRowAlignment()
设置指定行的对齐方式。方法的原型如下:
public void setRowAlignment(int row,int align)
其中,参数row为要设置对齐方式的行的编号;参数align为要对齐的方式(左,中,右;上,中,下;同时设置左右上下,将两个值相加就可以了)。
? setRowBackground()
设置指定行的背景颜色,形式如下:
public void setRowBackground(int row,java.awt.Color color)
其中,参数row为要设置背景颜色的行的编号;参数color为要设置的颜色对象,为Java中java.awt.*包中的Color对象。
? setRowBorder()
设置表格中所有行的边界外观样式。方法的原型如下:
public void setRowBorder(int style)
其中,参数style为边界外观样式,即表格单元之间的边界线的粗细情况,该值为整数,值越大代表线越粗,0代表不显示。
? setRowBorderColor()
设置表格中指定行的边界的颜色,方法的原型如下:
public void setRowBorderColor(int row,java.awt.Color color)
其中,参数row为要设置边界颜色的行的编号;参数color是要设置的颜色对象,为Java中java.awt.*包中的Color对象。
? setRowFont()
设置表格中指定行内容的字体。方法的原型如下:
public void setRowFont(int row,java.awt.Font font)
其中,参数row为要设置字体的指定行;参数font是要设置的字体对象,为Java中java.awt.*包中的Font对象。
? setRowForeground()
设置表格中指定行的前景颜色,方法的原型如下:
public void setRowForeground(int row,java.awt.Color color)
其中,参数row是要设置前景颜色的行的编号;参数color是要设置的颜色对象,为Java中java.awt.*包中的Color对象。
? setRowHeight()
设置表格中指定行的高度。方法的原型如下:
public void setRowHeight(int row,int height)
其中,参数row是要设置高度的行的编号;参数height是要设置的行的高度。
? setColAlignment()
这篇关于基于JavaReport的Web报表开发【1】的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!