Jasperreport和iReport详细功能介绍

JasperReport和IReport报表开发的功能介绍

目录

1 简介 (4)

2 JasperReport和IReport的安装与配置 (4)

2.1 JDK的下载、安装和配置 (4)

2.2 ANT的下载、安装和配置 (5)

2.3 Jasperreport的下载、安装和配置 (6)

2.4 iReport的安装和配置 (7)

3 主要功能和实现过程 (7)

3.1 XML解析 (8)

3.2编译报表设计 (8)

3.3 Report Design 预览 (9)

3.4报表填充 (10)

3.5查看报表 (11)

3.6打印报表 (11)

3.7导出报表 (11)

3.8对象的载入和保存 (11)

4 iReport的使用指南 (12)

4.1一个简单的报表 (12)

4.2报表预览 (13)

4.3使用数据库的数据生成报表 (15)

5 报表设计 (18)

5.1DTD Reference (18)

5.2XML编码 (19)

5.3报表属性 (19)

6 报表数据 (21)

6.1表达式 (21)

6.2参数 (22)

6.3数据源 (24)

6.4查询报表 (25)

6.5字段 (26)

6.6变量 (28)

7 Report Sections (31)

7.1 Main Report Sections (31)

7.2 数据分组 (36)

8 脚本程序 (38)

9 报表元素 (38)

9.1文本元素 (40)

9.2图像元素 (45)

9.3超链接 (48)

9.4元素组 (48)

10 子报表 (49)

10.1子报表参数 (50)

10.2子报表数据源 (50)

11高级JasperReports应用 (50)

11.1 XML报表的导入和设计 (50)

11.2实例化数据源接口 (50)

11.3自定义查看器 (50)

11.4导出新的格式 (51)

1 简介

Jasperreport是一款报表打印组件，是开放源代码组织https://www.360docs.net/doc/6a9378324.html,中的一个java报表打印工程，是一款功能强大的报表生成工具。它既可以将报表内容在显示器上输出，也可以通过打印机打印出来，同时它还支持使用PDF、HTML和XML等多种文件格式进行存储。在不久的将来，诸如CSV、XLS、RTF等格式也将会被兼容。

iReport也是开源组织https://www.360docs.net/doc/6a9378324.html,中的一款免费软件，其主要作用是用来以可视化的方式设计生成JasperReport所使用的报表格式文件，因为JasperReport本身并未提供很好的可视化报表设计工具，iReport的出现正好弥补了这个缺陷。

2 JasperReport和IReport的安装与配置

2.1 JDK的下载、安装和配置

下载

JDK的最新版本可以从SUN 公的官方网站上下载得到，网址为https://www.360docs.net/doc/6a9378324.html, ，JDK共分为3 个版本，J2ME,J2SE,J2EE，因为是在计算机上使用，我们需要下载使用 J2SE SDK，如果您的计算机是用来做软件开发，需要下载J2SE SDK，如果是用来运行已经编译好的JAVA 程序的，可以只下载J2SE JRE 即可。

下载JDK 时SUN 公司会要求你同意一个JDK 的使用许可协议，选接受协议后，会出

现选择适合不同的操作系统平台使用的JDK 版本选择的界面，您可以根据自己使用的操作系统平台选择适合的JDK 版本。

安装

以Windows 平台的安装为例，在安装的过程中一路Next 即可，同时请注意记录下JDK 安装后的目录，稍后进行配置时要用到。

配置

以在Windows xp平台配置J2SE SDK 为例，鼠标右键点击桌面上的“我的电脑”图标，在弹出的菜单中选择属性，选择“高级”选项，选择“环境变量”。

点击“系统变量”下的新增按钮，在对话框中的变量名处输入大写的JAVA_HOME，在变量值处输入的JDK 安装目录。

点击“确定”完成第一步的配置，接下来以同样的方法配置系统环境变量CLASSPATH，在CLASSPATH的变量值处输入%JAVA_HOME%\lib\tools.jar; %JAVA_HOME%\lib\dt.jar，当然，也可以直接输入绝对路径，但建议使用%JAVA_HOME%的方式。

再接下来还要修改系统环境变量PATH,增加%JAVA_HOME%\bin 目录。

