Code Monkey home page Code Monkey logo

fine-report's Introduction

fine-report

帆软报表10.0嵌入集成,基于spring boot,可扩展 spring cloud。无侵入,高扩展。

  1. 本质是springboot 嵌入式tomcat提供壳子启动以外部资源启动。
  2. 可以自行更新帆软最新lib,自行更新数据源说使用jar
  3. 通过类加载的顺序,自定义功能生成classes文件之后引入

配置

准备帆软服务器文件

帆软官网下载指定系统类型的服务器部署版的包。 finereport_download

帆软文件路径

准备帆软文件的DOC_BASE路径,例如设置为/data/fr10-web

​ 下载最新版本finereport10,将webapps/webroot/下所有文件和文件夹复制都**/data/fr10-web/** 下

path

image-20210202154711407

部署

打包

mvn clean package -DskipTest=true

运行

java -Xmx1g -Xms1g \
-DDOC_BASE='/data/fr10-web' \
-Dloader.path="BOOT-INF/classes/,file:/data/fr10-web/WEB-INF/classes,file:/data/fr10-web/WEB-INF/lib,BOOT-INF/lib/,/Library/Java/JavaVirtualMachines/jdk1.8.0_221.jdk/Contents/Home/lib/tools.jar" \
-jar hdsp-fr-server.jar  > ./logs/hdsp-fr-server.log 2>&1 &

重点:

loader.path loader.path为spring boot loader的lib包加载目录,同时⚠️loader.path的顺序为加载类的顺序。指定值中

  1. BOOT-INF/classes/, hdsp-fr-server.jar包内Spring-Boot-Classes目录。
  2. BOOT-INF/lib/,hdsp-fr-server.jar包内BOOT-INF/lib/目录。
  3. /Library/Java/JavaVirtualMachines/jdk1.8.0_221.jdk/Contents/Home/lib/tools.jar 这个修改,修改为服务器的java tools包的路径,在$JAVA_HOME/lib/tools.jar下,需要指定为绝对路径。
  4. 帆软的jar,指定绝对目录,在DOC_BASE 下 lib。例如DOC_BASE/data/fr10-web ,指定为file:/data/fr10-web/WEB-INF/lib
  5. 帆软重载的classes,指定绝对目录,在DOC_BASE 下classes。例如DOC_BASE/data/fr10-web,指定为file:/data/fr10-web/WEB-INF/classes

运行

image-20210202170200431

  • 访问帆软模板:http://127.0.0.1:8080/decision/view/report?viewlet=GettingStarted.cpt,其中GettingStarted.cpt是帆软默认提供的。

image-20210202170324976

实现

内置tomcat定制化

第一种方式是通过通用的 Web 容器工厂 ConfigurableServletWebServerFactory,来定制一些 Web 容器通用的参数:

@Component
public class MyGeneralCustomizer implements
  WebServerFactoryCustomizer<ConfigurableServletWebServerFactory> {
  
    public void customize(ConfigurableServletWebServerFactory factory) {
        factory.setPort(8081);
        factory.setContextPath("/hello");
     }
}

第二种方式是通过特定 Web 容器的工厂比如 TomcatServletWebServerFactory 来进一步定制。下面的例子里,我们给 Tomcat 增加一个 Valve,这个 Valve 的功能是向请求头里添加 traceid,用于分布式追踪。

class TraceValve extends ValveBase {
    @Override
    public void invoke(Request request, Response response) throws IOException, ServletException {

        request.getCoyoteRequest().getMimeHeaders().
        addValue("traceid").setString("1234xxxxabcd");

        Valve next = getNext();
        if (null == next) {
            return;
        }

        next.invoke(request, response);
    }
}

跟第一种方式类似,再添加一个定制器,代码如下:

@Component
public class MyTomcatCustomizer implements
        WebServerFactoryCustomizer<TomcatServletWebServerFactory> {

    @Override
    public void customize(TomcatServletWebServerFactory factory) {
        factory.setPort(8081);
        factory.setContextPath("/hello");
        factory.addEngineValves(new TraceValve() );

    }
}

PropertiesLauncher

springboot 提供的类加载机制。可以通过这个扩展加载方式。指定外部jar的加载方式。打包时指定repackage 会默认选择PropertiesLauncher。

核心代码

    public static class FineReportWebServerFactoryCustomizer implements WebServerFactoryCustomizer<TomcatServletWebServerFactory>, Ordered {

        @Override
        public void customize(TomcatServletWebServerFactory factory) {
            String docBase = System.getProperty("DOC_BASE");
            if (StringUtils.isEmpty(docBase)) {
                throw new IllegalArgumentException("DOC_BASE system property can't empty");
            }
            File file = new File(docBase);
            if (!file.exists()) {
                boolean mkdirsStatus = file.mkdirs();
            }
            if (file.exists() && file.isDirectory()) {
                String env = file.getAbsoluteFile().getPath();
                factory.setDocumentRoot(file);
            } else {
                throw new IllegalArgumentException("Fine webapp dir [env] not found");
            }
            // 加载帆软Web
            factory.getTomcatContextCustomizers()
                    .add(context -> context.addApplicationListener("com.fr.startup.FineServletContextListener"));
        }

        @Override
        public int getOrder() {
            return 0;
        }
    }

其它

spring不支持加载超大jar包(了解就好)

​ 自己打包Spring boot项目依赖了第三方的fine-third jar包过大,导致启动后报错Caused by: java.lang.IllegalStateException: Zip64 archives are not supported.

方式一

将一个jar拆分为多个jar,使用 jar -xf 解压jar 后拆解,使用jar -cf 压缩jar。

方式二

Spring boot 2.2.x的版本进行了修复。可以将spring-boot-loader打包插件的版本提升到 2.2.x以上

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <version>2.3.2.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-loader</artifactId>
            <version>2.3.2.RELEASE</version>
        </dependency>
    </dependencies>
</dependencyManagement>

问题

为什么要重置src/main/webapp目录到env

这是因为创建src/main/webapp目录后,如果将帆软资源复制进去后,那么在打包的时候,则需要打成war包(通过tomcat部署)。

而重置webapp目录到env后,可以打包成jar包,帆软此时通过env目录来进行配置读取、模版解析、备份等。

也就是说,env目录相当于tomcatdocBase了。

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.