Maven 插件
在maven入门中,我们用了 mvn archetype:generate 命令来生成一个项目。那么这里的 archetype:generate 是什么意思呢?archetype 是一个插件的名字,generate是目标(goal)的名字。这个命令的意思是告诉 maven 执行 archetype 插件的 generate 目标。插件目标通常会写成pluginId:goalId
一个目标是一个工作单元,而插件则是一个或者多个目标的集合。比如说Jar插件,Compiler插件,Surefire插件等。从看名字就能知道,Jar 插件包含建立Jar文件的目标, Compiler 插件包含编译源代码和单元测试代码的目标。Surefire 插件的话,则是运行单元测试。
看到这里,估计你能明白了,mvn 本身不会做太多的事情,它不知道怎么样编译或者怎么样打包。它把构建的任务交给插件去做。插件定义了常用的构建逻辑,能够被重复利用。这样做的好处是,一旦插件有了更新,那么所有的 maven 用户都能得到更新。
Maven 生命周期
在maven入门中,我们用的第二个命令是:mvn package。这里的 package 是一个maven的生命周期阶段 (lifecycle phase )。生命周期指项目的构建过程,它包含了一系列的有序的阶段 (phase),而一个阶段就是构建过程中的一个步骤。
那么生命周期阶段和上面说的插件目标之间是什么关系呢?插件目标可以绑定到生命周期阶段上。一个生命周期阶段可以绑定多个插件目标。当 maven 在构建过程中逐步的通过每个阶段时,会执行该阶段所有的插件目标。
maven 能支持不同的生命周期,但是最常用的是默认的Maven生命周期 (default Maven lifecycle )。如果你没有对它进行任何的插件配置或者定制的话,那么上面的命令 mvn package 会依次执行默认生命周期中直到包括 package 阶段前的所有阶段的插件目标:
-
process-resources 阶段:resources:resources
-
compile 阶段:compiler:compile
-
process-classes 阶段:(默认无目标)
-
process-test-resources 阶段:resources:testResources
-
test-compile 阶段:compiler:testCompile
-
test 阶段:surefire:test
-
prepare-package 阶段:(默认无目标)
-
package 阶段:jar:jar
Maven 依赖管理
之前我们说过,maven 坐标能够确定一个项目。换句话说,我们可以用它来解决依赖关系。在 POM 中,依赖关系是在 dependencies 部分中定义的。在上面的 POM 例子中,我们用 dependencies 定义了对于 junit 的依赖:
Xml 代码
<dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> <scope>test</scope> </dependency> </dependencies>
那这个例子很简单,但是实际开发中我们会有复杂得多的依赖关系,因为被依赖的 jar 文件会有自己的依赖关系。那么我们是不是需要把那些间接依赖的 jar 文件也都定义在POM中呢?答案是不需要,因为 maven 提供了传递依赖的特性。
所谓传递依赖是指 maven 会检查被依赖的 jar 文件,把它的依赖关系纳入最终解决的依赖关系链中。针对上面的 junit 依赖关系,如果你看一下 maven 的本地库(我们马上会解释 maven 库)~/.m2/repository/junit/junit/3.8.1/ ,
你会发现 maven 不但下载了 junit-3.8.1.jar,还下载了它的 POM 文件。这样 maven 就能检查 junit 的依赖关系,把它所需要的依赖也包括进来。
在 POM 的 dependencies 部分中,scope 决定了依赖关系的适用范围。
scope : compile(默认值),即任何时候都会被包含在 classpath 中,在打包的时候也会被包括进去。
scope : test,那么它只会在执行 compiler:testCompile and surefire:test 目标的时候才会被加到 classpath 中,
在执行 compiler:compile 目标时是拿不到 junit 的。
scope : provided,意思是 JDK 或者容器会提供所需的jar文件。比如说在做web应用开发的时候,我们在编译的时候需要 servlet API jar 文件,
但是在打包的时候不需要把这个 jar 文件打在 WAR 中,因为servlet容器或者应用服务器会提供的。
scope : runtime,测试和运行时依赖,编译时不依赖。
Maven 传递特性
依赖关系范围是compile的,可以传递到下一个maven project中;而依赖关系范围是test的不会传递。
依赖级别最短的,会优先被传递;依赖级别相同的,在pom.xml中最先引用的,优先依赖。
如:
A->commons-logging-1.0.4.jar,A依赖commons-loggin-1.0.4.jar
B->commons-logging-1.1.1.jar,B依赖commons-loggin-1.1.1.jar
C->A、B
在C的pom.xml中:
<dependency>
<!-- A -->
</dependency>
<dependency>
<!-- B -->
</dependency>
commons-logging.jar都是A、B直接依赖的,等级级别是相同,但在C的pom.xml中,是先依赖A的,所以在C中会依赖A的commons-logging-1.0.4.jar;
当然,我们也可以使用排除的方法,即是在pom.xml中声明不依赖某个jar,我们可以在C的pom.xml中这样写:
<dependency>
<!-- A -->
<exclusions>
<exclusion>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<!-- B -->
</dependency>
在A的依赖配置中,使用了<exclusion>元素,就是排除,不依赖A的commons-logging,那么C就依赖B的commons-loggin了。
如果在C的pom.xml中:
<dependency>
<!-- A -->
</dependency>
<dependency>
<!-- B -->
</dependency>
<dependency>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
<version>1.2</version>
</dependency>
由于commons-loggin-1.2是在C中直接依赖的,等级级别都比A和B中的commons-logging的高,所以C会依赖commons-logging-1.2.jar。
Maven 聚合和继承
聚合
当有多个maven模块时,我们可以定义一个根模块来聚合所有的模块,这样在install maven project就不每一个模块都要执行一次install。
假如有两个maven模块:mymaven-core、mymaven-portal,可以定义根模块(或叫做父模块)mymaven-parent来聚合两个子模块,
mymaven-parent的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/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>lam.maven.mymaven</groupId>
<artifactId>mymaven-parent</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>pom</packaging>
<url>http://maven.apache.org</url>
<properties>
<project.build.sourceEncoding>utf-8</project.build.sourceEncoding>
</properties>
<!-- 聚合 -->
<modules>
<module>../mymaven-core</module>
<module>../mymaven-portal</module>
</modules>
这样,我们可以对mymaven-parent进行install时,mymaven-core和mymaven-portal也会被install的。
继承
除了聚合外,还使用继承,在父模块定义好依赖的jar,子模块可以继承父模块,这样jar包的版本、依赖范围(scope)可以统一在父管理,
mymaven-parent的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/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>lam.maven.mymaven</groupId>
<artifactId>mymaven-parent</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>pom</packaging>
<url>http://maven.apache.org</url>
<properties>
<project.build.sourceEncoding>utf-8</project.build.sourceEncoding>
</properties>
<!-- 聚合 -->
<modules>
<module>../mymaven-core</module>
<module>../mymaven-portal</module>
</modules>
<!-- 定义子模块的相同依赖,以供继承 -->
<dependencyManagement>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.7</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.hibernate</groupId>
<artifactId>hibernate-core</artifactId>
<version>4.1.12.Final</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.35</version>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
<dependency>
<groupId>${project.groupId}</groupId>
<artifactId>mymaven-core</artifactId>
<version>${project.version}</version>
<exclusions>
<exclusion>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>
</dependencyManagement>
</project>
在子模块,要声明对父模块的继承。
mymaven-core的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>
<parent>
<groupId>lam.maven.mymaven</groupId>
<artifactId>mymaven-parent</artifactId>
<version>0.0.1-SNAPSHOT</version>
<relativePath>../mymaven-parent/pom.xml</relativePath>
</parent>
<artifactId>mymaven-core</artifactId>
<packaging>jar</packaging>
<name>mymaven-core</name>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<!-- <version>4.7</version> inherit from parent -->
<!-- <scope>test</scope> -->
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<!-- <version>1.2.17</version> -->
</dependency>
</dependencies>
<build>
<finalName>mymaven-core</finalName>
</build>
</project>
Maven 库
当第一次运行 maven 命令的时候,你需要 Internet 连接,因为它要从网上下载一些文件。那么它从哪里下载呢?它是从 maven 默认的远程库(http://repo1.maven.org/maven2) 下载的。这个远程库有 maven 的核心插件和可供下载的 jar 文件。
但是不是所有的 jar 文件都是可以从默认的远程库下载的,比如说我们自己开发的项目。这个时候,有两个选择:要么在公司内部设置定制库,要么手动下载和安装所需的jar文件到本地库。
本地库是指 maven 下载了插件或者 jar 文件后存放在本地机器上的拷贝。在 Linux 上,它的位置在 ~/.m2/repository,在 Windows XP 上,在 C:\Documents and Settings\username\.m2\repository ,在 Windows 7 上,在 C:\Users\username\.m2\repository。当 maven 查找需要的 jar 文件时,它会先在本地库中寻找,只有在找不到的情况下,才会去远程库中找。
运行下面的命令能把我们的 helloworld 项目安装到本地库:
$mvn install
一旦一个项目被安装到了本地库后,你别的项目就可以通过 maven 坐标和这个项目建立依赖关系。比如如果我现在有一个新项目需要用到 helloworld,那么在运行了上面的 mvn install 命令后,我就可以如下所示来建立依赖关系:
Xml 代码
<dependency> <groupId>com.mycompany.helloworld</groupId> <artifactId>helloworld</artifactId> <version>1.0-SNAPSHOT</version> </dependency>
好了,maven 的核心概念就简单的介绍到这里。至于在 Eclipse 中如何使用 maven,这个网上很多了,google 一下就行。
Eclipse中使用maven,可以参考: