JavaReport



一、 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中，在页头部分应加入如下语句：
　　<%@ 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()

设置表格中指定列的对齐方式，方法的原型如下：
　　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类继承下来：
　　<%@ page contentType="text/html; charset=GBK" %>
　　<%@ page import="javax.servlet.*"%>
　　<%@ page import="com.javareport.beans.*"%>
　　<%@ page extends="com.javareport.http.WebReportEngine"%>
　　<%!
　　public Report createReport(HttpServletRequest request) throws Exception {
　　……
　　   }
　　  ……
　　%>

　　这是一个开发的程序模板，一般情况下实现createReport（）函数就可以，项目中报表的样式和内容就在这函数里实现，因此它是动态实时的表报，另外，还可以重载其他函数，可根据需要而定。

下面给出一个更详细的JSP开发模板，以供参考。
　　JSP报表开发模板
　　<%@ page import="javax.servlet.*"%>
　　<%@ page import="com.javareport.beans.*"%>
　　<%@ page extends="com.javareport.http.WebReportEngine"%>
　　<%!
　　 * 这是报表系统在应用中给开发人员的JSP模板文件，可以根据需要调整接口内容。部分函
　　 * 数可以适当删除。在开发中一般是实现createReport（）函数就可以，形成实时动态报表
 　　* 就是在这个函数里实现的。剩下的工作（怎样在Web上显示，怎样形成Work，PDF文件等）
 　　* 交给报表引擎自动实现。

　　
　　public Report createReport(HttpServletRequest request) throws Exception{
 　　 Report report = new Report();
 　　 report.addText("This is a template !");
 　　 return report;
　　}
　　
　　public String validate(HttpServletRequest request){
　　  return null;
　　}
　　
　　public String getStartScript(HttpServletRequest request){
 　　 return null;
　　}

　　
　　public String getEndScript(HttpServletRequest request){
　　  return null;
　　}

　　
　　public String getToolbarScript(HttpServletRequest request){
  　　return null;
　　}

　　
　　public boolean isShowToolbar(){
 　　 return true;
　　}　　
　　
　　public int getAllEchoButton(){
 　　 return 0xFFFF;
　　}
　　%>