原文地址：https://www.jianshu.com/p/33cc25cd0043欢迎转载

一、背景

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

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

二、准备工作

1、下载安装帆软报表DEMO

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

三、集成步骤

1、创建SpringBoot项目

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

2、引入帆软报表相关jar

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

1576825901192.png

在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/artifact/com.microsoft.sqlserver/sqljdbc4 -->
        <dependency>
            <groupId>com.microsoft.sqlserver</groupId>
            <artifactId>sqljdbc4</artifactId>
            <version>4.0</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/net.sf.squirrel-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目录拷贝到服务器的指定目录，如：

1576830659018.png

获取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 = new File(documentRoot);
                        tomcat.setDocumentRoot(root);
                    }
                }
            }
        };
    }
}

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

1576831967686.png

四、访问报表

集成报表系统启动

打包完成后执行：

java -jar finereportdemo-0.0.1-SNAPSHOT.jar

访问集成报表系统

http://localhost:8080/ReportServer

1576831706544.png

访问集成报表系统报表：

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

1576831852102.png

SpringBoot集成FineReport9.0实践