1. 概述
1.1 版本
Tomcat 版本 | JDK 版本 |
---|---|
推荐使用 Tomcat8.5.57 及以上版本,或者 Tomcat8 最新版本 注:使用推荐版本可减少因 Tomcat 版本过低导致的安全问题。 支持Tomcat7.0~9.0 版本 不支持 Tomcat10.0 版 | JDK 1.8 且小版本需在 JDK8u102 以上 |
1.2 应用场景
用户经常需要将 FineReport10.0 服务器集成到已有的工程中使用,以便在工程里直接调用 FineReport 服务器的代码。
由 报表安装目录结构 章节可知,若希望将报表部署到已有的工程中时,需要按照下图所示的目录结构,将报表相关的文件拷贝到相应目录:
注1:本文方法不适用于 springboot 。springboot 相关免费用户建议到 问答 咨询下;付费用户建议询问技术支持:技术支持联系方式:前往「服务」,选择「在线支持」、电话「400-811-8890」
注2:不需要在目标系统的 web.xml 中配置 Servlet 。
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.jar、visualvm-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 应用成功,如下图所示: