📜  JasperReports-环境设置

📅  最后修改于: 2020-11-16 07:45:56             🧑  作者: Mango


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

ZIP文件包括JasperReports JAR文件以及JasperReports源代码,从属JAR,以及许多展示JasperReport功能的示例。

JasperReport环境

要开始创建报告,我们需要准备好环境。将下载的JasperReport.ZIP文件解压缩到任何位置(在本例中,我们已将其解压缩到C:\ tools \ jasperreports-5.0.1)。提取文件的目录结构如下所示-

Jasper目录结构

这是所有目录的详细信息-

  • 构建-包含已编译的JasperReport类文件。

  • 演示-包含各种示例,展示了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目录下的JAR来生成报告。由于JasperReports是开源工具,如果在执行过程中在jasperreports-xxxjar中识别出任何缺陷或错误,我们可以对其进行修复,并使用build.xml文件再次构建JAR。

设置CLASSPATH

要使用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更新’Path’变量。现在您可以创建报告了。

在本教程的所有示例中,我们都使用了ANT任务来生成报告。构建文件负责导入所有必需的JAR,以生成报告。因此,如上所述设置CLASSPATH仅对希望在不使用ANT的情况下生成报告的人有所帮助。

构建设置

本教程中的所有示例-

  • 使用简单的文本编辑器编写的。

  • 已保存在目录C:\ tools \ jasperreports-5.0.1 \ test \ src \ com \ tutorialspoint下。

  • 已使用Apache ANT在命令提示符下进行编译和执行。我们将使用baseBuild.xml文件,我们将在后续章节中将其导入ANT build.xml文件。将此文件保存到C:\ tools \ jasperreports-5.0.1 \ test。以下是baseBuild.xml文件的内容-



   Previews our JasperReport XML Design
   
   
   
   
   
   
   
   
   

   
      
      
      
      
         
      
      
      
         
      
   
   
   
      
        
      
   
   
   
      
      
      
         
            
         
      
   
   
   
      
      
      
   
   

该文件具有所有必需的目标,例如清理目录,编译Java文件和执行类文件。

以下是baseBuild.xml中各个目录提到的详细信息。假设当前目录为C:\ tools \ jasperreports-5.0.1 \ test)-

  • jasper.dir-是C:\ tools \ jasperreports -5.0.1目录

  • lib.dir-是C:\ tools \ jasperreports -5.0.1 \ lib目录

  • src.dir-是C:\ tools \ jasperreports -5.0.1 \ test \ src

  • classes.dir-是C:\ tools \ jasperreports-5.0.1 \ test \ classes

  • 主类-com.tutorialspoint.HelpMe。当没有从命令行传递任何类文件名时,此类是执行的简单类。将此文件保存到C:\ tools \ jasperreports-5.0.1 \ test \ src \ com \ tutorialspoint。

package com.tutorialspoint;

public class HelpMe {
   public static void main(String[] args) {
      System.out.println("This is the default class executed."
         + "Please pass the fully qualified class" + " name to be executed as command line"
         + " parameter, for example," + " com.tutorialspoint.HelpMe ");
   }
}

碧玉经理班

有许多类,将用于编译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-在设计时用于预览报告模板。

设置Apache ANT

我们将使用Apache ANT构建所有示例。因此,请检查“ ANT-Environment Setup”一章以在系统上设置Apache ANT。