JavaReport

一、<wbr>JavaReport介绍</wbr>
　　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同时并行处理线程的最大数受限制。限制是为了避免系统资源占用过大，使系统反应迟钝。该版本适合中小型的应用系统，保障应用系统正常运行。
服务器版在最大连接数没有受限，它能充分发挥服务器的个部分硬件设备的作用；相对要求服务器的设备配置高，保障最优性能效率。该版本适合大中型的应用系统使用。

　　企业版提供垃圾回收机制管理，自动处理在内存中无用对象的引用；支持多服务器处理模式，提供在多个服务器的集群功能和服务器之间负载均衡功能。提高服务器群的负载能力和和快速响应能力。该版本适合负载繁重的应用系统使用。

　　二、<wbr>安装JavaReport</wbr>
　　找到JavaReport-V3-Enterprise-Released.jar这个Jar文件，把这个文件的路径加入到classpath系统变量中，或拷贝到当前Web应用的WEB-INF\lib目录下，或拷贝到Tomcat5的安装目录的common\lib目录中；第一种方法和第三种方法对所有Web应用有效，而第二种方法仅对当前Web应用有效。
好了，至此，JavaReport就算安装完毕了。接下来，继续介绍JavaReport。

　　三、<wbr><wbr>相关类介绍</wbr></wbr>
　　下面给出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中，在页头部分应加入如下语句：
　　<%@<wbr>page<wbr>extends="com.javareport.http.WebReportEngine"%&gt;</wbr></wbr>

　　如果是Servlet，相应的Servlet类声明时语句如下：
　　public<wbr>class<wbr>Servlet类名称<wbr>extends<wbr>WebReportEngine{</wbr></wbr></wbr></wbr>
<wbr><wbr>……</wbr></wbr>
　　}
?<wbr><wbr>createReport()</wbr></wbr>

　　方法原型如下：
　　public<wbr>Report<wbr>createReport(javax.servlet.http.HttpServletRequest<wbr>request)</wbr></wbr></wbr>
<wbr><wbr><wbr><wbr><wbr><wbr><wbr><wbr><wbr>throws<wbr>java.lang.Exception</wbr></wbr></wbr></wbr></wbr></wbr></wbr></wbr></wbr></wbr>
　　此方法用于建立报表，并返回报表的实例。这个报表实例可以在Web上显示，同时也可以导出Word,<wbr></wbr>Excel,<wbr>PDF,<wbr>CSV,</wbr></wbr><wbr></wbr>HTML等格式的文档以供使用。
　　参数request可用于获取所有的动态请求的数据。
?<wbr><wbr>validate()</wbr></wbr>

　　此方法用于对上一个页面Form提交的参数进行检查，由于实时报表需要动态的参数，在这里进行数据校验。方法原型如下：
　　public<wbr>java.lang.String<wbr>validate(javax.servlet.http.HttpServletRequest<wbr>request)</wbr></wbr></wbr>
　　其中，参数request可用于获取所有的动态请求的数据；方法的返回值为null时代表通过，其他内容则为参数错误的提示信息。
?<wbr><wbr>getStartScript()</wbr></wbr>

　　方法用于构造报表内容在Web页面上显示之前执行的JavaScript或VBScript脚本，如果要定制则要重载这个方法。方法原型如下：
　　public<wbr>java.lang.String<wbr>　　getStartScript(javax.servlet.http.HttpServletRequest<wbr>request)</wbr></wbr></wbr>
　　其中，参数request可用于获取所有的动态请求的数据；方法返回值为null时代表没有脚本内容。
?<wbr><wbr>getEndScript()</wbr></wbr>

　　方法用于构造报表内容在Web页面上显示之后执行的JavaScript或VBScript脚本，如果要定制则要重载这个方法。方法原型如下：
　　public<wbr>java.lang.String<wbr>　　getEndScript(javax.servlet.http.HttpServletRequest<wbr>request)</wbr></wbr></wbr>
　　其中，参数request可用于获取所有的动态请求的数据；方法返回值为null时代表没有脚本内容。
?<wbr><wbr>getToolbarScript()</wbr></wbr>

