Project Object Model，项目对象模型。通过xml格式保存的pom.xml文件。作用类似ant的build.xml文件，功能更强大。该文件用于管理：源代码、配置文件、开发者的信息和角色、问题追踪系统、组织信息、项目授权、项目的url、项目的依赖关系等等。

一个完整的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>
  <!– The Basics –>
  <groupId>…</groupId>
  <artifactId>…</artifactId>
  <version>…</version>
  <packaging>…</packaging>
  <dependencies>…</dependencies>
  <parent>…</parent>
  <dependencyManagement>…</dependencyManagement>
  <modules>…</modules>
  <properties>…</properties>
  <!– Build Settings –>
  <build>…</build>
  <reporting>…</reporting>
  <!– More Project Information –>
  <name>…</name>
  <description>…</description>
  <url>…</url>
  <inceptionYear>…</inceptionYear>
  <licenses>…</licenses>
  <organization>…</organization>
  <developers>…</developers>
  <contributors>…</contributors>
  <!– Environment Settings –>
  <issueManagement>…</issueManagement>
  <ciManagement>…</ciManagement>
  <mailingLists>…</mailingLists>
  <scm>…</scm>
  <prerequisites>…</prerequisites>
  <repositories>…</repositories>
  <pluginRepositories>…</pluginRepositories>
  <distributionManagement>…</distributionManagement>
  <profiles>…</profiles>
</project>

基本设置

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/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>my-project</artifactId>
  <version>1.0</version>
  <packaging>war</packaging>
</project>

1. groupId : 组织标识，例如：org.codehaus.mojo，在M2_REPO目录下，将是: org/codehaus/mojo目录。
2. artifactId : 项目名称，例如：my-project，在M2_REPO目录下，将是：org/codehaus/mojo/my-project目录。
3. version : 版本号，例如：1.0，在M2_REPO目录下，将是：org/codehaus/mojo/my-project/1.0目录。
4. packaging : 打包的格式，可以为：pom , jar , maven-plugin , ejb , war , ear , rar , par

POM之间的关系

主要用于POM文件的复用。

依赖关系：依赖关系列表（dependency list）是POM的重要部分。

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.0</version>
      <scope>test</scope>
    </dependency>
    …
  </dependencies>

1. groupId , artifactId , version :
2. scope : compile(default),provided,runtime,test,system
3. exclusions

继承关系：继承其他pom.xml配置的机制。

比如父pom.xml：

<project>
  [...]
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.4</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
  [...]
</project>

在子pom.xml文件继承它的依赖（还可以继承其他的：developers and contributors、plugin lists、reports lists、plugin executions with matching ids、plugin configuration）：

[...]
<parent>
<groupId>com.devzuz.mvnbook.proficio</groupId>
  <artifactId>proficio</artifactId>
  <version>1.0-SNAPSHOT</version>
</parent>
[...]

在这种机制下，maven还提供了一个类似java.lang.Object的顶级父pom.xml文件：

