JasperReports最终用户手册中文版——第二章API 概述

《JasperReports最终用户手册中文版——第二章API 概述》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、2API概述大多数情况下，人们使用JasperReports的类库的时候都只会用到一小部分，并且不会对所有的API有个整体的概念。在这一章节里让我们近距离的来看一下那些在使用时有重要意义的类和接口。同时也可以了解在需要使用到JasperReports报表功能的应用程序里怎样使用这些类和接口。Classdori.jasper.engine.design.JasperDesign从这个类开始介绍是因为这个类的实例为JasperReports生成报表提供原材料。在JasperReprots使用内部的XML解析器解析了XML报表设计文件后便生成了d

2、ori.jasper.engine.design.JasperDesign实例。如果应用程序不使用XML文件，这个实例的生成也可以通过编程来实现。在提供源代码的例子里有一个叫做noxmldesign的例子，通过它你可以了解到如何不写XML报表设计文件而动态的生成一个dori.jasper.engine.design.JasperDesign实例。所有dori.jasper.engine.design.JasperDesign类的实例在被填充和生成报表使用之前已经被编译出来了。这就是我说它为类库提供原材料的原因。Classdori.jaspe

3、r.engine.JasperReport这个类的实例是编译好的报表设计对象。它只会作为JasperReports报表编译的结果获得，并在填充表格和生成报表时被使用。为了以后更快速的使用，在通过不通程度的检查和报表元素整理后，这个类库创建了一个临时文件存放包括报表变量表达式、文本域和图形表达式组表达式等所有的报表表达式信息。这个临时Java源文件可以在两种情况下被编译。一是在使用中编译，还有一种是被JDK编译。如果在classpath里没有发现tools.jare文件，编译器就会通过运行javac.exe来编译这个文件。编译出来的二进制文件

4、在填充报表数据和计算表达式时用到。Classdori.jasper.engine.JasperCompileManager这个类包括了报表编译的所有功能。使用它可以编译以文件形式和流形式提供的XML报表设计信息。它也可以直接在内存中将dori.jasper.engine.design.JasperDesign对象编译成dori.jasper.engine.JasperReport对象。其他的实用方法还包括了报表设计校验、在内存中生成XML报表设计和构造dori.jasper.engine.design.JasperDesign实例。通过GU

5、I工具使用这些方法设计报表是一件非常简单的事情。Classdori.jasper.engine.JasperPrint在报表设计编译过并且填上了数据后，生成的文档以dori.jasper.engine.JasperPrint实例的形式存在。这时可以通过JasperReports内建的报表查看器直接使用，也可以序列化后存储到磁盘上以后使用，更甚于通过网络发送给他处使用。这个类的实例是JasperReports报表填充过程的输出，可以作为自定义格式的存储特征和页面导向的文档。它可以通过调用其他的方法被转换成诸如PDF、HTML、XML等常见的格

6、式。Interfacedori.jasper.engine.JRDataSourceJasperReports在报表数据来源方面是具有高柔韧性的。人们可以使用任意的数据源，前提条件就是能够提供一个这个接口的恰当的实现。这样报表引擎可以在填充报表时从数据源解析和检索数据。通常来说，如果一个报表填充了数据，肯定有一个这个接口的实例被报表引擎提供或创建。Classdori.jasper.engine.JRResultSetDataSource这个类是dori.jasper.engine.JRDataSource接口的一个默认实现。由于大多数的报表

7、都由关系数据库的数据生成，JasperReports包含了一个封装了java.sql.ResultSet对象的默认实现。这个类有着明确的目的：在传给报表填充测试之前封装已经载入的数据集。在执行了通过JDBC的报表查询后它会被用来封装从数据库获得的数据。Classdori.jasper.engine.data.JRTableModelDataSource这个类是dori.jasper.engine.JRDataSource接口的另外一个默认实现。它封装了javax.swing.table.TableModel对象。它可以在JavaSwing应

8、用程序中通过已经载入的屏幕表格的数据生成报表。Classdori.jasper.engine.JREmptyDataSource作为最简单的dori.jasper.engine.