凡科网站可以做自适应的吗,wordpress编辑页面图片并排,网店营销推广计划书,医院网站建设预算表在函数计算(Aliyun FC)中发布一个 Java 函数#xff0c;往往需要将函数打包成一个 all-in-one 的 zip 包或者 jar 包。Java 中这种打包 all-in-one 的技术常称之为 Fatjar 技术。本文小结一下 Java 里打包 FatJar 的若干种方法。 什么是 FatJar FatJar 又称作 uber-Jar#x… 在函数计算(Aliyun FC)中发布一个 Java 函数往往需要将函数打包成一个 all-in-one 的 zip 包或者 jar 包。Java 中这种打包 all-in-one 的技术常称之为 Fatjar 技术。本文小结一下 Java 里打包 FatJar 的若干种方法。 什么是 FatJar FatJar 又称作 uber-Jar是包含所有依赖的 Jar 包。Jar 包中嵌入了除 java 虚拟机以外的所有依赖。我们知道 Java 的依赖分为两种 零散的 .class 文件和把多个 .class 文件以 zip 格式打包而成 jar 文件。FatJar 是一个 all-in-one Jar 包。FatJar 技术可以让那些用于最终发布的 Jar 便于部署和运行。 三种打包方法 我们知道 .java 源码文件会被编译器编译成字节码.class 文件。Java 虚拟机执行的是 .class 文件。一个 java 程序可以有很多个 .class文件。这些 .class 文件可以由 java 虚拟机的类装载器运行期装载到内存里。java 虚拟机可以从某个目录装载所有的 .class 文件但是这些零散的.class 文件并不便于分发。所有 java 支持把零散的.class 文件打包成 zip 格式的 .jar 文件并且虚拟机的类装载器支持直接装载 .jar 文件。 一个正常的 java 程序会有若干个.class 文件和所依赖的第三方库的 jar 文件组成。 1. 非遮蔽方法Unshaded 非遮蔽是相对于遮蔽而说的可以理解为一种朴素的办法。解压所有 jar 文件再重新打包成一个新的单独的 jar 文件。 借助 Maven Assembly Plugin 都可以轻松实现非遮蔽方法的打包。 Maven Assembly Plugin Maven Assembly Plugin 是一个打包聚合插件其主要功能是把项目的编译输出协同依赖模块文档和其他文件打包成一个独立的发布包。使用描述符descriptor来配置需要打包的物料组合。并预定义了常用的描述符可供直接使用。 预定义描述符如下 bin 只打包编译结果并包含 README, LICENSE 和 NOTICE 文件输出文件格式为 tar.gz, tar.bz2 和 zip。 jar-with-dependencies 打包编译结果并带上所有的依赖如果依赖的是 jar 包jar 包会被解压开平铺到最终的 uber-jar 里去。输出格式为 jar。 src 打包源码文件。输出格式为 tar.gz, tar.bz2 和 zip。 project 打包整个项目除了部署输出目录 target 以外的所有文件和目录都会被打包。输出格式为 tar.gz, tar.bz2 和 zip。除了预定义的描述符用户也可以指定描述符以满足不同的打包需求。 打包成 uber-jar需要使用预定义的 jar-with-dependencies 描述符 在 pom.xml 中加入如下配置 plugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-assembly-plugin/artifactIdversionCHOOSE LATEST VERSION HERE/versionconfigurationdescriptorRefsdescriptorRefjar-with-dependencies/descriptorRef/descriptorRefs/configurationexecutionsexecutionidassemble-all/idphasepackage/phasegoalsgoalsingle/goal/goals/execution/executions
/plugin Gradle Java plugin gradle 下打包一个非遮蔽的 jar 包有不少插件可以用但是由于 gradle 自身的灵活性可以直接用 groove 的 dsl 实现。 apply plugin: javajar {from {(configurations.runtime).collect {it.isDirectory() ? it : zipTree(it)}}
} 非遮蔽方法会把所有的 jar 包里的文件都解压到一个目录里然后在打包同一个 fatjar 中。对于复杂应用很可能会碰到同名类相互覆盖问题。 2. 遮蔽方法Shaded 遮蔽方法会把依赖包里的类路径进行修改到某个子路径下这样可以一定程度上避免同名类相互覆盖的问题。最终发布的 jar 也不会带入传递依赖冲突问题给下游。 Maven Shade Plugin 在 pom.xml 中加入如下配置 plugingroupIdorg.apache.maven.plugins/groupIdartifactIdmaven-shade-plugin/artifactIdversion3.1.1/versionconfiguration!-- put your configurations here --/configurationexecutionsexecutionphasepackage/phasegoalsgoalshade/goal/goals/execution/executions/plugin Gradle Shadow plugin Gradle shadow plugin 使用非常简单简单声明插件后就可以生效。 plugins {id com.github.johnrengelman.shadow version 2.0.4id java
}shadowJar {include *.jarinclude *.propertiesexclude a2.properties
} 遮蔽方法依赖修改 class 的字节码更新依赖文件的包路径达到规避同名同包类冲突的问题但是改名也会带来其他问题比如代码中使用 Class.forName 或 ClassLoader.loadClass 装载的类Shade Plugin 是感知不到的。同名文件覆盖问题也没法杜绝比如META-INF/services/javax.script.ScriptEngineFactory不属于类文件但是被覆盖后会出现问题。 3. 嵌套方法Jar of Jars 还是一种办法就是在 jar 包里嵌套其他 jar这个方法可以彻底避免解压同名覆盖的问题但是这个方法不被 JVM 原生支持因为 JDK 提供的 ClassLoader 仅支持装载嵌套 jar 包的 class 文件。所以这种方法需要自定义 ClassLoader 以支持嵌套 jar。 Onejar Maven Plugin One-JAR 就是一个基于上面嵌套 jar 实现的工具。onejar-maven-plugin 是社区基于 onejar 实现的 maven 插件。 plugingroupIdcom.jolira/groupIdartifactIdonejar-maven-plugin/artifactIdversion1.4.4/versionexecutionsexecutiongoalsgoalone-jar/goal/goals/execution/executions
/plugin Spring boot plugin One-JAR 有点年久失修好久没有维护了Spring Boot 提供的 Maven Plugin 也可以打包 Fatjar支持非遮蔽和嵌套的混合模式并且支持 maven 和 gradle 。 plugingroupIdorg.springframework.boot/groupIdartifactIdspring-boot-maven-plugin/artifactIdconfigurationlayoutZIP/layoutrequiresUnpackdependencygroupIdorg.jruby/groupIdartifactIdjruby-complete/artifactId/dependency/requiresUnpack/configuration
/plugin plugins {id org.springframework.boot version 2.0.4.RELEASE
}bootJar {requiresUnpack **/jruby-complete-*.jar
} requiresUnpack 参数可以定制那些 jar 不希望被解压采用嵌套的方式打包到 Fatjar 内部。 其打包后的内部结构为 example.jar|-META-INF| -MANIFEST.MF-org| -springframework| -boot| -loader| -spring boot loader classes-BOOT-INF-classes| -mycompany| -project| -YourClasses.class-lib-dependency1.jar-dependency2.jar 应用的类文件被防止到 BOOT-INF/classes 目录依赖包被放置到 BOOT-INF/lib 目录。 查看 META-INF/MANIFEST.MF 文件其内容为 Main-Class: org.springframework.boot.loader.JarLauncher
Start-Class: com.mycompany.project.MyApplication 启动类是固定的 org.springframework.boot.loader.JarLauncher应用程序的入口类需要配置成 Start-Class。这样做的目的主要是为了支持嵌套 jar 包的类装载替换掉默认的 ClassLoader。 但是函数计算需要的 jar 包是一种打包结构在服务端运行时会解压开不会调用 Main-Class。所以自定义 ClassLoader 是不生效的所以不要使用嵌套 jar 结构除非在入口函数指定重新定义 ClassLoader 或者 Classpath 以支持 BOOT-INF/classes 和 BOOT-INF/lib 这样的定制化的类路径。 小结 插件构建平台工作机制maven-assembly-pluginmavenUnshadedGradle Java plugingradleUnshadedmaven-shade-pluginmavenShadedcom.github.johnrengelman.shadowgradleShadedOnejarant, mavenJar of JarsSpring boot pluginmaven, gradleUnshaded, Jar of Jars单从 Fatjar 的角度看 Spring boot maven/gradle 做得最精致。但是 jar 包内部的自定义路径解压开以后和函数计算是不兼容的。所以如果用于函数计算打包建议使用 Unshaded 或者 Shared 的打包方式但是需要自己注意文件覆盖问题。 参考阅读 https://imagej.net/Uber-JARhttps://softwareengineering.stackexchange.com/questions/297276/what-is-a-shaded-java-dependencyhttps://docs.spring.io/spring-boot/docs/current/reference/html/executable-jar.html