至此JDK 的配置也完成.

打开一个命令行窗口，键入set classpath 与set java_home 应该可以看到正确的配置信息，同时，输入javac -version 看系统能否找到JAVA 的编译器。

2.2 ANT的下载、安装和配置

ant 是个很好用的工具，虽然对于JasperReport 和iReport 来说ant 并不是必须的，但还是建议以使用ant 的方式来应用。

ANT的下载和安装

ant 是apache 组织的一个子项目，可以从https://www.360docs.net/doc/6a9378324.html, 下载得到，Windows 平台

的可以下载ZIP 格式的安装文件，下载完成以后解压缩到某个目录，建议使用根目录下的直接子目录作为ant 解压缩以后目录，ant 无需安装，解压缩文件以后就算安装完成。

Ant的配置

与设置JDK相同的操作过程打开系统环境变量设置窗口，增加ANT_HOME环境变量，变量值为解压缩以后的ant 所在目录

在系统的环境变量Path 中增加%ANT_HOME%\bin 目录

新开一个命令行窗口，输入ant 后如果出现如下图所示内容即算正确完成ant 的配置。

2.3 Jasperreport的下载、安装和配置

Jasperreport的下载和安装

因为JasperReport 是https://www.360docs.net/doc/6a9378324.html, 的开源项目，最新的JasperReport 版本可以在https://www.360docs.net/doc/6a9378324.html, 中找到，同时，为了方便世界各国程序员下载，https://www.360docs.net/doc/6a9378324.html, 还设有许多的镜像站点供你选择。

强烈建议下载jasperreport 的source.zip，因为这里面包含了很多的示例程序，对于想深入研究jasperreport 的人来说会有很大的帮助。如果不想对JasperReport 有太多的深入了解，只需要下载.jar 文件就能正常开发应用了。

没有必要单独为JasperReport.jar 文件设置目录，建议放在系统中%JAVA_HOME%\lib\

目录中。

Jasperreport的配置

将JasperReport-x.x.x.jar 文件添加到操作系统的环境变量ClASSPATH 中即可完成JasperReport 的配置。

2.4 iReport的安装和配置

iReport的安装

iReport 在Windows 平台也是以.zip 形式的文件提供的，直接解压缩后就算完成了安装

如果是2.x版的，且您决定以ant 的方式运行iReport 程序，需要修改一下iReport 目录中的ireport.bat 文件中的内容，第一次运行ireport.bat 会生成javadoc，在确定已正确生成javadoc 文件后可以将生成doc 的那一段注释掉以便以后可以快速的启动iReport 程序。

3.0 版无需修改ireport.bat 文件。

i Report 的使用

在有ant 环境的下运行iReport，直接运行iReport 目录中的ireport.exe 即可。

在没有ant 的环境下运行iReport，2.X 版本使用iReport 目录中的noant 目录中的startup.bat 运行，3.0 版本使用bin 目录中的startup.bat 运行。

3 主要功能和实现过程

现在我们将对XML报表设计进行分析，编译，装填数据，预览结果和导出到其他格式的过程。

Jasperreport的实例

下面是Jasperreport工具，将XML报表转变成的各种类型报表的流程图：

3.1 XML解析

JasperReport使用SAX2.0 API对XML文件进行解析。然而，这并不是必须的，用于可以在执行其自行决定使用哪一种XML解析器。

JasperReport使用org.xml.sax.helpers.XMLReaderFactory类的createXMLReader()来获得解析器实例。在这种情况下，就像在SAX2.0文档中说的那样，在运行期，把Java 系统属性org.xml.sax.driver的值设定为SAX driver类的全限定名是必要的。

设置系统属性有两种方法：

第一种方法是在你启动Java虚拟机的时候，在命令行窗口使用-D开关：

java -Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser MySAXApp sample.xml

在JasperReport提供的所有例子中，都采用ANT构建工具来执行不同的任务。我们通过使用内置的 task中的元素来提供这一系统属性；

第二种设置系统属性的方法是使用

https://www.360docs.net/doc/6a9378324.html,ng.System.setProperty(String key, String value)

System.setProperty(“org.xml.sax.driver”,

“ org.apache.xerces.parsers.SAXParser”);