　　方法用于定制Web报表在页面首部显示的工具栏为标准的样式（上下翻页，导出文件），可以在此扩展工具栏的内容，如：添加公司主页的链接，返回上一层链接的“返回”按钮，如果要定制则要重载这个方法。方法原型如下：
　　public<wbr>java.lang.String<wbr>　　getToolbarScript(javax.servlet.http.HttpServletRequest<wbr>request)</wbr></wbr></wbr>
　　其中，参数request可用于获取所有的动态请求的数据；方法返回值为null时代表不添加内容。
?<wbr><wbr>isShowToolbar()</wbr></wbr>

　　如果不想在页面上显示报表工具栏，可重载这个方法，并设定返回值为false。需要注意的是，如果是多页报表，上下翻页按钮就无法使用。方法原型如下：
public<wbr>boolean<wbr>isShowToolbar()</wbr></wbr>
　　方法的返回值是是否显示工具栏的布尔值标志。
?<wbr><wbr>getAllEchoButton()</wbr></wbr>
　　方法用于自定义显示在Web页面中的报表导出文件的按钮，比如应用中只导出PDF文件，其他的不需要，就可以这里设定。按钮值从Word按钮开始是（1，2，4，8，...），需要显示的按钮则将它们的值相加就可以了。默认情况下工具栏上的按钮如图17-12所示：
<wbr></wbr>
　　图17-12<wbr><wbr>默认情况下工具栏上的按钮</wbr></wbr>

　　方法原型如下：
　　public<wbr>int<wbr>getAllEchoButton()</wbr></wbr>
　　方法的返回值是显示按钮对应的和值。要作自定义，需要重载这个方法，并将返回值设为要显示的按钮对应的和值。

（2）Report类
　　即com.javareport.beans.Report，报表类。这个类的对象用于代表一张报表，是所有报表元素的容器，这是整个系统的核心，也是在浏览器上显示和生成电子文档（Word，Excel，PDF，Html等）的基础。
?<wbr><wbr>addHeaderSeparator()</wbr></wbr>

　　方法用于在报表的页眉添加一条横直线。方法原型如下：
　　public<wbr>java.lang.String<wbr>addHeaderSeparator(int<wbr>num)</wbr></wbr></wbr>
　　其中，参数num表示横直线的粗细程度，以自然数表示，数字越大表示线越粗。
?<wbr><wbr>addHeaderSpace()</wbr></wbr>

　　此方法用于在页眉中添加若干个空格。方法原型如下：
　　public<wbr>java.lang.String<wbr>addHeaderSpace(int<wbr>num)</wbr></wbr></wbr>
　　其中，参数num是要添加的空格的个数。
?<wbr><wbr>addHeaderTab()</wbr></wbr>

　　方法用于在页眉中添加若干个【Tab】键，【Tab】键跟空格键一样是不可见的，默认每个【Tab】为8个空格。方法原型如下：
　　public<wbr>java.lang.String<wbr>addHeaderTab(int<wbr>num)</wbr></wbr></wbr>
　　其中，参数num是要添加的【Tab】键的个数。
?<wbr><wbr>addHeaderBreak()</wbr></wbr>

　　在页眉中添加一个换行符号，紧跟后面的内容则从下行第一个字符的位置开始。方法原型如下：
　　public<wbr>java.lang.String<wbr>addHeaderBreak()</wbr></wbr>
?<wbr><wbr>addHeaderText()</wbr></wbr>

　　在页眉中添加文本信息内容，紧跟后面的内容则从下行第一个字符的位置开始。方法原型如下：
　　public<wbr>java.lang.String<wbr>addHeaderText(java.lang.String<wbr>text)</wbr></wbr></wbr>
　　其中，参数text是要添加的文本信息内容。其中，{P}代表当前页，{N}代表总页数，如：“第{P}页，共{N}页”。
?<wbr><wbr>addChart()</wbr></wbr>

