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

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

此时项目结构如下图

说明：
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包相对路径添加到配置中，如下：
<!--设置maven-war-plugins插件，否则外部依赖无法打进war包-->
<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>