基于JavaReport的Web报表开发.doc

一、 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-INFlib目录下，或拷贝到Tomcat5的安装目录的commonlib目录中；第一种方法和第三种方法对所有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中，在页头部分应加入如下语句：如果是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()设置表格中指定列的对齐方式，方法的原型如下：public void setColAlignment(int col,int align)其中，参数col是指定对齐方式的列；参数align指出对齐的方式，依次为横向左，中，右；竖向上，中，下（如果要同时设置左右上下，可将两个值相加就可以了），值可以用数字表示，也可以用Table类的常量来表示（实质上Table类实现了com.javareport.ReportConstants接口，所有常量在ReportConstants接口中作了定义），其常量与值的对应情况如下：Table.H_LEFT：横向左对齐，值为1；Table.H_CENTER：横向居中对齐，值为2；Table.H_RIGHT：横向右对齐，值为4；Table.V_TOP：竖向上对齐，值为8；Table.V_CENTER：竖向居中对齐，值为16；Table.V_BOTTOM：竖向下对齐，值为32。? setColBackground()设置表格中指定列的背景颜色。方法的原型如下：public void setColBackground(int index,java.awt.Color color)其中，参数index是指定的列；参数color是要设置的颜色对象，为Java中java.awt.*包中的Color对象。? setColBorder()设置表格的所有列的边界外观样式，方法的原型如下：public void setColBorder(int style)其中，参数style指定边界外观样式，即表格单元之间边界线的粗细情况，该值为整数，值越大代表线越粗，0代表不显示。? setColBorder()设置表格中指定列的边界外观样式。方法的原型如下：public void setColBorder(int index,int style)其中，参数int为指定的列；参数style指定边界外观样式，即表格单元之间边界线的粗细情况，该值为整数，值越大代表线越粗，0代表不显示。? setColBorderColor()设置表格中指定列的边界的颜色，方法的原型如下：public void setColBorderColor(int index,java.awt.Color color)其中，参数index为指定的列；参数color是要设置的颜色对象，为Java中java.awt.*包中的Color对象。? setColFont()设置表格中指定列内容的字体。方法的原型如下：public void setColFont(int index,java.awt.Font font)其中，参数index为指定的列；参数font是要设置的字体对象，为Java中java.awt.*包中的Font对象。? setColForeground()设置表格中指定列的前景颜色，方法的原型如下：public void setColForeground(int index,java.awt.Color color)其中，参数index为指定的列；参数color是要设置的颜色对象，为Java中java.awt.*包中的Color对象。? setColWidth()设置表格中指定列的宽度。方法的原型如下：public void setColWidth(int index,int width)其中，参数index是要设置高度的列的编号；参数width为要设置的列的宽度。? setData()给表格填充数据。表格单元的数据可以是数据，也可以是其他元素。方法的原型如下：public void setData(java.lang.Object data)其中，参数data是填充表格内容的二维数据。? setAlignment()设置表格中所有单元的对齐方式。方法的原型如下：public void setAlignment(int align)其中，参数align是要对齐的方式，具体如何取值请参见setColAlignment()方法。? setColAutoSize()设置表格中所有列是否自动调整宽度。方法的原型如下：public void setColAutoSize(boolean flag)其中，参数flag是布尔型的标志值。? setRowAutoSize()设置表格中所有行是否自动调整宽度。方法的原型如下：public void setRowAutoSize(boolean flag)其中，参数flag是布尔型的标志值。? setFont()设置所有表格单元的字体。方法的原型如下：public void setFont(java.awt.Font font)其中，参数font是要设置的字体对象，为Java中java.awt.*包中的Font对象。? setHeaderColCount()设置表格列表头的数目。方法的原型如下：public void setHeaderColCount(int count)其中，参数count为列表头的数目。? setHeaderRowCount()设置表格行表头的数目。方法的原型如下：public void setHeaderRowCount(int count)其中，参数count为行表头的数目。? setRowHeight()设置行的默认高度。方法的原型如下：public void setRowHeight(int height)其中，参数height为默认的高度值。? setCellSpan()合并表格单元，即把连续的多个表格单元和并成为一个表格。方法的原型如下：public void setCellSpan(int x,int y,java.awt.Dimension dimension)其中，参数x为合并表格左上角的表格的坐标x值；参数y为合并表格的左上角的表格的坐标y值；参数dimension合并的矩型框的大小，即跨越表格的面积。? setLineWrap()设置表格单元的内容超宽时是否换行显示。方法的原型如下：public void setLineWrap(boolean flag)其中，参数flag是布尔型的标志值。? setFont()设置指定表格单元内容的字体。方法的原型如下：public void setFont(int x,int y,java.awt.Font font)其中，参数x是要设置字体表格单元的坐标x值；参数y是要设置字体表格单元的坐标y值；参数font是要设置的字体对象，为Java中java.awt.*包中的Font对象。? setForeground()设置指定表格单元的前景颜色。方法的原型如下：public void setForeground(int x,int y,java.awt.Color color)其中，参数x是要设置颜色的表格单元的坐标x值；参数y是要设置颜色的表格单元的坐标y值；参数color是要设置的颜色对象，为Java中java.awt.*包中的Color对象。? setBackground()设置指定表格单元的背景颜色。方法的原型如下：public void setBackground(int x,int y,java.awt.Color color)方法参数的含义同setForeground()方法。（4）Chart类即com.javareport.beans.Chart，图表类。这个类的对象属于报表对象Report中的元素。统计图在报表中不可缺少的，使用户浏览更加直观。可用这个类生成十几种报表统计图。? Chart()Chart类的构造函数，用于实例化一个图表对象。方法的原型如下：public Chart(java.lang.Number data)其中，参数是用于初始化图形中数据的二维数字型数据数组。? setLabel()方法用于设置图表中指定的单元数据的显示标签。方法的原型如下：public void setLabel(int i,java.lang.String label)其中，参数I是需要设置标签的数据单元的下标值；参数label指定对应的单元数据的标签。? setLabels()设置图表中的单元数据显示的标签。方法的原型如下：public void setLabels(java.lang.String labels)其中，参数labels是单元数据的标签字符串数组。? setData()设置图表中指定的单元或所有单元的数据。方法的原型如下：public void setData(int i,int j,java.lang.Number data)或public void setData(java.lang.Number data)第一种形式参数说明如下：参数i指定的二维数据单元的坐标x的值；参数j指定的二维数据单元的坐标y的值；参数data用于给指定的单元赋值，数据可以是Byte, Double, Float, Integer, Long, Short，这些数据类型都是Number类的子类。第二种形式参数说明如下：参数data是一个二维的数据，数据可以是Byte、Double、Float、Integer、Long、Short。? setStyle()设置统计图的类型，统计图可以是：曲线图，百分比图等。方法的原型如下：public void setStyle(int type)其中，参数type是指定的统计图类型，总共有十多种，常用常量来表示，常用的有以下几种。Chart.CHART_PIE3D：立体饼图Chart.CHART_STACKBAR3D：立体条形图Chart.CHART_CURVE：曲线图Chart.CHART_LINE：线图Chart.CHART_POINT：点图Chart.CHART_INVERTED_CURVE：反向曲线图Chart.CHART_INVERTED_LINE：反向线图Chart.CHART_INVERTED_STACKBAR：横向的条形图? setShowValue()设置统计图中显示时是否把具体的数值也显示出来。方法的原型如下：public void setShowValue(boolean flag)其中，参数flag是一个布型型的标志值。（5）RsTable类即com.javareport.beans.RsTable，记录集表格类。这个类的对象属于报表对象Report中的元素。RsTable类具有Table类的全部功能，是针对统计报表中显示记录集是一个非常频繁使用的动作而设计的，开发者使用它时能够用几行代码就可把一个JDBC记录集里的数据以表格形式列举显示出来。这个类与Table类有相同之处，它们在外观显示风格上的方法是相同的，因此这里不再介绍RsTable类的外观显示风格设置的方法，具体可参见Table类。? RsTable()RsTable类的构造函数，用于实例化一个记录集表格对象。方法原型如下：public RsTable(java.sql.ResultSet rs)或public RsTable(java.lang.String as,java.sql.ResultSet rs)其中，参数rs是填充表格内容的记录集；参数as是记录集中列的名称映射表，比如记录值中“ID”映射为“编号”，则报表的表头名称列显示为“编号”。? setMapping()设置表头与列名的映射关系。方法的原型如下：public void setMapping(java.lang.String as)其中，参数as是映射关系中的对照表，是一个二维数组。17.3.4 开发Web报表的方法（1）开发JSP报表的方法开发JSP时，自定义的JSP需要从WebReportEngine类继承下来：这是一个开发的程序模板，一般情况下实现createReport（）函数就可以，项目中报表的样式和内容就在这函数里实现，因此它是动态实时的表报，另外，还可以重载其他函数，可根据需要而定。下面给出一个更详细的JSP开发模板，以供参考。JSP报表开发模板（2）开发Servlet报表的方法开发Servlet的时候，自定义的servlet从WebReportEngine类继承下来：import javax.servlet.http.*;import com.javareport.beans.*;public class ReportExam extends WebReportEngine public Report createReport(HttpServletRequest request) throws Exception 说明：在本书中将详细介绍JSP中开发报表的方法，Servlet开发报表的方法可自行完成。下面给出一个Servlet报表开发的详细模板，以供参考。Servlet报表开发模板import javax.servlet.http.*;import com.javareport.beans.*;public class Template extendsWebReportEngine * 这是报表系统在应用中给开发人员的JSP模板文件，可以根据需要调整接口内容。部分函* 数可以适当删除。在开发中一般是实现createReport（）函数就可以，形成实时动态报表* 就是在这个函数里实现的。剩下的工作（怎样在Web上显示，怎样形成Work，PDF文件等） * 交给报表引擎自动实现。/* * 建立报表，返回报表的实例。这个报表实例可以在Web上显示，同时也可以导出Word，Excel，* PDF,CSV,HTML等格式的文档供使用。 */public Report createReport(HttpServletRequest request) throws Exception Report report = new Report(); report.addText(This is a template !); return report;/* * 这是对上一个页面Form提交的参数进行检查，由于实时报表需要动态的参数，在这里进 * 行数据校验。 * 返回值为null时代表通过，其他内容则为参数错误的提示信息。 */public String validate(HttpServletRequest request) return null;/* 这是报表在Web上显示时，内容显示出来前执行的脚本，脚本内容一般为JavaScript脚* 本或VBScript脚本。* 返回值为null时代表通过没有脚本内容。*/public