　　在报表中添加图表信息内容。方法原型如下：
　　public<wbr>java.lang.String<wbr>addChart(ChartImpl<wbr>chart)</wbr></wbr></wbr>
　　其中，参数chart是要添加的图表，图表类ChartImpl是JavaReport的核心模块，各种各样统计图由图表类生成。
?<wbr><wbr>setCurrentFont()</wbr></wbr>

　　设置报表当前的字体。原型如下：
　　public<wbr>void<wbr>setCurrentFont(java.awt.Font<wbr>font)</wbr></wbr></wbr>
　　其中，参数是要设置的字体对象，为Java中java.awt.*包中的Font对象。
?<wbr><wbr>setCurrentBackground()</wbr></wbr>

　　设置报表当前的背景颜色。原型如下：
　　public<wbr>void<wbr>setCurrentBackground(java.awt.Color<wbr>color)</wbr></wbr></wbr>
　　其中，参数color是要添加的图形对象，为Java中java.awt.*包中的color对象。
?<wbr><wbr>setCurrentForeground()</wbr></wbr>

　　设置报表当前的前景颜色。原型如下：
　　public<wbr>void<wbr>setCurrentForeground(java.awt.Color<wbr>color)</wbr></wbr></wbr>
　　其中，参数color是要添加的图形对象，为Java中java.awt.*包中的color对象。
?<wbr><wbr>addImage()</wbr></wbr>

　　在报表中添加图片信息内容。原型如下：
　　public<wbr>java.lang.String<wbr>addImage(java.awt.Image<wbr>image)</wbr></wbr></wbr>
　　其中，参数image是要添加的图形对象，为Java中java.awt.*包中的Image对象。<wbr></wbr>
?<wbr><wbr>addBullet()</wbr></wbr>
　　这个方法有两种形式：
　　public<wbr>java.lang.String<wbr>addBullet()<wbr><wbr><wbr>或</wbr></wbr></wbr></wbr></wbr>
　　public<wbr>java.lang.String<wbr>addBullet(java.awt.Image<wbr>image)</wbr></wbr></wbr>
　　该方法用于添加项目符号的表示符号。第一种形式添加默认的项目符号（圆点）的表示符号，第二种形式用自定义的图片内容代替默认的圆点内容。参数image是要添加的图形对象，为Java中java.awt.*包中的Image对象。
?<wbr><wbr>addNewline()</wbr></wbr>

　　方法用于在报表中添加一个换行符号，紧跟后面的内容则从下行第一个字符的位置开始。方法原型如下：
　　public<wbr>java.lang.String<wbr>addNewline(int<wbr>num)</wbr></wbr></wbr>
　　其中，参数num代表换行的数量，即多次换行。
?<wbr><wbr>addPageBreak()</wbr></wbr>

　　方法用于在报表中添加换页的标识符号，当报表系统做分页显示时，遇到这个符号时，则紧跟后面的内容在新的一页开始显示。方法原型如下：
　　public<wbr>java.lang.String<wbr>addPageBreak()</wbr></wbr>
?<wbr><wbr>addSeparator()</wbr></wbr>

　　在报表中添加一条横直线。方法原型如下：
　　public<wbr>java.lang.String<wbr>addSeparator(int<wbr>num)</wbr></wbr></wbr>
　　其中，参数num表示横直线的粗细程度，以自然数表示，数字越大表示线越粗。
?<wbr><wbr>addSpace()</wbr></wbr>

　　添加若干个空格。方法原型如下：
　　public<wbr>java.lang.String<wbr>addSpace(int<wbr>num)</wbr></wbr></wbr>
　　其中，参数num代表空格的个数。
?<wbr><wbr>addTab()</wbr></wbr>

在报表中添加若干个【Tab】键，【Tab】键跟空格键一样是不可见的，默认每个【Tab】键为8个空格。方法原型如下：
public<wbr>java.lang.String<wbr>addTab(int<wbr>num)</wbr></wbr></wbr>
　　其中，参数num是要添加的【Tab】键的个数。
?<wbr><wbr>addText()</wbr></wbr>

