Maven项目中有一些约定:在项目的根目录中放置pom.xml,在src/main/java目录中放置项目的主代码,在src/test/java目录中放置项目的测试代码。我们称这些基本的目录结构和pom.xml文件内容为项目的骨架。我们可以手工创建项目骨架,也可以使用Maven提供的Archetype快速勾勒出项目骨架。下面使用Archetype创建项目骨架。
在E盘建一个maven工作空间:E:/mavenspace
打开命令行窗口,进入maven工作空间,执行命令 mvn archetype:create -DgroupId=com.zzj.app -DartifactId=my-app
E:\mavenspace>mvn archetype:create -DgroupId=com.zzj.app -DartifactId=my-app
如果是第一次创建项目,会从远程仓库下载依赖包到本地仓库。
创建的项目结构如下:
在项目根目录下生成了一个pom.xml文件,这是maven的核心文件:
文件内容如下:
<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>com.zzj.app</groupId>
<artifactId>my-app</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>jar</packaging>
<name>my-app</name>
<url>http://maven.apache.org</url>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>
</project>
有三个非常重要的元素:groupId、artifactId和version,这三个元素定义了一个项目的基本坐标,其他项目通过这三个元素可以定位到这个项目。
另一个重要的元素就是dependencies,该元素下可以包含多个dependency元素以声明项目的依赖。
打开源文件App.java:
package com.zzj.app;
/**
* Hello world!
*
*/
public class App
{
public static void main( String[] args )
{
System.out.println( "Hello World!" );
}
}
修改该文件:
package com.zzj.app;
import org.apache.commons.lang.StringUtils;
/**
* Hello world!
*
*/
public class App
{
public static void main( String[] args )
{
System.out.println( "Hello World!" );
System.out.println("equals:" + StringUtils.equals("a", "a"));
}
}
以上代码依赖了apache的commons包,所以需要在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>com.zzj.app</groupId>
<artifactId>my-app</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>jar</packaging>
<name>my-app</name>
<url>http://maven.apache.org</url>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>commons-lang</groupId>
<artifactId>commons-lang</artifactId>
<version>2.1</version>
</dependency>
</dependencies>
</project>
进入my-app目录,编译:
E:\mavenspace\my-app>mvn compile
在项目根目录下生成了target文件夹,里面存放了class文件。
运行:
E:\mavenspace\my-app>mvn exec:java -Dexec.mainClass="com.zzj.app.App"
结果:
运行成功!注意,不能直接用java命令运行(除非指定classpath),因为项目依赖了外部jar包。
我们还可以运行其他命令,比如package,install等等。
虽然很难列出一张非常全面的表,但在此可先列出最普通的默认的生命周期阶段:
validate:验证工程是否正确,所有需要的资源是否可用。
compile:编译项目的源代码。
test:使用合适的单元测试框架来测试已编译的源代码。这些测试不需要已打包和布署。
Package:把已编译的代码打包成可发布的格式,比如jar。
integration-test:如有需要,将包处理和发布到一个能够进行集成测试的环境。
verify:运行所有检查,验证包是否有效且达到质量标准。
install:把包安装在本地的repository中,可以被其他工程作为依赖来使用。
Deploy:在集成或者发布环境下执行,将最终版本的包拷贝到远程的repository,使得其他的开发者或者工程可以共享。
clean:清除先前构建的artifacts(在maven中,把由项目生成的包都叫作artifact),该命令会删除target文件夹。
site:为项目生成文档站点。