1. 介绍
构建(build)一个项目包括:下载依赖,编译源代码,执行单元测试,以及打包编译后的源代码等一系列子任务。手工的执行这些任务是一项非常繁琐,且容易出错的事情。Maven封装了这些子任务,并提供给用户执行这些子任务的命令。简而言之,Maven是Java项目的一个管理和构建(build)工具。
2. 项目对象模型(Project Object Model)
项目对象模型(以下简称POM)是Maven的基本组成单元,它是位于项目主目录下的一个xml文件(pom.xml),Maven使用pom.xml文件中的信息来构建(build)项目。
一个简单的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>
<groupId>com.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>
<name>my-app</name>
<url>http://maven.apache.org</url>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>
<properties>
<maven.compiler.source>1.6</maven.compiler.source>
<maven.compiler.target>1.6</maven.compiler.target>
</properties>
<build>
<plugins>
<plugin>
//...
</plugin>
</plugins>
</build>
</project>
本小结将介绍pom.xml中常用的一些元素。
2.1 项目标识符(Project Identifiers)
-
groupId
– 创建项目的公司或者组织的名称 -
artifactId
– 项目的名称 -
version
– 项目的版本号 -
packaging
– 项目的打包方式(jar/war/pom)
GAV (groupId:artifactId:version)是Maven项目的唯一表示符。packaging决定Maven生成包的类型,默认值是jar。
2.2 依赖(dependencies)
pom.xml文件通过元素<dependency>
来声明外部依赖,例如:
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>
声明项目依赖3.8.1版本的junit。默认情况下,Maven将在构建项目的时候从Maven的中央仓库(Central Repository)下载依赖到本地仓库(${USER_HOME/.m2/repository/})。不过用户也可以通过元素<repository>
来声明备选仓库(alternate repository)。
2.3 属性(Properties)
可以像在Java等编程语言中定义变量一样,在pom.xml文件中定义属性,这样就可以达到一处定义,多处使用的目的,使用和维护起来也更加容易。
pom.xml中通过元素<properties>
定义属性,通过占位符${property_name}
使用属性。如下:
<properties>
<spring.version>4.3.5.RELEASE</spring.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-core</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>${spring.version}</version>
</dependency>
</dependencies>
如果在将来需要升级spring-core和spring-context的版本,那时将只需要修改属性spring.version
的值。
2.4 构建(build)
元素<build>
中可以指定默认的Maven Goal的信息,编译后的文件的名称,名称等信息。如下:
<build>
<defaultGoal>install<defaultGoal>
<directory>${basedir}/target</directory>
<finalName>${artifactId}-${version}</finalName>
...
</build>
2.5 Profiles
在实际的日常开发中,在不同的环境(test/prod) 通常会有不同的构建(build)逻辑或者配置。元素<profile>
可以用来实现这个目的。如下:
<profiles>
<profile>
<id>prod</id>
<build>
<plugins>
<plugin>
//...
</plugin>
</plugins>
</build>
</profile>
<profile>
<id>test</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<build>
<plugins>
<plugin>
//...
</plugin>
</plugins>
</build>
</profile>
</profiles>
如果想触发某个profile,可以使用命令:mvn clean install -P<profile id>
。
3. Maven构建生命周期(build lifecycle):
Maven的构建生命周期定义了如何构建和发布Java项目,Maven内建了三种构建生命周期:clean,default,site。构建生命周期由一系列的阶段(phase)构成:
- validate
- compile
- test
- package
- verify
- install
- deploy
具体各个阶段的定义可以参考Maven文档。命令 mvn <phase>
可以用来执行<phase>以及<phase>之前的阶段。例如:mvn install
将执行validate ~ install所有的阶段。
4. 常用命令
- mvn archetype:generate -DgroupId=<groupId> -DartifactId=<artifactId> 创建一个项目
- mvn compile 编译项目
- mvn test 执行测试用例
- mvn install 安装编译后的二进制包到本地Maven仓库。
……
5. 其他内容
多模块(multi-module)和 plugin goal,等等。