　　在报表中添加文本信息内容，紧跟后面的内容则从下行第一个字符的位置开始。方法原型如下：
　　public<wbr>java.lang.String<wbr>addText(java.lang.String<wbr>text)</wbr></wbr></wbr>
　　其中，参数text为要添加的文本信息内容。
?<wbr><wbr>addTable()</wbr></wbr>

　　添加报表中的表格信息内容。方法原型如下：
　　public<wbr>java.lang.String<wbr>addTable(Table<wbr>table)</wbr></wbr></wbr>
　　其中，参数table是要添加的表格，有关Table类的内容详见本节中（3）中的内容。
?<wbr><wbr>addFooterSeparator()</wbr></wbr>

　　在页尾添加一条横直线。方法的原型如下：
　　public<wbr>java.lang.String<wbr>addFooterSeparator(int<wbr>num)</wbr></wbr></wbr>
　　其中，参数num为横直线的粗细程度，以自然数表示，数字越大表示线越粗。
?<wbr><wbr>addFooterSpace()</wbr></wbr>

　　在页尾添加若干个空格。方法的原型如下：
　　public<wbr>java.lang.String<wbr>addFooterSpace(int<wbr>num)</wbr></wbr></wbr>
　　其中，参数num代表要添加的空格的个数。
?<wbr><wbr>addFooterTab()</wbr></wbr>

　　在页尾添加若干个【Tab】键，【Tab】键跟空格键一样是不可见的，默认每个【Tab】键为8个空格。方法的原型如下：
　　public<wbr>java.lang.String<wbr>addFooterTab(int<wbr>num)</wbr></wbr></wbr>
　　其中，参数num为要添加的【Tab】键的个数。
?<wbr><wbr>addFooterTab()</wbr></wbr>
　　在页尾添加一个换行符号，紧跟后面的内容则从下行第一个字符的位置开始。<wbr></wbr>
　　public<wbr>java.lang.String<wbr>addFooterBreak()</wbr></wbr>
?<wbr><wbr>addFooterText()</wbr></wbr>

　　在页尾添加文本信息内容，紧跟后面的内容则从下行第一个字符的位置开始。方法的原型如下：
　　public<wbr>java.lang.String<wbr>addFooterText(java.lang.String<wbr>text)</wbr></wbr></wbr>
　　其中，参数text是要添加的文本信息内容。其中，{P}代表当前页，{N}代表总页数，如：“第{P}页，共{N}页”。

　　（3）Table类
　　即com.javareport.beans.Table，表格类。这个类的对象属于报表对象Report中的元素。表格在报表中是不可缺少的，整齐排列着数据内容。表格单元里面的内容可以是文本内容，也可以是图形和其他元素，同时这个对象也是表套表的基础。JavaReport会自动处理表格的跨页、分页问题和新页中的表头显示问题，开发过程中把它想象成连续的就可以了。
?<wbr><wbr>Table()</wbr></wbr>

　　Table类的构造函数，用于实例化一个表格对象，方法的原型如下：
　　public<wbr>Table(java.lang.Object[][]<wbr>data)</wbr></wbr>
　　其中，参数data为填充表格内容的二维数组。
?<wbr><wbr>setRowAlignment()</wbr></wbr>

　　设置指定行的对齐方式。方法的原型如下：
　　public<wbr>void<wbr>setRowAlignment(int<wbr>row,int<wbr>align)</wbr></wbr></wbr></wbr>
　　其中，参数row为要设置对齐方式的行的编号；参数align为要对齐的方式（左，中，右；上，中，下；同时设置左右上下，将两个值相加就可以了）。
?<wbr><wbr>setRowBackground()</wbr></wbr>

