Maven 扫盲（上）

Apache Maven 入门篇 ( 上 )

作者：George Ma

写这个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 文件：

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 的核心概念，希望能回答你可能会有的一些疑问。