基于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()