SpringBoot 添加本地 jar 文件

前言

有时候我们在项目中，会用到一些本地 jar 包文件，比如隔壁公司自己打包的；

此时无法从maven远程仓库拉取；

那么我们可以考虑把 jar 文件安装到本地 maven 库中，然后再添加依赖。

步骤

1. 添加 jar 文件到项目中

在 resources 目录中创建一个 lib 目录，将本地 jar 放进去，如下所示的 demo.jar

image-20210926215633667

2. 安装 jar 包到 maven 本地仓库

这里我们可以利用 maven-install-plugin 插件来安装， pom.xml如下：

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-install-plugin</artifactId>
                <version>2.5.2</version>
                <executions>
                    <execution>
                        <id>install-demo-jar</id>
            <!-- 阶段：设定在 mvn clean 时执行安装,如果设定为 validate，那么就是在 mvn validate 时才安装 -->
                        <phase>clean</phase>
                        <configuration>
              <!-- 路径：这就是刚才添加的 jar 路径 -->
                            <file>${project.basedir}/src/main/resources/lib/demo.jar</file>
                            <!-- 属性：下面的这三个属性，就是后面我们添加依赖时的值 -->
              <groupId>com.javalover</groupId>
                            <artifactId>demo</artifactId>
                            <version>1.0</version>
                            <packaging>jar</packaging>
                            <generatePom>true</generatePom>
                        </configuration>
                        <goals>
              <!-- 目标：安装外部的 jar 文件到 maven 本地仓库 -->
                            <goal>install-file</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

运行mvn clean后，会打印如下日志：

[INFO] --------------------------< com.example:demo >--------------------------
[INFO] Building demo 0.0.1-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO] 
[INFO] --- maven-clean-plugin:3.1.0:clean (default-clean) @ demo ---
[INFO] 
[INFO] --- maven-install-plugin:2.5.2:install-file (install-demo-jar) @ demo ---
[INFO] pom.xml not found in demo.jar
[INFO] Installing /Users/jalon/Project/SpringBootProject/demo/src/main/resources/lib/demo.jar to /Users/jalon/.m2/repository/com/javalover/demo/1.0/demo-1.0.jar
[INFO] Installing /var/folders/t6/99ks0lsn0fx2j6kt4n46f_rh0000gn/T/mvninstall6930618999486285918.pom to /Users/jalon/.m2/repository/com/javalover/demo/1.0/demo-1.0.pom
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.316 s
[INFO] Finished at: 2021-09-26T22:12:47+08:00
[INFO] ------------------------------------------------------------------------

重点是这一行：

[INFO] Installing /Users/jalon/Project/SpringBootProject/demo/src/main/resources/lib/demo.jar to /Users/jalon/.m2/repository/com/javalover/demo/1.0/demo-1.0.jar`

可以看到，将我们本地的 demo.jar 安装到了 maven 本地仓库中

3. 添加依赖

        <dependency>
            <groupId>com.javalover</groupId>
            <artifactId>demo</artifactId>
            <version>1.0</version>
        </dependency>

此时程序就可以正常使用 demo.jar 包了，而且 maven 打包也会把 demo.jar 打包进去

参考

Apache Maven Install Plugin – Introduction

maven插件maven-install-plugin - Mars.wang - 博客园 (cnblogs.com)