JasperReport編譯報表設計

我們在前面的章節中產生的JasperReport模板（JRXML文件）。這個文件不能直接用於生成報告。它必須被編譯成JasperReport的「本地二進制"格式，稱爲Jasperfile。在編制我們把JasperDesign對象轉換成JasperReport的對象：

Jasper

接口net.sf.jasperreports.engine.design.JRCompiler編譯過程中起着核心的一部分。這個接口有根據用於報表表達式語言，它可以只要編譯器可以實現在運行時計算它被用Java編寫的，Groovy，JavaScript的或任何其他腳本語言的幾個實現。我們可以通過以下兩種方式編譯JRXML文件：

提供編程編譯。
編譯通過ANT任務。

JRXML提供編程編譯

JasperReports的API提供了一個門面類net.sf.jasperreports.engine.JasperCompileManager用於編譯JasperReport。這個類包含幾個公共靜態方法編制的報告模板。模板的源可以從文件，輸入流，內存中的對象。

該jrxml文件（jasper_report_template.jrxml）的內容如下。它被保存在目錄 C: oolsjasperreports-5.0.1 est:

下面的代碼演示了上述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: oolsjasperreports-5.0.1 estsrccomyiibaiJasperReportCompile.java 並導入baseBuild.xml在爲下面的build.xml文件。baseBuild.xml已經編譯和運行的目標：

接下來，讓我們打開命令行窗口並轉到build.xml文件放置的目錄。最後執行的命令ant -Dmain-class=com.yiibai.JasperReportCompile 如下:

C: oolsjasperreports-5.0.1 est>ant -Dmain-class=com.yiibai.JasperReportCompile
Buildfile: C: oolsjasperreports-5.0.1 estuild.xml
compile:
[javac] C: oolsjasperreports-5.0.1 estaseBuild.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: oolsjasperreports-5.0.1 estclasses

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 SUCCESSFUL
Total time: 8 seconds

正如上文編譯的結果，會看到jasper_report_template.jasper得到了語言生成的模板文件在C: oolsjasperreports-5.0.1 est 目錄。

預覽編譯報表模板

net.sf.jasperreports.view.JasperDesignViewer 正如在前面的章節中討論可用來預覽編譯報告模板以及JRXML模板。

爲了進一步推動，讓我們添加一個新的目標viewDesign上述build.xml文件，這將讓我們先看盾編譯報告。下面是修改後build.xml：
導入文件 - baseBuild.xml做好環境設置，並應放置在同一目錄中的build.xml。

讓我們執行命令：ant（viewDesign是默認的目標），在命令提示符下。 JasperDesignViewer窗口打開顯示Jasper文件如下：

Jasper

通過ANT任務編譯

報告模板編譯更像是比一個運行時的工作設計時的工作，JasperReport庫具有一個自定義ANT任務。因爲當在運行時創建JRXML文件某些情況下，不能使用此ANT任務。自定義ANT任務被稱爲JRC和由類實現：net.sf.jasperreports.ant.JRAntCompileTask。其語法和行爲是非常相似的內置 ANT任務。

模板編譯

讓我們添加新的目標編譯報表設計，以我們現有的build.xml。這裏使用與文件集的嵌套標籤中指定的源文件夾。嵌套的源標籤允許編譯器，可通過許多不同的地點分散，在一個單一的根報表源文件夾不進行分組報告模板。下面是修改後的build.xml：

接下來，讓我們打開命令提示符並轉到build.xml文件放置的目錄。執行命令ant（compilereportdesing是默認的目標）輸出爲如下：

C: oolsjasperreports-5.0.1 est>ant
Buildfile: C: oolsjasperreports-5.0.1 estuild.xml

compilereportdesing:
[jrc] Compiling 1 report design files.
[jrc] log4j:WARN No appenders could be found for logger
(net.sf.jasperreports.engine.xml.JRXmlDigesterFactory).
[jrc] log4j:WARN Please initialize the log4j system properly.
[jrc] log4j:WARN See
http://logging.apache.org/log4j/1.2/faq.htmll#noconfig
for more info.
[jrc] File :
C: oolsjasperreports-5.0.1 estjasper_report_template.jrxml ... OK.

BUILD SUCCESSFUL
Total time: 5 seconds

文件jasper_report_template.jasper是在文件系統（在我們的例子中爲 C: oolsjasperreports-5.0.1 est目錄）產生的。這個文件是相同的通過調用net.sf.jasperreports.engine.JasperCompileManager.compileReportToFile()程序生成一個。我們可以預覽這個 jasper文件，執行ant viewDesign。

JasperReports教程

JRXML提供編程編譯

模板編譯

預覽編譯報表模板

通過ANT任務編譯

模板編譯