　　设置指定行的背景颜色，形式如下：
　　public<wbr>void<wbr>setRowBackground(int<wbr>row,java.awt.Color<wbr>color)</wbr></wbr></wbr></wbr>
　　其中，参数row为要设置背景颜色的行的编号；参数color为要设置的颜色对象，为Java中java.awt.*包中的Color对象。
?<wbr><wbr>setRowBorder()</wbr></wbr>

　　设置表格中所有行的边界外观样式。方法的原型如下：
　　public<wbr>void<wbr>setRowBorder(int<wbr>style)</wbr></wbr></wbr>
　　其中，参数style为边界外观样式，即表格单元之间的边界线的粗细情况，该值为整数，值越大代表线越粗，0代表不显示。
?<wbr><wbr>setRowBorderColor()</wbr></wbr>

　　设置表格中指定行的边界的颜色，方法的原型如下：
　　public<wbr>void<wbr>setRowBorderColor(int<wbr>row,java.awt.Color<wbr>color)</wbr></wbr></wbr></wbr>
　　其中，参数row为要设置边界颜色的行的编号；参数color是要设置的颜色对象，为Java中java.awt.*包中的Color对象。
?<wbr><wbr>setRowFont()</wbr></wbr>

　　设置表格中指定行内容的字体。方法的原型如下：
　　public<wbr>void<wbr>setRowFont(int<wbr>row,java.awt.Font<wbr>font)</wbr></wbr></wbr></wbr>
　　其中，参数row为要设置字体的指定行；参数font是要设置的字体对象，为Java中java.awt.*包中的Font对象。
?<wbr><wbr>setRowForeground()</wbr></wbr>

　　设置表格中指定行的前景颜色，方法的原型如下：
　　public<wbr>void<wbr>setRowForeground(int<wbr>row,java.awt.Color<wbr>color)</wbr></wbr></wbr></wbr>
　　其中，参数row是要设置前景颜色的行的编号；参数color是要设置的颜色对象，为Java中java.awt.*包中的Color对象。
?<wbr><wbr>setRowHeight()</wbr></wbr>

　　设置表格中指定行的高度。方法的原型如下：
　　public<wbr>void<wbr>setRowHeight(int<wbr>row,int<wbr>height)</wbr></wbr></wbr></wbr>
　　其中，参数row是要设置高度的行的编号；参数height是要设置的行的高度。
?<wbr><wbr>setColAlignment()</wbr></wbr>

设置表格中指定列的对齐方式，方法的原型如下：
　　public<wbr>void<wbr>setColAlignment(int<wbr>col,int<wbr>align)</wbr></wbr></wbr></wbr>

　　其中，参数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。
?<wbr><wbr>setColBackground()</wbr></wbr>

　　设置表格中指定列的背景颜色。方法的原型如下：
　　public<wbr>void<wbr>setColBackground(int<wbr>index,java.awt.Color<wbr>color)</wbr></wbr></wbr></wbr>
　　其中，参数index是指定的列；参数color是要设置的颜色对象，为Java中java.awt.*包中的Color对象。
?<wbr><wbr>setColBorder()</wbr></wbr>

　　设置表格的所有列的边界外观样式，方法的原型如下：
　　public<wbr>void<wbr>setColBorder(int<wbr>style)</wbr></wbr></wbr>
　　其中，参数style指定边界外观样式，即表格单元之间边界线的粗细情况，该值为整数，值越大代表线越粗，0代表不显示。
?<wbr><wbr>setColBorder()</wbr></wbr>

　　设置表格中指定列的边界外观样式。方法的原型如下：
　　public<wbr>void<wbr>setColBorder(int<wbr>index,int<wbr>style)</wbr></wbr></wbr></wbr>
　　其中，参数int为指定的列；参数style指定边界外观样式，即表格单元之间边界线的粗细情况，该值为整数，值越大代表线越粗，0代表不显示。
?<wbr><wbr>setColBorderColor()</wbr></wbr>

