SpringBoot项目如何引入外部jar及将外部jar打包到项目发布jar包

1、创建一个SpringBoot项目

下载项目之后将项目导入IDEA

2、如何添加外部jar包

准备一个外部的jar包， 我这里使用的是

guava-31.1-jre.jar

作为演示
下载地址：https://repo1.maven.org/maven2/com/google/guava/guava/31.1-jre/guava-31.1-jre.jar

在项目根路径下创建一个文件夹libs，将guava-31.1-jre.jar放到libs下。

在pom.xml添加外部jar依赖：

<dependency><groupId>com.google.guava</groupId><artifactId>guava</artifactId><version>31.1-jre</version><!--
                scope=system表示此依赖是来自外部jar，而不是maven仓库
                注意：
                  只有当scope设置为system时，systemPath属性才会生效
                  systemPath是一个物理文件路径，来指定依赖的外部jar在物理磁盘的位置
                  ${project.basedir}代表项目根目录
            --><scope>system</scope><systemPath>${project.basedir}/libs/guava-31.1-jre.jar</systemPath></dependency>

通过以上步骤， 外部的这个guava-31.1-jre.jar文件就被成功引入到当前项目中了，测试一下
新建一个Test测试类文件


测试通过， 外部jar包成功集成到项目中

3、如何将外部jar包打包到当前项目jar包中

如果我们不进行配置，打包的时候是不会将外部的jar打包到jar/war中的

Spring Boot的项目，一般都会使用到打包插件，那么只需要添加一个配置即可

修改pom.xml文件， 修改内容如下：

<build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><configuration><excludes><exclude><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId></exclude></excludes><!-- 在打包时将引用的外部jar引入到当前项目包中    --><includeSystemScope>true</includeSystemScope></configuration></plugin></plugins></build>

includeSystemScope为true

这一个参数配置最为重要

如果有些配置文件，并非Spring Boot的默认路径，那么可能就需要借助resouce配置（resources节点和plugins节点同级）:

<build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><configuration><excludes><exclude><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId></exclude></excludes><!-- 在打包时将引用的外部jar引入到当前项目包中    --><includeSystemScope>true</includeSystemScope></configuration></plugin></plugins><resources><resource><!-- directory 表示取该目录下的文件 --><directory>libs</directory><!--targetPath 指定打包到哪个目录下  默认是放到class目录下--><targetPath>/BOOT-INF/lib/</targetPath><!-- 取符合格式的所有文件  *代表全部 --><includes><include>**/*.jar</include></includes></resource></resources></build>

以上配置完成， 执行打包进行测试， 看看打包完成之后的项目包中是否包含外部jar

4、总结

• 引入jar包， 最关键的以下配置

<dependency><groupId>com.google.guava</groupId><artifactId>guava</artifactId><version>31.1-jre</version><!--
        scope=system表示此依赖是来自外部jar，而不是maven仓库
        注意：
          只有当scope设置为system时，systemPath属性才会生效
          systemPath是一个物理文件路径，来指定依赖的外部jar在物理磁盘的位置
          ${project.basedir}代表项目根目录
    --><scope>system</scope><systemPath>${project.basedir}/libs/guava-31.1-jre.jar</systemPath></dependency>

• 发布jar包， 最关键的以下配置，使用spring-boot-maven-plugin插件及以下配置

<build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><configuration><excludes><exclude><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId></exclude></excludes><!-- 在打包时将引用的外部jar引入到当前项目包中    --><includeSystemScope>true</includeSystemScope></configuration></plugin></plugins><resources><resource><!-- directory 表示取该目录下的文件 --><directory>libs</directory><!--targetPath 指定打包到哪个目录下  默认是放到class目录下--><targetPath>/BOOT-INF/lib/</targetPath><!-- 取符合格式的所有文件  *代表全部 --><includes><include>**/*.jar</include></includes></resource></resources></build>