PDF报表技术文档

《PDF报表技术文档》由会员分享，可在线阅读，更多相关《PDF报表技术文档（27页珍藏版）》请在金锄头文库上搜索。

1、 内部技术文档 业务层应用技术- PDF 报表技术报表技术 PDF 报表技术报表技术介绍 JasperReports 包结构，路径等。 介绍 iReport 总的开发流程 1.1 iReport 使用说明 1.2 简单的报表制作 1.3 动态报表制作 1.3.1 给报表传递参数 1.3.2 带查询的报表制作 1.3.3 动态设置查询条件的查询报表制作 1.4 如何插入图片 1.4.1 显示本地磁盘上的图片 1.4.2 显示数据库中的图片 1.5 JasperReports 和 struts2 的结合1.5.1 安装 JasperReports 插件1.5.2 配置生成 JasperReport

2、s 报表的 struts.xml 配置文件1.5.3 生成 JasperReports 报表 附注 1.iReport 中的分页控制： 2.iReport 中变量的介绍 3.工作区介绍4.分栏的设置 在企业级的 web 应用中，必须面临大量的报表问题，即将数据库中的数据形成报表并进行打印，在传统的开发中 我们一般只能使用 HTML 页面生成报表。这样不仅开发人员花大量时间来设计 HTML 报表，而且不支持导出别的格 式的报表。由于这种局限的存在，不能满足用户的需要 ，而 JasperReports 项目的出现解决了企业开发的这种困境。JasperReports 是一个强大的，灵活的报表生成工具

3、，能够生成 PDF,HTML,XML 格式的报表。这个工具是开源的， 我们可以免费的使用她，并且完全使用 java 写成，可以用在各种 java 应用程序中，包括 java C/S 应用、Web 中应用 生成报表。 （她的文档是收费的） 当然了我们要生成 PDF 报表肯定使用 JasperReports 组件了。 JasperReports 的开发是由一份 XML 格式的报表的文件开始的，设计好这个 XML 文件后，利用 JasperReports 的 API 进行编译，填充数据，导出或者浏览，这样可以生成多种格式的报表的文件。开发者只需提供一个 XML 格式的 报表设计文件，而其他的细节以及

4、底层的数据处理等对开发者来说是完全透明的。JasperReports 的使用： 首先，我们登录 JasperReports 的官方网站下载 JasperReports 的最新版本 jasperreports-3.0.0。 JasperReports 组件的文件结构：build：存放的是 JasperReports 项目编译后生成的*.class 文件。demo：存放的是 JasperReports 项目的演示文件，我们可以参考该路径下的演示来学习 JasperReports 框架的使 用。dist：存放的是 JasperReports 项目的二进制 JAR 文件，还包括了 JasperRepo

5、rts 项目的 API 文档。docs：存放的是两份 XML 文档，没有什么用。lib：存放的是 JasperReports 项目编译和运行所需的 JAR 文件。src：存放的是 JasperReports 项目的所有源文件。 为了在我们的项目中使用 JasperReports 项目，我们应该将 dist 路径下的 jasperreports-3.0.0.jar 文件复制到应用的 CLASSPATH 路径下。如果是 web 应用，将改文件复制到 Web 应用的 WEB-INF/lib 路径下。不过 JasperReports 框架生成其他格式的文档还依赖另外一些开源项目，如果生成 PDF 文档

6、依赖 iText 项目，将 JasperReports 的 lib 下的 itext- 1.3.1.jar 文件复制到系统的 CLASSPATH 路径下；如果要生成 Excel 文件，则应将 lib 下的 poi-3.0.1-FINAL- 20070705.jar 文件复制到系统的 CLASSPATH 路径下。 光有这些还不够，如果你的 CLASSPATH 路径下没有 apache 的 commons 组件的话，我们还得将 commons 组件 的部分 jar 包放到我们的 CLASSPATH 中有：commons-collections-2.1.jar,commons-logging-1.0

7、.2.jar,commons-digester- 1.7.jar, Commons-beanutils-1.7.jar.这些 jar 包在我们下载的 JasperReports 包中的 lib 路径下。此外还要一个 eclipse 提供的编译 的 jar 包，在我们下载的 JasperReports 包中 lib 路径下有这个编译的 jar 包，jdt-compiler-3.1.1.jar。 我在简单说一下 apache 下的这个 commons 组件：commons 组件就是一个开源的工具类的组合，集中解决了 java 的涉及的各个方面。在某些方面比 java se 提供的功能都强大。它的存

8、在目的是创建和维护独立于其他框架和产品的 组件。当然了这些包我们也可以单独使用，就想 java Jdk 一样作为我们项目的一部分，这样我们可以大大的缩短开发 周期。 总之：我们应该在 CLASSPATH 中必须要放 8 个 jar 包：commons 的四个：（commons-collections，commons- logging， commons-beanutils，commons-digester） ，eclipse 编译包（jdt-compiler） ，JasperReports 包（jasperReports） ，生成 pdf 的 包（iTex） ，我们肯定会打印中文，则还需要中文支

