1.前言
SpringBoot和Maven的出现给我们的开发提供了很大的方便,正所谓事物都有两面性,有简便的地方就会有麻烦的地方,这里记录了一次使用Maven打包SpringBoot项目的时候出现的一个引用本地第三方jar包的问题。
2.问题描述
一个SpringBoot项目,平时引用第三方jar包的时候,在pom文件里指定好该jar包的依赖就可以了,这本就是maven的一个很正常的操作,配置好依赖,maven自动将相应的jar包加入工程里,开发的时候就可以直接引入jar包内的类和方法,打包的时候maven还会将依赖的jar包打入到WEB-INF/lib下,皆大欢喜,多么开心~
但总有那么个项目,由于一些列原因,必须要引入其他人提供给你的jar包,这些包是公有仓库上不存在的,如果有私服的还好,没有私服的就开始头疼了。
有人说了,在本地maven仓库中新建目录,自定义一个路径把jar包放进去,然后在pom.xml里加上对应的<dependency>配置就可以了吧!这样的确是可以了,但这种方式不利于项目团队开发和工程源代码留存,并不能做到下载下来的工程代码直接就能编译运行的效果,所以考虑到代码的完整性,这个方案pass掉了。
通过查阅一些相关资料,发现在<dependency>中使用<systemPath>就可以做到引用第三方jar包的效果,然后在spring-boot-maven-plugin中设置includeSystemScope为true就可以了,像下面这样:
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.st.springboot</groupId>
<artifactId>ingredients-java</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>war</packaging>
<name>ingredients-java</name>
<dependencies>
<dependency>
<groupId>org.bouncycastle</groupId>
<artifactId>bcprov-jdk16</artifactId>
<version>1.46</version>
<scope>system</scope>
<systemPath>${project.basedir}/src/main/resources/jar/bcprov-jdk16-1.46.jar</systemPath>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<includeSystemScope>true</includeSystemScope>
</configuration>
</plugin>
</plugins>
</build>
</project>
设置完了非常开心,如果用的是idea,甚至还能看到IDE连包里的内容都能显示:
本以为皆大欢喜了,然而在程序开发完毕,打包部署的时候出现了问题,发现引用的本地jar包压根就打不进WEB-INF的lib目录下,jar包还在工程原来的位置放着了!
3.解决问题
时间紧迫,先把所有引用的jar包往war包的lib目录下放进去吧,这么做确实好使,war包成功部署上去了。但一直这样不行啊,根本问题没有解决,万一有朝一日打算设置个maven定时自动打包部署什么的不就凉凉了……
继续查阅资料寻找解决方法,终于功夫不负有心人,maven提供了插件专门解决打war包的时候引用本地包的问题,这东西叫做maven-war-plugin!
于是我的pom.xml变成了下面这样子:
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.st.springboot</groupId>
<artifactId>ingredients-java</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>war</packaging>
<name>ingredients-java</name>
<dependencies>
<dependency>
<groupId>org.bouncycastle</groupId>
<artifactId>bcprov-jdk16</artifactId>
<version>1.46</version>
<scope>system</scope>
<systemPath>${project.basedir}/src/main/resources/jar/bcprov-jdk16-1.46.jar</systemPath>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<configuration>
<includeSystemScope>true</includeSystemScope>
</configuration>
</plugin>
<!-- 下面是为了将本地jar包打入WEB-INF/lib下而增加的配置-->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<version>3.2.2</version>
<configuration>
<webResources>
<resource>
<!-- 指向的是包含你所有要用jar包的目录 -->
<directory>${project.basedir}/src/main/resources/jar</directory>
<!-- 编译后要把这些jar包复制到的位置 -->
<targetPath>WEB-INF/lib</targetPath>
</resource>
</webResources>
</configuration>
</plugin>
</plugins>
</build>
</project>
配置完后,再次运行package命令,发现本地的jar包完美的打进了WEB-INF/lib下,到此问题解决了!
另外还有个需要注意的地方,由于使用的是maven-war-plugin,因此打jar包的时候不适用哦~