SpringBoot项目集成FineReport9.0实践

一、背景

​ 因工作需要，部署了一套帆软报表系统，但是在实际应用过程中存在多套系统并存，对于用户来说无疑是一种负担，但是用帆软做报表系统开发报表方便便捷，且springboot配置及应用极为简单，二者结合，如虎添翼。

​ 经过查阅相关资料，大多数整合方案都是将springboot打成war包方式整合，难以体现出springboot的优势所在，因此有了尝试打包成jar的想法，现将具体操作步骤奉上，欢迎大家吐槽。

二、准备工作1、下载安装帆软报表DEMO

​ 点击帆软报表V9.0版本下载并安装，安装成功后将用于报表系统集成及报表设计。

三、集成步骤1、创建SpringBoot项目

​ 创建SpringBoot项目并测试web应用可正常访问。

2、引入帆软报表相关jar

​ 在SpringBoot项目根目录创建lib目录并将如下jar包导入到lib目录

​ 在pom文件中引入对应依赖

​ 其中除了systemPath配置告诉maven引入的本地jar包的位置

        <!--帆软依赖-->

        <dependency>

            <groupId>com.fr</groupId>

            <artifactId>fr-chart</artifactId>

            <version>9.0</version>

            <scope>system</scope>

            <systemPath>${project.basedir}/libs/fr-chart-9.0.jar</systemPath>

        </dependency>

        <dependency>

            <groupId>com.fr</groupId>

            <artifactId>fr-core</artifactId>

            <version>9.0</version>

            <scope>system</scope>

            <systemPath>${project.basedir}/libs/fr-core-9.0.jar</systemPath>

        </dependency>

        <dependency>

            <groupId>com.fr</groupId>

            <artifactId>fr-datasource</artifactId>

            <version>9.0</version>

            <scope>system</scope>

            <systemPath>${project.basedir}/libs/fr-datasource-9.0.jar</systemPath>

        </dependency>

        <dependency>

            <groupId>com.fr</groupId>

            <artifactId>fr-performance</artifactId>

            <version>9.0</version>

            <scope>system</scope>

            <systemPath>${project.basedir}/libs/fr-performance-9.0.jar</systemPath>

        </dependency>

        <dependency>

            <groupId>com.fr</groupId>

            <artifactId>fr-platform</artifactId>

            <version>9.0</version>

            <scope>system</scope>

            <systemPath>${project.basedir}/libs/fr-platform-9.0.jar</systemPath>

        </dependency>

        <dependency>

            <groupId>com.fr</groupId>

            <artifactId>fr-report</artifactId>

            <version>9.0</version>

            <scope>system</scope>

            <systemPath>${project.basedir}/libs/fr-report-9.0.jar</systemPath>

        </dependency>

        <dependency>

            <groupId>com.fr</groupId>

            <artifactId>fr-third</artifactId>

            <version>9.0</version>

            <scope>system</scope>

            <systemPath>${project.basedir}/libs/fr-third-9.0.jar</systemPath>

        </dependency>

        <!-- 数据库相关的包-->

        <!-- https://mvnrepository.com/artifact/com.oracle/ojdbc14 -->

        <dependency>

            <groupId>com.oracle</groupId>

            <artifactId>ojdbc14</artifactId>

            <version>10.2.0.3.0</version>

            <scope>system</scope>

            <systemPath>${project.basedir}/libs/ojdbc14.jar</systemPath>

        </dependency>

        <dependency>

            <groupId>mysql</groupId>

            <artifactId>mysql-connector-java</artifactId>

            <version>5.1.6</version>

        </dependency>

        <!-- https://mvnrepository.com/artifact/com.ibm.informix/jdbc -->

        <dependency>

            <groupId>com.ibm.informix</groupId>

            <artifactId>jdbc</artifactId>

            <version>4.10.6.20151104</version>

        </dependency>

        <!-- https://mvnrepository.com/artifact/org.clojars.gzeureka/javapns -->

        <dependency>

            <groupId>org.clojars.gzeureka</groupId>

            <artifactId>javapns</artifactId>

            <version>2.2</version>

        </dependency>

        <!-- https://mvnrepository.com/artifact/net.sourceforge.jtds/jtds -->

        <dependency>

            <groupId>net.sourceforge.jtds</groupId>

            <artifactId>jtds</artifactId>

            <version>1.2.2</version>

        </dependency>

        <!-- https://mvnrepository.com/artifact/org.xerial/sqlite-jdbc -->

        <dependency>

            <groupId>org.xerial</groupId>

            <artifactId>sqlite-jdbc</artifactId>

            <version>3.8.11.2</version>

        </dependency>

        <!-- https://mvnrepository.com/artifa ... .sqlserver/sqljdbc4 -->

        <dependency>

            <groupId>com.microsoft.sqlserver</groupId>

            <artifactId>sqljdbc4</artifactId>

            <version>4.0</version>

        </dependency>

        <!-- https://mvnrepository.com/artifa ... -sql.plugins/sybase -->

        <dependency>

            <groupId>net.sf.squirrel-sql.plugins</groupId>

            <artifactId>sybase</artifactId>

            <version>3.2.2</version>

        </dependency>

