《报表傻瓜式文档》由会员分享，可在线阅读，更多相关《报表傻瓜式文档（9页珍藏版）》请在金锄头文库上搜索。
1、JasperReports报表傻瓜式文档1 需求说明在中石化信贷系统需要在WEB页面上提供批复单和签报单的下载，客户提出要使用Jasper Reports报表（以下简称JR）技术。具体的是要提供批复单和签报单的PDF格式文档下载，PDF格式的报表中包括领导签名图片。2 技术说明为实现上述需求采用Jasper Reports技术。该技术可以将IRepot设计好的报表与来自javat程序生成的数据进行填充，生成PDF文档。报表的内容由两部分组成，一部分由报表设计工具设计好的固定部分（IRport设计的报表），另一部分是由程序传递的值（可以是一维的变量值，也可以是二维的变量如list.另外也包括图片
2、）。3 系统整合由于华腾的框架中以经包含有Jasper Reports所需的Jar包：jasperreports-2.0.5.jarjasperreports-2.0.5-applet.jarjasperreports-2.0.5-javaflow.jar以及处理中文的相关Jar包：itext-1.3.1.jariTextAsian.jar4 开发实现JasperReports技术的具体开发应用分为以下两个阶段4.1 报表模板制作JasperReports报表设计工具有IReport Designer,JasperSoft Studio,JasperAssistant等等，下面的设计采用IRe
3、port作为设计工具。iReport是一个可视化的报表模板设计工具，使用此工具能方便地对报表进行设计。在iReport中已经包含了jasperreports在运行时需要的jar文件，在项目中的lib目录中包含Jasperreports-*.jar即可，其中*为版本号，比如2.0.5。iReport的安装包在“99-其它JasperReport开发文档整理soft”文件夹中。iReport-2.0.5-windows-installer.exe。安装iReport需要先设置JDK环境，2.0.X版本要求JDK1.5环境。4.1.1 Step1:iReport安装：如果是windows系统，直接双
4、击安装图标以下以在windows上安装为例：4.1.1.1 A欢迎界面，点击“Next ”继续4.1.1.2 B.阅读license内容，点击“I Agree”继续4.1.1.3 C.选择安装组件，点击“Next ”继续4.1.1.4 D.指定安装路径，点击“Next ”继续4.1.1.5 E.指定程序组名称，点击“Install”即可4.1.1.6 F.等待安装过程4.1.1.7 G.安装结束，点击“Finish”完成在桌面上会出现如此图标：4.1.2 Step2:iReport设置4.1.2.1 A启动iReport，如图：iReport启动会根据运行的机器的Locale属性自动设置软件语
5、言（Language），这里可能会出现一些偏差，笔者使用的是简体中文，但启动后设计界面是繁体中文，因此我们需要对其进行设置。4.1.2.2 B设置默认语言工具栏-“工具”（或“Option”）-“選項”更改语言种类，从下来菜单中选择“中文（中国）”。如果打开就是此项，可以先更换成别的种类（比如“中文”），然后再次进入此界面将其更换成“中文（中国）”。点击“存檔”后，可以看到界面变成了“简体中文”：4.1.2.3 C设置预览PDF的工具存放路径4.1.2.4 D解决中文问题由于jasper reports中没有可以完整显示中文的jar包，所以导入相应的jar包就可行了。需要导入的Jar包如下：i
6、text-1.3.1.jariTextAsian.jar导入方法如下图所示：1.工具栏上“Option”-“Classpath”,.2.在Classpath中点击“添加Jar”3.在弹出的对话框中，找到存放itext-1.3.1.jar，iTextAsian.jar的路径，选中后点击打开。4.最后要记信Save Classpath.5在Fonts Path中勾选导入的Jar包，并保存。此到就完成了解决中文显示问题的jar包导入工作。但到现在还是无法正常显示中文内容，因为。详见样式设置。4.1.2.5 E样式设置为什么要设置样式呢？很简单，因为这是唯一一劳永逸的解决中文问题的方法。费话少说，看图
7、。1.工具栏上“格式化”-“Styles”2.点击New，新建一个样式。Sytle name 为新宋体，并勾选上Default style3.在字体中进行相应设置，以便让中文可以显示在报表上。在Font那一栏上点击，会弹出一Add/modify report font对话框。在该对话框中有五个地方需要选一下，Font Name,Size可以根据实现情况进地设定，PDF Font Name,PDF Encoding,PDF Embeded须和图中设置的一致，才能在PDF中显示中文。经过这么多图的解说，中文问题到这里就完美的解决了。4.1.2.6 F其他设置此步不是必须的，根据需要设定。使用iRe
8、port新创建的报表模板为.jrxml格式，编辑完毕后需要编译，编译会产生.jasper文件，在运行时需要编译好的.jasper文件。这原理类似java程序，源代码文件是.java，编译好之后是.class文件，在应用的时候只需要.class文件。由于安装好之后默认的产生.jasper文件就在当前目录，为了便于管理，可以对iReport设计软件进行一些设置，统一目录来保存编译好的jasper文件。iReport可以有多种方式进行报表预览（pdf、excel）等，每次预览时候，如果选择这些格式，那么会产生这些文件，也可以通过此设置统一保存。工具栏上“Option”-“选项”，然后在选项卡上选择“
9、Compiler”，对“Default compilation directory”和“Directory where the paged out data is stored”进行设置，点击旁边的“浏览”即可进行目录选择。如果默认时，jasper文件和java文件生在JasperReports的安装目录。如果编译不希望保存自动产生的java文件，可以去掉“keep .java file”前面的勾选。4.1.3 Step3:新建报表模板Demo4.1.3.1 A.工具栏-“档案”-“开启新档”4.1.3.2 B.输入报表名称，本文为“Demo”，点击“OK”继续4.1.3.3 C.如图界面如图
10、，可以看到报表模板正文分几个区域，解释如下： titletitle 段只在整个报表的第一页的最上面部分显示，除了第一页以外，不管报表中共有多少个页面也不会再出现title段中的内容。 pageHeaderpageHeader 段中的内容将会在整个报表中的每一个页面中都会出现，显示在位置在页面的上部，如果是报表的第一页，pageHeader 中的内容将显示在title段下面，除了第一页以外的其他所有页面中pageHeader 中的内容将在显示在页面的最上端。 columnHeader针对detail段的表头段，一般情况下在这个段中画报表中列的列标题。每页均会出现一次。 detail报表内容段，在
11、这个段中设计报表中需要重复出现的内容，detail 段中的内容每页都会出现。 columnFooter针对detail段的表尾段，每页均会出现一次。 pageFooter显示在所在页面的最下端，每页都显示，最后一页由lastPageFooter替代 lastPageFooter最后一页页尾段内容，只在最后一页出现一次。 summary表格的合计段，出现在整个报表的最后一页中的detail段的后面，一般用来统计报表中某一个或某几个字段的合计值。4.1.3.4 D.创建数据库类型的JDBC数据源iReport支持多种数据库，本例采用oracle作为示例工具栏上“Data”-“连结/资源来源”在“C
12、onnections/Datasources”界面中点击“New”在“Connections properties”中选择“Database JDBC connection”，点击“Next”继续，这里可以看到，jasper report的数据来源可以有很多方式：数据库、XML文件、JavaBean文件等，从下图中可以看出来。4.1.3.5 E.指定数据库JDBC类型和JDBC URL其中，iReport中已经包含了mysql和hsqldb这两种数据库的驱动jar文件，可以根据实际需要选择不同的JDBC Type，（记得拷贝相应的数据库JDBC驱动jar文件到项目的lib目录中）根据实际内容，
13、输入JDBC URL和用户名及密码输入完成后，点击“Text”，如出现如下界面，说明连接成功。点击“save”保存，在列表中可以看到此连接的配置4.1.3.6 F.设置报表查询工具栏“Data”-“报表查询”出现如下界面：可以看到数据源有多种方式，这里我们使用Report Query方式，这种方式可以直接选择Query Lanuage种类，然后再在编辑框中输入SQL语句。如：select * from bctl，然后会自动读取相关表的结构出来，如图：点击“OK”以后，这些表的Field Name将会被加入到“Document structure”的“Fields”部分，如图：这里也可以采用另一
14、种方式，就是引入参数，这样可以在调用的时候根据业务规则比较灵活地通过设置参数来改变数据内容：在“Document structure”区找到“Parameters”，右键单击后，选择“Add”，再选择“Parameter”，如图：输入以下内容，Parameter Name在报表查询界面中要使用，或在自己的业务逻辑中使用，可以改变，这里也可以给一个默认值，即Default Value Expression内容，注意Parameter Class Type类型，本例使用默认的java.lang.String注意：Default Value Expression 的内容需要双引号引起来。在“报表查询
15、”编辑内容中就指定为使用此参数，格式为“$P!parameterName”，本例中就使用“$P!SQLSTR”，输入后，同样可以看到表结构会自动更新出来，点击“OK”，同样会把这些表结构内容放置到“Fileds”区域中。4.1.3.7 G.编辑报表模板如图：在编辑区中对应的段中放置需要的要素，要素有很多种，常用的有以下几种类型： 静态文本内容：这些内容是固定不变的文本内容，如上图的“中石化信贷项目Demo” 参数（Parameter）：如上图“$PSQLSTR”（） 字段（Fields）：如上图“$FBRCODE” 变量（Variables）：如上图“$VPAGE_NUMBER”（iReport自带的变量）从这里面把需要的内容拖出
