Apache Maven 入门篇 ( 上 )

Apache
Maven

入门篇

(

上

)

 
写这个

maven

的入门篇是因为之前在一个开发者会的动手实验中发现挺多人对于

maven

不是那么了解，所以就有了这个想法。

 
这个入门篇分上下两篇。本文着重动手，用

maven

来构建运行

hellow
world

程序，体会一下不用任何

IDE

，只用

maven

是咋回事。然后下篇就讲解一下

maven

的核心概念。写这两篇文章特意回避了复杂的示例，也不使用

IDE

，目的是排除干扰，着重于

maven

本身。

 
 
Apache
Maven

是做什么用的？

 
Maven

是一个项目管理和构建自动化工具。但是对于我们程序员来说，我们最关心的是它的项目构建功能。所以这里我们介绍的就是怎样用

maven

来满足我们项目的日常需要。

 
Maven

使用惯例优于配置的原则

。它要求在没有定制之前，所有的项目都有如下的结构：

 

目录	目的
${basedir}	存放 pom.xml和所有的子目录
${basedir}/src/main/java	项目的 java源代码
${basedir}/src/main/resources	项目的资源，比如说 property文件
${basedir}/src/test/java	项目的测试类，比如说 JUnit代码
${basedir}/src/test/resources	测试使用的资源

 
一个

maven

项目在默认情况下会产生

JAR

文件，另外

，编译后

的

classes

会放在

${basedir}/target/classes

下面，

JAR

文件会放在

${basedir}/target

下面。

 
这时有人会说了

，

Ant

就没有那么多要求

，它允许你可以自由的定义项目的结构。在这里不想引起口水战哈，

我个人觉得

maven

的这些默认定义很方便使用。

 
好了

，接下来我们来安装

maven

。

 
Maven



的

安装



 

 
在安装

maven

前，先保证你安装了

JDK

。

JDK
6

可以从

Oracle

技术网上

下载：
http://www.oracle.com/technetwork/cn/java/javase/downloads/index.html
 
Maven

官网的下载链接是

: http://maven.apache.org/download.html
该页的最后给出了安装指南。

 
安装完成后

，在命令行运行下面的命令：

 
 
$ mvn -v

 
Apache Maven
3.0.3 (r1075438; 2011-03-01 01:31:09+0800)

Maven home:
/home/limin/bin/maven3

Java version:
1.6.0_24, vendor: Sun Microsystems Inc.

Java home:
/home/limin/bin/jdk1.6.0_24/jre

Default locale:
en_US, platform encoding: UTF-8

OS name:
"linux", version: "2.6.35-28-generic-pae", arch:
"i386", family: "unix"

 
 

如果你看到类似上面的输出的话，就说明安装成功了。

 
接下来我们用

maven

来建立最著名的“

Hello
World!”

程序

:)

 
注意：如果你是第一次运行

maven

，你需要

Internet

连接，因为

maven

需要从网上下载需要的插件。

 
我们要做的第一步是建立一个

maven

项目。在

maven

中，我们是执行

maven

目标

(goal)

来做事情的。

maven

目标和

ant

的

target

差不多。在命令行中执行下面的命令来建立我们的

hello
world

项目

 

 

~$mvn
archetype:generate -DgroupId=com.mycompany.helloworld
-DartifactId=helloworld -Dpackage=com.mycompany.helloworld
-Dversion=1.0-SNAPSHOT

 

 

archetype:generate

目标会列出一系列的

archetype

让你选择。

Archetype

可以理解成项目的模型。

Maven

为我们提供了很多种的项目模型，包括从简单的

Swing

到复杂的

Web

应用。我们选择默认的

maven-archetype-quickstart

，是编号

#106

，如下图所示：

 



 
连打两个回车，这时候让你确定项目属性的配置，

 



 
这些属性是我们在命令行中用

-D

选项指定的。该选项使用

-Dname=value

的格式。回车确认，就完成了项目的建立，如下图所示：

 



 
这时候我们看一下

maven

给我们建立的文件目录结构：

 



 
maven

的

archetype

插件建立了一个

helloworld

目录，这个名字来自

artifactId

。在这个目录下面，有一个

Project
Object Model(POM)

文件

pom.xml

。这个文件用于描述项目，配置插件和管理依赖关系。

 
源代码和资源文件放在

src/main

下面，而测试代码和资源放在

src/test

下面。

 
Maven

已经为我们建立了一个

App.java

文件：

package com.mycompany.helloworld;

/**
* Hello world!
*
*/
public class App {

public static void main( String[] args ) {
System.out.println( "Hello World!" );
}
}

 
正是我们需要的

Hello
World

代码。所以我们可以构建和运行这个程序了。用下面简单的命令构建：

 
~$cd helloworld

~$mvn package

 
当你第一次运行

maven

的时候，它会从网上的

maven

库

(repository)

下载需要的程序，存放在你电脑的本地库

(local
repository)

中，所以这个时候你需要有

Internet

连接。

Maven

默认的本地库是

~/.m2/repository/

，在

Windows

下是

%USER_HOME%/.m2/repository/

。

 



 
如果构建没有错误的话，就会得到类似下面的结果：



 
这个时候，

maven

在

helloworld

下面建立了一个新的目录

target/

，构建打包后的

jar

文件

helloworld-1.0-SNAPSHOT.jar

就存放在这个目录下。编译后的

class

文件放在

target/classes/

目录下面，测试

class

文件放在

target/test-classes/

目录下面。

 
为了验证我们的程序能运行，执行下面的命令：

 
~$java -cp
target/helloworld-1.0-SNAPSHOT.jar com.mycompany.helloworld.App

 



 
运行成功！！

 
现在你可能会有不少的问题。所以下一篇文章会解释

maven

的核心概念，希望能回答你可能会有的一些疑问。

 

第

二

篇： Apache Maven 入门篇 ( 下 )