1.直接在jasperreports-1.3.0-project工程中运行,ant编译"demo\samples\webapp"的build.xml,可以直接看到由webapp中的.jrxml文件定义的报表格式,但是无法显示数据源的数据;

2.上述ant编译"demo\samples\webapp"的build.xml时,也出现了"-Xlint:unchecked" 和"- Xlint:deprecation"的版本兼容问题的错误,在build.xml中加入编译参数后,没什么变化,依然只是能看到.jrxml文件定义的报表格式,无法显示数据;

3.运行时出错,提示:
viewDesign:
net.sf.jasperreports.engine.JRException: java.io.FileNotFoundException: reports\WebappReport.jasper
at net.sf.jasperreports.engine.util.JRLoader.loadObject(JRLoader.java:75)

查看了一下"webapp\reports"目录,果然没有编译好的WebappReport.jasper文件,那么是操作问题导致编译出错无法把.jrxml编译成.jasper,还是程序本身就没有调用编译设计文件的代码?

4.查看build.xml文件中运行的net.sf.jasperreports.view.JasperDesignViewer类的源代码,以及看build.xml中提供的参数,发现JasperDesignViewer类只是根据传入的.jrxml或者.jasper文件的路径显示报表,并不负责编译和填充xml设计文件;

5.ok,webapp示例应该就是只提供了在web服务器中跑的支持,并不同时提供直接applet方式显示,简单让它能够根据.jrxml或者.jasper源设计文件看一下报表格式而已。因为applet方式显示报表的示例charts中都有了,也没必要提供支持了。

6.所以,如有要显示webapp示例,只能在web服务器中部署运行了。这个示例也正是用来展示web环境下如何使用jasperreports开发报表的!

7.部署webapp示例详见下文;

二、myeclipse+tomcat部署运行jasperreports的webapp示例step by step
1.在eclipse中新建web 工程:"jasperwebappproject";

2.把"jasperreports-1.3.0-project\demo\samples\webapp"下的所有文件拷贝到新建的web工程("jasperwebappproject")的webroot下;

注意:
* 此时新工程的webroot目录就与原webapp目录结构对应上了(不要把该webapp文件夹也拷贝过去了,因为新建web工程就默认有webroot根目录了),拷贝时要覆盖掉新建工程时webroot下的原WEB-INF目录;

*一定要确保webapp\WEB-INF\classes目录的下的三个源代码文件夹(datasource、scriptlets、servlets)和web.xml文件都拷贝过去了!!
因为本人操作的时候发现,有时候原WEB-INF文件能够全部拷贝过去,有时候skip掉没有拷贝过去。

*如果没有把该web.xml拷贝过去,将无法运行示例中的servlet samples,并且jsp samples中也无法显示图片!因为web.xml中没有配置ImageServlet:

ImageServlet
net.sf.jasperreports.j2ee.servlets.ImageServlet



ImageServlet
/servlets/p_w_picpath


3.把"jasperreports-1.3.0-project\lib"与"jasperreports-1.3.0-project\dist"下的所有jar包拷贝到新建工程的lib下;
注释:其实只需要拷贝webapp中build.xml文件中要include的jar包,不过本人懒得一一去对了,把所有的jar包都加上,图省事;

4.右键新建工程"jasperwebappproject"->"Properties"->"Java build path"->"source"-"add folder...",把"jasperwebappproject\webroot\WEB-INF\classes"文件夹打上勾,即:把classes文件夹也设置为source folder;因为classes文件夹下有.java源文件,如果不设置为source folder,就需要手工编译了,并且eclipse还可能因为自动编译把该classes的源文件全部清空,因为src是空的。
所以,一定要把classes文件夹设置为source folder;

注:
"Java build path"->"source"中有一选项"allow output folders for source folders",按字面理解应该是把该项选上就是把默认的输出路径WEB-INF\classes设置为source folder了,但是我把它选上了,好像没有效果,只是当时把classes加入source树了,但是下次再查看工程properties还是原样,工程中也没有把classes当作source folder,而且还把classes目录清空了。
选项"allow output folders for source folders"到底是干什么用的呢?不知道了,期待知道的回答一下,万分感谢!