　　设置表格中指定列的边界的颜色，方法的原型如下：
　　public<wbr>void<wbr>setColBorderColor(int<wbr>index,java.awt.Color<wbr>color)</wbr></wbr></wbr></wbr>
　　其中，参数index为指定的列；参数color是要设置的颜色对象，为Java中java.awt.*包中的Color对象。
?<wbr><wbr>setColFont()</wbr></wbr>

　　设置表格中指定列内容的字体。方法的原型如下：
　　public<wbr>void<wbr>setColFont(int<wbr>index,java.awt.Font<wbr>font)</wbr></wbr></wbr></wbr>
　　其中，参数index为指定的列；参数font是要设置的字体对象，为Java中java.awt.*包中的Font对象。
?<wbr><wbr>setColForeground()</wbr></wbr>

　　设置表格中指定列的前景颜色，方法的原型如下：
　　public<wbr>void<wbr>setColForeground(int<wbr>index,java.awt.Color<wbr>color)</wbr></wbr></wbr></wbr>
　　其中，参数index为指定的列；参数color是要设置的颜色对象，为Java中java.awt.*包中的Color对象。
?<wbr><wbr>setColWidth()</wbr></wbr>

　　设置表格中指定列的宽度。方法的原型如下：
　　public<wbr>void<wbr>setColWidth(int<wbr>index,int<wbr>width)</wbr></wbr></wbr></wbr>
　　其中，参数index是要设置高度的列的编号；参数width为要设置的列的宽度。
?<wbr><wbr>setData()</wbr></wbr>
　
　　给表格填充数据。表格单元的数据可以是数据，也可以是其他元素。方法的原型如下：
　　public<wbr>void<wbr>setData(java.lang.Object[][]<wbr>data)</wbr></wbr></wbr>
　　其中，参数data是填充表格内容的二维数据。
?<wbr><wbr>setAlignment()</wbr></wbr>

　　设置表格中所有单元的对齐方式。方法的原型如下：
　　public<wbr>void<wbr>setAlignment(int<wbr>align)</wbr></wbr></wbr>
　　其中，参数align是要对齐的方式，具体如何取值请参见setColAlignment()方法。
?<wbr><wbr>setColAutoSize()</wbr></wbr>

　　设置表格中所有列是否自动调整宽度。方法的原型如下：
　　public<wbr>void<wbr>setColAutoSize(boolean<wbr>flag)</wbr></wbr></wbr>
　　其中，参数flag是布尔型的标志值。
?<wbr><wbr>setRowAutoSize()</wbr></wbr>

　　设置表格中所有行是否自动调整宽度。方法的原型如下：
　　public<wbr>void<wbr>setRowAutoSize(boolean<wbr>flag)</wbr></wbr></wbr>
　　其中，参数flag是布尔型的标志值。
?<wbr><wbr>setFont()</wbr></wbr>

　　设置所有表格单元的字体。方法的原型如下：
　　public<wbr>void<wbr>setFont(java.awt.Font<wbr>font)</wbr></wbr></wbr>
　　其中，参数font是要设置的字体对象，为Java中java.awt.*包中的Font对象。
?<wbr><wbr>setHeaderColCount()</wbr></wbr>

　　设置表格列表头的数目。方法的原型如下：
　　public<wbr>void<wbr>setHeaderColCount(int<wbr>count)</wbr></wbr></wbr>
　　其中，参数count为列表头的数目。
?<wbr><wbr>setHeaderRowCount()</wbr></wbr>

　　设置表格行表头的数目。方法的原型如下：
　　public<wbr>void<wbr>setHeaderRowCount(int<wbr>count)</wbr></wbr></wbr>
　　其中，参数count为行表头的数目。
?<wbr><wbr>setRowHeight()</wbr></wbr>

　　设置行的默认高度。方法的原型如下：
　　public<wbr>void<wbr>setRowHeight(int<wbr>height)</wbr></wbr></wbr>
　　其中，参数height为默认的高度值。
?<wbr><wbr>setCellSpan()</wbr></wbr>

