`
thecloud
  • 浏览: 884840 次
文章分类
社区版块
存档分类
最新评论

JasperReport报表设计总结

 
阅读更多
首先，jasperReport是一个以java实现的报表工具，（好像是句废话）。可以实现多种格式的报表。
再我们先理解一下jasperReport的实现过程。笔者不再画图，网上到处都是。
1）定制报表格式。
有二种方式，一种就是写jrxml文件，其实就是xml文件，只不过是后缀名不一样罢了。另一种方式更直接，就是生成一个JasperDesign类的实例，在japsperDesign中自己定义模板。jrxml文件也是通过一个JRXmlLoad加载过来，转成JasperDesign类的实例。也就是说写jrxml文件还需要进行解析，加载。现实中我们使用的报表一般格式比较固定，因而可以通过先使用iReport工具生成模板，再加载解析的方式。这种方式简单，而且可见性强。
2）填充数据。
在最新版（2007.4.30发布）的jasperReports1.3.3中，支持了很多的格式，包括了对于Hibernate的支持。填充数据对于我们经常使用的来说，一般是二种方式，一种方式是通过JDBC连接提供数据源，一种就是通过javaBean的集合提供数据源。当然还有web Service的xml文件提供的。我的建议是，如果你的程序中的统计直接使用Jdbc就可以完成，那么就使用jdbc数据源的方法，反之，使用javaBean的集合是不错的选择，因为这样不会在意你的数据的来源，你也可以任意处理，比如说，要通过权限检查的数据才在报表中生成的话，就可以过滤到不符合权限的数据。
3）显示或打印。
显示，即将JasperReport生成的文件直接显示出来，打印所使用的方式其实就是生成文件，然后调用打印来对文件进行打印。
看起来是不是很简单，对，确实很简单。
笔者主要从事基于B/S模式的开发，相信大部分人的使用也是基于web进行使用。故笔者对于基于web的开发进行详细讲述。

1、工程环境配置。
　　将以下包加入WEB-INF/lib中。
　　commons-beanutils-1.7.jar;commons-collections-2.1.jar;commons-digester-1.7.jar;commons-logging-1.0.2.jar;commons-logging-api-1.0.2.jar;itext-1.3.1.jar;jasperreports-1.3.3.jar;jdt-compiler-3.1.1.jar;jxl-2.6.jar;png-encoder-1.5.jar;poi-2.0-final-20040126.jar
　以上包是jasperReport必须。
2、iReport的安装
这个很简单，直接下一步就可以了。
3、使用iReport生成 .jasper文件
　　.jasper是经过编译的japserReport模板，即.jrxml编译后的。
　　对于iReport的使用网络上已经有了详细的中文的文档，具体可以下载附件查看。使用.jasper文件可以避免在系统中再进行编译，增加系统的压力。
4、数据填充
　　数据填充是相对于比较重要的一步，数据填充的目的是为了将数据填充进去，生成一个JapserPrint对象。笔者在之前已经阐述过，现在主要是基于关系型数据库（比较简单的，没有权限控制的），以及基于JavaBean Collection进行数据填充。进行数据填充的基本就是一定要实现JRDataSource，JRDataSource定义了二个方法，一个是指针移动的方法next()，另一个是取值的getFieldValue（）方法，用来取值填充。
　　对于关系型数据库，即直接利用数据库的表来生成报表的，只需要传入一个Java Connection即可。JasperReport已经有了个默认的实现的JRDataSource的接口了。对于Java Conncetion的获得，笔者建议使用工厂方法或者使用Spring方式来获得。可以参照笔者写的如下：

java 代码
  1. /**
  2. *@copyRightBeijingTsing-TechReachwaySoftwareCo.,Ltd.
  3. *@authorJimmy.Shine2007-5-11
  4. */
  5. packagecn.com.reachway.framework.report;
  7. importjava.sql.Connection;
  8. importjava.sql.DriverManager;
  10. importcn.com.reachway.framework.exception.JasperReportException;
  12. /**
  13. *UsedforgetaJDBCconnectionforJasperReport
  14. */
  15. publicclassJDBCConnection{
  16. /**
  17. *WhichJdbcdriverwereused.Like:"net.sourceforge.jtds.jdbc.Driver"
  18. */
  19. privateStringjdbcDriver;
  20. /**
  21. *Thejdbcurl,definewhichdatabaseserver,whichdb.Like:
  22. *"jdbc:jtds:sqlserver://192.168.1.50:1433;DatabaseName=JAVA5;SelectMethod=Cursor"
  23. */
  24. privateStringjdbcUrl;
  26. privateStringdbUser;
  28. privateStringdbPassword;
  30. publicStringgetDbPassword(){
  31. returndbPassword;
  32. }
  34. publicvoidsetDbPassword(StringdbPassword){
  35. this.dbPassword=dbPassword;
  36. }
  38. publicStringgetDbUser(){
  39. returndbUser;
  40. }
  42. publicvoidsetDbUser(StringdbUser){
  43. this.dbUser=dbUser;
  44. }
  46. publicStringgetJdbcDriver(){
  47. returnjdbcDriver;
  48. }
  50. publicvoidsetJdbcDriver(StringjdbcDriver){
  51. this.jdbcDriver=jdbcDriver;
  52. }
  54. publicStringgetJdbcUrl(){
  55. returnjdbcUrl;
  56. }
  58. publicvoidsetJdbcUrl(StringjdbcUrl){
  59. this.jdbcUrl=jdbcUrl;
  60. }
  62. publicJDBCConnection(){
  63. super();
  64. }
  65. /**
  66. *GettheConnection
  67. *@returnconnection
  68. *@throwsJasperReportException
  69. */
  70. publicConnectiongetConnection()throwsJasperReportException{
  71. Connectioncon;
  72. try{
  73. check();
  74. Class.forName(this.jdbcDriver);
  75. con=DriverManager.getConnection(this.jdbcUrl,this.dbUser,this.dbPassword);
  76. returncon;
  77. }catch(Exceptione){
  78. e.printStackTrace();
  79. thrownewJasperReportException("GetJDBCConnectionError");
  80. }
  81. }
  83. /**
  84. *ChecktheConfigure
  85. *@throwsJasperReportException
  86. */
  87. privatevoidcheck()throwsJasperReportException{
  88. if(this.jdbcDriver==null||this.jdbcDriver.equals("")||this.jdbcUrl==null||this.jdbcUrl.equals("")
  89. ||this.dbUser==null||this.dbUser.equals("")||this.dbPassword==null){
  90. thrownewJasperReportException("JdbcConfigureerror!");
  91. }
  92. }
  94. }


java 代码
  1. /**
  2. *@copyRightBeijingTsing-TechReachwaySoftwareCo.,Ltd.
  3. *@authorJimmy.Shine2007-5-14
  4. */
  5. packagecn.com.reachway.framework.report.dataSource;
  7. importnet.sf.jasperreports.engine.JRDataSource;
  8. importnet.sf.jasperreports.engine.JRException;
  9. importnet.sf.jasperreports.engine.JRField;
  11. /**
  12. *报表的dataSource的基类，所有利用DataSource产生报表的继承此类
  13. */
  14. publicabstractclassReportDataSourceimplementsJRDataSource{
  16. /**
  17. *取值
  18. */
  19. publicabstractObjectgetFieldValue(JRFieldjrField)throwsJRException;
  21. /**
  22. *指针移动
  23. */
  24. publicabstractbooleannext()throwsJRException;
  26. }
　　这样可以共用配置文件中的jdbc连接的相关参数。
　　对于其它的数据源，JavaBean Collection，笔者采用了一个抽象类，使用抽象类的目的，是为了使开发者尽可能不用直接接触jasperReport（此为笔者自己的方式，笔者是PM，为了考虑底下的人的开发）。以下为抽象类以及笔者提供的一个sample:
  1. /**
  2. *@copyRightBeijingTsing-TechReachwaySoftwareCo.,Ltd.
  3. *@authorJimmy.Shine2007-5-14
  4. */
  5. packagecn.com.reachway.framework.report.dataSource;
  7. importjava.util.ArrayList;
  8. importjava.util.List;
  10. importnet.sf.jasperreports.engine.JRException;
  11. importnet.sf.jasperreports.engine.JRField;
  13. /**
  14. *利用JavaBeanCollection生成ReportDataSource的例子
  15. */
  16. publicclassReportDataSourceSampleextendsReportDataSource{
  18. privateListdocs=newArrayList();
  20. privateintindex=-1;
  22. publicReportDataSourceSample(){
  23. for(inti=0;i<10;i++){
  24. Documentdoc=newDocument("ViewTimesis:"+i,i);
  25. this.docs.add(doc);
  26. }
  27. }
  29. //内部类，作为demo时使用
  30. privateclassDocument{
  31. privateStringname;
  33. privateintviewTimes;
  35. publicStringgetName(){
  36. returnname;
  37. }
  39. publicvoidsetName(Stringname){
  40. this.name=name;
  41. }
  43. publicintgetViewTimes(){
  44. returnviewTimes;
  45. }
  47. publicvoidsetViewTimes(intviewTimes){
  48. this.viewTimes=viewTimes;
  49. }
  51. publicDocument(){
  52. }
  54. publicDocument(Stringname,intviewTimes){
  55. this.name=name;
  56. this.viewTimes=viewTimes;
  57. }
  58. }
  60. publicListgetDocs(){
  61. returndocs;
  62. }
  64. publicvoidsetDocs(Listdocs){
  65. this.docs=docs;
  66. }
  68. @Override
  69. publicObjectgetFieldValue(JRFieldjrField)throwsJRException{
  71. StringfieldName=jrField.getName();
  72. Documentdoc=this.docs.get(index);
  73. if("name".equals(fieldName)){
  74. returndoc.getName();
  75. }
  76. if("viewTimes".equals(fieldName)){
  77. returndoc.getViewTimes();
  78. }
  79. returnnull;
  80. }
  82. @Override
  83. publicbooleannext()throwsJRException{
  84. index++;
  85. return(index<this.docs.size());
  86. }
  87. }
java 代码

以上的例子应当很清楚的写明了如何生成数据源。
对于数据源的填充，笔者使用了二个类，分别用来对应使用Connction及JavaBean Collection进行填充。

java 代码
  1. /**
  2. *@copyRightBeijingTsing-TechReachwaySoftwareCo.,Ltd.
  3. *@authorJimmy.Shine2007-5-12
  4. */
  5. packagecn.com.reachway.framework.report.jasperPrint;
  7. importjava.io.File;
  8. importjava.sql.Connection;
  9. importjava.util.Map;
  11. importnet.sf.jasperreports.engine.JRException;
  12. importnet.sf.jasperreports.engine.JasperFillManager;
  13. importnet.sf.jasperreports.engine.JasperPrint;
  14. importnet.sf.jasperreports.engine.JasperReport;
  15. importnet.sf.jasperreports.engine.util.JRLoader;
  16. importcn.com.reachway.framework.exception.JasperReportException;
  18. /**
  19. *使用报表模板及数据等来生成JapserPrint
  20. */
  21. publicclassJasperPrintWithConnection{
  22. /**传入的参数*/
  23. privateMapparams;
  24. /**模板文件的地址*/
  25. privateStringreportFilePath;
  26. /**JDBCconnection*/
  27. privateConnectioncon;
  29. publicConnectiongetCon(){
  30. returncon;
  31. }
  33. publicvoidsetCon(Connectioncon){
  34. this.con=con;
  35. }
  37. publicMapgetParams(){
  38. returnparams;
  39. }
  41. publicvoidsetParams(Mapparams){
  42. this.params=params;
  43. }
  45. publicStringgetReportFilePath(){
  46. returnreportFilePath;
  47. }
  49. publicvoidsetReportFilePath(StringreportFilePath)throwsJasperReportException{
  50. if(reportFilePath==null||!reportFilePath.endsWith(".jasper"))
  51. thrownewJasperReportException("您传入的模板文件格式不对，请传入以.jasper为后缀的文件!");
  52. this.reportFilePath=reportFilePath;
  53. }
  55. publicJasperPrintWithConnection(){
  56. super();
  57. }
  59. publicJasperPrintWithConnection(StringreportFilePath,Mapparams,Connectioncon)throwsJasperReportException{
  60. if(reportFilePath==null||!reportFilePath.endsWith(".jasper"))
  61. thrownewJasperReportException("模板文件格式不对，请传入以.jasper为后缀的文件!");
  62. if(con==null)
  63. thrownewJasperReportException("Conncetion不应当为null!");
  64. this.setReportFilePath(reportFilePath);
  65. this.setParams(params);
  66. this.setCon(con);
  67. }
  69. /**
  70. *取得JasperPrint
  71. *@return
  72. *@throwsJasperReportException
  73. */
  74. publicJasperPrintgetJasperPrint()throwsJasperReportException{
  75. FilereportFile=newFile(this.reportFilePath);
  76. if(!reportFile.exists())
  77. thrownewJasperReportException("传入的模板文件不存在!");
  79. try{
  80. //Load编译好的模板
  81. JasperReportjasperReport=(JasperReport)JRLoader.loadObject(reportFile.getPath());
  82. //进行数据填充
  83. JasperPrintjasperPrint=JasperFillManager.fillReport(jasperReport,this.params,this.con);
  84. returnjasperPrint;
  86. }catch(JRExceptionjre){
  87. jre.printStackTrace();
  88. thrownewJasperReportException("在进行数据填充时发生了错误中，请检查是否是数据库连接错误或者是用来填充的参数map有误!");
  89. }
  91. }
  92. }
  1. /**
  2. *@copyRightBeijingTsing-TechReachwaySoftwareCo.,Ltd.
  3. *@authorJimmy.Shine2007-5-14
  4. */
  5. packagecn.com.reachway.framework.report.jasperPrint;
  7. importjava.io.File;
  8. importjava.util.Map;
  10. importnet.sf.jasperreports.engine.JRDataSource;
  11. importnet.sf.jasperreports.engine.JRException;
  12. importnet.sf.jasperreports.engine.JasperFillManager;
  13. importnet.sf.jasperreports.engine.JasperPrint;
  14. importnet.sf.jasperreports.engine.JasperReport;
  15. importnet.sf.jasperreports.engine.util.JRLoader;
  16. importcn.com.reachway.framework.exception.JasperReportException;
  18. /**
  19. *
  20. */
  21. publicclassJasperPrintWithDataSource{
  22. /**传入的参数*/
  23. privateMapparams;
  24. /**模板文件的地址*/
  25. privateStringreportFilePath;
  26. /**dataSrouce*/
  27. privateJRDataSourcedataSource;
  29. publicJRDataSourcegetDataSource(){
  30. returndataSource;
  31. }
  33. publicvoidsetDataSource(JRDataSourcedataSource){
  34. this.dataSource=dataSource;
  35. }
  37. publicMapgetParams(){
  38. returnparams;
  39. }
  41. publicvoidsetParams(Mapparams){
  42. this.params=params;
  43. }
  45. publicStringgetReportFilePath(){
  46. returnreportFilePath;
  47. }
  49. publicvoidsetReportFilePath(StringreportFilePath)throwsJasperReportException{
  50. if(reportFilePath==null||!reportFilePath.endsWith(".jasper"))
  51. thrownewJasperReportException("您传入的模板文件格式不对，请传入以.jasper为后缀的文件!");
  52. this.reportFilePath=reportFilePath;
  53. }
  55. publicJasperPrintWithDataSource(){
  56. super();
  57. }
  59. publicJasperPrintWithDataSource(StringreportFilePath,Mapparams,JRDataSourcedataSource)
  60. throwsJasperReportException{
  61. if(reportFilePath==null||!reportFilePath.endsWith(".jasper"))
  62. thrownewJasperReportException("模板文件格式不对，请传入以.jasper为后缀的文件!");
  63. if(dataSource==null)
  64. thrownewJasperReportException("DataSource不应当为null!");
  65. this.setReportFilePath(reportFilePath);
  66. this.setParams(params);
  67. this.setDataSource(dataSource);
  68. }
  69. /**
  70. *取得JasperPrint
  71. *@return
  72. *@throwsJasperReportException
  73. */
  74. publicJasperPrintgetJasperPrint()throwsJasperReportException{
  75. FilereportFile=newFile(this.reportFilePath);
  76. if(!reportFile.exists())
  77. thrownewJasperReportException("传入的模板文件不存在!");
  79. try{
  80. //Load编译好的模板
  81. JasperReportjasperReport=(JasperReport)JRLoader.loadObject(reportFile.getPath());
  82. //进行数据填充
  83. JasperPrintjasperPrint=JasperFillManager.fillReport(jasperReport,this.params,this.dataSource);
  84. returnjasperPrint;
  86. }catch(JRExceptionjre){
  87. jre.printStackTrace();
  88. thrownewJasperReportException("在进行数据填充时发生了错误中，请检查是否是数据库连接错误或者是用来填充的参数map有误!");
  89. }
  91. }
  92. }
java 代码

其中使用的JasperReportException为笔者定义的异常，用来统一处理报表异常。

5、报表产生
　　报表产生是程序中最终可见的一部分，在jasperReport的demo中，大部分中使用了jasperReport的net.sf.jasperreports.j2ee.servlets.*中的类来生成。其实这也算是开源的产品的一个问题，其实jasperReport提供的report的工具，只能算是demo级别的，不能算是产品级别的。相信很多的朋友在使用的时候就碰上无法生成的问题。笔者在此基础上封装了一下。
具体参见以下：

java 代码
  1. /**
  2. *@copyRightBeijingTsing-TechReachwaySoftwareCo.,Ltd.
  3. *@authorJimmy.Shine2007-5-12
  4. */
  5. packagecn.com.reachway.framework.report.export;
  7. importjava.io.IOException;
  8. importjava.io.PrintWriter;
  9. importjava.sql.Connection;
  10. importjava.util.Map;
  12. importjavax.servlet.http.HttpServletRequest;
  13. importjavax.servlet.http.HttpServletResponse;
  15. importnet.sf.jasperreports.engine.JRDataSource;
  16. importnet.sf.jasperreports.engine.JRExporterParameter;
  17. importnet.sf.jasperreports.engine.JasperPrint;
  18. importnet.sf.jasperreports.engine.export.JRHtmlExporter;
  19. importnet.sf.jasperreports.engine.export.JRHtmlExporterParameter;
  20. importnet.sf.jasperreports.j2ee.servlets.ImageServlet;
  21. importcn.com.reachway.framework.exception.JasperReportException;
  22. importcn.com.reachway.framework.report.jasperPrint.JasperPrintWithConnection;
  23. importcn.com.reachway.framework.report.jasperPrint.JasperPrintWithDataSource;
  25. /**
  26. *利用报表生成HTML格式报表
  27. */
  28. publicclassHTMLExport{
  30. /**
  31. *导出报表
  32. *
  33. *@paramrequest
  34. *@paramresponse
  35. *@paramreportFilePath
  36. *@paramparams
  37. *@paramcon
  38. *@throwsJasperReportException
  39. */
  40. publicvoidexport(HttpServletRequestrequest,HttpServletResponseresponse,StringreportFilePath,Mapparams,
  41. Connectioncon)throwsJasperReportException{
  42. try{
  43. PrintWriterout=response.getWriter();
  44. try{
  45. response.setContentType("text/html;charset=UTF-8");
  46. JasperPrintjasperPrint=newJasperPrintWithConnection(reportFilePath,params,con).getJasperPrint();
  47. //使用JRHtmlExproter导出Html格式
  48. JRHtmlExporterexporter=newJRHtmlExporter();
  49. request.getSession().setAttribute(ImageServlet.DEFAULT_JASPER_PRINT_SESSION_ATTRIBUTE,jasperPrint);
  50. exporter.setParameter(JRExporterParameter.JASPER_PRINT,jasperPrint);
  51. exporter.setParameter(JRExporterParameter.OUTPUT_WRITER,out);
  52. exporter.setParameter(JRHtmlExporterParameter.IMAGES_URI,"./servlets/image?image=");
  53. exporter.setParameter(JRExporterParameter.CHARACTER_ENCODING,"UTF-8");
  54. //导出
  55. exporter.exportReport();
  56. }catch(Exceptione){
  57. e.printStackTrace();
  58. thrownewJasperReportException("在导出Html格式报表时发生错误!");
  59. }finally{
  60. if(out!=null){
  61. try{
  62. out.close();
  63. }catch(Exceptione){
  64. }
  65. }
  66. }
  67. }catch(IOExceptionioe){
  68. ioe.printStackTrace();
  69. thrownewJasperReportException("")
  70. }
分享到：
| 正则表达式全部符号解释
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

Magicbox
Global site tag (gtag.js) - Google Analytics