在Spring Boot项目中引入本地JAR包

😍摘要：
本文探讨了在Spring Boot项目中引入本地JAR包的步骤和必要的配置。通过使用Maven的system作用域，开发者可以将自定义的本地库或功能集成到Spring Boot应用程序中。文章首先介绍了如何在项目的POM文件中添加依赖，以及如何指定JAR包的路径和作用域。其次，文中详细讲解了为了确保本地JAR包能够在打包时正确识别和包含，需要配置spring-boot-maven-plugin插件。最后，尽管这种方法对于特定需求非常有用，但也提到了如果需要在不同环境中部署应用程序或需要协调其他库时，建议使用更标准的依赖项管理方法。

😍 引言：
Spring Boot作为一个强大的应用程序开发框架，提供了一系列便捷工具和库，使得开发者能够更迅速地构建应用程序。然而，在开发过程中，往往需要引入第三方库或自定义功能，以满足特定的业务需求。而本地JAR包是一种常见的集成方式，允许开发者将自己开发的库或功能模块在项目中复用。本文将深入介绍在Spring Boot项目中引入本地JAR包的方法，讨论了如何通过Maven的system作用域以及合适的插件配置，将本地JAR包成功地融入项目中。同时，我们也会强调在特定场景下使用本地JAR包的优势，以及需要考虑的一些注意事项。无论是为了满足定制化需求，还是为了更好地管理依赖，掌握这一知识都将在Spring Boot开发的旅程中大有裨益。

---

 在Spring Boot项目中引入本地JAR包是一个常见的需求，可以通过以下步骤来实现：

 方法一:本地jar包导入项目

☀️1. 将JAR包复制到项目目录

首先，将需要引入的本地JAR包复制到项目目录中，例如项目的src/main/resources/lib目录下。

 

☀️2. 在POM文件中添加依赖

打开项目的pom.xml文件，添加以下依赖配置，指定JAR包的system作用域以及路径：

 

<dependency>
     <groupId>supermap</groupId>
     <artifactId>supermap.data</artifactId>
     <version>11.1.1</version>
     <scope>system</scope>
     <systemPath>${pom.basedir}/src/main/resources/lib/com.supermap.data.jar</systemPath>
</dependency>

<dependency>
      <groupId>supermap</groupId>
      <artifactId>supermap.realspace</artifactId>
      <version>11.1.1</version>
      <scope>system</scope> 
<systemPath>${pom.basedir}/src/main/resources/lib/com.supermap.realspace.jar</systemPath>
</dependency>

在这里，${pom.basedir}代表项目根目录的路径，/src/main/resources/lib/com.supermap.data.jar是JAR包的相对路径。

配置Maven插件：为了确保本地JAR包在打包时能够被正确识别和包含，需要配置spring-boot-maven-plugin插件。在pom.xml中添加以下配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <includeSystemScope>true</includeSystemScope>
            </configuration>
        </plugin>
    </plugins>
</build>

这段配置中的<includeSystemScope>元素设置为true，以确保在依赖项解析过程中包括system作用域的依赖项。

方法二：将jar包安装至本地仓库后使用pom文件直接引入

☀️1. jar包安装到本地maven仓库

mvn install:install-file -Dfile=jar包的位置 -DgroupId=上面的groupId -DartifactId=上面的artifactId -Dversion=上面的version -Dpackaging=jar

mvn install:install-file  -Dfile=E:\work\workspace\IDEA\lkp-report-factory\src\main\resources\libs\aspose-words-14.9.0-jdk16.jar -DgroupId=com.aspose -DartifactId=aspose-words -Dversion=14.9.0-jdk16 -Dpackaging=jar

☀️2. pom引入：

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-words</artifactId>
    <version>14.9.0-jdk16</version>
</dependency>

通过以上步骤，您就成功地将本地JAR包引入到Spring Boot项目中了。需要注意的是，尽管这种方法在特定情况下非常有用，但如果您要在不同的环境中部署应用程序或需要与其他库进行协调，建议您仍然使用Maven官方仓库或私有仓库来管理依赖项。