Maven提供了多种依赖关系,这些依赖关系使用起来非常容易出错。这几天看到我们产品项目间的依赖关系使用相当混乱,所以花了几天时间研究了一把。
Maven提供多种项目依赖关系。
compile:这是缺省的依赖关系。不要被它的名字给迷惑了,它并不表示编译时依赖,而是所有都依赖。
provided:如果该库应用服务器提供了,就使用它。
test:只在单元测试使用。
还有其它几种,我觉得并不重要。
如果一个项目打包为Jar。那么根本不存在应用服务器这种情况,直接用缺省依赖关系compile即可。当然如果想更精细控制,向junit,hsqldb,mock这样的库一般可以作为test。
如果一个项目打包为war,ear。那么就应该把应用服务器提供的库给排除出去,即在该项目中添加这些库的依赖,依赖类型为provided。
下面是一个多项目产品的例子。
产品top-app。top-app包含下面4个项目,my-app,my-app2,my-app3,my-appwar。前面三个都是打成jar包。最后一个打成war包。所有子项目不能定义groupId,要不然可能会出错。
在top-app中定义产品测试用到的库,scope为test;定义应用服务器提供的库,scope为provided
具体定义如下
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.mycompany.app</groupId> <artifactId>top-app</artifactId> <version>1.0</version> <name>top-app</name> <packaging>pom</packaging> <modules> <module>my-app</module> <module>my-app2</module> <module>my-app3</module> <module>my-app3war</module> </modules> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> <scope>test</scope> </dependency> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.9</version> <scope>provided</scope> </dependency> </dependencies> </project>
my-app,my-app2,my-app3中只需要定义真正需要的。scope都为缺省即compile。如果项目单独添加了特别的测试用的库,那么加为test依赖,不过用compile也没有问题。
my-app2的pom.xml示例如下。
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <artifactId>my-app2</artifactId> <packaging>jar</packaging> <version>1.0</version> <name>my-app2</name> <parent> <groupId>com.mycompany.app</groupId> <artifactId>top-app</artifactId> <version>1.0</version> </parent> <dependencies> <dependency> <groupId>com.mycompany.app</groupId> <artifactId>my-app</artifactId> <version>1.0</version> <scope>compile</scope> </dependency> </dependencies> </project>
my-appwar中也只需要定义真正需要的。scope也都为缺省即compile,因为在top-app中已经定义了应用服务器提供的库,打包的时候maven不会打进去。
示例代码见附件。