Jsp/compile.jsp和web-inf/class/servlets/CompileServlet.java文件提供了这方面的例子。

3.2 编译报表设计

为了生成一个报表，用户首先需要完成报表的设计，生成方法或采用直接编辑XML文件，或通过程序生成一个net.sf.jasper.engine.design.JasperDesign对象。在此，主要采用编辑XML文件的方法，因为这种方法在目前是使用JasperReport类库的最好的方法。

XML报表设计是JasperReport用来生成报表的初级材料。这是因为XML中的内容需要被编译并载入到JasperDesign对象中，这些对象将在报表引擎向其中填入数据之前，必须经过编译过程。

报表编译过程的主要目的是生成并装载含有所有报表表达式的类的字节码。这个动态生成的类将会被用来在装填数据，并在给所有报表表达式求值的时候使用。具体例子是，如果你用iReport生成一个报表名字叫SimpleSheetTest，它的XML设计文件名叫SimpleSheetTest.jrxml，同时和它在同一目录下iReport会自动生成一个文件名为SimpleSheetTest.java，里面主要是一些报表元素，如Field，Parameters，Variables的定义，以及一些求值表达式。当然，像上面提到的，这个文件在你直接使用JasperReport API 的时候是看不到的，因为它是在执行期生成的一个Class。要想看到它的办法是：在IDE （JBuilder，Eclipse）中单步执行程序，在报表打印的阶段，你将能跟踪到这个类，它的名字就是“你的报表名.java”，按上面的例子就是SimpleSheetTest.java，这和iReport 是一致的。当然也可以像下面说的那样，到生成这个类的临时目录里找到它。

在这个类生成过程之前，JasperReport引擎需要验证报表设计的一致性，哪怕存在一处验证检查失败都不会继续运行下面的工作。

对于这个包含了所有报表表达式的类的字节码，我们至少需要关心三个方面的内容：临时工作目录、Java 编译器的使用、Classpath

为了能够编译Java源文件，这个文件必须被创建并且被保存到磁盘上。Java编译过程的输出是一个.class文件，这个包含所有报表表达式的类在这个工作目录里被创建并编译，这也是为什么JasperReport需要访问这个临时目录的原因。当报表的编译过程结束之后，这些临时的类文件将被自动删除，而生成的字节码将保存在

net.sf.jasper.engine.JasperReport对象中。如果需要的话，这个类可以将自己序列化并保存到磁盘上。这就是iReport的做法。

缺省情况下，这个临时工作目录就是启动JVM时的当前目录，这却取决于JVM的系统属性user.dir。通过更改系统属性https://www.360docs.net/doc/6a9378324.html,pile.temp，用户可以很容易更改这个工作目录。在Web环境下，特别是当你不想让含有启动Web Server的批处理文件的目录和报表编译过程的临时工作目录混在一起的时候，修改这个属性就可以了。

上面提到的第二个方面涉及用来编译报表表达式类的Java编译器。首先，报表引擎将试图使用sun.tools.javac.Main类来编译Java源文件。这个类包含在tools.jar中，当且仅当这个jar文件在JDK安装目录下的bin/目录中，或在classpath中时，sun.tools.javac.Main 才能正常使用。

如果JasperReport不能成功装载sun.tools.javac.Main文件，程序将动态执行java 编译过程，就像我们通常用命令行那样，使用JDK安装目录下的bin/目录下的javac.exe。这就是为什么将JDK安装目录/lib/下的tools.jar文件copy到JasperReport工程的lib/目录下是一个可选的操作（optional operation）。如果tools.jar不在classpath中，JasperReport将显示错误信息并继续上面提到的操作。

当编译Java源文件的时候，最重要的事情莫过于classpath。如果Java编译器不能在指定的classpath中找到它试图编译的所有相关类的源文件，则整个过程将失败并停止，错误信息将在控制台显示出来。同样的事情也将发生在JasperReport试图编译报表表达式类的时候。所以，在runtime为编译过程提供正确的classpath是非常重要的。例如，我们我们需要确认在classpath中，我们提供了在报表表达式中可能用到的类（custom class）。

