maven 项目中引入第三方jar包的方法

逃离我推掉我的手 2023-02-13 14:43 9阅读 0赞

博主基本上把maven pom.xml scope类型给介绍明白了，下面是正文：

\------------------------------------------------------------------------------------------------------

说明：这里说的第三方jar包是指maven库中没有改jar包，但是你的项目是maven项目，需要引入该jar包

1 将jar包放入项目的libs（我的路径是/Users/ma/workspace/bi/bi-pom/libs）文件夹中，没有可以自己新建。  
2 配置pom.xml,增加如下内容：  
<dependency>  
<groupId>org.openoffice</groupId>  
<artifactId>jodconverter</artifactId>  
<version>2.2.2</version>  
<type>jar</type>  
<scope>system</scope>  
<systemPath>$\{project.basedir\}/libs/jodconverter-2.2.2.jar</systemPath>  
</dependency>

此时项目结构如下图

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2gyNjA0Mzk2NzM5_size_16_color_FFFFFF_t_70][]  
说明：  
2.1 $\{project.basedir\} 就是你的项目的根路径，如/Users/ma/workspace/bi/bi-pom  
在bi-pom文件夹下，大概会有如下文件：  
LICENSE  
datas  
libs  
pom.xml  
script  
src  
target  
velocity.log

上面两步完成后发现：  
现象1 代码中已经可以使用jar包中的内容了，并且 mvn clean package -Ptest打包的时候，发现也没有问题，甚至直接通过main方法调用代码也没有问题。  
现象2 但是如果通过web接口调用jar包中的内容，会报错：  
Caused by: java.lang.NoClassDefFoundError: com/artofsolving/jodconverter/openoffice/connection/OpenOfficeConnection  
现象3 mvn clean package -Ptest打包后，项目打war包，然后放到服务器上，问题仍然存在。

现象2解决  
https://blog.csdn.net/wn084/article/details/80482187  
这个博客可以解决现象而的问题。但貌似仅仅是临时的方案，现象三的问题还在。

现象3产生的原因：  
当scope为system的时候打包不会自动打包进去的，所以mvn打包会导致第三方包缺失。详细内容如下：  
maven中的scope  
<scope>system</scope>  
scope maven中scope的默认值是compile  
scope的分类  
1）compile 默认是compile。compile表示被依赖项目需要参与当前项目的编译，包括后续的测试，运行周期也参与其中，是一个比较强的依赖。打包的时候通常需要包含进去。  
2）test 表示依赖项目仅仅参与测试相关的工作，包括测试代码的编译，执行。比较典型的如junit  
3）runtime 表示被依赖项目无需参与项目的编译，不过后期的测试和运行周期需要其参与。与compile相比，跳过编译而已。在终端的项目（非开源，企业内部系统）中，和compile区别不是很大。比较常见的如JSRXXX的实现，对应的API jar是compile，具体实现是runtime的，compile只需要知道接口就足够了。oracle jdbc驱动jar包就是一个很好的例子，一般scope为runtime。 另runtime的依赖通常和optional搭配使用，optional为true。即可以用A实现也可以用B实现。  
4）procided 意味着打包的时候可以不用包进去，别的设施（web container）会提供。事实上该依赖理论上可以参与编译、测试、运行等周期。相当于compile，但是打包阶段做了exclude的动作。  
5）system 和provide相同，不过被依赖项不会从maven仓库抓，而是从本地系统文件拿，一定要配合systemPath使用

scope为system时，maven不打包jar包的解决

解决方法一 避免问题  
将jar文件放到 maven 私库里，然后就可以不用使用<scope>syetem</scope>，maven打包的时候会直接从你本地仓库获取jar包，并且打包会打进去

解决方法二 手动添加jar包  
将jar包直接加到系统资源中（/Users/ma/workspace/bi/bi-pom/src/main/webapp/WEB-INF/lib路径下，没有lib则创建），WEB-INF/lib中的东西打包的时候会自动打进去

问题：为什么 bi-pom/src/main/webapp/WEB-INF/lib中的东西打包的时候会自动打进去？？？但是bi-pom/libs中的不行？？

解决方法三 配置mvn外部依赖打进war包  
更好的方式是配置编译参数<compilerArguments>，添加extdirs将jar包相对路径添加到配置中，如下：  
  
<plugin>  
<groupId>org.apache.maven.plugins</groupId>  
<artifactId>maven-war-plugin</artifactId>  
<configuration>  
<webResources>  
<resource>  
<directory>libs</directory>  
<targetPath>WEB-INF/lib/</targetPath>  
<includes>  
<include>\*\*/\*.jar</include>  
</includes>  
</resource>  
</webResources>  
</configuration>  
</plugin>  
————————————————  
版权声明：本文为CSDN博主「深山猿」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。  
原文链接：https://blog.csdn.net/h2604396739/article/details/97623552

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2gyNjA0Mzk2NzM5_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/2019072909514657.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2gyNjA0Mzk2NzM5,size_16,color_FFFFFF,t_70