简介

概述

Maven 是一个项目管理和整合工具
Maven 为开发者提供了一套完整的构建生命周期框架
Maven 简化了工程的构建过程，并对其标准化，它无缝衔接了编译、发布、文档生成、团队合作和其他任务

环境配置

系统要求

JDK
- Maven 3.3 要求 JDK 1.7 或以上
- Maven 3.2 要求 JDK 1.6 或以上
- Maven 3.0/3.1 要求 JDK 1.5 或以上
磁盘
Maven自身安装需要大约 10 MB 空间。除此之外，额外的磁盘空间将用于你的本地 Maven 仓库。你本地仓库的大小取决于使用情况，但预期至少 500 MB。
内存
没有最低要求。
操作系统
没有最低要求。

Java安装

Windows
打开命令控制台，输入：java -version；输出：

java version "1.8.0_131"
Java(TM) SE Runtime Environment (build 1.8.0_131-b11)
Java HotSpot(TM) Client VM (build 25.131-b11, mixed mode, sharing)

如果没有安装自行安装，并配置环境变量。

Linux
打开命令终端，输入：java -version；输出：

 java version "1.8.0_131"
Java(TM) SE Runtime Environment (build 1.8.0_131-b11)
Java HotSpot(TM) Client VM (build 25.131-b11, mixed mode, sharing)

如果没有安装自行安装，并配置环境变量

Mac
打开命令终端，输入：java -version；输出：

java version "1.8.0_131"
Java(TM) SE Runtime Environment (build 1.8.0_131-b11)
Java HotSpot(TM) Client VM (build 25.131-b11, mixed mode, sharing)

如果没有安装自行安装，并配置环境变量

Maven安装

下载安装文件，选择最新稳定版本：http://maven.apache.org/download.html
安装
- Windows:解压文件到你想要安装的位置：D:\Software\apache-maven-3.5.0
- Linux:解压文件到你想要安装的位置：/usr/local/apache-maven
- Mac:解压文件到你想要安装的位置：/usr/local/apache-maven
设置 Maven 环境变量(不清楚的自行查找资料)
- Windows
  配置M2_HOME环境变量：
  M2_HOME=D:\Software\apache-maven-3.5.0；
  将bin目录追加到PATH路径中：%M2_HOME%\bin；
- Linux
  在/etc/profile文件中添加Maven环境变量，如下所示：
  export M2_HOME=/usr/local/apache-maven/apache-maven-3.5.0
  export PATH=$M2_HOME/bin:$PATH
  然后执行source /etc/profile，使环境变量生效
- Mac
  在/etc/profile文件中添加Maven环境变量，如下所示：
  export M2_HOME=/usr/local/apache-maven/apache-maven-3.5.0
  export PATH=$M2_HOME/bin:$PATH
  然后执行source /etc/profile，使环境变量生效
- 验证 Maven 安装(有输出maven版本信息，Java版本信息表示安装成功)
  - Windows : mvn --version
  - Linux : mvn --version
  - Mac : mvn --version

功能

项目管理工具
依赖管理工具
构建工具

优点

对第三方依赖库进行了统一的版本管理
统一了构建过程
统一了项目的目录结构

构建

清理 : mvn clear
编译 : mvn compile
测试 : mvn test
打包 : mvn package
部署 : mvn deploy
安装（将jar安装到本地仓库）: mvn install

使用入门

约定优于配置

Maven 规定了项目的源代码，测试代码，资源文件，编译包输出文件，字节码文件等文件的目录，统一了项目的目录结构

源代码目录 : /src/main/java
资源文件目录 : /src/main/resources
测试代码目录 : /src/test/java
包输出目录 : /target
编译后的字节码输出目录 : /target/classes

POM文件详解

POM 代表工程对象模型，它是使用Maven工作时的基本组件，是一个xml文件，它被放在工程根目录下，文件命名为pom.xml；
POM 包含了关于工程和各种配置细节的信息，Maven使用这些信息构建工程；
POM 也包含了目标和插件，当执行一个任务或者目标时，Maven会查找当前目录下的POM，从其中读取所需要的配置信息，然后执行目标；
在创建POM之前，我们首先确定工程组（groupId），及其名称（artifactId）和版本，在仓库中这些属性是工程的唯一标识；
- 所有的POM文件需要project元素和三个必须的字段：groupId， artifactId，version；
- 在仓库中的工程标识为groupId:artifactId:version；
- POM.xml的根元素是 project，它有三个主要的子节点
  - groupId:这是工程组的标识,它在一个组织或者项目中通常是唯一的；
  - artifactId:这是工程的标识,它通常是工程的名称,groupId 和 artifactId 一起定义了 artifact 在仓库中的位置；
  - version:这是工程的版本号,在 artifact 的仓库中，它用来区分不同的版本；

