ireport图文教程(超详细)

1、1 下载 iReportiReport是一个可视化的报表模板设计工具，使用此工具能方便地对报表进行设计。在 iReport中已经包含了 jasperreports在运行时需要的jar文件，在项目中的lib目录中包含Jasperreports-*.jar 即可，其中* 为版本号，比如 2.0.3 。下载地址：,此文档编写时版本为 2.0.3 ,如图：Latest File ReleasesPackageReleaseD?teNotes 7 Monitor Downloads(Report 2 (javaversion)iReport 0 3 December 20, 2007 IDoiNnloa

2、d南利网丽初江号子丽点击download 出现以下界面:PackBfle 洸 FifegSize tbytes Downloads Architecture TypeH (Report 2 java version)Latest臼 iR印312.0.3 IjCI (2007-12-20 10:41iReport-2 0 3-src.zip 39150132196PlatformIndependentSource zipiReport-2.0.3.targz -3951271 S204PlatformIndependent乎*iReport-S.O-windows-installer.exe .

3、 436136741042i38£exe (32-bil Windows).zipiReport-2,0.3,zip -39693451449Platform-htt pJ11 YE. c nJ 可以看到提供了多种下载包，其中：?iReport20.3-src.zip:为 iReport 的源代码iReport-2.0.3.tar.gz :为.tar.gz 格式，一般用于 Linux、Unix 等非 windows 系统iReport-2.0.3-windows.installer.exe:为 exe 格式，一般用于 windows 系统? iReport-2.0.3.zip :为z

4、ip格式，可以用于各类操作系统本文使用window 版本为例，因此下载 iReport20.3-windows.installer.exe即可2 安装 iReport安装iReport需要先设置JDK环境，2.0.X版本要求JDK1.5环境（另参考文档）。iiReport_2.3-wmdow如果是windows系统，直接双击安装图标L'的一%万希黔也7即可。（如果是下载的zip文档，则将其解压到指定的目录，还需运行bin/startup.bat ）。如果是其他系统，比如Linux , Unix等，解压下载的安装文件（如下载的是 tar.gz格式，使用gmRep|203|g进行解压，如下

5、 载的zip格式，使用zip命令解压），然后运行bin/startup.sh 即可。以下以在windows 上安装为例：A.欢迎界面，点击 Next > ”继续B. 阅读license 内容，点击 "Agree ”继续C.选择安装组件，点击Next >”继续D.指定安装路径，点击Next >”继续E.指定程序组名称，点击Install即可F.等待安装过程G.安装结束，点击Finish完成IX. iReport 2. 0. 3 SetupiReportbeen In5Ulled on your computer1Click Finish to close this w

6、izard.回 氢/R0花获专-nri. -ICompleting the iReport 2 0 3 Setup Wizard在桌面上会出现如此图标:3编辑一个报表模板3.1 启动 iReport启动 iReport-2.0.3 ,如图：他 iReport 2.Q.3 - (c) 2002-2007 by JasperSoft Corp.棺案褊赣福格式化IJati建立Options Plufins 篝助 3 触 . 三工=回回国TII 运, ”Mun Console Frt>ble»5 (J)Error hading configuration file: C:Documen

7、ts and SettingslAdminlstratortineporftrecentFiles xinl_ iReport home (ireport.home system property：_* User home (user.home system property): ClDocuments and SettmgslAdministratort ireport-iReport default compile directory:.iReport user home directory (iReport compiles here if there re no settings or

8、 if iReport isn't compiling to the report directory):IIJI川江号子询>iReport启动会根据运行的机器的Locale属性自动设置软件语言（Language ）,这里可能会出现一些偏差，笔者使用的是简体中文，但启动后设计界面是繁体中文，因此我们需要对其进行设置。3.2设置默认语言工具栏-> “工具”（或Option ”），“逗工具Flugins"助基格森A滑鼠不能移勒物件口X国1一1相容性定JClas即式h彳Fonts PathReload fontsFormulasExport 口pt ions:、Qu&#

9、171;ry executersL定 plug in三4。.：ByyuanfeTf1 27更改语言种类，从下来菜单中选择中文（中国）”。如果打开就是此项，可以先更换成别的种类（比如中文”），然后再次进入此界面将其更换成IX中文（中国）钮iReport -邈琪Compiler Backup External ProamsGenerO使用ilflH富案作葛新文件的槎板0常便用敬新棺】畴不套用榛板存福 福|取消Byyuanrerf127点击存槽”后，可以看到界面变成了 简体中文M iReport 2.0.3 - (c) 2002-2007 by JasperSoft Corp.帮助档案 编辑 预览

10、格式化Bata建立Op t i ons Flugins M | 昌 K*三三三三E S E T由J E工-工井»李JK KCO Open Filesft it雇性| Document structureLibraryDocumentFa簧 ITiunlerTotal Pag«sFy X of YLibrary Styles LibraryOutput Consolefl XMain CoMole Problems ©)&HError loading configuration file: CADocuments and SettingsVdministra

11、toA irepornrecentFiles.xml-iReport horns (Irejiort home systein property):.'i leer hnmp fii二口home 0”。十口中 rirnn口r+wi nrinrumpnts anN 1口情nriZAflminiotratn力 irpnnr-f<1>Threads" f 'By yua nfeTil 273.3其他设置此步不是必须的，根据需要设定。使用iReport新创建的报表模板为jrxml格式，编辑完毕后需要编译，编译会产生.jasper文件，在运行时需要编译好的.jasp

12、er文件。这原理类似java程序，源代码文件是.java ,编译好之后是.class文件，在应用的时候只需要.class文件由于安装好之后默认的产生.jasper文件就在当前目录，为了便于管理，可以对 iReport设计软件进行一些设置，统一目录来保存编译好的jasper文件。iReport可以有多种方式进行报表预览（pdf、excel ）等，每次预览时候，如果选择这些格式，那么会产生这些文件，也可以通过此设置统一保存。工具栏上 Option ”->"选项"，然后在选项卡上选择"Compiler”, 对 Default compilation directo

13、ry ”和 Directory where the paged outdata is stored ”进行设置，点击旁边的浏览"即可进行目录选择。如果编译不希望保存自动产生的java文件，可以去掉 keep .java file ”前面的勾选3.4新建报表模板SampleA.工具栏-> “档案”->“开启新档”档案 编辑 预览 格式化 gt-jiCtrl+S开启新档Ctrl+O/报表楮灵 开启旧档存档另存新档全部存档 美闭Close AllClose All Except Thi sPrint Desi gn CtrlRevert to Last最近使用的档案离开'

14、;r *1的苑疝颜 127B.输入报表名称，本文为 “sample ”，点击“ OK”继续报表名称5 皿 pieI挈1眼福一h号，M&r£iiL 字段数 Scriptlst clss More. . . i16n渝淞号可丽3 J八f-、叩曲荷ivC. 如图界面如图，可以看到报表模板正文分几个区域，解释如下:? titletitle段只在整个报表的第一页的最上面部分显示，除了第一页以外，不管报表中共有多少个页面也不会再出现title段中的内容。? pageHeaderpageHeader段中的内容将会在整个报表中的每一个页面中都会出现，显示在位置在页面的上部，如果是报表的第一页

15、，pageHeader中的内容将显示在title段下面，除了第一页以外的其他所有页面中pageHeader中的内容将在显示在页面的最上端。? columnHeader针对detail段的表头段，一般情况下在这个段中画报表中列的列标题。每页均会出现一次。? detail报表内容段，在这个段中设计报表中需要重复出现的内容，detail段中的内容每页都会出现。? columnFooter针对detail段的表尾段，每页均会出现一次。? pageFooter显示在所在页面的最下端，每页都显示，最后一页由lastPageFooter 替代? lastPageFooter最后一页页尾段内容，只在最后一页出

16、现一次。? summary表格的合计段，出现在整个报表的最后一页中的detail段的后面，一般用来统计报表中某一个或某几个字段的合计值。D. 创建数据库类型的JDBC数据源iReport支持多种数据库，本例采用mysql作为示例工具栏上D ata ”- > “连结/资源来源Data 建立 Options 连结/资料来源 设定动态连结口报表查询fSub dataset a .在"Connections/Datasources ” 界面中点击“NeW在"Connections properties "中选择 "Database JDBC connect

17、ion "，点击"Next"继续，这里可以看到，jasper report 的数据来源可以有很多方式:数据库、XML文件、JavaBean文件等，从下图中可以看出来。E. 指定数据库JDBC 类型和JDBC URL其中，iReport中已经包含了 mysql和hsqldb这两种数据库的驱动jar文件，可以根据实际需要选择不同的JDBC Type ,（记得拷贝相应的数据库JDBC驱动jar文件到项目的lib目录中）根据实际内容，输入 JDBC URL和用户名及密码输入完成后，点击 Text”，如出现如下界面，说明连接成功点击Save”保存，在列表中可以看到此连接的配

18、置F.设置报表查询工具栏“Data”-> “报表查询”。式建立 Opti MLS 连结;资料来函厂 设定动右连结出现如下界面:可以看到数据源有多种方式，这里我们使用Report Query方式，这种方式可以直接选择Query Lanuage种类，然后再在编辑框中输入SQL语句如：select * from employee ,然后会自动读取相关表的结构出来，如图:治 Report queryField Ham电Field TypeEMPLOYED IEDEPT口EMPLOYEE NANESEXj avaH lang. Stririgj ava. Iwg. BooleaztFilter E

19、xpression . hBtt价泄电班川江号子前广'Descrip tiSort optionsj ava. lang. String 其&皿G | /elTl 27点击OK'以后，这些表的 Field Name将会被加入到 "Document structure "的"Fields部分，如图:Documerrt structureDocument+ Far ametersrsMaa a-;LL.iQ EMPLOYEE!)QEEPT_IEQ * Q Q Q Q Q Q Q QWLOYEE. SEX EIRTHEA.Y NimiED SAL

20、ARY DEGREE EMAIL WEB CNHT IMAGE_NAHEVwi abl es bAckground ti4 X4 "BUahfenlZZ这里也可以采用另一种方式，就是引入参数，这样可以在调用的时候根据业务规则比较灵活地通过设置参数来改变数据内容:在"Document structure "区找到 "Parameters”,右键单击后，选择 "Add-",再选择 "Parameter",如图:Document structurej DoctunentPar airieters Fields+ 口 Va

21、r i abl:l：旨 backgroimdtitla pagieHeider cclumnK&ad de t ai 1 colum nF aot pag&Fcoter lastPi£eFoEditCutCopyPast«DelateNew Report Group WizardRefreshFieldVariableSub dataset.口写皿nmaryhttp3湍N川江号子;cM"f 3，输入以下内容，Parameter Name在报表查询界面中要使用，或在自己的业务逻辑中使用,可以改变，这里也可以给一个默认值，即DefaultValue E

22、xpression 内容，注意 Parameter Class Type 类型，本例使用默认的java.lang.String在报表查询”编辑内容中就指定为使用此参数，格式为"$P!parameterName”，本例中就使用“$P!SQLSTR，输入后，同样可以看到表结构会自动更新出来，点击 “OK,同样会把这些表结构内容放置到“Fileds区域中G.编辑报表模板如图：在编辑区中对应的段中放置需要的要素，要素有很多种，常用的有以下几种类型:静态文本内容：这些内容是固定不变的文本内容，如上图的Test Report参数(Parameter ):如上图 “ $PSQLSTR ”字段(Fi

23、elds ):如上图 “ $FEMPLOYEE_ID ”变量(Variables ):如上图 “ $VPAGE_NUMBERDocument structureDo eminentli) Cfl* Paramatfirsij CQ Fieldst+ Q| Var i abl e sJF.q*七内gM超词2 7从这里面把需要的内容拖出来放置到模板编辑区中相应的段中即可。H.编译预览在工具栏上找到 国一的 E,分别是编译、执行、执行（动态连结），点击编译将会产生.jasper文件，点击执行会先编译再预览（如果设定了对应的预览）。预览有多种方式，点击工具栏上建立”，可以看到如下图多种预览方式:建立

24、Opli *>ns Flugins 窗口 帮助编连执行报表执行报表（使用动感连结Create from templatePDF预览HTML预览JAVA 2D预览Ectl预览Excel Preview (using JZxcelApi)CSV预览究文字预流Text Frevi iti CJK)BTF Frsvi ewOpiiiDff ice (OBF) prtvi ex JUVietr 预览设定动态连结Set Report Locale - 中文(中国S«t report time zone - defaultIgjiart paginationMuc Records (no l

25、imit sU5直 Report Virtnalizer27根据需要选择预览类型，还要注意，如果没有对应的软件（比如Adobe Reader ）来查看生成好的文件，那不会看到效果，iReport会在对应的目录生成文件而已（见3.3节）如何设置文件的查看软件，还是在工具栏上点击 "Op ions "-> "选项"，然后在选项卡中选择"External Programs",再对每一种需要设置的格式选择对应的查看软件，如图:IX看iReport -选项套用存档General Compiler Backup Estsrnal Progr

26、amsBy'yfhfenl 27这样，指定了预览文件的类型，又指定了预览的软件，点击预览时就会采用对应的润见展示出来。I.预览效果www,川江号子.cn员1：列表姓r.EMA.LANLIN00-5-17 上午 12:002027.00changliniBXIAOBO门小波79-5-10 I T12:002034.00E 一chenborrIMII1I 00 O 回回 回肉匠 2f1 ?i：yuanfen127 BLOG: http7/www.'i| ；L '； f cnBLOG: http: 127iReport JasperViewerGUOUWEI国糙临7&

27、11-15I 12:004600.00g uoliwe i m ailSe rve l comHETAO科博7&101412:002410.00h etao m ail Se rver. comHEZQhlOSI忖家忠-17-12004373 00h ezc ng f im ail St rve r.ccmHQNGINGZHUtl景柱70-3-0r 12002352.00h on yi ngzhu m 司 ilSe ive rcom75%1SQL:sel-ect" from employeeAuth or' s B Io g: http J/b log. cs dn.

28、 net/u f«n 1127 (vwwv. Ill； < _ 4cri) Sq many opn source projects. Why not Open you Docuiments?X畸浒谕丽:川棺号守恋N、4曰即咨M前i”J.报表模板制作完成4 Web 中使用 iReport4.1开发工具开发工具使用eclispe3.2.2 和MyEclipse5.0 搭配开发。环境配置参考另外的手册。4.2创建项目打开 Eclipse ,在工具栏中， File "-> "NeW -> “OtherFile£di t Source Navi

29、gate Search Proj ect MyEclipEe Rui Window HelpAlt+SKi ft+M ,L 1Fcj set.口pen File_.CloseCtrl十WClose AllCtrl+Shift+Wi £, Package& cias耳(i Int erfaceIWI Ss.vsCtrl+sSava A&.Save AllCtrl+Shif t+SRevert电aEnuihAimotat i onSource FolderFolderFil»Untitlsd Tsxt Filsi_' JUni t T est CaseC

30、trl+TBy yuanfeMi3fs. 一Rename.RefreshConvert Line Delimiters; T。创建一个 web项目，选择 "MyEclipse"下的"Web Project ”,点击 Next”下一步，如图:Oth*r.Swi tch Workspace.-.而阳僦Mill江号手r *” f输入 Project Name ,本例为"iReportTest "，点击 Finish ”完成如图:riXJSTL Support Add JSTL libraries to WEB-IHF/lib folder?J2EE

31、Specif i cati on LevelO龙EE 1.30J2EE 14 lefault|< 旦.ck NaxtFim ahNew J2EE Web ProjectCreate web projecthtt闯阶横.川江号丰田八 J、一一，-7口 | Cancel ，, 丁5Pyuan庇巾 27在项目列表中可以看到 iReportTest 的项目:- '占 iKefWlTeStsrc.1+ /.，JRE System Library j25dkL, 4.2_14ii+ 比 J2EE 1,4 Library ContaineriyuanferrlT 14.3导入jar文件在项目中

32、找到 "WebRoot -> "lib "，右键单击，选择 Import”,如图:tasthtr j" teitpd ,laanEpm_JHBC ,3 Opti«nfxcel ,(papi_lb2_cli« l3 papi_oralce_> J qui ckforothei l2J quickstvtl qui ckstr t4& iReportTest 国 ETC+ 用 JRE System Library jW5dkL 4一 W4+ J2EE L4 Library ContainerE VebRcst+ lJ?

33、 META-INF+ report0 & tfEB-INPNew一? ilib4 i - ia *1，ax *ebOpen in M&w WinAow睛 CopyCtrl+CC&py Qualified Kame值 FasteCtrl+¥X Bel«tgDelateBuild FathReHclor' Import.匕 Esp£rt.,选择"General"->"File System” 点击 Next”继续Select an import source： type filter text&

34、; (/予 Gtner al二 Archive FileBreakpoints_ Existing Proj acts into Workspace 亡二Fil电 Sys t en j 1-wr nm r rain r rein nrirf匚PreferencesB 良&&& ®-®'-:®-:® 丽CVSD'orado StudioFlugin BevelopmentT金则Web Servi cesh命派而Mfit号子;而八%'、'、 一姓“ fly yuanfg ff 27点击“七owse，指定

35、jar文件，这里初级学者可以指向 Jasper安装目录下的lib目录中所有的jar文件，这样可以快速看到效果，可以排除其中的txt文件File systemImport resourcsE from th包 local file syst&m.- libImport froh directory文件夹：111新建文件央徽）取消Select a directory to import from.< Eack3C： Frogram Fil4sj45prS>£tiReport-2. 0, 3librnclcnb Qi c- t o >1 - p b Jue&

36、;£ 1 iRa， 0 田l±HBnBBHl百7. 5. j ar61j ar百 asm-attrs, jar barbecue-l. L jargbsh-Z.OU. jar.cglib-2. 1. jar- K ： T5 K GE- 1 V . VE-I 4； 一户MEr&wse, r,hm；泳痴?：J 11江号子M巾 4 -、jf= - f '''-'finish项目中可以看到jar文件被引入了，如图:- 或 iReportTest芋srcK JE£ Syster» Library jSEdkl. 4, 2_1

37、fcjt J2EE 1. 4 Library Container!_lJ asp er B ab yl ou" 1 . 0. 0, jar anUr-2. 7. 5. jar asm"&ttrse jar asm. jar4.4 与入jasper 文件在 WebRoot 下建立目录report ,并把3.4节编译好的jasper 文件导入进来+ % J2EE 1. 4 Library Container-V ebRoot1+ 1. ，HETA-IHF-(23 riport 'j=s=-!=s-!7=!=s=!f,；j jssmpl* jisper ：

38、3;- a WEB-IHF- j, teEthtml.jip、3筮七零By-yfiSnfeni?4.5 处理带有中文的报表当生成为PDF格式时，可能会发现中文内容无法显示，主要是设置font时候需要注意以下几点:1. 设置的字体的Font Name需要是能显示中文的，比如宋体、 SansSerfi2. 设置 PDF Font Name 为 STSong-Light3. 设置 PDF Encoding 为 UniGB-UCS2-H (Chinese Simplified)4. 是否lib中包含iTextAsian.jar 文件右键单击需要改变字体的内容，选择属性”，在选项卡中选择“Font”，做

39、如图更改:PDF预览效果如下:Adobe Reader4.6字体属性统一设置在上一节中是针对每一个字体框进行设置，如果需要设置loo个的话，这样一个一个去设置就显得比较繁琐，减低了效率。格式化”->"Style ”(2.0.3是推荐使用这种iReport提供了一个功能，就是把这种设置配置好，然后只是需要的时候选择就可以了。在工具栏中方式，如果早期版本是选择 字体")，如图:点击“NeW创建一种新格式，命名为朱体”，再进行相关设置，如图:软 Add/Modify styl乜运StyleStyle nait 史Style ConditionsBefault八睬体DEwFi

40、H:Pw15SansS«rif 10i Up II ownRwStFontLine spacingBoldEe faultByyuanfhi 27iittB：的丽州江号承6”“CommSn 选项卡,这样，这个 朱体”的Style就设置好了，在设定字体的时候就不需要再到选项卡一项一项地进行设置，在字体的属性中选择在Style中选择这个 朱体”即可:Common Font Static Text Border All回 Tr anEparent RemoveO Printline when blankin first whole bandZl Print when detail over

41、t,., 回 Print reptited valuesStretch Typ®Ho stretchktt国防献川江号竽河/iFosition Typefix rel4tito t&pPrint词h白n group uhg皆电三I3Ksystall cTeKt-16Styl#宋伟中文蓝色4.7创建显示HTML格式报表的JSP文件在 WebRoot 根目录下创建jsp文件testhtml.jsp ,内容如下:<% page contentType = "text/html;charset=GB2312"%><% page import =

42、"net.sf.jasperreports.engine.*"%><%pageimport="java.util.*"%><%pageimport="java.io.*"%><%pageimport="java.sql.*"%><%/报表编译之后生成的.jasper文件的存放位置File reportFile = new File( this .getServletContext().getRealPath( "/report/sample.jasper&q

43、uot; );String url= "jdbc:mysql:/localhost:3306/db"Class.forName( "com.mysql.jdbc.Driver");Map parameters =new HashMap();p&geH金&Her26ridth279 ? oreground|J103Hei ght18 Backjgroinidl|BoniLeft/"SQLSTR”是报表中定义的参数名称，其类型为String/设置SQLSTR参数的内容，根据需要赋值sql语句parameters.put( "

44、;SQLSTR" , "select * from employee" Connection conn = DriverManager.getConnection(url,）；username(3),"password" );JasperRunManager.runReportToHtmlFile(reportFile.getPath(),response.sendRedirect("report/sample.html"); parameters,conn);(5)%>代码说明：1.定位jasper 文件2 .给报表模板中使用到的参数 SQLSTR赋值，这里指定一个 sql语句3 .采用JDBC方式连结数据库4. 生成HTML文件，参数分别为报表文件模板物理位置，报表参数，数据库连结5. 转向到此页面，这个页面是固定的，需要和报表模板的位置和路径相同发布项目后预览，输入 http:/localhost:8080/iReportTest/testhtml.jsp（本例采用tomcat作为web服务器，发布过程参考其他文档，数据库采用的mysql ）效果：4.8创建显示PDF格式报表的JSP文件在 WebRoot 根目录下创建jsp文件testpdf.jsp ,内容如下：<% page conte