信步漫谈之Maven—基础介绍

Maven 是一个项目管理和构建自动化工具，最直接的讲，就是可以通过配置 pom.xml 文件关联 jar 仓库中的 jar 包，方便项目的管理。
一般情况下，maven 项目的结构都如下所示：

一、Maven安装

1）下载 maven 安装包，例如：apache-maven-3.0.5（官网：http://maven.apache.org/）
2）maven 环境变量配置，配置方式跟 jdk 有些类似。新建环境变量 MAVEN_HOME（值为 maven 的根目录）、然后在 PATH 环境变量里加入 %MAVEN_HOME%in; 即可。
3）设置 setting.xml 文件，配置本地仓库。apache-maven-3.0.5conf下有个 setting.xml 文件，打开，localRepository 的值设置成本地仓库的路径。

<?xml version="1.0" encoding="UTF-8"?>  
<settings 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/settings-1.0.0.xsd">  
      
    <!--本地仓库。该值表示构建系统本地仓库的路径。其默认值为~/.m2/repository。 -->  
    <localRepository>D:/mavenRepository</localRepository>  
  
    <!-- 
        Maven是否需要和用户交互以获得输入。如果Maven需要和用户交互以获得输入，则设置成true，反之则应为false。默认为true。 
    -->  
    <interactiveMode>true</interactiveMode>  
  
    <!-- 
        Maven是否需要使用plugin-registry.xml文件来管理插件版本。如果需要让Maven使用文件~/.m2/plugin-registry.xml来管理插件版本，则设为true。默认为false。 
    -->  
    <usePluginRegistry>false</usePluginRegistry>  
      
    <!-- 
        表示Maven是否需要在离线模式下运行。如果构建系统需要在离线模式下运行，则为true，默认为false。当由于网络设置原因或者安全因素，构建服务器不能连接远程仓库的时候，该配置就十分有用。 
    -->  
    <offline>false</offline>  
    
    
    <!--  
        根据环境参数来调整构建配置的列表。settings.xml中的profile元素是pom.xml中profile元素的裁剪版本。它包含了  
        id，activation, repositories, pluginRepositories和  
        properties元素。这里的profile  
        元素只包含这五个子元素是因为这里只关心构建系统这个整体（这正是settings.xml文件的角色定位），而非单独的项目对象模型设置。如果一个  
        settings中的profile被激活，它的值会覆盖任何其它定义在POM中或者profile.xml中的带有相同id的 profile。  
    -->  
      
    <profiles>  
        <!--根据环境参数来调整的构件的配置-->  
        <profile>  
            <!--该配置的唯一标识符。 -->  
            <id>test</id>  
            
            <!--远程仓库列表，它是Maven用来填充构建系统本地仓库所使用的一组远程项目。 -->  
            <repositories>  
                <!--包含需要连接到远程仓库的信息 -->  
                <repository>  
                    <!--远程仓库唯一标识-->  
                    <id>codehausSnapshots</id>  
                    <!--远程仓库名称 -->  
                    <name>Codehaus Snapshots</name>  
                    <!--如何处理远程仓库里发布版本的下载-->  
                    <releases>  
                        <!--true或者false表示该仓库是否为下载某种类型构件（发布版，快照版）开启。  -->  
                        <enabled>false</enabled>  
                        <!-- 
                            该元素指定更新发生的频率。Maven会比较本地POM和远程POM的时间戳。这里的选项是：always（一直），daily（默认，每日），interval：X（这里X是以分钟为单位的时间间隔），或者never（从不）。 
                        -->  
                        <updatePolicy>always</updatePolicy>  
                        <!--当Maven验证构件校验文件失败时该怎么做-ignore（忽略），fail（失败），或者warn（警告）。-->  
                        <checksumPolicy>warn</checksumPolicy>  
                    </releases>  
                    <!-- 
                        如何处理远程仓库里快照版本的下载。有了releases和snapshots这两组配置，POM就可以在每个单独的仓库中，为每种类型的构件采取不同的策略。例如，可能有人会决定只为开发目的开启对快照版本下载的支持。参见repositories/repository/releases元素 
                    -->  
                    <snapshots>  
                        <enabled />  
                        <updatePolicy />  
                        <checksumPolicy />  
                    </snapshots>  
                    <!--远程仓库URL，按protocol://hostname/path形式 -->  
                    <url>http://snapshots.maven.codehaus.org/maven2</url>  
                    <!--  
                        用于定位和排序构件的仓库布局类型-可以是default（默认）或者legacy（遗留）。Maven  
                        2为其仓库提供了一个默认的布局；然而，Maven  
                        1.x有一种不同的布局。我们可以使用该元素指定布局是default（默认）还是legacy（遗留）。  
                    -->  
                    <layout>default</layout>  
                </repository>  
            </repositories>  
            
        </profile>  
    </profiles>  