<project>
  <modelVersion>4.0.0</modelVersion>
  <name>Maven Default Project</name>
  <repositories>
    <repository>
      <id>central</id>
      <name>Maven Repository Switchboard</name>
      <layout>default</layout>
      <url>http://repo1.maven.org/maven2</url>
      <snapshots>
        <enabled>false</enabled>
      </snapshots>
    </repository>
  </repositories>
  <pluginRepositories>
    <pluginRepository>
      <id>central</id>
      <name>Maven Plugin Repository</name>
      <url>http://repo1.maven.org/maven2</url>
      <layout>default</layout>
      <snapshots>
        <enabled>false</enabled>
      </snapshots>
      <releases>
        <updatePolicy>never</updatePolicy>
      </releases>
    </pluginRepository>
  </pluginRepositories>
  <build>
    <directory>target</directory>
    <outputDirectory>target/classes</outputDirectory>
    <finalName>${project.artifactId}-${project.version}</finalName>
    <testOutputDirectory>target/test-classes</testOutputDirectory>
    <sourceDirectory>src/main/java</sourceDirectory>
    <scriptSourceDirectory>src/main/scripts</scriptSourceDirectory>
    <testSourceDirectory>src/test/java</testSourceDirectory>
    <resources>
      <resource>
        <directory>src/main/resources</directory>
      </resource>
    </resources>
    <testResources>
      <testResource>
        <directory>src/test/resources</directory>
      </testResource>
    </testResources>
    <pluginManagement>
       <plugins>
         <plugin>
           <artifactId>maven-antrun-plugin</artifactId>
           <version>1.1</version>
         </plugin>      
         <plugin>
           <artifactId>maven-assembly-plugin</artifactId>
           <version>2.2-beta-2</version>
         </plugin>
         <plugin>
           <artifactId>maven-clean-plugin</artifactId>
           <version>2.2</version>
         </plugin>
         <plugin>
           <artifactId>maven-compiler-plugin</artifactId>
           <version>2.0.2</version>
         </plugin>
         <plugin>
           <artifactId>maven-dependency-plugin</artifactId>
           <version>2.0</version>
         </plugin>
         <plugin>
           <artifactId>maven-deploy-plugin</artifactId>
           <version>2.3</version>
         </plugin>
         <plugin>
           <artifactId>maven-ear-plugin</artifactId>
           <version>2.3.1</version>
         </plugin>
         <plugin>
           <artifactId>maven-ejb-plugin</artifactId>
           <version>2.1</version>
         </plugin>
         <plugin>
           <artifactId>maven-install-plugin</artifactId>
           <version>2.2</version>
         </plugin>
         <plugin>
           <artifactId>maven-jar-plugin</artifactId>
           <version>2.2</version>
         </plugin>
         <plugin>
           <artifactId>maven-javadoc-plugin</artifactId>
           <version>2.4</version>
         </plugin>
         <plugin>
           <artifactId>maven-plugin-plugin</artifactId>
           <version>2.4.1</version>
         </plugin>
         <plugin>
           <artifactId>maven-rar-plugin</artifactId>
           <version>2.2</version>
         </plugin>
         <plugin>               
           <artifactId>maven-release-plugin</artifactId>
           <version>2.0-beta-7</version>
         </plugin>
         <plugin>               
           <artifactId>maven-resources-plugin</artifactId>
           <version>2.2</version>
         </plugin>
         <plugin>
           <artifactId>maven-site-plugin</artifactId>
           <version>2.0-beta-6</version>
         </plugin>
         <plugin>
           <artifactId>maven-source-plugin</artifactId>
           <version>2.0.4</version>
         </plugin>         
         <plugin>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>2.4.2</version>
         </plugin>
         <plugin>
           <artifactId>maven-war-plugin</artifactId>
           <version>2.1-alpha-1</version>
         </plugin>
       </plugins>
     </pluginManagement>
  </build>
  <reporting>
    <outputDirectory>target/site</outputDirectory>
  </reporting>
  <profiles>
    <profile>
      <id>release-profile</id>
      <activation>
        <property>
          <name>performRelease</name>
          <value>true</value>
        </property>
      </activation>
      <build>
        <plugins>
          <plugin>
            <inherited>true</inherited>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-source-plugin</artifactId>
            <executions>
              <execution>
                <id>attach-sources</id>
                <goals>
                  <goal>jar</goal>
                </goals>
              </execution>
            </executions>
          </plugin>
          <plugin>
            <inherited>true</inherited>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <executions>
              <execution>
                <id>attach-javadocs</id>
                <goals>
                  <goal>jar</goal>
                </goals>
              </execution>
            </executions>
          </plugin>
          <plugin>
            <inherited>true</inherited>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-deploy-plugin</artifactId>
            <configuration>
              <updateReleaseInfo>true</updateReleaseInfo>
            </configuration>
          </plugin>
        </plugins>
      </build>
    </profile>
  </profiles>
</project>

可以通过下面命令查看当前pom.xml受到超pom.xml文件的影响：

mvn help:effective-pom

聚合关系：用于将多个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/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>my-parent</artifactId>
  <version>2.0</version>
  <modules>
    <module>my-project<module>
  </modules>
</project>

属性

maven的属性，是值的占位符，类似EL，类似ant的属性，比如${X}，可用于pom文件任何赋值的位置。有以下分类：

1. env.X：操作系统环境变量，比如${env.PATH}
2. project.x：pom文件中的属性，比如：<project><version>1.0</version></project>，引用方式：${project.version}
3. settings.x：settings.xml文件中的属性，比如：<settings><offline>false</offline></settings>，引用方式：${settings.offline}
4. Java System Properties：java.lang.System.getProperties()中的属性，比如java.home，引用方式：${java.home}
5. 自定义：在pom文件中可以：<properties><installDir>c:/apps/cargo-installs</installDir></properties>，引用方式：${installDir}

