JasperReports 安装

JasperReports 是一个纯 Java 库，而不是一个独立的应用程序。它不能单独运行，因此需要嵌入到另一个客户端或服务器端 Java 应用程序中。由于它基于 Java，因此可以在任何支持 Java 的平台（JDK 1.3 及更高版本）上运行。JasperReport 的所有功能都集中在一个 JAR 文件 jasperreports-xxxjar 中。可以从以下站点下载此 JAR 以及必需和可选的库（.ZIP 文件）：JasperReport 库链接。

该 ZIP 文件包括 JasperReports JAR 文件以及 JasperReports 源代码、相关 JAR 和许多演示 JasperReport 功能的示例。

JasperReport 安装 非Maven

要开始创建报告，我们需要准备好环境。将下载的 JasperReport.ZIP 文件解压到任何位置（在我们的例子中，我们将它解压到 C:\tools\jasperreports-5.0.1）。解压后的文件目录结构如下所示：

以下问所有目录的详细介绍：

• build ： 包含编译的 JasperReport 类文件。

• demo ： 包含各种示例，演示 JasperReports 功能的几个方面。

• dist ： 包含 jasperreports-xxxjar 文件。我们将把这个 JAR 文件添加到我们的 CLASSPATH 以利用 JasperReports。

• docs ： 包含 JasperReports 文档的本地副本。

• lib ： 包含构建 JasperReports 和在我们的应用程序中使用它所需的所有 JAR。

• src ： 包含 JasperReports 源代码。

• build.xml ： 用于构建 JasperReports 源代码的 ANT 构建文件。如果我们不打算修改 JasperReports，我们不需要使用这个文件，因为 JasperReports 是以编译形式分发的。

• changes.txt ： 一个文本文档，解释了 JasperReports 类库的当前版本和以前版本之间的差异。

• license.txt ： 包含 LGPL（较小通用公共许可证）许可证全文的文本文档。

• readme.txt ： 一个文本文档，包含有关如何构建和执行所提供示例的说明。

基本上我们只使用dist下的jasperreports-xxxjar和lib目录下的JARs来生成报表。由于 JasperReports 是一个开源工具，如果在 jasperreports-xxxjar 中执行过程中发现任何缺陷或错误，我们可以修复它并使用 build.xml 文件再次构建 JAR。

设置类路径

要使用 JasperReport，我们需要将以下文件设置到我们的 CLASSPATH -

• jasperreports-xxxjar，其中 xxx 是 JasperReports 版本。这在目录 C:\tools\jasperreports-xxx\dist 下找到）。

• lib子目录 (C:\tools\jasperreports-xxx\lib)下的所有 JAR 文件。

在安装时，我们使用了 JasperReport 5.0.1 版。右键单击“我的电脑”并选择“属性”，单击“高级”选项卡下的“环境变量”按钮。现在用这个C:\tools\jasperreports-5.0.1\dist\jasperreports-5.0.1.jar:C:\tools\jasperreports-5.0.1\lib更新“路径”变量。现在您已准备好创建报告。

JasperReport 安装 Maven

<dependency>
  <groupId>net.sf.jasperreports</groupId>
  <artifactId>jasperreports</artifactId>
   <version>6.17.0</version>
</dependency>

JasperReport的核心类结构

JasperReport有许多类将用于编译 JRXML 报表设计、填充报表、打印报表、导出为 PDF、HTML 和 XML 文件、查看生成的报表以及报表设计。

这些类的说明如下：

• net.sf.jasperreports.engine.JasperCompileManager ： 用于编译 JRXML 报表模板。

• net.sf.jasperreports.engine.JasperFillManager ： 用于使用来自数据源的数据填充报表。

• net.sf.jasperreports.engine.JasperPrintManager ： 用于打印 JasperReports 库生成的文档。

• net.sf.jasperreports.engine.JasperExportManager ： 用于获取报表填写过程生成的文档的 PDF、HTML 或 XML 内容。

• net.sf.jasperreports.view.JasperViewer ： 它代表一个简单的 Java Swing 应用程序，可以加载和显示报表。

• net.sf.jasperreports.view.JasperDesignViewer ： 在设计时用于预览报表模板。