JasperReports 填充报表

任何报表工具的主要目的都是生成高质量的文档。报表填充过程通过操作数据集帮助报表工具实现这一目标。

报表填充过程所需的主要输入是 ：

• 报表模板：这是实际的 JasperReport 文件。

• 报表参数： 这些基本上是在报表填充时传递给引擎的命名值。我们将在报表参数章节中讨论它们。

• 数据源： 我们可以从一系列数据源中填充 Jasper 文件，例如 SQL 查询、XML 文件、csv 文件、HQL（Hibernate 查询语言）查询、Java Bean 的集合等。这将详细讨论在报表数据源一章中。

此过程生成的输出是.jrprint文档，可以查看、打印或导出为其他格式。外观类net.sf.jasperreports.engine.JasperFillManager通常用于用数据填充报表模板。此类具有填充报表模板的各种fillReportXXX()方法（模板可以位于磁盘上、从输入流中选取或直接作为内存提供）。

这个门面类中有两类 fillReportXXX() 方法 ：

• 第一种类型，接收一个 java.sql.Connection 对象作为第三个参数。大多数情况下，报告中填充了来自关系数据库的数据。这是通过以下方式实现的 

  • 通过JDBC连接到数据库。

  • 在报表模板中包含 SQL 查询。

  • JasperReports 引擎使用传入的连接并执行 SQL 查询。

  • 从而产生用于填充报表的报表数据源。

• 第二种，接收一个net.sf.jasperreports.engine.JRDataSource对象，当需要填写的数据有其他形式时。

填充报表数据

本案例项目结构如下：

首先以上一章：《编译模板》最后产生的jasper文件为基础。

接下来，让我们将一组 Java 数据对象（Java Bean）传递给 JasperReport 引擎，以填充这个编译后的报表。

编写一个POJO DataBean.java，它代表数据对象（Java bean）。这个类定义了两个 String 对象，即“name”和“country”。

package com.yiidian;

public class DataBean {
   private String name;
   private String country;

   public String getName() {
      return name;
   }

   public void setName(String name) {
      this.name = name;
   }

   public String getCountry() {
      return country;
   }

   public void setCountry(String country) {
      this.country = country;
   }
}

编写一个类DataBeanList.java，它具有生成java bean 对象集合的业务逻辑。这将进一步传递给 JasperReports 引擎，以生成报告。这里我们在列表中添加了 4 个 DataBean 对象。

package com.yiidian;

import java.util.ArrayList;

public class DataBeanList {
   public ArrayList<DataBean> getDataBeanList() {
      ArrayList<DataBean> dataBeanList = new ArrayList<DataBean>();

      dataBeanList.add(produce("Manisha", "India"));
      dataBeanList.add(produce("Dennis Ritchie", "USA"));
      dataBeanList.add(produce("V.Anand", "India"));
      dataBeanList.add(produce("Shrinath", "California"));

      return dataBeanList;
   }

   /**
    * This method returns a DataBean object,
    * with name and country set in it.
    */
   private DataBean produce(String name, String country) {
      DataBean dataBean = new DataBean();
      dataBean.setName(name);
      dataBean.setCountry(country);
      
      return dataBean;
   }
}

编写一个主类文件JasperReportFill.java，它从类 (DataBeanList) 中获取 java bean 集合并将其传递给 JasperReports 引擎，以填充报表模板。

package com.yiidian;

import net.sf.jasperreports.engine.JRException;
import net.sf.jasperreports.engine.JasperFillManager;
import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.Map;

public class JasperReportFill {
   
   public static void main(String[] args) {
      String sourceFileName = "d:/jasper_report_template.jasper";
      DataBeanList DataBeanList = new DataBeanList();
      ArrayList<DataBean> dataList = DataBeanList.getDataBeanList();

      JRBeanCollectionDataSource beanColDataSource = new JRBeanCollectionDataSource(dataList);
      Map parameters = new HashMap();
      try {
         JasperFillManager.fillReportToFile(sourceFileName, parameters, beanColDataSource);
      } catch (JRException e) {
         e.printStackTrace();
      }
   }
}

生成报表文件 

运行上面的JasperReportFill类，将会在jasper_report_template.jasper同级目录下生成jasper_report_template.jrprint文件，如下：