方法与材料

1、 方法/步骤

2、 FineReport 7.1.1 是一款功能完备的报表设计与开发平台软件。

3、 安装包体积为148.2MB，支持Windows及Linux操作系统环境。

4、 参照报表应用的标准目录结构说明，若需将报表模块嵌入已有Web工程，应严格依照图示目录层级，将对应报表资源文件迁移至目标工程的相应路径中。

5、 全量内容迁移方案

6、 为提升部署效率，推荐直接将FineReport安装路径下 WebReport/WEB-INF 目录中的 classes、lib、reportlets 和 resources 四个核心文件夹整体拷贝至 Tomcat 的 webapps/jsp-examples/WEB-INF 目录中。该方式操作便捷、适配性强，适用于快速上线且无需深度定制的集成场景，可显著缩短部署周期。

7、 在与用户项目融合过程中，%FineReport_HOME%/WebReport/WEB-INF/classes 目录下存放的网络报表相关 class 文件不会引发类冲突，可稳定运行。

8、 关于网络报表的具体使用规范与扩展机制，请参阅官方提供的二次开发技术文档。

9、 部分内容迁移方案

10、 用户可根据实际需求，仅选取关键组件进行部署，实现轻量化集成。

11、 必需迁移的资源清单

12、 fr-server-7.1.jar：封装了FineReport全部服务逻辑，必须放置于 WEB-INF/lib 目录下。

13、 fr-third-7.1.jar：提供报表运行所依赖的关键第三方组件，须同步复制至 WEB-INF/lib 目录，否则系统无法正常启动。

14、 reportlets 文件夹为FineReport预设的固定命名目录，名称须全小写，严禁修改大小写或重命名。

15、 支持在其内部创建多级子目录；所有报表模板（.cpt格式）均需存放在该目录及其子路径中；且 reportlets 文件夹必须置于 WEB-INF 根目录下。

16、 resources 文件夹为FineReport服务器必需的配置目录，命名强制小写、不可变更，用于存储系统配置文件（如 finereport.xml 等），需完整复制至 WEB-INF 目录内。

17、 上述必要文件及目录均需准确导入至当前Web应用的对应位置。

18、 可选迁移项

19、 classes 文件夹属于Java Web容器标准目录，主要用于存放编译后的字节码文件（.class）。若开展FineReport二次开发（如自定义函数、程序数据源、网络报表等），需将生成的 class 文件统一放入此目录，确保JVM能正确识别并加载扩展功能。

20、 若报表通过JDBC方式访问数据库，需额外引入对应数据库厂商提供的驱动程序。

21、 以Oracle为例，需将 ojdbc14.jar 驱动包复制到 WEB-INF/lib 目录；其他数据库（如MySQL、SQL Server等）同理处理。

22、 需在现有工程的 web.xml 配置文件中新增 servlet 定义及映射规则。

23、 请从 %FineReport_HOME%/WebReport/WEB-INF/web.xml 中提取指定的 servlet 与 servlet-mapping 片段，粘贴至目标工程路径 %Web_home%/webapps/项目名/WEB-INF/web.xml 的末尾——具体位置为最后一个 标签之后，确保新配置生效且不破坏原有结构。

24、 将上述配置代码插入指定 web.xml 文件后保存，最终效果如下图所示。

25、 注意 web.xml 中各元素存在严格的顺序约束：<servlet></servlet> 必须位于 <servlet-mapping></servlet-mapping> 之前定义。为保障配置可维护性与系统稳定性，建议将全部 servlet 声明集中置于所有 servlet-mapping 配置之前，形成清晰、合规的XML结构，防止因顺序错乱导致部署失败或运行异常。

26、 验证报表访问是否成功

27、 重启Tomcat服务，启动浏览器，在地址栏输入指定URL地址。

28、 访问地址为：https://www.php.cn/link/e225f54774a1fa1358ba9f23b2809ad5 FineReport 已顺利完成与Web应用的集成，并已在Tomcat服务器上成功部署。