9、持的包（iTextAsian 包） 。在 itex 的官方站点下载。至此，所有的配置工作全部完成。 当我们成功的做了上述的工作，那么我们就可以在应用中使用 JasperReports 框架了。让我们一块体验她的魅力吧！不过，在开发报表之前还得先说一下 iReport 工具： 我们要想开发一个报表必须先定义一个报表设计文件即一个特殊的 XML 文件，这份 XML 文件中包含了大量的 JasperReports 标签，我们没有必要在去了解 JasperReports 标签的详细含义。设计 XML 此文件是相当的繁琐的。即使 设计一个简单的静态报表也要写上好多的代码，而且非常容易出错。好在有了 iR

10、eport 工具，iReport 也是开源组织 中的一款免费软件，主要作用就是用可视化的方式设计生成 JasperReport 所使用的报表格式文件，因为 JasperReport 本身并未提供很好的可视化报表设计工具，iReport 的出现正好弥补了这个缺陷。因此现在我们就不用在 亲自去设计那繁琐的又必须使用的 XML 文件了，使用 iReport 工具以所见即所得的方式来生成，这样大大的提高了工 作效率。JasperReports 和 iReport 结合起来使用，你会深深的被她们提供的功能所折服的！我们首先要在 www.jasperforge.org 下载 iReport 的最新版本。

11、(iReport-3.0.0.zip)。在压缩包解压后有一个 iReport.exe 文件，双击即可运行 iReport。在详细介绍之前，先总体的说一下开发报表的流程，让大家在整体上有个认识：1.开发人员开发报表设计文件，也就是定义一个*.jrxml 文件（就是最开始的那个 XML 文件） 。2.使用 JasperReports 提供 API 中的 JasperCompileManager 类编译*.jrxml 文件，编译后生成一个*.jasper 文件。3.使用 JasperReports 提供 API 中的 JasperFillManager 类填充编译后的*.jasper 文件，填充后生

12、成一个*.jrprint 文 件。4.使用导出管理器（JasperExportManager）或 者各种格式的文件导出器（JRXxxExporter）将*.jrprit 文件导出成 各种格式的报表文件。也可以使用 JRViewer 工具类来直接浏览报表。 开发流程图：1.1 iReport 使用说明 首先我们先开发一个静态的报表为例，介绍如何利用 JasperReports+iReport 开发 JasperReports 报表。 iReport 的应用： 这是个既简单有复杂的事情，说他简单是因为这里没什么任何技术含量，完全类此 word 的操作，说起复杂 是因为需要这些报表组合的具有一定的美

13、感。 1.1.1 双击 iReport.exe 文件，即可打开 iReport 主页面：我们一睹她的模样吧！1 单击菜单中的档案菜单，然后在选择“开启新档”菜单项，将出现下图：我们可以更改报表的名称，页边距的设置以及选择纸张的大小和类型。除次之外比较重要的一点就是：如果报表 文件需要使用中文字符，我们应单击 i18n 选项卡，在该选项卡的“XML 编码”输入框中输入 GBK。如图：2.我们大家都熟悉 word 了，word 中的分栏给我们带来极大的方便，同样在 pdf 报表中分栏也是必不可少的，我 们也可以通过设置对 pdf 报表进行任意次的分栏。上两个图的“字段数”选项卡，我们都看见了吧！单

14、击该选项卡得到下图：字段数输入框的数就代表了所分的栏数，默认是 1，也就是不分栏。如果要分两栏我们把他改成 2 即可。 1.1.2 主页面的各个工作区介绍： 1.设置文本格式的工具按钮：2.文本排列工具按钮：3.资源管理器：4.控制台：5.中间空白的一大部分则是报表设计区了。 6.最后介绍我们常用的，也是最重要的一个：我们经常要用到的就是“T” ， “F”这两个按钮了。“T”添加静态文本。 “F”添加文本字段。 （动态） 。其他按钮我们可以尝试的试试它们的功能。1.2 简单报表制作 （一） 、首先我们要做重要一步，打印出中文，这不是必不可少的，那就是为当前报表建一个风格(Style),并设置

15、为当前默认风格。 步骤：1. 单击菜单中的格式菜单，然后在选择“Style”菜单项，将出现下图：2单击“New”按钮：出现 Add/Modify Styles 对话框：3.Add/Modify Styles 对话框设置：3.1 设置 Styles 标签：在 Styles name 中输入一个名字，名字任意，并设置成默认的风格：设置后如图：3.2 设置 Text Properties 标签：拖动滑动块，在下面可以看到 Text Propertise 标签：接着点击 Font 选项后的按钮，将弹出如下对话框：在这个对话框中，我们将对打印中文问题进行设置，其中主要设置有两项： PDF Font Na

16、me 设置为：STSong-Light PDF Embedded 设置为：UniGB-UCS2-H (Chinese Simplified) 设置后如图：然后点击 OK 即可。打印中文的 PDF 报表设置完成。 至此，总结一下，PDF 中要想打印中文有三个地方要设置：第一，中要想打印中文有三个地方要设置：第一，CLASSPATH 中必须增加中文支持包中必须增加中文支持包 iTextAsian。第二，在。第二，在 i18n 标签中标签中 XML 编码必须是编码必须是 GBK（要手动输入）（要手动输入） 。第三，要设置。第三，要设置 PDF Font Name和和 PDF Embedded。（二） 、通过“T”添加静态文本:来制作一个简单的报表：单击“T”按钮，然后在设计区进行拖拽：插入静态文本后的报表如图：然后保存，保存后便可得到一个*.jrxml 文件。假设我们保存为 test.jrxml 放在 C 盘根目录下。这个文件相当于我 们手工编写