pom.xml文件详解(参考http://blog.csdn.net/oDeviloo/article/details/52050277）

概述


        4.0.0
        
        ...
        ...
        ...
        ...
        
        ...
        ...
        ...
        ...
        ...
        
        ...
        ...
        
        ...
        ...
        ...
        ...
        ...
        ...
        ...
        ...
        
        ...
        ...
        ...
        ...
        ...
        ...
        ...
        ...
        ...

基本配置
- modelVersion : pom模型版本，maven2和3只能为4.0.0
- groupId : 组ID，maven用于定位
- artifactId : 在组中的唯一ID用于定位
- version : 项目版本
- packaging : 项目打包方式，有以下值：pom, jar, maven-plugin, ejb, war, ear, rar, par，默认为jar

依赖配置

parent：用于确定父项目的坐标


    com.hyn
    SIP-parent
    
    0.0.1-SNAPSHOT

groupId：父项目的构件标识符
artifactId：父项目的唯一标识符
relativePath：Maven首先在当前项目的找父项目的pom，然后在文件系统的这个位置（relativePath），然后在本地仓库，再在远程仓库找
version：父项目的版本

modules : 有些maven项目会做成多模块的，这个标签用于指定当前项目所包含的所有模块。之后对这个项目进行的maven操作，会让所有子模块也进行相同操作


   com-a
   com-b
   com-c

properties : 用于定义pom常量


    1.7

这个常量可以在pom文件的任意地方通过${java.version}来引用

dependencies : 项目相关依赖配置，如果在父项目写的依赖，会被子项目引用，一般父项目会将子项目公用的依赖引入


    
        junit
        junit
        4.12

dependencyManagement : 在父模块中定义后，子模块不会直接使用对应依赖，但是在使用相同依赖的时候可以不加版本号，这样的好处是，父项目统一了版本，而且子项目可以在需要的时候才引用对应的依赖

父项目：

    
        
            junit
            junit
            4.12
            test
        
    

子项目：

    junit
    junit

构建配置

build : 用于配置项目构建相关信息

reporting : 该元素描述使用报表插件产生报表的规范,当用户执行“mvn site”，这些报表就会运行,在页面导航栏能看到所有报表的链接

项目信息
- name : 给用户提供更为友好的项目名
- description : 项目描述，maven文档中保存
- url : 主页的URL，maven文档中保存
- inceptionYear : 项目创建年份，4位数字。当产生版权信息时需要使用这个值
- licenses : 该元素描述了项目所有License列表,应该只列出该项目的license列表，不要列出依赖项目的license列表,如果列出多个license，用户可以选择它们中的一个而不是接受所有license
```
    
    ...
    
    ....
    
    repo
    
    ....
```
- organization : 1.name 组织名 2.url 组织主页url
- developers : 项目开发人员列表
```
    
    
        
        ...
        
        ...
        
        ...
        
        ...
        
        
            Java Dev
            Web UI
        
        
        sun
        
        ...
        
        
            
        
        
        -5
    
```
- contributors : 项目其他贡献者列表，同developers

环境设置

issueManagement : 目的问题管理系统(Bugzilla, Jira, Scarab)的名称和URL


    Bugzilla系统类型
    http://127.0.0.1/bugzilla/路径

ciManagement : 项目的持续集成信息


    continuum持续集成系统的名字
    http://127.0.0.1:8080/continuum持续集成系统的URL
    构建完成时，需要通知的开发者/用户的配置项。包括被通知者信息和通知条件（错误，失败，成功，警告）
      
        mail通知方式
        true错误时是否通知
        true失败时是否通知
        false成功时是否通知
        false警告时是否通知
        [email protected]通知发送到的地址
        扩展项

mailingLists : 项目相关邮件列表信息


    
      User List
      [email protected]订阅邮件（取消订阅）的地址或链接，如果是邮件地址，创建文档时，mailto: 链接会被自动创建
      [email protected]订阅邮件（取消订阅）的地址或链接，如果是邮件地址，创建文档时，mailto: 链接会被自动创建
      [email protected]接收邮件的地址
      http://127.0.0.1/user/浏览邮件信息的URL
      
        http://base.google.com/base/1/127.0.0.1
      
    
    .....

scm : 允许你配置你的代码库，供Maven web站点和其它插件使用


    scm:svn:http://127.0.0.1/svn/my-project表示我们如何连接到maven的版本库。connection只提供读。写法如：scm:[provider]:[provider_specific]如果连接到CVS仓库，可以配置如下：scm:cvs:pserver:127.0.0.1:/cvs/root:my-project
    scm:svn:https://127.0.0.1/svn/my-project表示我们如何连接到maven的版本库。developerConnection将提供写的请求。写法如：scm:[provider]:[provider_specific]如果连接到CVS仓库，可以配置如下：scm:cvs:pserver:127.0.0.1:/cvs/root:my-project
    HEAD项目标签，默认HEAD
    http://127.0.0.1/websvn/my-project共有仓库路径

prerequisites : 项目构建的前提


    2.0.6

repositories,pluginRepositories : 依赖和扩展的远程仓库列表


    
      
        false
        always
        warn
      
      
        true
        never
        fail
      
      codehausSnapshots
      Codehaus Snapshots
      http://snapshots.maven.codehaus.org/maven2
      default
    


 ...

releases, snapshots : 这是各种构件的策略，release或者snapshot。这两个集合，POM就可以根据独立仓库任意类型的依赖改变策略。如：一个人可能只激活下载snapshot用来开发
enable : true或者false，决定仓库是否对于各自的类型激活(release 或者 snapshot)
updatePolicy : 这个元素决定更新频率。maven将比较本地pom的时间戳（存储在仓库的maven数据文件中）和远程的. 有以下选择: always, daily (默认), interval:X (x是代表分钟的整型) ， never
checksumPolicy : 当Maven向仓库部署文件的时候，它也部署了相应的校验和文件。可选的为：ignore，fail，warn，或者不正确的校验和
layout : 在上面描述仓库的时候，提到他们有统一的布局。Maven 2有它仓库默认布局。然而，Maven 1.x有不同布局。使用这个元素来表明它是default还是legacy。

distributionManagement: 它管理的分布在整个构建过程生成的工件和支持文件


    ...
    http://mojo.codehaus.org/my-project
    deployed

 downloadUrl : 其他pom可以通过此url的仓库抓取组件
status : 给出该构件在远程仓库的状态
none : 默认
converted : 将被早期Maven 2 POM转换过来
partner : 这个项目会从合作者仓库同步过来
deployed : 从Maven 2或3实例部署
verified : 被核实时正确的和最终的

repository : 指定Maven pom从远程下载控件到当前项目的位置和方式，如果snapshotRepository没有被定义则使用repository相关的配置


    
      false
      corp1
      Corporate Repository
      scp://repo/maven2
      default
    
    
      true
      propSnap
      Propellors Snapshots
      sftp://propellers.net/maven
      legacy
    
    ...

id, name : 仓库的唯一标识
uniqueVersion : true或false，指明控件部署的时候是否获取独立的版本号
url : repository元素的核心,指定位置和部署协议发布控件到仓库
layout : 布局，default或legacy

site,distribution : 多分布存储库,distributionManagement负责定义如何部署项目的网站和文档


...

  mojo.website
  Mojo Website
  scp://beaver.codehaus.org/home/projects/mojo/public_html/

...

id, name, url: 这些元素与distributionManagement repository中的相同
relocation : 重新部署-项目不是静态的，是活的。他们需要被搬到更合适的地方。如：当你的下个成功的开源项目移到Apache下，重命名为org.apache:my-project:1.0 对你项目更有好处


    ...
    
      org.apache
      my-project
      1.0
      We have moved the Project under Apache
    
    ...

profiles : profile可以让我们定义一系列的配置信息（插件等），然后指定其激活条件

坐标与依赖

坐标

作用
坐标是Jar包的唯一标识，Maven通过坐标在仓库中找到项目所需的Jar包
坐标元素理解
- maven的坐标元素包括 : groupid、artifactid、version、packaging、classifier
```
junit
junit
4.12
jar
```
- groupId : 定义当前maven项目隶属的实际项目。这和实际项目不同，不一定是一对一的关系，如spring-framework，它对应很多模块,spring-core,spring-context等，由于Maven中模块的概念，因此，一个实际项目往往会被划分成很多模块。通常和域名反向对应。
- artifactId : 定义实际项目中的一个maven项目（模块）。如果是模块，一般使用实际项目名作为artifactId的前缀。在默认情况下maven生成的构建，其文件名会以artifactId作为开头：如junit-test生成junit-test-4.12.jar
- version : 定义项目目前版本
- packaging : 定义maven项目的打包方式，如jar则生成.jar文件，如果是war则为.war文件，默认jar
- classifier : 用来定义构建输出的一些附属构建。如下情况：有的时候会有jdk版本，这时候就需要jdk15指定对应jdk版本
- groupId、artifactId、version、packaging是必须定义的，classifier是不能被直接定义的，因为附属构件不是项目直接默认生成的，而是由附加的插件帮助生成的。

依赖

3种classpath范围
- 测试
- 编译
- 运行
依赖配置
```
    
            junit
            junit
            4.12
            
            test
            
            
            
                
                    
                    
                
            
    
```
- groupId,artifactId : 在上一章,坐标中已经说明,用于maven对于构件的定位
- version : 版本
- classifier : 用来定义构建输出的一些附属构建
- scope : 依赖范围,有以下值:
  - compile : 默认值，适用于所有阶段，会随着项目一起发布
  - provided : 编译和测试的有用，在运行时无效，如servlet-api，在编译和测试的时候需要依赖，但是运行时，容器已经提供，所以不需要再次引入
  - runtime : 只在运行时使用，如JDBC驱动，适用运行和测试阶段
  - test : 只在测试时使用，用于编译和运行测试代码。不会随项目发布
  - system : 类似provided，需要再使用systemPath元素显示制定依赖文件路径，如下。（由于绑定本地文件，在其他计算机不一定存在，所以尽量不要使用）
```
system
${java.home}/lib/rt.jar
```
  - type : 依赖类型，对应项目坐标定义的packaging，默认不用声明则为jar
  - optional : 标记依赖是否可选，有true和false。如果A依赖于B，但是B只是A在测试时使用，这个时候X依赖于A，那么X就不需要B，那么在x的pom中配置optional为true的话，则在x编译的时候会忽略B的依赖
  - exclusions : 用来排除传递性依赖。比如，我们的项目A中引入了第三方构件B，但是B中又引入了C和D，但是D对于我们的项目有冲突那么我们可以配置如下，将D这个依赖忽略
```
    D
    D
```
依赖范围
- 编译阶段（compile）：该范围表明相关依赖是只在工程的类路径下有效，默认取值，对于编译、测试、运行三种classpath都有效
- 供应阶段（provided）：该范围表明相关依赖是由运行时的JDK或者网络服务器提供的，对于编译和测试classpath有效，但在运行时无效。典型范例：servlet-api
- 运行阶段（runtime）：该范围表明相关依赖在编译阶段不是必须的，但是在执行阶段是必须的，对于测试和运行classpath有效，但在对编译主代码时无效。典型范例：JDBC
- 测试阶段（test）：该范围表明相关依赖只在测试编译阶段和执行阶段，只对测试classpath有效。典型范例：Junit
- 系统阶段（system）：该范围表明你需要提供一个系统路径
- 导入阶段（import）：该范围只在依赖是一个pom里定义的依赖时使用。同时，当前工程的POM 文件的部分定义的依赖关系可以取代某特定的POM。它不会对三种实际的classpath产生影响
  
  依赖范围.png
依赖传递性
假设：A依赖于B，B依赖于C，那么我们就说A对于B是第一直接依赖，B对于C是第二直接依赖，A对于C是传递性依赖。
- 当第二直接依赖的范围是compile的时候，传递性依赖的范围与第一直接依赖的范围一致；
- 当第二直接依赖的范围是test的时候，依赖不会得以传递;
- 当第二直接依赖的范围是provided的时候，只传递第一依赖范围也为provided的依赖，且传递性依赖的范围同样是provided；
- 当第二直接依赖的范围是runtime的时候，传递性依赖的范围与第一直接依赖的范围一致，但compile除外，此时传递性依赖范围为runtime;
  
  依赖传递性.png
  
  左侧第一列表示第一直接依赖范围，最上面一行表示第二直接依赖
依赖调解原则
- 情景一：我们在项目中分别引入了2个依赖A和B，A又依赖的C，C又依赖了D，B也依赖了D，但是这个时候C依赖的D和B依赖的D的版本是不同的：
  项目----A---C----D
  项目----B---D
  也就是说，当前项目引入了2次D依赖，那么这时，Maven将采用第一原则：路径最近原则
- 情景二：我们在项目中分别引入了2个依赖A和B，而A和B又都引入了C，但是，此时A依赖的C和B依赖的C版本是不一致的，那么这个时候Maven如何处理呢？
  这时，第一原则已经不起作用了，
  在Maven2.0.8及之前的版本中和Maven2.0.9之后的版本Maven对于这种情况的处理方式是不一致的,确切的说：
  在Maven2.0.8及之前的版本中Maven究竟会解析哪个版本的依赖，这是不确定的
  在Maven2.0.9之后的版本中，制定了第二原则：第一声明者优先；就是说，它取决于在POM中依赖声明的顺序
可选依赖
```
如果A->B，B中有如下依赖：

    com.my.C
    cpt
    1.0.0
    true

通过上面配置，optional为true，那么A中就不会依赖这个cpt
```
为什么会有可选依赖呢？是因为某一个项目实现了多个特性，但是我们在面向对象的设计中，有一个原则叫：单一职责性原则，就是强调在一个类只有一项职责，而不是糅合了太多的功能，所以一般这种可选依赖很少会出现。
排除依赖
- 如果项目A依赖第三方依赖B，B又依赖SNAPSHOT版C那么C的不稳定会影响到A，这个时候就需要排除掉C。还有就是一个传递性依赖在中央仓库中对应的版本不存在，我们就需要排除依赖，然后再导入存在版本的依赖
- 想实现依赖排除，然后替换成自己想要的依赖，这时我们要用到的一个配置是和，我们可以使用这一元素声明排除依赖，然后显示的声明我们想要的依赖，在中可以声明一个或多个来排除一个或多个传递性依赖。注：声明的时候只需要声明groupId和artifactId就能唯一定位依赖图中的某个依赖。
```
    com.ys.b
    pro-b
    1.0.1

    
        
            com.ys.c
            pro-c
        
    



    com.ys.c
    pro-c
    1.0.0
```
归并依赖
- 如果我们在pom中引入了多个依赖，比如spring相关的有core，beans，context等，这样如果我们需要修改版本，需要一个一个修改，十分麻烦,这个时候就可以使用properties来定义：
```
    2.5.6
```
- 这个时候我们就可以在声明依赖的时候使用${springframework.version}来替换具体的版本号：
```
    org.springframework
    spring-context-support
    ${springframework.version}
```
查看依赖
- mvn dependency:list以列表形式解析依赖
- mvn dependency:tree以树的形式展示
- mvn dependency : analyze分析当前当前项目的依赖，该命令执行结果的两个重要部分：
  - Used undeclared dependencies: 表示项目中使用到的，但是没有显示声明的依赖
  - Unused declared dependencies: 表示项目中未使用的，但显示声明的依赖
    注：dependency : analyze只会分析编译主代码和测试代码需要用到的依赖，一些执行测试和运行时需要的依赖它无法发现。

生命周期

概述

Maven的生命周期就是对所有的构建过程进行抽象和统一。包含了项目的清理、初始化、编译、测试、打包、集成测试、验证、部署和站点生成等几乎所有的构建步骤
典型的构建生命周期

构建生命周期.png

三套生命周期

clean生命周期
- 在进行真正的构建之前进行一些清理工作
- 包含三个phase
  - pre-clean：执行清理前需要完成的工作
  - clean：清理上一次构建生成的文件
  - post-clean：执行清理后需要完成的工作
default生命周期
- 构建的核心部分，编译，测试，打包，部署等等
- Maven 的主要生命周期，被用于构建应用。包括图中的 23 个阶段
  
  阶段.png
  
  当一个阶段通过 Maven 命令调用时，例如 mvn compile，只有该阶段之前以及包括该阶段在内的所有阶段会被执行。
  不同的 maven 目标将根据打包的类型（JAR / WAR / EAR），被绑定到不同的 Maven 生命周期阶段。
site生命周期
- 生成项目报告，站点，发布站点
- 包括四个phase
  - pre-site：生成项目站点之前需要完成的工作
  - site：生成项目站点文档
  - post-site：生成项目站点之后需要完成的工作
  - site-deploy：将项目站点发布到服务器

命令行

mvn clean : 调用clean生命周期的clean阶段，实际执行pre-clean和clean阶段
mvn test : 调用default生命周期的test阶段，实际执行test以及之前所有阶段
mvn clean install : 调用clean生命周期的clean阶段和default的install阶段，实际执行pre-clean和clean，install以及之前所有阶段
mvn clean install -Dmaven.test.skip=true : 调用clean生命周期的clean阶段和default的install阶段，实际执行pre-clean和clean，install以及之前所有阶段,但跳过test阶段

仓库

本地

Maven 本地仓库是机器上的一个文件夹。它在你第一次运行任何 maven 命令的时候创建。
Maven 本地仓库保存你的工程的所有依赖（library jar、plugin jar 等）。当你运行一次 Maven 构建，Maven 会自动下载所有依赖的 jar 文件到本地仓库中。它避免了每次构建时都引用存放在远程机器上的依赖文件。
Maven本地仓库的默认位置：无论是Windows还是Linux，在用户的目录下都有一个.m2/repository/的仓库目录，这就是Maven仓库的默认位置。
如何更改maven默认的本地仓库的位置：这里要引入一个新的元素：localRepository，它是存在于maven的settings.xml文件中
- 更改配置用户范围的本地仓库：先在/.m2/目录下创建settings.xml文件，然后在~/.m2/settings.xml，设置localRepository元素的值为想要的仓库地址
```
    D:\maven_new_repository
```
- 更改配置全局范围的本地仓库：在M2_HOME/conf/settings.xml中更改配置，更改配置的方法同上(注：此时更改后，所有的用户都会受到影响，而且如果maven进行升级，那么所有的配置都会被清除，所以要提前复制和备份M2_HOME/conf/settings.xml文件，故：一般情况下不推荐配置全局的settings.xml)

中央

Maven 中央仓库是由 Maven 社区提供的仓库，其中包含了大量常用的库。
中央仓库的关键概念：
- 这个仓库由 Maven 社区管理。
- 不需要配置。
- 需要通过网络才能访问。
settings配置


           
                     central
                     Central Repository
                     http://repo.maven.apache.org/maven2
                     default
                     
                         true
                         always
                         always

image.png

远程（私服）

私服是一种特殊的远程仓库，他是架设在局域网内的仓库服务，私服代理广域网上的远程仓库，供局域网内的Maven用户使用。当Maven需要下载构件的时候，它从私服请求，如果私服上不存在改构件，则从外部的远程仓库下载，同时缓存在私服之上，然后为Maven下载请求提供服务，另外，对于第三方的jar无法从仓库下载（JDBC驱动）可以从本地上传到私服供客户端下载。
特性
- 节省自己的外网带宽：减少重复请求造成的外网带宽消耗
- 提高稳定性，增强控制：Internet不稳定的时候，maven构建也会变的不稳定，一些私服软件还提供了其他的功能
- 加速Maven构件：如果项目配置了很多外部远程仓库的时候，构建速度就会大大降低
- 部署第三方构件：有些构件无法从外部仓库获得的时候，我们可以把这些构件部署到内部仓库(私服)中，供内部maven项目使用
- 降低中央仓库的负荷：maven中央仓库被请求的数量是巨大的，配置私服也可以大大降低中央仓库的压力
配置
- 配置远程仓库将引入新的配置元素：，在元素下，可以使用子元素声明一个或者多个远程仓库。
```
    
        jboss
        JBoss Repository
        http://repository.jboss.com/maven2/
        
            daily
            true
            warn
        
        
            false
        
        default
    

元素：表示更新的频率，值有：never, always,interval,daily, daily 为默认值
元素：表示maven检查和检验文件的策略，warn为默认值
```
- 出于安全方面的考虑，有时我们要对远程仓库的访问进行认证，一般将认证信息配置在settings.xml中：
```
    
        same with repository id in pom
        username
        pwd
    

这里的id必须与POM中需要认证的repository元素的Id一致
```
- 如何将生成的项目部署到远程仓库需要在POM中进行配置，这里有新引入了一个元素:distributionManagement;distributionManagement包含了2个子元素：repository和snapshotRepository, 前者表示发布版本构件的仓库，后者表示快照版本的仓库
  这两个元素都需要配置 id(该远程仓库的唯一标识)，name，url(表示该仓库的地址)；
  向远程仓库中部署构件，需要进行认证。配置同上,配置正确后运行： mvn clean deploy

 
    
        deploymentRepo_releases
        Nexus Release Repository
        http://localhost:8081/nexus/content/repositories/releases/
    
    
        deploymentRepo_snapshots
        Nexus Snapshot Repository
        http://localhost:8081/nexus/content/repositories/snapshots/

私服搭建
- 参考：http://www.cnblogs.com/tangyanbo/p/4282147.html和http://blog.csdn.net/odeviloo/article/details/52199260

Maven依赖搜索顺序

步骤一：在本地仓库中搜索，如果找不到，执行步骤二，如果找到了则执行其他操作
步骤二：在中央仓库中搜索，如果找不到，并且有一个或多个远程仓库已经设置，则执行步骤四，如果找到了则下载到本地仓库中已被将来引用。
步骤三：如果远程仓库没有被设置，Maven 将简单的停滞处理并抛出错误（无法找到依赖的文件）。
步骤四：在一个或多个远程仓库中搜索依赖的文件，如果找到则下载到本地仓库已被将来引用，否则 Maven 将停止处理并抛出错误（无法找到依赖的文件）。

镜像

如果仓库X可以提供仓库Y存储的所有内容，那么就可以认为X是Y的一个镜像，某些情况下使用镜像可以提高项目构建效率。
settings配置

  
    
      mirrorId
      repositoryId
      Human Readable Name for this Mirror.
      http://my.repository.com/repo/path

镜像的意思是，当你访问mirrorOf的仓库时，就会转到对应的镜像url中请求对应的资源。一般镜像都是和私服结合使用。由于私服可以代理任何外部的公共仓库（包括中央仓库），因此，对于组织内部的Maven用户来说，使用一个私服地址就等于使用了所有需要的外部仓库，这个可以将配置集中到私服，从而简化Maven本身的配置。在这种情况下，任何需要的构件都可以从私服中获得，私服就是所有仓库的镜像。这时候那个镜像如下配置：

  
    
      mirrorId
      *
      Human Readable Name for this Mirror.
      http://my.repository.com/repo/path

聚合与继承

聚合

将多个项目放到一起运行

用法

packaging是pom
定义modules


    SIP-utils
    SIP-web
    SIP-sql
    SIP-core

每个module的值都是一个当前POM的相对目录

为了快速构建项目

继承

抽取各模块相同的依赖和插件
子项目中pom文件配置：


    4.0.0
    
        com.juvenxu.mvnbook.account
         account-parent 
        1.0.0-SNAPSHOT
        ../account-parent/pom.xml
    
     account-email 
    Account Email

父项目pom文件配置：


    4.0.0
    com.juvenxu.mvnbook.account
     account-parent 
    1.0.0-SNAPSHOT
    pom
    Account Parent

可被继承的pom元素：
- groupId:项目组ID,项目坐标的核心元素
- version: 项目版本, 项目坐标的核心元素
- description: 项目的描述信息
- organization: 项目的组织信息
- inceptionYear: 项目的创始年份
- url: 项目的URL地址
- developers: 项目开发者信息
- contributors: 项目的贡献者信息
- distributionManagement: 项目的部署配置
- issueManagement: 项目的缺陷跟踪系统信息
- ciManagement: 项目的持续集成系统信息
- scm: 项目的版本控制系统信息
- mailingLists: 项目的邮件列表信息
- properties: 自定义的maven属性
- dependencies: 项目的依赖配置
- dependencyManagement: 项目的依赖管理配置
- repositories: 项目的仓库配置
- build: 包括项目的源码目录配置、输出目录配置、插件配置、插件管理配置等
- reporting: 包括项目的报告输出目录配置、报告插件配置等

其他

常用命令

mvn archetype:generate -DgroupId=com.companyname.bank -DartifactId=consumerBanking -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false：创建一个简单的Java工程
mvn archetype:generate -DgroupId=com.companyname.automobile -DartifactId=trucks -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false：创建一个java的web工程
mvn clean：清理（删除target目录下编译内容）
mvn compile：编译项目
mvn test-compile：编译测试程序
mvn test：运行测试
mvn package：打包发布
mvn package -Dmaven.test.skip=ture：打包时跳过测试
mvn site：生成站点目录
mvn site-deploy：生成站点目录并发布
mvn install：安装当前工程的输出文件到本地仓库
mvn install:install-file -DgroupId= -DartifactId= -Dversion=1.0.0 -Dpackaging=jar -Dfile=：安装指定文件到本地仓库
mvn help:effective-pom：查看实际pom信息
mvn dependency:tree：分析项目的依赖信息

settings文件详解

概览



  
  
  
  
  
  
  
  
  

1.用户级别
    ${user.home}/.m2/settings.xml
    可以通过指令 -s /path/to/user/settings.xml
2.全局级别
    ${maven.home}/conf/settings.xml.
    可以通过指令 -gs /path/to/global/settings.xml

localRepository
- localRepository用于构建系统的本地仓库的路径。默认的值是${user.home}/.m2/repository。
- Default:${user.home}/.m2/repository/path/to/local/repo
interactiveMode:interactiveMode 用于决定maven是否在需要输出的时候提示你，默认true。如果是false，它将使用合理的默认值，或者基于一些设置。
offline:决定maven是否在构建的时候进行网络传输。默认false，表示联网状态，true为取消联网。在某些情况下设置为true是很有用的，比如jar无法从网上下载等
pluginGroups:pluginGroups 插件组


    org.mortbay.jetty

proxies:此项用于设置http代理，有时候由于安全问题，需要配置http代理，通过代理服务才能正常访问外部仓库下载资源可以ping repo1.maven.org来访问中央仓库


    
      optional
      true
      http
      proxyuser
      proxypass
      proxy.host.net
      80
     local.net|some.host.com
    

id：proxy的唯一标识，用来区别proxy元素。
active：表示是否激活代理，如果配置多个，默认是第一个生效
username，password：提供连接代理服务器时的认证。
host，port：主机地址，端口号
nonProxyHosts：用来表示哪些主机名不需要代理，可以用|来分割多个，此外也支持通配符
如：*.goole.com表示所有以goole.com结尾的都不需要通过代理

servers:这是一个认证配置的列表,根据系统中使用的server-id控制。认证配置在maven连接到远程服务时使用。


    
    
          deploymentRepo
          repouser
          repopwd
        
        
        
          siteServer
          /path/to/private/key
          可空

mirrors:指定镜像仓库位置用于从远程仓库下载资源


    
      mirrorId
      repositoryId
      Human Readable Name for this Mirror.
      http://my.repository.com/repo/path
    

id：用于继承和直接查找，唯一
mirrorOf：镜像所包含的仓库的Id
name：唯一标识，用于区分镜像站
url：镜像路径

profiles

settings.xml中时意味着该profile是全局的，所以只能配置范围宽泛一点配置信息，比如远程仓库等。而一些比较细致一点的需要定义在项目的pom.xml中。
profile可以让我们定义一系列的配置信息，然后指定其激活条件。
根据每个profile对应不同的激活条件和配置信息，从而达到不同环境使用不同配置。
例子：通过profile定义jdk1.5以上使用一套配置，jdk1.5以下使用另外一套配置；或者通过操作系统来使用不同的配置信息。
settings.xml中的信息有repositories、pluginRepositories和properties。定义在properties的值可以在pom.xml中使用。


    
           test
           
               false
               1.5
               
                     Windows XP
                     Windows
                     x86
                     5.1.2600
                
                
                     mavenVersion
                     2.0.3
                
                
                      ${basedir}/file2.properties
                      ${basedir}/file1.properties
                
            
    

jdk：检测到对应jdk版本就激活
os：针对不同操作系统
property：当maven检测到property（pom中如${name}这样的）profile将被激活
file：如果存在文件，激活，不存在文件激活

properites
- Maven的属性是值占位符，就像Ant中的一样。如果X是一个属性的话，在POM中可以使用${X}来进行任意地方的访问。他们来自于五种不同的风格，所有都可以从settings.xml文件中访问到。
- env.x：“env.”前缀会返回当前的环境变量。如${env.PATH}就是使用了$path环境变量（windosws中的%PATH%）。
- project.x：一个点“.”分割的路径，在POM中就是相关的元素的值。例如：1.0就可以通过${project.version}来访问。
- settings.x：一个点“.”分割的路径，在settings.xml中就是相对应的元素的值，例如：false就可以通过${settings.offline}来访问。
- Java系统属性：通过java.lang.System.getProperties()来访问的属性都可以像POM中的属性一样访问，例如：${java.home}
- x：被或者外部文件定义的属性，值可以这样访问${someVar}
```
    
      ...
      
        ${user.home}/our-project
      
      ...
    
```
Repositories:Repositories是远程项目集合maven用来移植到本地仓库用于构建系统。如果来自本地仓库，Maven调用它的插件和依赖关系。不同的远程仓库可能包含不同的项目，当profile被激活，他们就会需找匹配的release或者snapshot构件。


    
      ...
      
        
          codehausSnapshots
          Codehaus Snapshots
          
            false
            always
            warn
          
          
            true
            never
            fail
          
          http://snapshots.maven.codehaus.org/maven2
          default
        
      
      
        ...
      
      ...
    

releases，snapshots：这是各种构件的策略，release或者snapshot。这两个集合，POM就可以根据独立仓库任意类型的依赖改变策略。如：一个人可能只激活下载snapshot用来开发。
enable：true或者false，决定仓库是否对于各自的类型激活(release 或者 snapshot)。
updatePolicy: 这个元素决定更新频率。maven将比较本地pom的时间戳（存储在仓库的maven数据文件中）和远程的. 有以下选择: always, daily (默认), interval:X (x是代表分钟的整型) ， never.
checksumPolicy：当Maven向仓库部署文件的时候，它也部署了相应的校验和文件。可选的为：ignore，fail，warn，或者不正确的校验和。
layout：在上面描述仓库的时候，提到他们有统一的布局。Maven 2有它仓库默认布局。然而，Maven 1.x有不同布局。使用这个元素来表明它是default还是legacy。

activeProfiles:每个activeProfile元素对应一个profile id的值，任何profile id被定义到activeProfile的profile将被激活。


    alwaysActiveProfile
    anotherAlwaysActiveProfile

整理文章主要为了自己日后复习用，文章中可能会引用到别的博主的文章内容，如涉及到博主的版权问题，请博主联系我。

Maven 基础教程

简介

概述