设置表格中指定列的对齐方式,方法的原型如下:
  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文件等)
    * 交给报表引擎自动实现。  /**
    *   建立报表,返回报表的实例。这个报表实例可以在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 String getStartScript(HttpServletRequest request){
     return null;
   }  /**
    *   这是报表在Web上显示时,内容显示出来后执行的脚本,脚本内容一般为JavaScript脚
    * 本或VBScript脚本。
    * 返回值为null时代表通过没有脚本内容。
    */
   public String getEndScript(HttpServletRequest request){
     return null;
   }  /**
    * 这是报表在Web上显示时,上面的工具栏为标准的样式(上下翻页,导出文件)。可以在
    * 此扩展工具栏的内容,一般可以添加公司主页的链接,返回上一层链接的“返回”按钮就是
    * 在这里添加脚本的。
    * 返回值为null时代表不添加内容。
    */
   public String getToolbarScript(HttpServletRequest request){
     return null;
   }  /**
    *   这是报表在Web上显示时,如果不想让工具栏显示出来,就让函数的返回值就false就可以。
    * 注意:如果是多页报表,上下翻页按钮就无法使用。
    */
   public boolean isShowToolbar(){
     return true;
   }  
   /**
    * 这是报表在Web上显示时,导出文件的按钮可以自定义,比如应用中只要导出PDF文件,
    * 其他的不需要,就可以这里设定。按钮值从Work按钮开始是(1,2,4,8,...  ),需要
    * 显示的按钮则将它们的值相加就可以了。
    */
   public int getAllEchoButton(){
     return 0xFFFF;
   }
   %>

  (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开发报表的方法可自行完成。