JasperReports报表的开发流程

JasperReports的开发流程

1. 开发报表设计文件，也就是一个*.jrxml文件。

2. 使用JasperReports提供的JasperCompileManager工具编译*.jrxml文件，编译后生成一个*.jasper文件。

3. 使用JasperReports提供的JasperFillManager工具填充编译后的*.jasper文件，填充后生成一个*.jrprint文件。

4. 使用导出管理器JasperExportManager或者各种格式的文件导出器JRXxxExporter将*.jrprint文件导出成各种格式的报表文件。也可以使用JRViewer工具类来直接浏览报表。也可以使用打印管理器JasperPrintManager来打印报表。

在JasperReports开发过程中，报表源文件开各种格式的报表文件要经过下图所示的过程：

在JasperReports的开发流程中，JasperReports共涉及以下几个类：

net.sf.jasperreports.engine.design.JasperDesign

对应报表设计文件在内存中的形式，也就是对应的*.jrxml文件。

net.sf.jasperreports.engine.JasperReport

对应二进制报表文件在内存中的形式，也就是对应的*.jasper文件。

net.sf.jasperreports.engine.JasperPrint

对应可显示报表设计文件在内存中的形式，也就是对应的*.jrprint文件。这时可以通过JasperReports内建的报表查看器直接使用，也可以序列化后存储到磁盘上以后使用，更甚于通过网络发送给他处使用。

net.sf.jasperreports.engine.xml.JRXmlLoader

当调用这个方法来载入一个对象时，程序会先通过一个有效的URL来解析路径。如果失败了，程序就会认为这是一个文件路径并且尝试去读取。如果这个文件也没有被发现，程序就会尝试在classpath里寻找能够匹配的资源。如果这也失败了，只好抛出异常。

JasperDesign design = JRXmlLoader.load(File file);
JasperDesign design = JRXmlLoader.load(InputStreaminputStream);
JasperDesign design = JRXmlLoader.load(String sourceFileName);

net.sf.jasperreports.engine.JasperCompileManager

这是一个与编译有关的类，利用它提供的一些编译方法，允许我们将一个报表设计文档（*.jrxml文件）编译成一个二进制文件（*.jasper文件）。此外，它也可以直接将net.sf.jasperreports.engine.design.JasperDesign（*.jrxml文件在内存中的形式）对象编译成net.sf.jasperreports.engine.JasperReport对象。

    JasperCompileManager.compileReport(InputStream inputStream);    return JasperReport
    JasperCompileManager.compileReport(JasperDesign jasperDesign);  return JasperReport
    JasperCompileManager.compileReport(String sourceFileName);      return JasperReport

    JasperCompileManager.compileReportToFile(JasperDesign jasperDesign, String destFileName);
    JasperCompileManager.compileReportToFile(String sourceFileName);
    JasperCompileManager.compileReportToFile(String sourceFileName, String destFileName).

    JasperCompileManager.compileReportToStream(InputStream inputStream, OutputStream outputStream);
    JasperCompileManager.compileReportToStream(JasperDesign jasperDesign, OutputStream outputStream);

net.sf.jasperreports.engine.JasperFillManager

这个类用于报表填充的。报表填充就是为报表的数据查询提供数据库连接，给报表的参数设置值等。填充之前是*.jasper文件，经过填充后就变成了*.jrprint文件--这是一个可显示或者可导出成报表的文件。

参数的值通常通过一个java.util.Map对象来提供，这个Map对象的键是报表参数的名字。

数据源在不同的情况下可以通过两种方式提供：通常情况下，它必须作为一个JRDataSource对象被提供。但是由于大多数的报表所填的值都是从关系数据库取出来的。JasperReports有一个内建的默认行为，可以让人们在报表设计的时候就指定一条SQL查询语句。当在运行时填充报表的时候，执行SQL查询语句来获得需要填充的值。在这种情况下，JasperReports需要的仅仅是一个java.sql.Connection对象，一个通常的数据源对象的实例。JasperReports需要使用这个连接对象通过JDBC连接到关系数据库管理系统，并且执行报表查询。

在执行了报表查询后，JasperReports会自动创建一个net.sf.jasperreports.engine.JRResultSetDataSource对象来封装java.sql.ResultSet对象，并将它传给普通的填充过程使用。

    JasperFillManager.fillReport(InputStream inputStream, Map parameters);         return JasperPrint
    JasperFillManager.