　　合并表格单元，即把连续的多个表格单元和并成为一个表格。方法的原型如下：
　　public<wbr>void<wbr>setCellSpan(int<wbr>x,int<wbr>y,java.awt.Dimension<wbr>dimension)</wbr></wbr></wbr></wbr></wbr>
　　其中，参数x为合并表格左上角的表格的坐标x值；参数y为合并表格的左上角的表格的坐标y值；参数dimension合并的矩型框的大小，即跨越表格的面积。
?<wbr><wbr>setLineWrap()</wbr></wbr>

　　设置表格单元的内容超宽时是否换行显示。方法的原型如下：
　　public<wbr>void<wbr>setLineWrap(boolean<wbr>flag)</wbr></wbr></wbr>
　　其中，参数flag是布尔型的标志值。
?<wbr><wbr>setFont()</wbr></wbr>

　　设置指定表格单元内容的字体。方法的原型如下：
　　public<wbr>void<wbr>setFont(int<wbr>x,int<wbr>y,java.awt.Font<wbr>font)</wbr></wbr></wbr></wbr></wbr>
　　其中，参数x是要设置字体表格单元的坐标x值；参数y是要设置字体表格单元的坐标y值；参数font是要设置的字体对象，为Java中java.awt.*包中的Font对象。
?<wbr><wbr>setForeground()</wbr></wbr>

设置指定表格单元的前景颜色。方法的原型如下：
　　public<wbr>void<wbr>setForeground(int<wbr>x,int<wbr>y,java.awt.Color<wbr>color)</wbr></wbr></wbr></wbr></wbr>
　　其中，参数x是要设置颜色的表格单元的坐标x值；参数y是要设置颜色的表格单元的坐标y值；参数color是要设置的颜色对象，为Java中java.awt.*包中的Color对象。
?<wbr><wbr>setBackground()</wbr></wbr>

　　设置指定表格单元的背景颜色。方法的原型如下：
　　public<wbr>void<wbr>setBackground(int<wbr>x,int<wbr>y,java.awt.Color<wbr>color)</wbr></wbr></wbr></wbr></wbr>
　　方法参数的含义同setForeground()方法。

（4）Chart类
　　即com.javareport.beans.Chart，图表类。这个类的对象属于报表对象Report中的元素。统计图在报表中不可缺少的，使用户浏览更加直观。可用这个类生成十几种报表统计图。
?<wbr><wbr>Chart()</wbr></wbr>

　　Chart类的构造函数，用于实例化一个图表对象。方法的原型如下：
　　public<wbr>Chart(java.lang.Number[][]<wbr>data)</wbr></wbr>
　　其中，参数是用于初始化图形中数据的二维数字型数据数组。
?<wbr><wbr>setLabel()</wbr></wbr>

　　方法用于设置图表中指定的单元数据的显示标签。方法的原型如下：
　　public<wbr>void<wbr>setLabel(int<wbr>i,java.lang.String<wbr>label)</wbr></wbr></wbr></wbr>
　　其中，参数I是需要设置标签的数据单元的下标值；参数label指定对应的单元数据的标签。
?<wbr><wbr>setLabels()</wbr></wbr>

　　设置图表中的单元数据显示的标签。方法的原型如下：
　　public<wbr>void<wbr>setLabels(java.lang.String[]<wbr>labels)</wbr></wbr></wbr>
　　其中，参数labels是单元数据的标签字符串数组。
?<wbr><wbr>setData()</wbr></wbr>

　　设置图表中指定的单元或所有单元的数据。方法的原型如下：
　　public<wbr>void<wbr>setData(int<wbr>i,int<wbr>j,java.lang.Number<wbr>data)<wbr>或</wbr></wbr></wbr></wbr></wbr></wbr>
　　public<wbr>void<wbr>setData(java.lang.Number[][]<wbr>data)</wbr></wbr></wbr>

