首页
/ JeecgBoot项目JAR分离打包优化实践

JeecgBoot项目JAR分离打包优化实践

2025-05-02 11:55:23作者:明树来

背景介绍

在Java企业级应用开发中,Spring Boot应用的打包部署是一个常见需求。JeecgBoot作为一款基于Spring Boot的低代码开发平台,其项目结构通常包含多个模块。在实际生产环境中,我们经常需要对应用进行分离打包,即将依赖库与业务代码分离,以便于部署和更新。

传统分离打包的问题

在JeecgBoot 3.6.3版本中,使用标准的Spring Boot分离打包方式时,所有依赖(包括业务模块生成的jeecg前缀JAR包)都会被提取到外部lib目录中。这种打包方式虽然实现了依赖分离,但在实际运维中会带来以下问题:

  1. 业务代码更新复杂:每次更新都需要从众多依赖JAR中找出业务相关的JAR进行替换
  2. 部署包管理困难:难以区分核心依赖和业务代码
  3. 更新效率低下:需要人工识别哪些JAR需要更新

优化方案设计

针对上述问题,我们可以通过定制Maven打包配置,实现更合理的分离打包策略:

核心思路

  1. 将第三方依赖与业务代码分离
  2. 业务模块JAR保留在主JAR包内
  3. 仅将稳定的第三方依赖提取到外部

具体实现

通过修改pom.xml文件中的spring-boot-maven-plugin配置,可以实现更精细的打包控制:

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <layout>ZIP</layout>
        <includes>
            <include>
                <groupId>com.jeecg</groupId>
                <artifactId>*</artifactId>
            </include>
        </includes>
    </configuration>
</plugin>

这种配置会确保所有com.jeecg组件的业务代码保留在主JAR中,而其他第三方依赖会被提取到外部lib目录。

完整打包配置示例

以下是一个完整的分离打包配置示例,包含了资源文件和依赖的处理:

<plugins>
    <!-- Spring Boot打包插件 -->
    <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
        <configuration>
            <layout>ZIP</layout>
            <includes>
                <include>
                    <groupId>com.jeecg</groupId>
                    <artifactId>*</artifactId>
                </include>
            </includes>
        </configuration>
    </plugin>
    
    <!-- 依赖复制插件 -->
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-dependency-plugin</artifactId>
        <executions>
            <execution>
                <id>copy-dependencies</id>
                <phase>package</phase>
                <goals>
                    <goal>copy-dependencies</goal>
                </goals>
                <configuration>
                    <outputDirectory>${project.build.directory}/lib</outputDirectory>
                    <excludeGroupIds>com.jeecg</excludeGroupIds>
                </configuration>
            </execution>
        </executions>
    </plugin>
    
    <!-- 资源文件处理 -->
    <plugin>
        <artifactId>maven-resources-plugin</artifactId>
        <executions>
            <execution>
                <id>copy-resources</id>
                <phase>package</phase>
                <goals>
                    <goal>copy-resources</goal>
                </goals>
                <configuration>
                    <resources>
                        <resource>
                            <directory>${project.build.directory}/classes</directory>
                            <includes>
                                <include>*.xml</include>
                                <include>*.yml</include>
                                <include>jeecg/**</include>
                                <include>static/**</include>
                                <include>templates/**</include>
                            </includes>
                        </resource>
                    </resources>
                    <outputDirectory>${project.build.directory}/config</outputDirectory>
                </configuration>
            </execution>
        </executions>
    </plugin>
</plugins>

启动方式

优化后的打包结构启动命令如下:

java -jar -Dfile.encoding=UTF-8 -Dloader.path=lib jeecg-system-start.jar

优势分析

这种优化后的打包方式具有以下优势:

  1. 更新便捷:业务代码变更只需替换主JAR包即可
  2. 依赖管理清晰:第三方依赖与业务代码明确分离
  3. 部署效率高:减少了人工识别和选择JAR包的过程
  4. 结构合理:符合"稳定依赖与易变代码分离"的设计原则

注意事项

  1. 确保业务模块的groupId统一使用com.jeecg(或项目自定义的前缀)
  2. 对于多模块项目,需要确保各子模块的pom配置一致
  3. 在CI/CD流程中,需要相应调整构建脚本以适应新的打包结构
  4. 测试阶段需验证所有依赖是否正确加载

总结

通过对JeecgBoot项目打包策略的优化,我们实现了更合理的JAR分离打包方案,解决了业务代码更新不便的问题。这种方案不仅适用于JeecgBoot项目,对于其他基于Spring Boot的多模块企业级应用也具有参考价值。在实际应用中,开发团队可以根据项目具体情况调整打包策略,找到最适合自身项目的部署方案。

登录后查看全文
热门项目推荐
相关项目推荐