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

浅浅的花香味﹌ 2021-11-16 16:58 644阅读 0赞

说明：这里说的第三方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>

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2gyNjA0Mzk2NzM5_size_16_color_FFFFFF_t_70]: /images/20211116/497fe4cf2be442908bd3a483a70b2a4f.png