历史版本33 :Windows下Tomcat嵌入式部署FineReport工程 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本

Tomcat 版本JDK 版本
Tomcat 8及以上
1.8
注:不需要在目标系统的web.xml中配置servlet。

1.2 应用场景

用户经常需要将 FineReport10.0 服务器集成到已有的工程中使用,以便在工程里直接调用 FineReport 服务器的代码。

由 报表应用目录结构 章节可知,若希望将报表部署到已有的工程中时,需要按照下图所示的目录结构,将报表相关的文件拷贝到相应目录:

222

2. 复制目录编辑

2.1 全部复制

为了简便,可以直接将%FineReport_HOME%webapps/webroot/WEB-INF目录下面的 assets、assist、classes、embed、lib、plugins、reportlets 七个文件夹复制到%Tomcat_HOME% webapps/examples/WEB-INF下。

注:%FineReport_HOME%webapps/webroot/WEB-INF/classes文件夹下面可能会放置一些网络报表的 class 文件,在和用户工程集成时并无冲突。

有关网络报表的介绍,可以在二次开发文档中找到

2.2 部分复制

也可以选择性的只复制必要性文件至已有工程中。

2.2.1 必须复制的文件

JAR 包:lib 中以 fine 开头的 JAR 包(包含了报表服务的所有功能),及 netty-all-xxx.Final.jarvisualvm-xxx.jar,必须拷贝至 WEB-INFlib 下;

assets:新特性图表 8.6.0 及以后版本存放图表资源的目录。

assist:存放一些辅助工具,比如新图表要使用 phantom 等。

plugins:该文件夹包含了报表管理里安装的所有插件的 JAR 包和配置信息,拷贝至 WEB-INF 下面。

reportlets:该文件夹为 FineReport 服务器规定的,不能修改,且必须为小写,其下可以建立子目录,所有报表模板 cpt 文件必须保存在 reportlets 文件夹下,且 reportlets 文件必须放在 WEB-INF 下面。

注:以上文件或文件夹是必须拷贝到已有应用目录下的。

2.2.2 选择性复制的文件

embed:存储 HSQL,所有的配置信息,推荐拷贝至 WEB-INF 下面,否则部署的为新工程。

classes:该文件夹是应用服务器规定的,主要作用是存放 .class文件。若对 FineReport 进行了二次开发,如自定义函数、程序数据源、程序网络报表等,也需要将编译后的 class 类文件拷贝到该文件夹下;

数据库驱动包:若报表中使用了 JDBC 连接了数据库,需要将对应的数据库驱动包如Oracle数据库的驱动ojdbc14.jar拷贝到WEB-INFlib下,其他数据库驱动同样;

2.3 拷贝 tools.jar

%JAVA_HOME%/jdk/lib下的 tools.jar 拷贝到部署的服务器中,详情参考:服务器部署需引入 tools.jar

3. 检测是否部署成功编辑

可以通过浏览报表确定是否部署成功。

重新启动工程,打开浏览器,在地址栏输入

http:/ip:服务器端口号/项目所在目录/decision,能成功进入下图所示页面,则表明 FineReport 应用集成 Web 应用成功,如下图所示:

222
注:SpringBoot 集成请参见:SpringBoot 集成 FineReport 。