jasperreport学习官方例子：webapp

学习开源项目的最好办法：通过学习官方例子。当然，在这之前最好看看关于这个开源项目是什么东东，有什么基本概念。

对于jasperreport，建议先看看官网里面的这篇文章：

http://jasperforge.org/projects/jasperreports



一、将webapp部署到tomcat上

首先，要run一下ant对应的build.xml文件

看一下主要是做了以下两个事情：

1、将一些需要的jar文件拷贝到lib目录下（注意执行build操作时，这个webapp目录必须要在原来的目录下，或者需要修改build.xml文件里面的部分目录参数）

2、编译class目录下java文件

当然，还可以打包的，但是发现这个功能在这个build.xml中有点问题，所以索性复制整个目录到tomcat里面算了！

到此为止，我们可以通过这个build.xml文件可以学习到这个webapp需要什么lib的支持！

然后，就是复制目录了

最后，就是启动tomcat。

二、通过webapp学习报表生成的过程

步骤一：compile JRXML

例子原来在reports目录就有一个WebappReport.jrxml文件（一个xml文件）

这个步骤完成的就是将WebappReport.jrxml文件编译成一个对应的WebappReport.jasper

示例中分别用了两种方式，servlet和jsp,其实做的东西都差不多，不过个人推荐使用jsp。

下面就节选完成这个步骤的关键代码：

try

{

JasperCompileManager.compileReportToFile(context.getRealPath("/reports/WebappReport.jrxml"));

}

catch (JRException e)

{
注：在这种情况下，生成的jasper文件的目录与/WebappReport.jrxml一样

总结：一般编译jasper文件不是在线完成的，在线下完成；而且不容易改变的！

步骤二：fill report

将数据渲染到report模板中，得到一个JasperPrint对象

将这个JasperPrint对象放到session,以便后续处理!

关键代码以及分析：

try

{

String reportFileName = context.getRealPath("/reports/WebappReport.jasper");

File reportFile = new File(reportFileName);

if (!reportFile.exists())

throw new JRRuntimeException("File WebappReport.jasper not found. The report design must be compiled first.");

//parameters用来对原来jrxml中自定义的parameter进行赋值

Map parameters = new HashMap();

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

parameters.put("BaseDir", reportFile.getParentFile());

//里面的 new WebappDataSource()对象是数据的来源

JasperPrint jasperPrint =

JasperFillManager.fillReport(

reportFileName,

parameters,

new WebappDataSource()

);

//上面生成的JasperPrint对象可以理解成一个渲染了数据的report的包裹

request.getSession().setAttribute(BaseHttpServlet.DEFAULT_JASPER_PRINT_SESSION_ATTRIBUTE, jasperPrint);

}

catch (JRException e)


步骤三：export report

根据不同要求（文件格式），将JasperPrint对象以对应的文件格式显示出来。

比如说将report以pdf的方式：

//从session中取回jasperPrint对象

List jasperPrintList = BaseHttpServlet.getJasperPrintList(request);



62

63 if (jasperPrintList == null)



64 {



65 throw new ServletException("No JasperPrint documents found on the HTTP session.");



66 }



67



68 Boolean isBuffered = Boolean.valueOf(request.getParameter(BaseHttpServlet.BUFFERED_OUTPUT_REQUEST_PARAMETER));



69 if (isBuffered.booleanValue())



70 {

//生成输出器

71 JRPdfExporter exporter = new JRPdfExporter();



72 exporter.setParameter(JRExporterParameter.JASPER_PRINT_LIST, jasperPrintList);



73

74 ByteArrayOutputStream baos = new ByteArrayOutputStream();



75 exporter.setParameter(JRExporterParameter.OUTPUT_STREAM, baos);



76



77 try



78 {

//输出

79 exporter.exportReport();



80 }



81 catch (JRException e)







解释结束！