前言
在项目开发有时需要引入一些在maven仓库中不存在的包,典型的就是Oracle驱动包, 一般做法就是在项目目录下新建一个lib文件夹, 然后把Oracel的驱动包放进去。然后右键文件夹, 选择 add as Library, 然后就可以正常使用外部jar包了。
如下图所示:
问题就是在maven Package打包之后,放在测试环境上启动就会报错, 显示无法加载到Oracle的驱动。
其实问题也很简单, 是maven打包的问题,特此记录一下!
发现问题
打开package结束之后的target目录下的jar, 就会发现, 在BOOT-INF->lib文件夹下,压根找不到 我们所需要的Oracle驱动包,所以就是maven没有把lib下的jar打包进去导致的。
正确使用外部Jar
一、加入lib, 然后add as library
就像我上面所说,这样在编译器里就可以正常使用Jar包,启动成功了, 至此,只是在编译器能正常使用,想要通过java -jar 启动还是会报错,所以还需要另外一些配置,如下。
二、maven打包
maven打包的时候,就需要在POM文件中加上jar的一些信息,以及在build标签配置资源文件路径了。
<dependency>
<groupId>com.oracle</groupId>
<artifactId>ojdbc14</artifactId>
<version>10.2.0.4.0</version>
<scope>system</scope>
<systemPath>${basedir}/lib/ojdbc14-10.2.0.4.0.jar</systemPath>
</dependency>
其中要注意的就是scope标签和systemPath标签。
maven中scope的默认值是compile
scope的分类
1)compile 默认是compile。compile表示被依赖项目需要参与当前项目的编译,包括后续的测试,运行周期也参与其中,是一个比较强的依赖。打包的时候通常需要包含进去。
2)test 表示依赖项目仅仅参与测试相关的工作,包括测试代码的编译,执行。比较典型的如junit
3)runtime 表示被依赖项目无需参与项目的编译,不过后期的测试和运行周期需要其参与。与compile相比,跳过编译而已。在终端的项目(非开源,企业内部系统)中,和compile区别不是很大。比较常见的如JSRXXX的实现,对应的API jar是compile,具体实现是runtime的,compile只需要知道接口就足够了。
4)procided 意味着打包的时候可以不用包进去,别的设施(web container)会提供。事实上该依赖理论上可以参与编译、测试、运行等周期。相当于compile,但是打包阶段做了exclude的动作。
5)system 和provide相同,不过被依赖项不会从maven仓库抓,而是从本地系统文件拿,一定要配合systemPath使用
其次是build的配置, 需要在resources标签下指定资源文件的地址
<build>
<finalName>smpMonitor</finalName>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
<resources>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.xml</include>
</includes>
<filtering>true</filtering>
</resource>
<resource>
<directory>${basedir}/src/main/resources</directory>
</resource>
<!--外部jar包地址-->
<resource>
<directory>${basedir}/lib</directory>
<targetPath>BOOT-INF/lib/</targetPath>
<includes>
<include>**/*.jar</include>
</includes>
</resource>
</resources>
</build>
至此之后,项目打包就可以把外部的jar包也成功打包进去,在target文件夹也可以找到了,打包好的jar包内也存在引用的外部jar了。