在Maven中怎么配置外部Jar

转摘自：http://liugang594.iteye.com/blog/1677712

假设我们有一个Maven的project，其中有些Jar包不是来自Maven库的，是存在本地的某些Jar文件，比如说在project下有一个lib，里面放了一些额外需要的Jar。

默认情况下，如果用mvn 命令去编译或运行它，并且其中有使用到这些外部jar的类，那么可能报x.x.x包找不着。这是因为maven在它当前的配置里找不到你需要的这些外部jar的配置。

那么如何在maven中配置外部jar，以便在编译和运行的时候能找着它们呢？这里就简单介绍两种方法。

一、使用Dependency声明

这个方法就是和其他maven的dependency一样，在pom.xml里声明一个dependency:

<dependency>
<groupId>org.ibm</groupId>
<artifactId>jms</artifactId>
<version>1.0.0</version>
<scope>system</scope>
<systemPath>${project.basedir}/lib/jms.jar</systemPath>
</dependency>

细心的人可能已经留意到了，这里多了两个声明：scope和systemPath。

在Maven中可用的声明大致有：compile, runtime, test, system, 和 provided 。关于他们的具体意思，有兴趣的可以去 http://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#Dependency_Scope 看。

在上面的dependency里，我们声明了scope为system，它使用起来和provided差不多，即此依赖由系统提供，但是与provided有点不同的是，它需要显式的使用systemPath指定lib所在的路径，如上systemPath。

最后看到的效果如上图，jms.jar被加到了工程的maven依赖里。用这种方法可以不需要预先把需要的jar安装在maven库下。

二、创建一个Project范围的库

以上的方法是从避免安装lib到maven库方向上实现。另一种方法就是则是从构造库的方向上考虑的：创建一个虚拟的本地库，让maven到这个本地库里去查找需要的lib。

步骤大致如下：

1. 构造虚拟Maven库

这里我们需要提供一个和maven库结构一样的文件夹/文件结构，以模拟Maven库，例如假如project里lib即是一个maven库，则它的结构可能是：

如上，虚拟库中声明了两个jar:

1. com.ibm.mq-1.0.jar : groupId 是 org.ibm.jms；artifactId是com.ibm.mq；version是1.0

2. com.ibm.mqjms-1.0.jar : groupId是org.ibm.jms；artifactId是com.ibm.mqjms；version是1.0

假设以上jar是可用的maven依赖的话，那在dependency依赖里的添加项为：

<dependency>
<groupId>org.ibm.jms</groupId>
<artifactId>com.ibm.mqjms</artifactId>
<version>1.0</version>
</dependency>
<dependency>
<groupId>org.ibm.jms</groupId>
<artifactId>com.ibm.mq</artifactId>
<version>1.0</version>
</dependency>

下面的问题就是如何让Maven能找到这个虚拟Maven库。

在pom.xml里，我们使用repositories声明可能查找的、多个其他的Maven的库，例如：

<repositories>
<repository>
<releases>
<enabled>false</enabled>
<updatePolicy>always</updatePolicy>
<checksumPolicy>warn</checksumPolicy>
</releases>
<snapshots>
<enabled>true</enabled>
<updatePolicy>never</updatePolicy>
<checksumPolicy>fail</checksumPolicy>
</snapshots>
<id>codehausSnapshots</id>
<name>Codehaus Snapshots</name>
<url>http://snapshots.maven.codehaus.org/maven2</url>
<layout>default</layout>
</repository>
</repositories>

当Maven在Central库里没有找到对应的artifact，则会到这些库里去查找。所以，我们只需要如上把虚拟的Maven库的定义的添加到pom.xml里即可：

<repositories>
<repository>
<id>repo</id>
<releases>
<enabled>true</enabled>
<checksumPolicy>ignore</checksumPolicy>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
<url>file://${project.basedir}/lib</url>
</repository>
</repositories>

这里库的路径是：${project.basedir}/lib 。它是一个release库而不是snapshot库。

区别

方式一：会直接引用指定路径的lib，而不会把它加到本地的Maven库里去，所以它只在当前project使用，但工程可以方便的共享，且不使用额外的空间

方式二：引用的jars会首先被安装到本地的maven库里，然后再通过引用从本地的Maven库里加载，好处是一旦安装，在其他的project也可以引用，但是需要首先在本地安装，当前工程是便携的，但是直接引用而未如上声明的工程可能不是便携的。