构建设置

构建有两种build标签：

<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">
  …
  <!– "Project Build" contains more elements than just the BaseBuild set –>
  <build>…</build>
  <profiles>
    <profile>
      <!– "Profile Build" contains a subset of "Project Build"s elements –>
      <build>…</build>
    </profile>
  </profiles>
</project>

build中的主要标签：Resources和Plugins。

Resources：用于排除或包含某些资源文件

    <resources>
      <resource>
        <targetPath>META-INF/plexus</targetPath>
        <filtering>false</filtering>
        <directory>${basedir}/src/main/plexus</directory>
        <includes>
          <include>configuration.xml</include>
        </includes>
        <excludes>
          <exclude>**/*.properties</exclude>
        </excludes>
      </resource>
    </resources>

Plugins：设置构建的插件

  <build>
    …
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-jar-plugin</artifactId>
        <version>2.0</version>
        <extensions>false</extensions>
        <inherited>true</inherited>
        <configuration>
          <classifier>test</classifier>
        </configuration>
        <dependencies>…</dependencies>
        <executions>…</executions>
      </plugin>

创建项目

在命令行输入，这一步和创建java项目类似：

mvn archetype:generate

Choose a number: 回车即可，也就是选择18，这里和java普通项目不一样
Define value for groupId: 输入组织id，比如easymorse.com
Define value for artifactId：输入项目名称，比如helloworld
Define value for version: 输入版本号，可以直接回车，默认是1.0-SNAPSHOT
Define value for package: java的包名，比如com.easymorse
然后回车表示确认上述输入即可。

运行maven任务

命令行进入创建项目的目录。

项目打包命令

mvn package

这一步和java项目类似，不过生成的是war包，在target目录下。其他任务和java项目类似。

将maven项目转化为eclipse项目

mvn -Dwtpversion=1.0 eclipse:eclipse

这样生成wtp插件的web项目。
打开eclipse，菜单选择：file>import>general>existing projects into workspace，在对话框中选中目录，导入即可。
另外，需要在eclipse里创建一个classpath变量，名称为：M2_REPO，值为系统用户下.m2/repository目录。

创建项目

在命令行执行命令进行交互式的创建项目：

mvn archetype:generate

Choose a number: 回车即可，也就是选择15。
Define value for groupId: 输入组织id，比如easymorse.com
Define value for artifactId：输入项目名称，比如helloworld
Define value for version: 输入版本号，可以直接回车，默认是1.0-SNAPSHOT
Define value for package: java的包名，比如com.easymorse
然后回车表示确认上述输入即可。

helloworld目录（Define value for artifactId输入的项目名称）下生成的文件和目录：

• 项目构建文件: pom.xml
• 代码框架: src\main\java\com\easymorse\App.java
• 测试代码: src\test\java\com\easymorse\AppTest.java

运行maven任务

命令行进入helloworld目录Define value for artifactId输入的项目名称）。

项目打包命令

mvn package

命令生成了什么？

• target目录
• 编译了代码
• 编译了测试代码
• 使用junit测试并生成的报告
• 生成代码的jar文件

运行打包的jar文件

java -cp  target\helloworld-1.0-SNAPSHOT.jar
com.easymorse.App

编译源程序

mvn compile

编译并测试

mvn test

清空生成的文件

mvn clean

maven项目转化为eclipse项目

mvn eclipse:eclipse

打开eclipse，菜单选择：file>import>general>existing projects into workspace，在对话框中选中目录，导入即可。如果要清除有关eclipse项目的配置信息：

mvn eclipse:clean

http://maven.apache.org/download.html

解压缩到本地。配置maven, 将maven/bin目录设置到windows环境变量Path中。检查maven是否安装成功, 在命令行中执行命令测试是否安装成功：

mvn -version

从源代码和文档创建交付使用的产品的过程。

软件构建的方式

1. 手工构建，比如java，通过javac编译代码，再手工复制部署到指定位置，手工执行javadoc生成javadoc文档等等；
2. 通过IDE工具，比如eclipse自动编译，通过图形界面导出软件制品（比如jar，war）等等；
3. 通过自动化构建工具，maven就是一种自动构建工具。

构建工具的作用

如果只有一个开发人员，使用IDE工具已经足够。当多人参与项目编码时，为提高集成和构建的效率，需要使用构建工具。

IDE和构建工具的区别

• IDE是通过多次交互(比如点击按钮)完成构建过程，自动构建工具是批处理方式自动完成构建过程；
• IDE的用户是专业的开发人员，构建工具的用户可以是普通用户或者网管等；
• IDE工具依赖图形界面环境，构建工具只使用命令行界面。

Maven和Ant的区别

• 不需要写复杂的处理脚本；
• 声明式的类库依赖管理。

Maven的基本功能小结

• 构建：比如生成class、jar、war或者ear文件
• 生成文档：比如生成javadoc、网站文档
• 生成报告：比如junit测试报告
• 生成依赖类库：生成文档，说明项目多其他软件的依赖
• 有关SCM：SCM（Software Configuration Management），软件配置管理，比如版本控制，比如bug管理等等
• 发布：生成供发布的分发包，比如生成Struts2的分发包，供提交给用户使用
• 部署：比如，web应用程序，自动部署到指定的服务器上

完整的maven示例

http://code.google.com/p/simplelife/wiki/SimpleLife_Product

http://code.google.com/p/simplelife/wiki/SimpleLife_Sample_Ant

Ant编译和库的依赖

在项目中创建lib目录，放置项目需要的jar文件。并在ant文件中引用该目录下jar文件到classpath。

build文件

build文件的属性文件

buid.xml文件不需要修改，所有可变动的内容放置在build.properties文件中，供build.xml文件引用。

project.name=user_manager

build.path=build

build.path.class=${build.path}/classes

lib.path=lib

dist.path=dist

src.path=src

doc.path=${dist.path}/doc

javadoc.path=${doc.path}/api

javadoc.title=User Management API

web.path=WebContent

deploy.url=http://localhost:8080/manager

deploy.userName=marshal

deploy.password=password

ant项目导入Eclipse

创建Eclipse Dynamic Web Project。复制lib，src和webcontent目录中的文件，build.xml，build.properties。选中lib目录下需要的jar文件，鼠标右键，add to build path。

在项目属性中，J2EE Module Dependences加入jar文件。通过Eclipse中集成的ant功能构建。

准备工作

解压缩Ant分发包.设置JAVA_HOME变量.在Windwos系统环境中的Path变量中增加, {ant_home}/bin.打开命令行窗口（若能看到版本信息说明安装成功）:

ant -version

创建项目目录和Java文件

创建一个任意的项目目录.在该目录下创建src目录.在src目录下创建test目录, 并在该目录下编写一个最简单的java程序:

package test;

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

创建构建文件

构建文件一般被称作build文件.在刚才建立的项目根目录下,创建build.xml文件:

<?xml version="1.0" encoding="UTF-8"?>
<project name="firstbuild" default="compile">
        <target name="compile">
                <javac srcdir="src" />
                <echo>构建成功!</echo>
        </target>
</project>

运行构建脚本

项目根目录下, 运行:

ant

在运行中看到更详细信息的方法:

ant -verbose

增加构建的功能

上面的构建只完成一个工作, 将java文件编译为class文件.存在的不足: 源文件和编译后的文件放在一起, 比较混乱.源文件和编译文件存放在不同的目录下;编译后的class文件打包为jar文件.一般的目录约定:

编写build文件

target的依赖关系

如果循环依赖, ant会检测到并报错退出。

更多的ant功能

了解build中所有任务

ant -projecthelp

增量构建

再次运行, 将编译改动过的class文件。

一次运行多个target

ant compile archive

指定运行的构建文件

ant -buildfile build.xml compile

减少构建中信息输出

ant -quiet

运行程序

可以通过命令行执行java程序：

java -cp build/classes test.HelloWorld

通过ant执行的配置：

使用ant执行的好处:

• 可以比较容易的将复杂参数加入程序
• 易于设置classpath
• 直接使用ant配置的JVM

完整的构建文件

build配置文件的组成

• 一个build文件包含一个project标签(根标签);
• project标签中包含多个target标签
• 一个target可能依赖其他target(可以多个)
• target包含多个task
• task实现构建的各个任务