　　第一种形式参数说明如下：
　　参数i指定的二维数据单元的坐标x的值；参数j指定的二维数据单元的坐标y的值；参数data用于给指定的单元赋值，数据可以是Byte,<wbr>Double,<wbr>Float,<wbr>Integer,<wbr>Long,<wbr>Short，这些数据类型都是Number类的子类。</wbr></wbr></wbr></wbr></wbr>
　　
　　第二种形式参数说明如下：
　　参数data是一个二维的数据，数据可以是Byte、Double、Float、Integer、Long、Short。
?<wbr><wbr>setStyle()</wbr></wbr>

　　设置统计图的类型，统计图可以是：曲线图，百分比图等。方法的原型如下：
　　public<wbr>void<wbr>setStyle(int<wbr>type)</wbr></wbr></wbr>

　　其中，参数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：横向的条形图
?<wbr><wbr>setShowValue()</wbr></wbr>
　　设置统计图中显示时是否把具体的数值也显示出来。方法的原型如下：
　　public<wbr>void<wbr>setShowValue(boolean<wbr>flag)</wbr></wbr></wbr>
　　其中，参数flag是一个布型型的标志值。

　　（5）RsTable类
　　即com.javareport.beans.RsTable，记录集表格类。这个类的对象属于报表对象Report中的元素。RsTable类具有Table类的全部功能，是针对统计报表中显示记录集是一个非常频繁使用的动作而设计的，开发者使用它时能够用几行代码就可把一个JDBC记录集里的数据以表格形式列举显示出来。

　　这个类与Table类有相同之处，它们在外观显示风格上的方法是相同的，因此这里不再介绍RsTable类的外观显示风格设置的方法，具体可参见Table类。
?<wbr><wbr>RsTable()</wbr></wbr>
　　RsTable类的构造函数，用于实例化一个记录集表格对象。方法原型如下：
　　public<wbr>RsTable(java.sql.ResultSet<wbr>rs)<wbr>或</wbr></wbr></wbr>
　　public<wbr>RsTable(java.lang.String[]<wbr>as,java.sql.ResultSet<wbr>rs)</wbr></wbr></wbr>

　　其中，参数rs是填充表格内容的记录集；参数as是记录集中列的名称映射表，比如　　记录值中“ID”映射为“编号”，则报表的表头名称列显示为“编号”。
?<wbr><wbr>setMapping()</wbr></wbr>
　　设置表头与列名的映射关系。方法的原型如下：
　　public<wbr>void<wbr>setMapping(java.lang.String[][]<wbr>as)</wbr></wbr></wbr>
　　其中，参数as是映射关系中的对照表，是一个二维数组。

　　17.3.4<wbr><wbr>开发</wbr></wbr>Web报表的方法
　　（1）开发JSP报表的方法
　　开发JSP时，自定义的JSP需要从WebReportEngine类继承下来：
　　<%@<wbr>page<wbr>contentType="text/html;<wbr>charset=GBK"<wbr>%&gt;</wbr></wbr></wbr></wbr>
　　<%@<wbr>page<wbr>import="javax.servlet.*"%&gt;</wbr></wbr>
　　<%@<wbr>page<wbr>import="com.javareport.beans.*"%&gt;</wbr></wbr>
　　<%@<wbr>page<wbr>extends="com.javareport.http.WebReportEngine"%&gt;</wbr></wbr>
　　<%!
　　public<wbr>Report<wbr>createReport(HttpServletRequest<wbr>request)<wbr>throws<wbr>Exception<wbr>{</wbr></wbr></wbr></wbr></wbr></wbr>
　　……
　　<wbr><wbr><wbr>}</wbr></wbr></wbr>
　　<wbr><wbr>……</wbr></wbr>
　　%>

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

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

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

　　
　　public<wbr>String<wbr>getEndScript(HttpServletRequest<wbr>request){</wbr></wbr></wbr>
　　<wbr><wbr>return<wbr>null;</wbr></wbr></wbr>
　　}

　　
　　public<wbr>String<wbr>getToolbarScript(HttpServletRequest<wbr>request){</wbr></wbr></wbr>
<wbr><wbr>　　return<wbr>null;</wbr></wbr></wbr>
　　}

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