划重点！！！敲黑板！！！下面的一步配置也是最重要的一步，网上很多的教程缺了这样一步之后就会导致虽然本地可以运行，但是只要使用maven打包就不行，因为maven没有将本地的jar也打到生成的包中，在pom中给spring boot的打包插件设置一下includeSystemScope参数即可。

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <!--将本地libs目录下的jar打包到项目中-->
                    <includeSystemScope>true</includeSystemScope>
                </configuration>
            </plugin>
        </plugins>
    </build>3、获取WebReport绝对路径

​ 将WebReport目录拷贝到服务器的指定目录，如：

​ 获取WebReport的绝对路径：

D:\FineReport_9.0\WebReport

4、在Controller中添加Servlet的映射及设置内置Tomcat运行项目目录

@SpringBootApplication

@RestController

public class FinereportApplication {

    public static void main(String[] args) {

        SpringApplication.run(FinereportApplication.class, args);

    }

    /**

     * 验证web服务是否正常

     * @return

     */

    @GetMapping("/hello")

    public String hello(){

        return "Hello World!";

    }

    /**

     * 添加Servlet的映射

     * @return

     */

    @Bean

    public ServletRegistrationBean servletRegistrationBean(){

        return new ServletRegistrationBean(new ReportServlet(),"/ReportServer");

    }

    /**

     * 设置内置Tomcat运行项目目录

     * @return

     */

    @Bean

    public WebServerFactoryCustomizer<ConfigurableWebServerFactory> webServerFactoryCustomizer(){

        // 设置帆软报表根目录（第三步中获取的绝对路径）

        String documentRoot = "D:\FineReport_9.0\WebReport";

        return new WebServerFactoryCustomizer<ConfigurableWebServerFactory>() {

            @Override

            public void customize(ConfigurableWebServerFactory factory) {

                if (factory instanceof TomcatServletWebServerFactory) {

                    TomcatServletWebServerFactory tomcat = (TomcatServletWebServerFactory) factory;

                    if (!StringUtils.isEmpty(documentRoot)) {

                        File root = null;

                        try {

                            root = ResourceUtils.getFile(documentRoot);

                        } catch (FileNotFoundException e) {

                            e.printStackTrace();

                        }

                        tomcat.setDocumentRoot(root);

                    }

                }

            }

        };

    }

}

至此Springboot与帆软报表系统通过jar方式集成方案已经完成，附上项目目录：

四、访问报表集成报表系统启动

打包完成后执行：

java -jar finereportdemo-0.0.1-SNAPSHOT.jar

访问集成报表系统

http://localhost:8080/ReportServer

访问集成报表系统报表：

http://localhost:8080/ReportServer?reportlet=demo/analytics/financial2/财务综合指标.cpt&op=write

帮楼主简单排版了下

传说哥 发表于 2019-12-20 22:33
帮楼主简单排版了下

这个编辑器好复杂，不会排版了

厉害我的国

很好，很强大，试验成功了

resources下的webreport放了什么

按文档一步步弄， 结果启动项目报错了

个人感觉spring boot集成帆软的意义不大，因为打包好的war包包括帆软所需要的静态资源，还有其他的文件，这些大大小小的文件加起来和lib文件一起，大概整个包要超过1G，这样的war包部署到现场还不一定完全能运行，所以个人感觉不如直接用客户端，然后写class文件控制报表,也就是程序控制的方式。