jasperreports初级教程:[5]编译报表设计

我们在前面的章节中产生的JasperReport模板（JRXML文件）。这个文件不能直接用于生成报告。它必须被编译成JasperReport的“本地二进制'格式，称为Jasperfile。在编制我们把JasperDesign对象转换成JasperReport的对象：

接口net.sf.jasperreports.engine.design.JRCompiler编译过程中起着核心的一部分。这个接口有根据用于报表表达式语言，它可以只要编译器可以实现在运行时计算它被用Java编写的，Groovy，JavaScript的或任何其他脚本语言的几个实现。我们可以通过以下两种方式编译JRXML文件：1. 提供编程编译。2. 编译通过ANT任务。

JRXML提供编程编译JasperReports的API提供了一个门面类net.sf.jasperreports.engine.JasperCompileManager用于编译JasperReport。这个类包含几个公共静态方法编制的报告模板。模板的源可以从文件，输入流，内存中的对象。该jrxml文件（jasper_report_template.jrxml）的内容如下。它被保存在目录 C:\tools\jasperreports-5.0.1\test:

下面的代码演示了上述jasper_report_template.jrxml文件的编译。package com.yiibai; import net.sf.jasperreports.engine.JRException;import net.sf.jasperreports.engine.JasperCompileManager; public class JasperReportCompile {    public static void main(String[] args) {      String sourceFileName = 'C://tools/jasperreports-5.0.1/test' +      '/jasper_report_template.jrxml';       System.out.println('Compiling Report Design ...');      try {         /**          * Compile the report to a file name same as          * the JRXML file name          */         JasperCompileManager.compileReportToFile(sourceFileName);      } catch (JRException e) {         e.printStackTrace();      }      System.out.println('Done compiling!!! ...');   }}  模板编译至于下一步，让我们保存上面的文件内容：C:\tools\jasperreports-5.0.1\test\src\com\yiibai\JasperReportCompile.java 并导入baseBuild.xml在为下面的build.xml文件。baseBuild.xml已经编译和运行的目标：      接下来，让我们打开命令行窗口并转到build.xml文件放置的目录。最后执行的命令ant -Dmain-class=com.yiibai.JasperReportCompile 如下: C:\tools\jasperreports-5.0.1\test>ant -Dmain-class=com.yiibai.JasperReportCompileBuildfile: C:\tools\jasperreports-5.0.1\test\build.xmlcompile:    [javac] C:\tools\jasperreports-5.0.1\test\baseBuild.xml:27:    warning: 'includeantruntime' was not set, defaulting to    build.sysclasspath=last;set to false for repeatable builds    [javac] Compiling 1 source file to C:\tools\jasperreports-5.0.1\test\classes run:     [echo] Runnin class : com.yiibai.JasperReportCompile     [java] Compiling Report Design ...     [java] log4j:WARN No appenders could be found for logger     (net.sf.jasperreports.engine.xml.JRXmlDigesterFactory).     [java] log4j:WARN Please initialize the log4j system properly.     [java] Done compiling!!! ... BUILD SUCCESSFULTotal time: 8 seconds  正如上文编译的结果，会看到jasper_report_template.jasper得到了语言生成的模板文件在C:\tools\jasperreports-5.0.1\test 目录。预览编译报表模板net.sf.jasperreports.view.JasperDesignViewer 正如在前面的章节中讨论可用来预览编译报告模板以及JRXML模板。 为了进一步推动，让我们添加一个新的目标viewDesign上述build.xml文件，这将让我们先看盾编译报告。下面是修改后build.xml：导入文件 - baseBuild.xml做好环境设置，并应放置在同一目录中的build.xml。                                     让我们执行命令：ant（viewDesign是默认的目标），在命令提示符下。 JasperDesignViewer窗口打开显示Jasper文件如下：

通过ANT任务编译报告模板编译更像是比一个运行时的工作设计时的工作，JasperReport库具有一个自定义ANT任务。因为当在运行时创建JRXML文件某些情况下，不能使用此ANT任务。自定义ANT任务被称为JRC和由类实现：net.sf.jasperreports.ant.JRAntCompileTask。其语法和行为是非常相似的内置 ANT任务。模板编译让我们添加新的目标编译报表设计，以我们现有的build.xml。这里使用与文件集的嵌套标签中指定的源文件夹。嵌套的源标签允许编译器，可通过许多不同的地点分散，在一个单一的根报表源文件夹不进行分组报告模板。下面是修改后的build.xml：

接下来，让我们打开命令提示符并转到build.xml文件放置的目录。执行命令ant（compilereportdesing是默认的目标）输出为如下：C:\tools\jasperreports-5.0.1\test>antBuildfile: C:\tools\jasperreports-5.0.1\test\build.xml  文件jasper_report_template.jasper是在文件系统（在我们的例子中为 C:\tools\jasperreports-5.0.1\test目录）产生的。这个文件是相同的通过调用net.sf.jasperreports.engine.JasperCompileManager.compileReportToFile()程序生成一个。我们可以预览这个 jasper文件，执行ant viewDesign。

自由报表—自定义父子格1. 概述内置的数据库中有一张雇员表，他有很多字段，这些字段都要显示在报表中，如果把它显示在报表的一行上，看起来会很拥挤，如果报表中要显示图片字段，把图片和非图片字段都显示在报表的同一行上，会严重的影响报表的美观，这个时候就可以做成自由格式的报表。如下面的订单统计自由报表：

可以看到，自由报表不像网格式报表或者分组报表那样规则，其特点是数据库表中的一条记录不是分布在一行上，而是散放在多行上，记录分块或者分页显示，以提高报表的可读性和美观性。2. 制作步骤2.1 新建工作簿，添加数据集新建工作薄，添加数据集ds1，SQL语句为SELECT * FROM [订单]。2.2 表样设计自由格式报表相当随意，按照需要的样式在对应单元格中拖入数据列即可，如下图所示：

2.3 父格设置由于数据列不在同一行上，因此不会自动形成父子关系，我们希望客户ID、订购日期等数据列能附属于订单ID而扩展，同时报表标题及数据列标题也会跟随订单ID的扩展而复制。将B1、B2至B6单元格，父格设为订单ID单元格。同样，C3至C6单元格，也设置父格为订单ID单元格。预览即上图效果。注：根据父子格原理，D3至E6可以不另设父格，因为他们会自动将C3至C6单元格为左父格。2.4 保存报表并发布END