在这个方面也有一个缺省的行为。如果没有为编译report class特殊指定classpath，引擎将会使用系统属性java.class.path的值来确定当前的JVM classpath。如果你指定了系统属性https://www.360docs.net/doc/6a9378324.html,pile.class.path的值，你可以用你定义的classpath来覆盖缺省行为。

大多数情况下，编译一个report只需要简单的调用JasperReport类库中的https://www.360docs.net/doc/6a9378324.html,pileReport(myXmlFileName);即可。调用之后将生成编译好的report design并存储在.jasper文件中，这个文件将会保存在和提供XML report design 文件相同的目录中。

3.3 Report Design 预览

JasperReport类库并没有提供高级的GUI工具来辅助进行设计工作。但是目前已经有至少4个project试图提供这样的工具。然而，JasperReport本身提供了一个很有用的可视化组件来帮助报表设计者在编译的时候预览报表设计（其实不如直接用IReport方便）。net.sf.jasper.view.JasperDesigner是一个基于Swing的Java应用程序，它可以载入并显示XML形式或编译后的报表设计。尽管它不是一个复杂的GUI应用程序，缺乏像拖拽可视化报表元素这样的高级功能，但是它仍然是一个有用的工具。所有JasperReport工程提供的例子都利用了这个报表查看器。

如果你已经安装了ANT，想要查看一个简单的报表设计，你只需要到相应的文件夹下输入如下命令：

ant viewDesignXML 或者 ant viewDesign

如果你没安装ANT，要达到上面的效果就不是很容易，因为JasperReport本身需要一些其他辅助的jar包（在JasperReport安装目录/lib下），在运行的时候，你需要把这些jar包都包含到你的classpath里面，并且正确设计系统属性，如上面提到的org.xml.sax.driver。我可以展示一下在windows下的例子：

>java -classpath ./;../../../lib/commons-digester.jar;

../../../lib/commons-beanutils.jar;../../../lib/commons-collections.jar;

../../../lib/xerces.jar;../../../lib/jasperreports.jar

-Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser

dori.jasper.view.JasperDesignViewer -XML -FFirstJasper.xml

3.4报表填充

报表填充过程是JasperReport library最重要的功能。它体现了这个软件最主要的目的，因为这一过程可以自由的操作数据集，以便可以产生高质量的文档。有3种材料需要装填过程中作为输入提供给JasperReport：report design、参数、数据源

这一过程的输出通常是一个单一的最终要被查看，打印或导出到其他格式的文档。要进行这一过程，我们需要采用net.sf.jasper.engine.JasperFillManager类。这个类提供了一些方法来让我们填充报表设计，report design的来源可以是本地磁盘，输入流，或者直接就是一个已存在于内存中的net.sf.jasper.engine.JasperReport类。输出的产生是于输入类型相对应的，也就是说，如果JasperFillManager接到一个report design的文件名，填充结束后生成的report将会是一个放在磁盘上的文件；如果JasperFillManager收到的是一个输入流，则生成的report将会被写到一个输出流中。

有些时候，这些JasperFillManager提供的方法不能满足某些特定的应用的要求，例如可能有人希望他的report design被作为从classpath中得到的资源，并且输出的报表作为一个文件存放在一个指定的磁盘目录下。遇到这种情况时，开发人员需要考虑在将报表设计传递给报表装填过程之前，用net.sf.jasper.engine.util.JRLoader类来装载report design对象。这样，他们就能获得像报表名这样的report design属性，于是开发者就能生成最终文档的名字，并将它存放到所需的位置上。

在现实中，有许多报表装填的情境，而装填管理器仅试图覆盖其中最常被使用到的部分。然而对于想要自己定制装填过程的人来说，只要采用上面所说的方法，任何开发者都可以达到满意的结果。

报表参数通常作为java.util.Map的value提供给装填管理器，参数名为其键值。

作为装填过程所需的第三种数据源，有如下两种情况：

通常，引擎需要处理net.sf.jasper.engine.JRDataSource接口的一个实例，通过这个实例，引擎可以在装填过程中获取所需数据。JasperFillManager提供的方法支持所有的JRDataSource对象。

然而，这个管理器还提供一些接受java.sql.Connection对象作为参数的方法集，来取代所需的数据源对象。这是因为在很多情况下，报表生成所需的数据都来源于某个关系型数据库中的表。

