最近,公司采购了帆软的系统,领导安排要与公司的SpringBoot框架进行整合。费了一番牛劲,终于整合成功,下面分享一下我的经验。
首先,我的开发环境是Intellij IDEA,使用的SpringBoot版本是2.1.1,整合的finereport版本是10.0。
一、根据帆软官方教程 http://help.finereport.com/ 高级教程->部署集成->服务器部署->报表部署流程->嵌入式部署的介绍,
将%FineReport_HOME%\webapps\webroot\WEB-INF目录下面的assets、assist、classes、embed、lib、plugins、reportlets七个文件夹复制到你的项目的webapp的WEB-INF文件夹下,再将%JAVA_HOME%/jdk/lib下的tools.jar拷贝到你的项目的webapp的WEB-INF的lib文件夹下,如图所示:
注意,springboot框架默认是不带webapp文件夹以及其子文件夹WEB-INF的,此时需要自己创建这两个文件夹,并将webapp文件夹设置为Web Resource Directory。(通过Project Structure设置)
二、更改SpringBoot的配置(打包方式/启动方式)
1.修改pom文件
(1)修改打包方式为war
(2)修改pom依赖的包,添加servlet依赖,去掉内嵌Tomcat依赖,添加servlet-api依赖:
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
<exclusion>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version>
<scope>provided</scope>
</dependency>
</dependencies>
2.修改启动文件
3.在idea中设置项目以tomcat方式启动
(1)
(2)
(3)
点击Fix时,选择第一个即可。
附一张最后的项目结构图:
三、启动程序
在地址栏中输入http://ip:端口号/项目目录/decision,能成功显示下图页面,则表明SpringBoot集成FineReport成功。
项目源代码链接:
第一部分:https://download.csdn.net/download/weixin_44299969/10894741
第二部分:https://download.csdn.net/download/weixin_44299969/10894769
第三部分:https://download.csdn.net/download/weixin_44299969/10894786
第四部分:https://download.csdn.net/download/weixin_44299969/10894809
四、补充
1.网上的教程中,有很多介绍将finereport的lib文件做成maven repository的,本人试了试,也可以操作成功,具体操作方法为:
(1)新建一个bat文件,并将下列的语句复制进去,注意根据你的实际情况修改finereport的jar包的路径,运行这个bat文件,finereport的jar包就会加载到maven的仓库中
call mvn install:install-file -Dfile=E:\programfiles\FineReport_10.0\webapps\webroot\WEB-INF\lib\fine-accumulator-10.0.jar -DgroupId=com.fine -DartifactId=fine-accumulator -Dversion=10.0 -Dpackaging=jar call mvn install:install-file -Dfile=E:\programfiles\FineReport_10.0\webapps\webroot\WEB-INF\lib\fine-activator-10.0.jar -DgroupId=com.fine -DartifactId=fine-activator -Dversion=10.0 -Dpackaging=jar call mvn install:install-file -Dfile=E:\programfiles\FineReport_10.0\webapps\webroot\WEB-INF\lib\fine-core-10.0.jar -DgroupId=com.fine -DartifactId=fine-core -Dversion=10.0 -Dpackaging=jar call mvn install:install-file -Dfile=E:\programfiles\FineReport_10.0\webapps\webroot\WEB-INF\lib\fine-datasource-10.0.jar -DgroupId=com.fine -DartifactId=fine-datasource -Dversion=10.0 -Dpackaging=jar call mvn install:install-file -Dfile=E:\programfiles\FineReport_10.0\webapps\webroot\WEB-INF\lib\fine-decision-10.0.jar -DgroupId=com.fine -DartifactId=fine-decision -Dversion=10.0 -Dpackaging=jar call mvn install:install-file -Dfile=E:\programfiles\FineReport_10.0\webapps\webroot\WEB-INF\lib\fine-decision-report-10.0.jar -DgroupId=com.fine -DartifactId=fine-decision-report -Dversion=10.0 -Dpackaging=jar call mvn install:install-file -Dfile=E:\programfiles\FineReport_10.0\webapps\webroot\WEB-INF\lib\fine-report-engine-10.0.jar -DgroupId=com.fine -DartifactId=fine-report-engine -Dversion=10.0 -Dpackaging=jar call mvn install:install-file -Dfile=E:\programfiles\FineReport_10.0\webapps\webroot\WEB-INF\lib\fine-schedule-10.0.jar -DgroupId=com.fine -DartifactId=fine-schedule -Dversion=10.0 -Dpackaging=jar call mvn install:install-file -Dfile=E:\programfiles\FineReport_10.0\webapps\webroot\WEB-INF\lib\fine-schedule-report-10.0.jar -DgroupId=com.fine -DartifactId=fine-schedule-report -Dversion=10.0 -Dpackaging=jar call mvn install:install-file -Dfile=E:\programfiles\FineReport_10.0\webapps\webroot\WEB-INF\lib\fine-swift-log-adaptor-10.0.jar -DgroupId=com.fine -DartifactId=fine-swift-log-adaptor -Dversion=10.0 -Dpackaging=jar call mvn install:install-file -Dfile=E:\programfiles\FineReport_10.0\webapps\webroot\WEB-INF\lib\fine-third-10.0.jar -DgroupId=com.fine -DartifactId=fine-third -Dversion=10.0 -Dpackaging=jar call mvn install:install-file -Dfile=E:\programfiles\FineReport_10.0\webapps\webroot\WEB-INF\lib\fine-webui-10.0.jar -DgroupId=com.fine -DartifactId=fine-webui -Dversion=10.0 -Dpackaging=jar
(2)在pom文件中,添加以下依赖(正文中的依赖不变)
<dependency>
<groupId>com.fine</groupId>
<artifactId>fine-core</artifactId>
<version>10.0</version>
</dependency>
<dependency>
<groupId>com.fine</groupId>
<artifactId>fine-activator</artifactId>
<version>10.0</version>
</dependency>
<dependency>
<groupId>com.fine</groupId>
<artifactId>fine-core</artifactId>
<version>10.0</version>
</dependency>
<dependency>
<groupId>com.fine</groupId>
<artifactId>fine-datasource</artifactId>
<version>10.0</version>
</dependency>
<dependency>
<groupId>com.fine</groupId>
<artifactId>fine-decision</artifactId>
<version>10.0</version>
</dependency>
<dependency>
<groupId>com.fine</groupId>
<artifactId>fine-decision-report</artifactId>
<version>10.0</version>
</dependency>
<dependency>
<groupId>com.fine</groupId>
<artifactId>fine-report-engine</artifactId>
<version>10.0</version>
</dependency>
<dependency>
<groupId>com.fine</groupId>
<artifactId>fine-schedule</artifactId>
<version>10.0</version>
</dependency>
<dependency>
<groupId>com.fine</groupId>
<artifactId>fine-schedule-report</artifactId>
<version>10.0</version>
</dependency>
<dependency>
<groupId>com.fine</groupId>
<artifactId>fine-swift-log-adaptor</artifactId>
<version>10.0</version>
</dependency>
<dependency>
<groupId>com.fine</groupId>
<artifactId>fine-third</artifactId>
<version>10.0</version>
</dependency>
<dependency>
<groupId>com.fine</groupId>
<artifactId>fine-webui</artifactId>
<version>10.0</version>
</dependency>
(3)此时,正文中第一步的过程中,可以把帆软提供的lib文件中以fine打头的jar包不拷贝到你的项目的webapp中