</settings>

4）在 eclipse 上安装 maven 插件（下载插件包，解压后把对应的 features 和 plugins 这两个文件夹的内容复制到 eclipse 相同文件夹里面即可，然后重启 eclipse），打开 Window->Preferences，可以看到 Maven 配置项。

5）Windows–>Prefrences–>Installations–>Add。installation name 选 maven 的根目录（就是之前本地安装的 apache-maven-3.0.5），OK 即可。

注意：
1.eclipse 在安装 maven 插件后，默认使用 Maven 的 setting.xml 文件读取目录为 C:Users 当前登录用户名 .m2，但是他不会自动生成 setting.xml 文件，需要我们手动加入。
2.eclipse 在安装 maven 插件后，也有一个内嵌的 maven，这个内嵌的 Maven 通常会比较新，但不一定很稳定，而且往往也会和我们在命令行使用的 Maven 不是同一个版本。这里有会出现两个潜在的问题：首先，较新版本的 Maven 存在很多不稳定因素，容易造成一些难以理解的问题；其次，除了 IDE，我们也经常还会使用命令行的 Maven，如果版本不一致，容易造成构建行为的不一致，这是我们所不希望看到的。因此，我们应该在 IDE 中配置 Maven 插件时使用与命令行一致的 Maven。

二、创建Maven项目

在 eclipse 中右键创建项目 New->Other，选择 Maven 项目

这时候，我们有个可选项 Create a simple project(skip archetype selection)，eclipse 默认会为使用者提供一些 maven 项目骨架，如果勾选了这项，则我们将跳过使用默认骨架，自己定义 maven 项目的基础结构。

groupId：项目或者组织的唯一标志，并且配置时生成路径也是由此生成，如 com.alfred.test 生成的相对路径为：/com/alfred/test
artifactId：项目的通用名称
version：项目的版本
packaging：打包机制，如 pom,jar,maven-plugin,ejb,war,ear,rar,par，一般 java 项目选址 jar，web 项目选址 war
name：用户描述项目的名称，无关紧要的东西，可选
description：应该是只是写明开发团队的网站，无关紧要，可选

注意：在实际项目中，如果需要添加外部依赖 jar 包，可以在 pom.xml 中添加依赖节点 dependencies->dependency

<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.alfred.jetty</groupId>
    <artifactId>jetty-base</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <name>Jetty基础</name>
    <packaging>war</packaging>
    <dependencies>
        <dependency>
            <groupId>org.eclipse.jetty</groupId>
            <artifactId>jetty-server</artifactId>
            <version>8.1.19.v20160209</version>
        </dependency>
        <dependency>
            <groupId>org.eclipse.jetty</groupId>
            <artifactId>jetty-webapp</artifactId>
            <version>8.1.19.v20160209</version>
        </dependency>
        <dependency>
            <groupId>org.eclipse.jetty</groupId>
            <artifactId>jetty-servlet</artifactId>
            <version>8.1.19.v20160209</version>
        </dependency>
    </dependencies>
</project>

三、Maven的常用命令

1. 创建 Maven 的普通 java 项目：
mvn archetype:create -DgroupId=packageName -DartifactId=projectName
2. 创建 Maven 的 Web 项目：
mvn archetype:create -DgroupId=packageName -DartifactId=webappName -DarchetypeArtifactId=maven-archetype-webapp
3. 编译源代码：mvn compile
4. 编译测试代码：mvn test-compile
5. 运行测试：mvn test
6. 产生site：mvn site
7. 打包：mvn package
8. 在本地 Repository 中安装 jar：mvn install
9. 清除产生的项目：mvn clean
10. 生成 eclipse 项目：mvn eclipse:eclipse
11. 生成 idea 项目：mvn idea:idea
12. 组合使用 goal 命令，如只打包不测试：mvn -Dtest package
13. 编译测试的内容：mvn test-compile
14. 只打 jar 包: mvn jar:jar
15. 只测试而不编译，也不测试编译：mvn test -skipping compile -skipping test-compile
( -skipping 的灵活运用，当然也可以用于其他组合命令)
16. 清除 eclipse 的一些系统设置:mvn eclipse:clean