在报表中，用户可以提供SQL查询语句来从数据库中取回报表数据。在执行期，engine 唯一需要做的是获得JDBC connection对象，并使用它来连接想要连接的数据库，执行SQL 查询并取回报表数据。在后台，引擎将使用一个特殊的JRDataSource对象，但是它对于调用它的程序来说是透明的。

JasperReport工程提供了相关的例子，它们采用HSQL数据库服务器（在工程文件中，有一个相应的文件夹），要运行这些例子你需要首先启动该服务器，方法是：在/demo/hsqldb 目录下输入如下命令：>ant 或者 >ant runServer

没装ANT就麻烦点：>java -classpath ./;../../lib/hsqldb.jar org.hsqldb.Server

一下代码片断显示了query例子是如何装填数据的：

//Preparing parameters

Map parameters = new HashMap();

parameters.put("ReportTitle", "Address Report");

parameters.put("FilterClause", "'Boston', 'Chicago', 'Oslo'");

parameters.put("OrderClause", "City");

//Invoking the filling process

JasperFillManager.fillReportToFile(fileName, parameters, getConnection());

3.5 查看报表

报表填充阶段的输出通常是一个JasperPrint对象，如果把它保存在磁盘上，通常以一个.jrprint文件的形式存在。JasperReport拥有一个内置的查看器，用来查看用内置的XML导出器获得的XML格式的报表文件。这个查看器就是以前提到过的net.sf.jasper.niew.JRViewer，用户可以通过继承这个类来定制自己所需的查看器。JasperReport工程中自带的例子webapp中，你可以阅读JRViewerPlus类的代码来获取进一步内容。

3.6 打印报表

JasperReport类库的主要目标，就是生成可打印的文档。而且多数应用程序生成的报表都是需要打印到纸张上。我们可以用net.sf.jasper.engine.JasperPrintManager来打印JasperReport生成的文档。当然，报表也同样可以在被导出到其他格式如PDF，HTML之后再被打印。通过JasperPrintManager提供的方法，我们可以打印整个文档，打印单个文档或打印某一范围内的文档，可以显示打印对话框也可以不显示。下面的例子演示了不显示对话框，打印整个文档的方法：JasperPrintManager.printReport(myReport,false);

3.7 导出报表

在一些应用程序环境下，将JasperReport生成的文档从其特有的格式导出到其他更为流行的格式如PDF，HTML是非常有用的。这样一来，其他人就可以在没有安装JasperReport 的情况下查看这些报表，特别是当这些文档要通过网络发送出去的时候。

JasperReport提供了JasperExportManager类来支持此项功能。这项功能将会在以后不断加入对新的格式的支持。目前，JasperReport主要支持导出PDF，HTML和XML类型的文档，下面是导出的代码片断：JasperExportManager.exortReportToHtmlFile(myReport);

注意：想要将自己的报表导出到其他格式的用户，需要实现JRExporter的接口，或继承相应的JRAbstractExporter类。

3.8 对象的载入和保存

当使用JasperReport的时候，你经常会与序列化的对象，如以编译的报表设计，或已生成的报表打交道。有时，你需要手动载入从不同的source如input stream或你用类库核心功能产生的序列化类。JasperReport提供了两个特殊的工具类来提供上述操作的能力，这些类通常供报表引擎自己使用：

net.sf.jasper.engine.util.JRLoader

net.sf.jasper.engine.util.JRSaver

第一个类提供了一些方法让我们能够从不同类型的数据源如文件，URL，input stream 和classpath里面获取序列化对象。最令人感兴趣的方法是loadObjectFormLocation(String)。它已经在上一章中介绍过了，这里不再赘述。

与上面的对象载入工具相反的部分是JRSaver类，它可以帮助程序员将自己的类序列化之后存放到本地磁盘或通过Output Stream发送到网络上去。

有时，开发人员可能想要载入已经生成好的report，或最终的已经被导出到XML格式的JasperReport文档，这与上面所说的直接load序列化对象有所不同。这时，我们需要载入的是将载入的XML内容进行编译，并生成JasperPrint对象，而并非仅仅是载入序列化对象。这时，我们可以通过net.sf.jasper.engine.xml.JRPrintXmlLoader类的一些静态方法，通过编译从XML文件中读取的内容构建出一个位于内存中的文档对象。

