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

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

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

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

4、<queryString><![CDATA[]]></queryString><fieldnam髫潋啜缅e="country"class="java.lang.String"><fieldDescription><![CDATA[country]]></fieldDescription></field><fieldname="name"class="java.lang.String"><fieldDescription><![CDATA[name]]></fieldDescription></field><columnHeader><bandheight="23"><staticText><reportElementmode="Opaque"x="0"y="3"width="535"height="15"backcolor="#70A9A9"/><box><bottomPenlineWidth="1.0"lineColor="#CCCCCC"/></box><textElement/>

5、下面的代码演示了上述ja衡痕贤伎sper_report_template.jrxml文件的编译。packagecom.yiibai;import荏鱿胫协net.sf.jasperreports.engine.JRException;importnet.sf.jasperreports.engine.JasperCompileManager;publicclassJasperReportCompile{publicstaticvoidmain(String[]args){StringsourceFileName="C://tools/jasperreports-5.0.1/test"+"/jasper_report_template.jrxml";System.out.println("CompilingReportDesign...");try{/***Compilethereporttoafilenamesameas*theJRXMLfilename*/JasperCompileManager.compileReportToFile(sourceFileName);}catch(JRExceptione){e.printStackTrace();}System.out.println("Donecompiling!!!...");}}模板编译至于下一步，让我们保存上面的文件内容：C:\tools\jasperreports-5.0.1\test\src\com\yiibai\JasperReportCompile.java并导入baseBuild.xml在为下面的build.xml文件。baseBuild.xml已经编译和运行的目标：<?xmlversion="1.0"encoding="UTF-8"?><projectname="JasperReportTest"default="run"basedir="."><importfile="baseBuild.xml"/></project>接下来，让我们打开命令行窗口并转到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'wasnotset,defaultingtobuild.sysclasspath=last;settofalseforrepeatablebuilds[javac]Compiling1sourcefiletoC:\tools\jasperreports-5.0.1\test\classesrun:[echo]Runninclass:com.yiibai.JasperReportCompile[java]CompilingReportDesign...[java]log4j:WARNNoappenderscouldbefoundforlogger(net.sf.jasperreports.engine.xml.JRXmlDigesterFactory).[java]log4j:WARNPleaseinitializethelog4jsystemproperly.[java]Donecompiling!!!...BUILDSUCCESSFULTotaltime:8seconds正如上文编译的结果，会看到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。<?xmlversion="1.0"encoding="UTF-8"?><projectname="JasperReportTest"default="viewDesign"basedir="."><importfile="baseBuild.xml"/><targetname="viewDesign"description="Designviewerislaunchedtopreviewthecompiledreportdesign."><javaclassname="net.sf.jasperreports.view.JasperDesignViewer"fork="true"><argvalue="-F${file.name}.jasper"/><classpathrefid="classpath"/></java></target></project>让我们执行命令：ant（viewDesign是默认的目标），在命令提示符下。JasperDesignViewer窗口打开显示Jasper文件如下：

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

7、<?xmlversion="1.0"encoding屏顿幂垂="UTF-8"?>媪青怍牙<projectname="JasperReportTest"default="compilereportdesing"basedir="."><importfile="baseBuild.xml"/><targetname="viewDesign"description="Designviewerislaunchedtopreviewthecompiledreportdesign."><javaclassname="net.sf.jasperreports.view.JasperDesignViewer"fork="true"><argvalue="-F${file.name}.jasper"/><classpathrefid="classpath"/></java></target><targetname="compilereportdesing"description="CompilestheJXMLfileandproducesthe.jasperfile."><taskdefname="jrc"classname="net.sf.jasperreports.ant.JRAntCompileTask"><classpathrefid="classpath"/></taskdef><jrcdestdir="."><src><filesetdir="."><includename="*.jrxml"/></fileset></src><classpathrefid="classpath"/></jrc></target></project>

8、接下来，让我们打开命令提示符并转到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文件，执行antviewDesign。