JasperReport学习知识大全

JasperReport学习(转)

http://www.54bk.com/user1/8030/index.html

最近使用了JasperReports和iReport制作了几个报表，这片文章是我的一些总结。

JasperReports是一个开源的java报表制作引擎
http://jasperreports.sourceforge.net

iReport是JasperReports的一个GUI工具，用来生成JasperReports的jrxml文件。
http://ireport.sourceforge.net

首先使用iReport制作报表的模板（我自己起的名词）：

运行iReport，新建一个report。
在Title band中输入报表的名称，好象使用pageheader band也可以，目前我还没有弄明白2者具体的差别。
在column header band中放置一些static text，做为报表的列标题。
在detal band中放入一些textfield，显示报表的详细数据。
在summary band中放入类似于"合计"之类的textfield，这个band是显示在最后一行数据的下放。
在LastPageFooter band中放入想在最后一页显示的信息，比如说"审阅人签名"之类的。

这样报表的框架就基本上搭好了，然后compile一下检查是否有错误，如果没有错误那么就可以在程序中使用这个报表模板了。

JasperReports介绍：

使用JasperReports生成报表是非常简单的，仅仅使用net.sf.jasperreports.engine包中的几个类即可完成报表的生成、预览、打英导出等各个功能。

1. net.sf.jasperreports.engine.JasperCompileManager类。
使用这个类的几个静态方法即可完成对报表的编译工作（具体参见api文档）
编译完成后可以JasperCompileManager有两种处理方式：
1> 返回一个JasperReport对象
2> 在.jrxml文件所在的目录生成一个.jasper文件
这两种方式是由程序员自己选择的。不过我比较倾向使用.jasper文件，毕竟报表的结构不是每天都在改动，所以每次重新编译报表并不是很划算。

2. net.sf.jasperreports.engine.JasperFillManager类
这个类的作用是用数据填充报表。它可以使用JasperReport对象也可以使用。jasper文件做为报表模板。
它同样有2中处理方式：
1> 返回一个JsaperPrint对象。
2> 在.jasper文件所在目录生成一个.jrprint文件
这个类使用net.sf.jasperreports.engine.JRDataSource接口的实现做为数据源。任何实现了JRDataSource的类均可做为数据源使用
在net.sf.jasperreports.engine.data包中定义了一些数据源，可根据自己的需要选择。这里我使用的是JRTableModelDataSource做为
数据源（因为我的报表还要显示在Table中）。

3. net.sf.jasperreports.engine.JasperPrintManager和net.sf.jasperreports.engine.JasperExportManager
者两个类的作用是打英导出报表
他们使用 JasperPrint 和 .jrprint文件做为输入。
可以根据自己的需要使用里面的方法。

例：
import net.sf.jasperreports.engine.*;
import net.sf.jasperreports.view.*;
public class CompileReport {
public static void main(String args[]) {
try {
//编译report.jrxml并在report.jrxml所在的目录中生成report.jasper文件
JasperCompileManager.compileReportToFile("report.jrxml");
//填充数据，这里使用的是JREmptyDataSource
JasperFillManager.fillReportToFile("report.jasper", null, new JREmptyDataSource(50));
//预览报表，false代表不是使用xml文件。
JasperViewer view = new JasperViewer("reports.jrprint", false);
view.pack();
view.setVisible(true);
}
catch (Exception e) {
e.printStackTrace()
}
}
}

http://www.heci.net 贺词网！]
JasperReports学习笔记

版本：jasperreports-0.6.7
学习资料来源：http://jasperreports.sourceforge.net

一、 需求（requirements）
JasperReports要用到的工具和类
1. JDK（java开发环境）
JDK 1.2.2 or higher
2. XML
JAXP 1.1 XML Parser（XML解析器）

Jakarta Commons Digester Component (version 1.1 or later)
http://jakarta.apache.org/commons/digester/

Jakarta Commons BeanUtils Component (version 1.1 or later)
http://jakarta.apache.org/commons/beanutils/

Jakarta Commons Collections Component (version 1.0 or later)
http://jakarta.apache.org/commons/collections/

Jakarta Commons Logging Component (version 1.0 or later)
http://jakarta.apache.org/commons/logging/
3. JDBC（连接数据库用）
JDBC 2.0 Driver

4. PDF（转换为PDF文件用到）
iText - Free Java-PDF library by Bruno Lowagie and Paulo Soares
(version 1.01 or later)
http://www.lowagie.com/iText/

5. XLS（转换为excel文件用）
Jakarta POI (version 2.0 or later)
http://jakarta.apache.org/poi/