4 iReport的使用指南

4.1一个简单的报表

如上面左图所示新建一个文档，如右图设置报表的名称、大小等属性。

依照上图的标识，分别设计报表的各部分，可以通过以下快捷方式来插入图形、静态文字、动态文字图片等元素，设计如下图

报表设计完毕，选择菜单栏中的“建立”下拉菜单，选择其中“编译”，对报表尽进行编译，如有错误，会在底端提示，若无错误，则生成.Jrxml文件。编译成功之后，选择“执行报表”，进行预览。

4.2 报表预览

Ireport默认是用其自带的iReport JasperViewer进行预览。我们可以选择其他的预览方式，通过选择菜单栏中的“Option”下拉菜单，选择其中的“选项”，选择External Programs选项卡，如下图所示，对各个预览工具进行配置

后选择“执行报表”，就可以用相应的应用程序对其进行预览。

4.3 使用数据库的数据生成报表

4.3.1连接数据库

选择菜单栏中的“data”下拉菜单，选择“连结/资料来源”，

选择“New”新建一个连接，配置如下图，其中experiment是已建立的数据库名称

单击“Test”，测试数据库连接是否成功，若成功，有以下对话框

若不成功，有类似于下图的相应的对话框

测试成功，单击“save”保存新建连接。

4.3.2设置SQL查询语句

选择菜单栏中的“data”下拉菜单，选择“报表查询”，

之后在相应地方编写SQL语句。编写完毕，单击“OK”保存并退出编写。

4.3.3字段在报表设计器中的使用

点击工具栏中的在报表中的“Details”段中用鼠标拖拽到适合的大小，右击该字段框，选择属性，在选择Text Fiel选项卡，如下图：

选中Text Field 项，如果没有设置正确的字段名称，则Textfield expression 中的内容将显示

蓝色，手工修改Textfield expression 中的内容为正确的字段名称，格式为$F{字段名称}，正确修改后将变为绿色显示。

4.3.4编译与预览带有字段的报表

对下面报表进行编译，其中数据已经在数据库中预先设好

编译报表可以选择菜单栏中“建立”下拉菜单中的“编译”，也可以直接点击工具栏中的

图标，如果编译过程正确完成，iReport 设计器的下面会显示如下内容：

带有字段的报表进行预览有两种方式，一种是不使用数据库中的数据，默认所有字段值为null 的方式，预览方法为选择“建立”菜单中的“执行报表”，也可以直接点击工具栏中的图标；第二种方式为使用数据库中的数据的方式，预览方法为选择“建立”菜单中的“执行报表（使用动态连接）”，也可以直接点击工具栏中的图标。下图进行预览：

5 报表设计

报表设计体现了一个模板，JasperReport引擎利用这个模板将同台生成的内容传递给打印机，屏幕或Web。存储在数据库中的数据在报表装填的过程中被组织起来，根据已有的报表设计来获得可以进行打印的，面向页面的（page oriented）文档。

总而言之，一个报表设计包含了所有的结构相关信息和将数据提供给报表所涉及的各个方面。这些信息涉及将在文档中显示出来的各种text或图像元素的位置和内容，自定义计算（custom calculation），数据组织，报表生成时的数据操作，等等。

报表设计通常都定义在一个拥有特殊格式的XML文档中，并且在被填充数据之前要经历JasperReport的编译过程。然而JasperReport也允许用户通过JasperReport提供的API 构造in-memory报表对象，例如noxmldesign就是很好的例子。

5.1 DTD Reference

当使用XML文件进行报表设计的时候，JasperReport将使用内置的DTD文件来验证其受到的XML内容的有效性。如果XML验证通过，则说明所提供的报表设计符合JasperReport 所需要的XML结构和语法规则，其引擎能够生成经过编译的report design。

有效的XML文档总是在验证时指向JasperReport的内部DTD文件。如果没有提供DTD 文档的引用，报表的编译过程将会突然结束。这对所有人来说都是一个负担，因为DTD引用通常是相同的，并且这些引用可能会简单的被从以前的报表设计中copy过来。在一开始，你需要将这个引用从给定的例子中copy过来。