5.此时,我们把webapp下的所有文件和需要的所有jar包都拷贝到新工程了,并且把WEB-INF\classes设置为source folder了;但是如果此时转换到J2EE development视图的话,会发现工程中报了很多错误,主要是.jsp文件和.html文件大量报错。.html文件的错误无关紧要,只是多了一些没有开始标签的结束标签,改不改都不影响运行。但是.jsp文件怎么会报错,提示很多类文件找不到呢?所需要的jar包(包括jasperreports-1.3.0.jar)和数据源等文件(WEB-INF\classes\datasource)都在工程中了呀!
解决:
根据以往经验,eclipse中如果直接把别人的代码复制粘贴上去,即使所有的类文件和jar包都存在,也会报错,需要把该.java源文件重新"剪切"粘贴一下,这样就不报错了。
试了一下,把jsp文件夹下的compile.jsp,fill.jsp,viewer.jsp,html.jsp文件前面部分导入包和类的那些语句(eg.<%@ page import="datasource.*" %>)重新剪切粘贴一下,保存,耶,不提示红×错误了!

注:
不理会eclipse中这些.jsp文件的报错也没关系,因为部署到tomcat后,运行时肯定是能够找到所需要的类的,因为那些jar包都在工程中了。不过在eclipse中看着那么多的红×错误,还是剪切粘贴一下消除它,心里比较爽。

6.把工程部署(deploy)到tomcat中;

7.启动tomcat;

8.在IE中输入"http://192.168.3.161:9005/jasperSampleWebapp/index.html",正确显示!
9.点左边的菜单"compile JRXML",点右边的"jsp examples",->"execute",提示编译成功!
10.点左边的菜单"fill report",点右边的"jsp examples",->"execute",提示填充数据成功!
11.点左边的菜单"export report",分别可以以pdf,html等格式输出报表!耶,革命终于胜利!

ok!

三、小结:
总结运行jasperreports的webapp示例的关键几个步骤:
1.要确保webapp\WEB-INF\classes目录的下的三个源代码文件夹(datasource、scriptlets、servlets)和web.xml文件都拷贝过去了!!
2.要把WEB-INF\classes设置为source folder,否则提示找不到数据源,因为该webapp示例的数据源是WEB-INF\classes\datasource\WebappDataSource.java里的二维数组;
3.要确保把原web.xml复制到工程中了,否则无法显示图片,也无法运行servlet samples;
4.*.jsp文件的报错可通过重新剪切粘贴一下来消除;
5.ie中浏览图表时要按照“compile、fill、export”的顺序点击,这样才能顺利看到报表。

四、其他相关内容:
1.把.jrxml编译成.jasper文件的类是:net.sf.jasperreports.engine.JasperCompileManager
方法compileReportToFile:这个方法能够创建一个在整个程序中使用的编译的报告文件(.jasper)。

这个类有两个重载函数,一个只有一个参数,指定.jrxml的路径;另一个有两个参数,分别指定.jrxml的路径和.jasper的输出路径;
compileReportToFile(String srcdir): 编译.jrxml得到.jasper,但是不输出该.jasper文件;
compileReportToFile(String srcdir,String destdir): 编译.jrxml得到.jasper,并且输出该.jasper文件到指定路径;

验证:
法一:
把compile.jsp中的关键的一行代码:
JasperCompileManager.compileReportToFile(application.getRealPath("/reports/WebappReport.jrxml"));
改为:
JasperCompileManager.compileReportToFile(application.getRealPath("/reports/WebappReport.jrxml"),application.getRealPath("/reports/WebappReport.jasper"));

重启tomcat,运行该compile.jsp文件,这时可以在tomcat的目录"tomcat5.5.17\webapps\jasperSampleWebapp\reports"下看到新生成的WebappReport.jasper文件!

法二:
写一个包含main函数的测试类,执行JasperCompileManager.compileReportToFile方法:

package test;

import net.sf.jasperreports.engine.JRException;
import net.sf.jasperreports.engine.JasperCompileManager;
import net.sf.jasperreports.engine.design.*;

public class testCompileManager{
public static void main(String[] args) {
String sourceFileName="E:\\jiangcm\\workspace-forict-myeclipse\\jasperreports\\demo\\samples\\webapp\\reports\\WebappReport.jrxml";
String destFileName="E:\\jiangcm\\workspace-forict-myeclipse\\jasperreports\\demo\\samples\\webapp\\reports\\WebappReport.jasper";
try {
JasperCompileManager.compileReportToFile(sourceFileName, destFileName);
} catch (JRException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}