二、快速了解（quick how to）
1. Main classes（主要的类）
用JasperReports 时，用到的主要类
net.sf.jasperreports.engine.JasperCompileManager
net.sf.jasperreports.engine.JasperFillManager
net.sf.jasperreports.engine.JasperPrintManager
net.sf.jasperreports.engine.JasperExportManager
这些类提供了很多静态方法，用来编译、填充、打印和导出报表。详细信息请参考JasperReports的javadoc文档。

net.sf.jasperreports.view.JasperViewer
此类用来预览生成的报表（generated reports.）。

net.sf.jasperreports.view.JasperDesignViewer
此类用来预览报表设计（view the report design）。

2. 编译报表设计Compiling a report design
xml文件定义报表设计（report design）。编译报表设计（report design）产生报表（generate reports）。网页http://jasperreports.sourceforge.net/quick.how.to.html中介绍用net.sf.jasperreports.engine.JasperCompileManager类的静态方法compileReportXXX()来编译报表设计（report design）。但是JasperCompileManager不赞成使用此方法编译报表设计（report design），推荐使用JasperCompileManager的方法compileReportXXX()来代替。
编译报表设计（report design）时，jasperreports engine首先检查模板，确定是否一致，然后转换所有的报表表达式（report expressions），最后产生.jasper文件。 要想使编译工作尽可能灵活，你可以实现接口net.sf.jasperreports.engine.design.JRCompiler。

3．预览报表设计 Viewing a report design
使用net.sf.jasperreports.view.JasperDesignViewer的程序来预览。他的main()方法接受报表设计文件名（xml）或者编译后的.jasper文件。

4. 填充报表 Filling a report
编译报表设计（xml文件）得到报表文件（.jasper），再调用net.sf.jasperreports.engine.JasperFillManager类的方法fillReportXXX()，可以得到报表(JasperPrint)。
5. 预览报表 Viewing a report
Generated reports can be viewed using the net.sf.jasperreports.view.JasperViewer application.
In its main() method, it receives the name of the file which contains the report to view.
我没有测试成功。
6. Printing a report
Generated reports can be printed using the printReport(), printPage() or printPages() static methods exposed by the net.sf.jasperreports.engine.JasperPrintManager class.

7. Exporting to PDF, HTML, XLS, CSV or XML format
填充报表文件（.jasper文件）得到报表（JasperPrint）后，可以使用net.sf.jasperreports.engine.JasperExportManager类的方法exportReportXXX()导出为各种格式的文件PDF，HTML，XML。
After having filled a report, we can also export it in PDF, HTML or XML format using the exportReportXXX() methods of the net.sf.jasperreports.engine.JasperExportManager class.

三、JasperReports的工作流程：

根据上图的流程，JasperReports做报表有一下步骤：

1、 报表设计，可以用ireport可视化工具来实现，生成xml文件。完成后，可以直接到步骤3，直接编译xml文件。
2、 如果已经存在报表设计文件（xml文件），可以用net.sf.jasperreports.engine.xml.JRXmlLoader.load()方法载入报表设计，该方法返回JasperDesign对象，通过JasperDesign对象，可以修改报表设计，比如：添加、删除字段，添加、删除变量，添加、删除分组，等等。
3、 完成报表设计后，接下来就可以编译报设计，编译报表设计可以用类net.sf.jasperreports.engine.JasperCompileManager的compileReport（）方法来实现，该方法可以编译xml文件或JasperDesign对象，产生JasperReport对象，JasperReport对象可序列化，能够保存为文件（通常是.jasper文件）。类net.sf.jasperreports.engine.JasperCompileManager还可以把报表转化为报表设计文件（xml文件）。得到JasperReport对象（可从.jasper文件实例化一个JasperReport对象）后，给报表填充数据产生JasperPrint对象。JasperPrint对象可序列化，保存为文件。有了JasperPrint对象后，可以打英浏览、转换为其他格式的文件，如：PDF,HTML,XML,XLS,CSV等等，这些操作就是我们想得到的最终结果。尽管JasperPrintManager类可以导出为PDF,XML文件，但是不赞成使用JasperPrintManager类来导出，建议用JasperExportManager类来导出PDF,HTML,XML文件；要导出XLS和CSV文件，用专业的导出类net.sf.jasperreports.engine.export.JRXlsExporter类和net.sf.jasperreports.engine.export.JRCsvExporter类
导出为XLS的代码段：
JRXlsExporter exporter = new JRXlsExporter();//创建实例
//设计参数
exporter.setParameter(JRExporterParameter.JASPER_PRINT, jasperPrint);
exporter.setParameter(JRExporterParameter.OUTPUT_FILE_NAME, strDestFile);
exporter.setParameter(JRXlsExporterParameter.IS_ONE_PAGE_PER_SHEET, Boolean.FALSE);
exporter.exportReport();//导出

导出为CSV文件和XLS类似。