正如以前说的一样，报表引擎仅能识别指向其内部DTD文件的的引用。你不能随便从类库的源文件中将那些DTD文件copy到别的地方，再在你的报表设计文件中指向你copy的那些DTD文件。如果你想那样做的话，你将需要调整类库中某些类，包括dori.jasper.engine.xml.JRXmlDigester类的某些代码。如果你遇到像引擎无法找到其内部的DTD文件而导致的无法载入资源的问题，请确定你已经在使用外部DTD文件之前排除了所有可能发生的情况。遇到这样的问题是不太可能的，因为资源载入机制会随着时间不断改进。

JasperReport只有两种合法的XML报表设计的DTD引用，他们是：

或者：

XML报表设计的根元素是，下面是一个普通的JasperReports XML报表设计文件的样子：

...

前三点描述了该报表设计的属性和设置，下面省略的部分则描述了各种报表设计要素如报表参数、字段、变量、组和报表栏等。

5.2 XML 编码

当要生成不同语言的XML报表设计的时候，在XMl文件的首部的编码属性需要特别关注一下。缺省情况下，如果这个属性的值没被订制，则XML解析器将会使用“UTF-8”作为XML 文件的编码格式。这一点是非常重要的，因为报表设计通常包含了静态的本地化文本。

对于大多数西欧语言来说，ISO-8859-1编码，也就是我们常说的LATIN1将会很好的处理如法语中重音符号的显示问题。

在编辑XML文件的时候，要找到某种特殊语言的编码类型，你可以查看XML document.FIXME。

5.3 报表属性

我们上面已经看到，XML报表设计的根元素。这一节我们将介绍报表设计对象的Property的细节以及这些属性所对应的XML attributes

报表名称

每一个报表都必须有一个名称。这个名称是相当重要的，因为类库需要它来生成文件，尤其是当编译，装填，导出报表的默认行为被使用的时候，这个名的作用更为重要。这个名称是以元素的name attribute的形式提供的，并且是强制必须填写。

列数

JasperReport允许生成每页的列数超过一列的报表，正如下面的图片，展示了拥有两列的报表：

默认情况下，报表引擎生成每页一列的报表。

打印顺序

对于拥有超过一列的报表，为其提供列将被以什么顺序填充是很重要的。你可以使用元素的printOrder attribute来进行设置。有如下两种情况：

●Verticaln Filling：这个选项将导致列是自顶向下被填充（printOrder=”Vertical”）●Horizontal filling：列将自左向右被填充（printOrder=”Horizontal”）

缺省设置将是printOrder=Vertical

页面大小

有两个attribute是用来提供要生成的文档大小的：pageWith，pageHeight。像所有其他显示元素位置和尺寸的attribute一样，这两个attribute是以像素为单位的。JasperReport采用Java默认的每英寸72点的设置。这意味着pageWith=”595”将大约是8.26英寸，这大概是A4纸的尺寸。

默认的纸张大小是A4纸：pageWith=”595” pageHeight=”842”

Page Orientation（默认设置为Portrait）

orientation属性用来设置文档打印格式是“Portrait”还是“Landscape”。JasperReport允许用户在从“Portrait”切换到“Landscape”的时候调整液面的宽度和高度。我们先看一个例子：我们假定要生成一个A4纸的报表，采用“Protrait”格式：

pageWidth=”595” pageHeight=”842” orientation=”Portrait”

如果我们决定用A4纸的“Landscape”布局，首先要调整相应的页面宽度和高度：

pageWidth=”842” pageHeight=”595” orientation=”Landscape”

这是因为JasperReport需要确切知道它所要绘制的报表页的宽度和高度，而不只看我们提供的orientation属性，至少在报表装填的时候是这样。orientation属性仅在报表打印时有用，来通知打印机或某些exporters页面的orientation设置。

页边距

一旦页面大小确定下来，用户就可以在生成报表的时候设定报表的边距。有四个属性来完成这项工作：topMargin，LeftMargin，bottomMargin和rightMargin。缺省的设置是上下边距20像素，左右边距30像素。

列宽和列间距（Column Size and Spacing）