marven系列0-最全简介

marven是什么

Maven项目对象模型(POM),可以通过一小段描述信息来管理项目的构建,报告和文档的软件项目管理工具。
用配置文件的方式对项目的描述、名称、版本号、项目依赖等等信息进行描述。使之项目描述结构清晰,任何人接手的成本比较低。在项目构建时,利用Maven的“约定大于配置”的思想,可以比Ant脚本构建项目省去不少配置文件的内容。而且一个项目可能依赖于其他的项目和第三方的组件才能顺利完成,Maven提供了仓库的概念,让这些依赖项放进仓库中,项目想要从仓库中去取,其他项目组也需要,OK,从仓库中去取,不必每个人去开源项目的站点去苦苦搜寻了。如此人员的成本、软件维护的成本、沟通的成本、硬件的成本都降下来了。

作用1:规范项目结构
相同的项目结构

使用Maven管理的Java 项目都有着相同的项目结构
1. 有一个pom.xml 用于维护当前项目都用了哪些jar包
2. 所有的java代码都放在 src/main/java 下面
3. 所有的测试代码都放在src/test/java 下面

作用2:统一维护jar包
实现jar包共享,需要的话添加几行配置即可,维护了jar包的统一性

作用3:版本控制,项目构建等

marven的生命周期

maven把项目的构建划分为不同的生命周期(lifecycle),(phase)包括:编译、测试、打包、集成测试、验证、部署。maven中所有的执行动作(goal)都需要指明自己在这个过程中的执行位置,然后maven执行的时候,就依照过程的发展依次调用这些goal进行各种处理。

这个也是maven的一个基本调度机制。一般来说,位置稍后的过程都会依赖于之前的过程。但是,maven可以在配置文件跳过某些阶段。

marven项目结构

 /项目目录
        pom.xml 用于maven的配置文件
        /src 源代码目录
            /src/main 工程源代码目录
                /src/main/java 工程java源代码目录
            /src/main/resource 工程的资源目录
            /src/test 单元测试目录
                /src/test/java
        /target 输出目录,所有的输出物都存放在这个目录下
            /target/classes 编译之后的class文件

marven的坐标机制

参考http://tangyanbo.iteye.com/blog/1503946
Maven坐标为各种构件引入了秩序,任何一个构件都必须明确定义自己的坐标,而一组Maven坐标是通过一些元素定义的,它们是groupId,artifactId,version,packaging,class-sifer

例如:

    <groupId>com.mycompany.app</groupId>  
      <artifactId>my-app</artifactId>  
      <packaging>jar</packaging>  
     <version>0.0.1-SNAPSHOT</version>  
  • groupId :定义当前Maven项目隶属的实际项目。首先,Maven项目和实际项目不一定是一对一的关系。比如SpringFrameWork这一实际项目,其对应的Maven项目会有很多,如spring-core,spring-context等。这是由于Maven中模块的概念,因此,一个实际项目往往会被划分成很多模块。其次,groupId不应该对应项目隶属的组织或公司。原因很简单,一个组织下会有很多实际项目,如果groupId只定义到组织级别,而后面我们会看到,artifactId只能定义Maven项目(模块),那么实际项目这个层次将难以定义。最后,groupId的表示方式与Java包名的表达方式类似,通常与域名反向一一对应。

  • artifactId : 该元素定义当前实际项目中的一个Maven项目(模块),推荐的做法是使用实际项目名称作为artifactId的前缀。比如上例中的my-app。

  • version : 该元素定义Maven项目当前的版本

  • packaging :定义Maven项目打包的方式,首先,打包方式通常与所生成构件的文件扩展名对应,如上例中的packaging为jar,最终的文件名为my-app-0.0.1-SNAPSHOT.jar。也可以打包成war, ear等。当不定义packaging的时候,Maven 会使用默认值jar

  • classifier: 该元素用来帮助定义构建输出的一些附件。附属构件与主构件对应,如上例中的主构件为my-app-0.0.1-SNAPSHOT.jar,该项目可能还会通过一些插件生成如my-app-0.0.1-SNAPSHOT-javadoc.jar,my-app-0.0.1-SNAPSHOT-sources.jar, 这样附属构件也就拥有了自己唯一的坐标

marven仓库概念

参考https://blog.csdn.net/wangdong5678999/article/details/72835539
得益于 Maven 的 坐标机制,任何 Maven项目使用任何一个构建的方式都是完全相同的,Maven 可以在某个位置统一存储所有的 Maven 项目共享的构建,这个统一的位置就是仓库,项目构建完毕后生成的构建也可以安装或者部署到仓库中,供其它项目使用。

仓库的布局

任何一个构件都有其唯一的坐标,根据这个坐标可以定义其在仓库中的唯一存储路径,这便是Maven的仓库布局方式。
如log4j:log4j:1.2.16这一依赖:
其对应的仓库路径为:log4j/log4j/1.2.16/log4j-1.2.16.jar
该路径与坐标的大致对应关系为:groupId/artifactId/version/artifactId-version.packaging

Maven仓库是基于简单文件系统存储的,如果遇到仓库相关的问题时,我们可以查找相关文件,定位问题。例如,当maven无法获得项目声明的依赖时,可以查看该依赖对应的文件在仓库中是否存在,如果不存在,查看是否有其他版本可用,等等。

仓库的分类

对于Maven来说,仓库分为两类:本地仓库 和 远程仓库。
当Maven根据坐标寻找构件的时候,它首先会查看本地仓库,如果本地仓库存在此构件,则直接使用;如果本地仓库不存在此构件,或者需要查看是否有更新的构件版本,Maven就会去远程仓库查找,发现需要的构件之后,下载到本地再使用。如果本地仓库和远程仓库都没有需要的构件,Maven就会报错。
《marven系列0-最全简介》

pom.xml配置文件详解

参考http://www.blogjava.net/hellxoul/archive/2013/05/16/399345.html

   1<project xmlns="http://maven.apache.org/POM/4.0.0 "    
   2 
   3     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance "    
   4 
   5     xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd ">    
   6 
   7     <!--父项目的坐标。如果项目中没有规定某个元素的值,那么父项目中的对应值即为项目的默认值。 坐标包括group ID,artifact ID和 version。-->  
   8 
   9     <parent>   
  10 
  11      <!--被继承的父项目的构件标识符-->  
  12 
  13      <artifactId/>   
  14 
  15      <!--被继承的父项目的全球唯一标识符-->  
  16 
  17      <groupId/>   
  18 
  19      <!--被继承的父项目的版本-->  
  20 
  21      <version/>   
  22 
  23      <!--父项目的pom.xml文件的相对路径。相对路径允许你选择一个不同的路径。默认值是../pom.xml。Maven首先在构建当前项目的地方寻找父项目的pom,其次在文件系统的这个位置(relativePath位置),然后在本地仓库,最后在远程仓库寻找父项目的pom。-->  
  24 
  25      <relativePath/>   
  26 
  27  </parent>   
  28 
  29  <!--声明项目描述符遵循哪一个POM模型版本。模型本身的版本很少改变,虽然如此,但它仍然是必不可少的,这是为了当Maven引入了新的特性或者其他模型变更的时候,确保稳定性。-->      
  30 
  31     <modelVersion>4.0.0</modelVersion>    
  32 
  33     <!--项目的全球唯一标识符,通常使用全限定的包名区分该项目和其他项目。并且构建时生成的路径也是由此生成, 如com.mycompany.app生成的相对路径为:/com/mycompany/app-->    
  34 
  35     <groupId>asia.banseon</groupId>     
  36 
  37     <!--构件的标识符,它和group ID一起唯一标识一个构件。换句话说,你不能有两个不同的项目拥有同样的artifact ID和groupID;在某个特定的group ID下,artifact ID也必须是唯一的。构件是项目产生的或使用的一个东西,Maven为项目产生的构件包括:JARs,源码,二进制发布和WARs等。-->    
  38 
  39     <artifactId>banseon-maven2</artifactId>     
  40 
  41     <!--项目产生的构件类型,例如jar、war、ear、pom。插件可以创建他们自己的构件类型,所以前面列的不是全部构件类型-->    
  42 
  43     <packaging>jar</packaging>     
  44 
  45     <!--项目当前版本,格式为:主版本.次版本.增量版本-限定版本号-->    
  46 
  47     <version>1.0-SNAPSHOT</version>    
  48 
  49     <!--项目的名称, Maven产生的文档用-->    
  50 
  51     <name>banseon-maven</name>    
  52 
  53     <!--项目主页的URL, Maven产生的文档用-->    
  54 
  55     <url>http://www.baidu.com/banseon</url>    
  56 
  57     <!--项目的详细描述, Maven 产生的文档用。  当这个元素能够用HTML格式描述时(例如,CDATA中的文本会被解析器忽略,就可以包含HTML标签), 不鼓励使用纯文本描述。如果你需要修改产生的web站点的索引页面,你应该修改你自己的索引页文件,而不是调整这里的文档。-->    
  58 
  59     <description>A maven project to study maven.</description>     
  60 
  61     <!--描述了这个项目构建环境中的前提条件。-->  
  62 
  63  <prerequisites>   
  64 
  65   <!--构建该项目或使用该插件所需要的Maven的最低版本-->  
  66 
  67     <maven/>  
  68 
  69  </prerequisites>   
  70 
  71  <!--项目的问题管理系统(Bugzilla, Jira, Scarab,或任何你喜欢的问题管理系统)的名称和URL,本例为 jira-->    
  72 
  73     <issueManagement>   
  74 
  75      <!--问题管理系统(例如jira)的名字,-->    
  76 
  77         <system>jira</system>    
  78 
  79         <!--该项目使用的问题管理系统的URL-->  
  80 
  81         <url>http://jira.baidu.com/banseon</url>    
  82 
  83     </issueManagement>    
  84 
  85     <!--项目持续集成信息-->  
  86 
  87  <ciManagement>   
  88 
  89   <!--持续集成系统的名字,例如continuum-->  
  90 
  91   <system/>   
  92 
  93   <!--该项目使用的持续集成系统的URL(如果持续集成系统有web接口的话)。-->  
  94 
  95   <url/>   
  96 
  97   <!--构建完成时,需要通知的开发者/用户的配置项。包括被通知者信息和通知条件(错误,失败,成功,警告)-->  
  98 
  99   <notifiers>   
 100 
 101    <!--配置一种方式,当构建中断时,以该方式通知用户/开发者-->  
 102 
 103    <notifier>   
 104 
 105     <!--传送通知的途径-->  
 106 
 107     <type/>   
 108 
 109     <!--发生错误时是否通知-->  
 110 
 111     <sendOnError/>   
 112 
 113     <!--构建失败时是否通知-->  
 114 
 115     <sendOnFailure/>   
 116 
 117     <!--构建成功时是否通知-->  
 118 
 119     <sendOnSuccess/>   
 120 
 121     <!--发生警告时是否通知-->  
 122 
 123     <sendOnWarning/>   
 124 
 125     <!--不赞成使用。通知发送到哪里-->  
 126 
 127     <address/>   
 128 
 129     <!--扩展配置项-->  
 130 
 131     <configuration/>  
 132 
 133    </notifier>  
 134 
 135   </notifiers>  
 136 
 137  </ciManagement>   
 138 
 139  <!--项目创建年份,4位数字。当产生版权信息时需要使用这个值。-->  
 140 
 141     <inceptionYear/>   
 142 
 143     <!--项目相关邮件列表信息-->    
 144 
 145     <mailingLists>   
 146 
 147      <!--该元素描述了项目相关的所有邮件列表。自动产生的网站引用这些信息。-->    
 148 
 149         <mailingList>    
 150 
 151          <!--邮件的名称-->  
 152 
 153             <name>Demo</name>     
 154 
 155             <!--发送邮件的地址或链接,如果是邮件地址,创建文档时,mailto: 链接会被自动创建-->    
 156 
 157             <post>banseon@126.com</post>    
 158 
 159             <!--订阅邮件的地址或链接,如果是邮件地址,创建文档时,mailto: 链接会被自动创建-->    
 160 
 161             <subscribe>banseon@126.com</subscribe>     
 162 
 163             <!--取消订阅邮件的地址或链接,如果是邮件地址,创建文档时,mailto: 链接会被自动创建-->    
 164 
 165             <unsubscribe>banseon@126.com</unsubscribe>    
 166 
 167             <!--你可以浏览邮件信息的URL-->  
 168 
 169             <archive>http:/hi.baidu.com/banseon/demo/dev/</archive>    
 170 
 171         </mailingList>    
 172 
 173     </mailingLists>    
 174 
 175     <!--项目开发者列表-->    
 176 
 177     <developers>    
 178 
 179      <!--某个项目开发者的信息-->  
 180 
 181         <developer>    
 182 
 183          <!--SCM里项目开发者的唯一标识符-->  
 184 
 185             <id>HELLO WORLD</id>     
 186 
 187             <!--项目开发者的全名-->  
 188 
 189             <name>banseon</name>    
 190 
 191             <!--项目开发者的email-->  
 192 
 193             <email>banseon@126.com</email>    
 194 
 195             <!--项目开发者的主页的URL-->  
 196 
 197             <url/>   
 198 
 199              <!--项目开发者在项目中扮演的角色,角色元素描述了各种角色-->  
 200 
 201              <roles>    
 202 
 203                  <role>Project Manager</role>    
 204 
 205                  <role>Architect</role>    
 206 
 207              </roles>   
 208 
 209              <!--项目开发者所属组织-->   
 210 
 211              <organization>demo</organization>    
 212 
 213              <!--项目开发者所属组织的URL-->  
 214 
 215              <organizationUrl>http://hi.baidu.com/banseon</organizationUrl>    
 216 
 217              <!--项目开发者属性,如即时消息如何处理等-->  
 218 
 219              <properties>    
 220 
 221                  <dept>No</dept>    
 222 
 223              </properties>   
 224 
 225              <!--项目开发者所在时区, -11到12范围内的整数。-->   
 226 
 227              <timezone>-5</timezone>    
 228 
 229          </developer>    
 230 
 231      </developers>    
 232 
 233      <!--项目的其他贡献者列表-->    
 234 
 235      <contributors>   
 236 
 237       <!--项目的其他贡献者。参见developers/developer元素-->  
 238 
 239       <contributor>  
 240 
 241     <name/><email/><url/><organization/><organizationUrl/><roles/><timezone/><properties/>  
 242 
 243       </contributor>       
 244 
 245      </contributors>      
 246 
 247      <!--该元素描述了项目所有License列表。 应该只列出该项目的license列表,不要列出依赖项目的 license列表。如果列出多个license,用户可以选择它们中的一个而不是接受所有license。-->    
 248 
 249      <licenses>   
 250 
 251       <!--描述了项目的license,用于生成项目的web站点的license页面,其他一些报表和validation也会用到该元素。-->    
 252 
 253          <license>   
 254 
 255           <!--license用于法律上的名称-->   
 256 
 257              <name>Apache 2</name>    
 258 
 259              <!--官方的license正文页面的URL-->  
 260 
 261              <url>http://www.baidu.com/banseon/LICENSE-2.0.txt</url>    
 262 
 263              <!--项目分发的主要方式:  
 264 
 265                repo,可以从Maven库下载  
 266 
 267                manual, 用户必须手动下载和安装依赖-->  
 268 
 269              <distribution>repo</distribution>    
 270 
 271              <!--关于license的补充信息-->  
 272 
 273              <comments>A business-friendly OSS license</comments>    
 274 
 275          </license>    
 276 
 277      </licenses>    
 278 
 279      <!--SCM(Source Control Management)标签允许你配置你的代码库,供Maven web站点和其它插件使用。-->    
 280 
 281      <scm>    
 282 
 283          <!--SCM的URL,该URL描述了版本库和如何连接到版本库。欲知详情,请看SCMs提供的URL格式和列表。该连接只读。-->    
 284 
 285          <connection>    
 286 
 287              scm:svn:http://svn.baidu.com/banseon/maven/banseon/banseon-maven2-trunk(dao-trunk)     
 288 
 289          </connection>    
 290 
 291          <!--给开发者使用的,类似connection元素。即该连接不仅仅只读-->  
 292 
 293          <developerConnection>    
 294 
 295              scm:svn:http://svn.baidu.com/banseon/maven/banseon/dao-trunk     
 296 
 297          </developerConnection>   
 298 
 299          <!--当前代码的标签,在开发阶段默认为HEAD-->  
 300 
 301          <tag/>           
 302 
 303          <!--指向项目的可浏览SCM库(例如ViewVC或者Fisheye)的URL。-->    
 304 
 305          <url>http://svn.baidu.com/banseon</url>    
 306 
 307      </scm>    
 308 
 309      <!--描述项目所属组织的各种属性。Maven产生的文档用-->    
 310 
 311      <organization>    
 312 
 313       <!--组织的全名-->  
 314 
 315          <name>demo</name>     
 316 
 317          <!--组织主页的URL-->  
 318 
 319          <url>http://www.baidu.com/banseon</url>    
 320 
 321      </organization>   
 322 
 323      <!--构建项目需要的信息-->  
 324 
 325      <build>   
 326 
 327       <!--该元素设置了项目源码目录,当构建项目的时候,构建系统会编译目录里的源码。该路径是相对于pom.xml的相对路径。-->  
 328 
 329    <sourceDirectory/>   
 330 
 331    <!--该元素设置了项目脚本源码目录,该目录和源码目录不同:绝大多数情况下,该目录下的内容 会被拷贝到输出目录(因为脚本是被解释的,而不是被编译的)。-->  
 332 
 333    <scriptSourceDirectory/>   
 334 
 335    <!--该元素设置了项目单元测试使用的源码目录,当测试项目的时候,构建系统会编译目录里的源码。该路径是相对于pom.xml的相对路径。-->  
 336 
 337    <testSourceDirectory/>   
 338 
 339    <!--被编译过的应用程序class文件存放的目录。-->  
 340 
 341    <outputDirectory/>   
 342 
 343    <!--被编译过的测试class文件存放的目录。-->  
 344 
 345    <testOutputDirectory/>   
 346 
 347    <!--使用来自该项目的一系列构建扩展-->  
 348 
 349    <extensions>   
 350 
 351     <!--描述使用到的构建扩展。-->  
 352 
 353     <extension>   
 354 
 355      <!--构建扩展的groupId-->  
 356 
 357      <groupId/>   
 358 
 359      <!--构建扩展的artifactId-->  
 360 
 361      <artifactId/>   
 362 
 363      <!--构建扩展的版本-->  
 364 
 365      <version/>  
 366 
 367     </extension>  
 368 
 369    </extensions>   
 370 
 371    <!--当项目没有规定目标(Maven2 叫做阶段)时的默认值-->  
 372 
 373    <defaultGoal/>   
 374 
 375    <!--这个元素描述了项目相关的所有资源路径列表,例如和项目相关的属性文件,这些资源被包含在最终的打包文件里。-->  
 376 
 377    <resources>   
 378 
 379     <!--这个元素描述了项目相关或测试相关的所有资源路径-->  
 380 
 381     <resource>   
 382 
 383      <!--描述了资源的目标路径。该路径相对target/classes目录(例如${project.build.outputDirectory})。举个例子,如果你想资源在特定的包里(org.apache.maven.messages),你就必须该元素设置为org/apache/maven/messages。然而,如果你只是想把资源放到源码目录结构里,就不需要该配置。-->  
 384 
 385      <targetPath/>   
 386 
 387      <!--是否使用参数值代替参数名。参数值取自properties元素或者文件里配置的属性,文件在filters元素里列出。-->  
 388 
 389      <filtering/>   
 390 
 391      <!--描述存放资源的目录,该路径相对POM路径-->  
 392 
 393      <directory/>   
 394 
 395      <!--包含的模式列表,例如**/*.xml.-->  
 396 
 397      <includes/>   
 398 
 399      <!--排除的模式列表,例如**/*.xml-->  
 400 
 401      <excludes/>  
 402 
 403     </resource>  
 404 
 405    </resources>   
 406 
 407    <!--这个元素描述了单元测试相关的所有资源路径,例如和单元测试相关的属性文件。-->  
 408 
 409    <testResources>   
 410 
 411     <!--这个元素描述了测试相关的所有资源路径,参见build/resources/resource元素的说明-->  
 412 
 413     <testResource>  
 414 
 415      <targetPath/><filtering/><directory/><includes/><excludes/>  
 416 
 417     </testResource>  
 418 
 419    </testResources>   
 420 
 421    <!--构建产生的所有文件存放的目录-->  
 422 
 423    <directory/>   
 424 
 425    <!--产生的构件的文件名,默认值是${artifactId}-${version}。-->  
 426 
 427    <finalName/>   
 428 
 429    <!--当filtering开关打开时,使用到的过滤器属性文件列表-->  
 430 
 431    <filters/>   
 432 
 433    <!--子项目可以引用的默认插件信息。该插件配置项直到被引用时才会被解析或绑定到生命周期。给定插件的任何本地配置都会覆盖这里的配置-->  
 434 
 435    <pluginManagement>   
 436 
 437     <!--使用的插件列表 。-->  
 438 
 439     <plugins>   
 440 
 441      <!--plugin元素包含描述插件所需要的信息。-->  
 442 
 443      <plugin>   
 444 
 445       <!--插件在仓库里的group ID-->  
 446 
 447       <groupId/>   
 448 
 449       <!--插件在仓库里的artifact ID-->  
 450 
 451       <artifactId/>   
 452 
 453       <!--被使用的插件的版本(或版本范围)-->  
 454 
 455       <version/>   
 456 
 457       <!--是否从该插件下载Maven扩展(例如打包和类型处理器),由于性能原因,只有在真需要下载时,该元素才被设置成enabled。-->  
 458 
 459       <extensions/>   
 460 
 461       <!--在构建生命周期中执行一组目标的配置。每个目标可能有不同的配置。-->  
 462 
 463       <executions>   
 464 
 465        <!--execution元素包含了插件执行需要的信息-->  
 466 
 467        <execution>   
 468 
 469         <!--执行目标的标识符,用于标识构建过程中的目标,或者匹配继承过程中需要合并的执行目标-->  
 470 
 471         <id/>   
 472 
 473         <!--绑定了目标的构建生命周期阶段,如果省略,目标会被绑定到源数据里配置的默认阶段-->  
 474 
 475         <phase/>   
 476 
 477         <!--配置的执行目标-->  
 478 
 479         <goals/>   
 480 
 481         <!--配置是否被传播到子POM-->  
 482 
 483         <inherited/>   
 484 
 485         <!--作为DOM对象的配置-->  
 486 
 487         <configuration/>  
 488 
 489        </execution>  
 490 
 491       </executions>   
 492 
 493       <!--项目引入插件所需要的额外依赖-->  
 494 
 495       <dependencies>   
 496 
 497        <!--参见dependencies/dependency元素-->  
 498 
 499        <dependency>  
 500 
 501           
 502 
 503        </dependency>  
 504 
 505       </dependencies>        
 506 
 507       <!--任何配置是否被传播到子项目-->  
 508 
 509       <inherited/>   
 510 
 511       <!--作为DOM对象的配置-->  
 512 
 513       <configuration/>  
 514 
 515      </plugin>  
 516 
 517     </plugins>  
 518 
 519    </pluginManagement>   
 520 
 521    <!--使用的插件列表-->  
 522 
 523    <plugins>   
 524 
 525     <!--参见build/pluginManagement/plugins/plugin元素-->  
 526 
 527     <plugin>  
 528 
 529      <groupId/><artifactId/><version/><extensions/>  
 530 
 531      <executions>  
 532 
 533       <execution>  
 534 
 535        <id/><phase/><goals/><inherited/><configuration/>  
 536 
 537       </execution>  
 538 
 539      </executions>  
 540 
 541      <dependencies>   
 542 
 543       <!--参见dependencies/dependency元素-->  
 544 
 545       <dependency>  
 546 
 547          
 548 
 549       </dependency>  
 550 
 551      </dependencies>  
 552 
 553      <goals/><inherited/><configuration/>  
 554 
 555     </plugin>  
 556 
 557    </plugins>  
 558 
 559   </build>   
 560 
 561   <!--在列的项目构建profile,如果被激活,会修改构建处理-->  
 562 
 563   <profiles>   
 564 
 565    <!--根据环境参数或命令行参数激活某个构建处理-->  
 566 
 567    <profile>   
 568 
 569     <!--构建配置的唯一标识符。即用于命令行激活,也用于在继承时合并具有相同标识符的profile。-->  
 570 
 571     <id/>   
 572 
 573     <!--自动触发profile的条件逻辑。Activation是profile的开启钥匙。profile的力量来自于它  
 574 
 575     能够在某些特定的环境中自动使用某些特定的值;这些环境通过activation元素指定。activation元素并不是激活profile的唯一方式。-->  
 576 
 577     <activation>   
 578 
 579      <!--profile默认是否激活的标志-->  
 580 
 581      <activeByDefault/>   
 582 
 583      <!--当匹配的jdk被检测到,profile被激活。例如,1.4激活JDK1.4,1.4.0_2,而!1.4激活所有版本不是以1.4开头的JDK。-->  
 584 
 585      <jdk/>   
 586 
 587      <!--当匹配的操作系统属性被检测到,profile被激活。os元素可以定义一些操作系统相关的属性。-->  
 588 
 589      <os>   
 590 
 591       <!--激活profile的操作系统的名字-->  
 592 
 593       <name>Windows XP</name>   
 594 
 595       <!--激活profile的操作系统所属家族(如 'windows')-->  
 596 
 597       <family>Windows</family>   
 598 
 599       <!--激活profile的操作系统体系结构 -->  
 600 
 601       <arch>x86</arch>   
 602 
 603       <!--激活profile的操作系统版本-->  
 604 
 605       <version>5.1.2600</version>  
 606 
 607      </os>   
 608 
 609      <!--如果Maven检测到某一个属性(其值可以在POM中通过${名称}引用),其拥有对应的名称和值,Profile就会被激活。如果值  
 610 
 611      字段是空的,那么存在属性名称字段就会激活profile,否则按区分大小写方式匹配属性值字段-->  
 612 
 613      <property>   
 614 
 615       <!--激活profile的属性的名称-->  
 616 
 617       <name>mavenVersion</name>   
 618 
 619       <!--激活profile的属性的值-->  
 620 
 621       <value>2.0.3</value>  
 622 
 623      </property>   
 624 
 625      <!--提供一个文件名,通过检测该文件的存在或不存在来激活profile。missing检查文件是否存在,如果不存在则激活  
 626 
 627      profile。另一方面,exists则会检查文件是否存在,如果存在则激活profile。-->  
 628 
 629      <file>   
 630 
 631       <!--如果指定的文件存在,则激活profile。-->  
 632 
 633       <exists>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</exists>   
 634 
 635       <!--如果指定的文件不存在,则激活profile。-->  
 636 
 637       <missing>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</missing>  
 638 
 639      </file>  
 640 
 641     </activation>   
 642 
 643     <!--构建项目所需要的信息。参见build元素-->  
 644 
 645     <build>  
 646 
 647      <defaultGoal/>  
 648 
 649      <resources>  
 650 
 651       <resource>  
 652 
 653        <targetPath/><filtering/><directory/><includes/><excludes/>  
 654 
 655       </resource>  
 656 
 657      </resources>  
 658 
 659      <testResources>  
 660 
 661       <testResource>  
 662 
 663        <targetPath/><filtering/><directory/><includes/><excludes/>  
 664 
 665       </testResource>  
 666 
 667      </testResources>  
 668 
 669      <directory/><finalName/><filters/>  
 670 
 671      <pluginManagement>  
 672 
 673       <plugins>   
 674 
 675        <!--参见build/pluginManagement/plugins/plugin元素-->  
 676 
 677        <plugin>  
 678 
 679         <groupId/><artifactId/><version/><extensions/>  
 680 
 681         <executions>  
 682 
 683          <execution>  
 684 
 685           <id/><phase/><goals/><inherited/><configuration/>  
 686 
 687          </execution>  
 688 
 689         </executions>  
 690 
 691         <dependencies>   
 692 
 693          <!--参见dependencies/dependency元素-->  
 694 
 695          <dependency>  
 696 
 697             
 698 
 699          </dependency>  
 700 
 701         </dependencies>  
 702 
 703         <goals/><inherited/><configuration/>  
 704 
 705        </plugin>  
 706 
 707       </plugins>  
 708 
 709      </pluginManagement>  
 710 
 711      <plugins>   
 712 
 713       <!--参见build/pluginManagement/plugins/plugin元素-->  
 714 
 715       <plugin>  
 716 
 717        <groupId/><artifactId/><version/><extensions/>  
 718 
 719        <executions>  
 720 
 721         <execution>  
 722 
 723          <id/><phase/><goals/><inherited/><configuration/>  
 724 
 725         </execution>  
 726 
 727        </executions>  
 728 
 729        <dependencies>   
 730 
 731         <!--参见dependencies/dependency元素-->  
 732 
 733         <dependency>  
 734 
 735            
 736 
 737         </dependency>  
 738 
 739        </dependencies>  
 740 
 741        <goals/><inherited/><configuration/>  
 742 
 743       </plugin>  
 744 
 745      </plugins>  
 746 
 747     </build>   
 748 
 749     <!--模块(有时称作子项目) 被构建成项目的一部分。列出的每个模块元素是指向该模块的目录的相对路径-->  
 750 
 751     <modules/>   
 752 
 753     <!--发现依赖和扩展的远程仓库列表。-->  
 754 
 755     <repositories>   
 756 
 757      <!--参见repositories/repository元素-->  
 758 
 759      <repository>  
 760 
 761       <releases>  
 762 
 763        <enabled/><updatePolicy/><checksumPolicy/>  
 764 
 765       </releases>  
 766 
 767       <snapshots>  
 768 
 769        <enabled/><updatePolicy/><checksumPolicy/>  
 770 
 771       </snapshots>  
 772 
 773       <id/><name/><url/><layout/>  
 774 
 775      </repository>  
 776 
 777     </repositories>   
 778 
 779     <!--发现插件的远程仓库列表,这些插件用于构建和报表-->  
 780 
 781     <pluginRepositories>   
 782 
 783      <!--包含需要连接到远程插件仓库的信息.参见repositories/repository元素-->      
 784 
 785      <pluginRepository>  
 786 
 787       <releases>  
 788 
 789        <enabled/><updatePolicy/><checksumPolicy/>  
 790 
 791       </releases>  
 792 
 793       <snapshots>  
 794 
 795        <enabled/><updatePolicy/><checksumPolicy/>  
 796 
 797       </snapshots>  
 798 
 799       <id/><name/><url/><layout/>  
 800 
 801      </pluginRepository>  
 802 
 803     </pluginRepositories>   
 804 
 805     <!--该元素描述了项目相关的所有依赖。 这些依赖组成了项目构建过程中的一个个环节。它们自动从项目定义的仓库中下载。要获取更多信息,请看项目依赖机制。-->  
 806 
 807     <dependencies>   
 808 
 809      <!--参见dependencies/dependency元素-->  
 810 
 811      <dependency>  
 812 
 813         
 814 
 815      </dependency>  
 816 
 817     </dependencies>   
 818 
 819     <!--不赞成使用. 现在Maven忽略该元素.-->  
 820 
 821     <reports/>      
 822 
 823     <!--该元素包括使用报表插件产生报表的规范。当用户执行“mvn site”,这些报表就会运行。 在页面导航栏能看到所有报表的链接。参见reporting元素-->  
 824 
 825     <reporting>  
 826 
 827        
 828 
 829     </reporting>   
 830 
 831     <!--参见dependencyManagement元素-->  
 832 
 833     <dependencyManagement>  
 834 
 835      <dependencies>   
 836 
 837       <!--参见dependencies/dependency元素-->  
 838 
 839       <dependency>  
 840 
 841          
 842 
 843       </dependency>  
 844 
 845      </dependencies>  
 846 
 847     </dependencyManagement>   
 848 
 849     <!--参见distributionManagement元素-->  
 850 
 851     <distributionManagement>  
 852 
 853        
 854 
 855     </distributionManagement>   
 856 
 857     <!--参见properties元素-->  
 858 
 859     <properties/>  
 860 
 861    </profile>  
 862 
 863   </profiles>   
 864 
 865   <!--模块(有时称作子项目) 被构建成项目的一部分。列出的每个模块元素是指向该模块的目录的相对路径-->  
 866 
 867   <modules/>  
 868 
 869      <!--发现依赖和扩展的远程仓库列表。-->    
 870 
 871      <repositories>    
 872 
 873       <!--包含需要连接到远程仓库的信息-->  
 874 
 875          <repository>   
 876 
 877           <!--如何处理远程仓库里发布版本的下载-->  
 878 
 879           <releases>   
 880 
 881            <!--true或者false表示该仓库是否为下载某种类型构件(发布版,快照版)开启。 -->  
 882 
 883      <enabled/>   
 884 
 885      <!--该元素指定更新发生的频率。Maven会比较本地POM和远程POM的时间戳。这里的选项是:always(一直),daily(默认,每日),interval:X(这里X是以分钟为单位的时间间隔),或者never(从不)。-->  
 886 
 887      <updatePolicy/>   
 888 
 889      <!--当Maven验证构件校验文件失败时该怎么做:ignore(忽略),fail(失败),或者warn(警告)。-->  
 890 
 891      <checksumPolicy/>  
 892 
 893     </releases>   
 894 
 895     <!--如何处理远程仓库里快照版本的下载。有了releases和snapshots这两组配置,POM就可以在每个单独的仓库中,为每种类型的构件采取不同的策略。例如,可能有人会决定只为开发目的开启对快照版本下载的支持。参见repositories/repository/releases元素-->  
 896 
 897     <snapshots>  
 898 
 899      <enabled/><updatePolicy/><checksumPolicy/>  
 900 
 901     </snapshots>   
 902 
 903     <!--远程仓库唯一标识符。可以用来匹配在settings.xml文件里配置的远程仓库-->  
 904 
 905     <id>banseon-repository-proxy</id>    
 906 
 907     <!--远程仓库名称-->  
 908 
 909              <name>banseon-repository-proxy</name>    
 910 
 911              <!--远程仓库URL,按protocol://hostname/path形式-->  
 912 
 913              <url>http://192.168.1.169:9999/repository/</url>    
 914 
 915              <!--用于定位和排序构件的仓库布局类型-可以是default(默认)或者legacy(遗留)。Maven 2为其仓库提供了一个默认的布局;然而,Maven 1.x有一种不同的布局。我们可以使用该元素指定布局是default(默认)还是legacy(遗留)。-->  
 916 
 917              <layout>default</layout>              
 918 
 919          </repository>    
 920 
 921      </repositories>   
 922 
 923      <!--发现插件的远程仓库列表,这些插件用于构建和报表-->  
 924 
 925      <pluginRepositories>   
 926 
 927       <!--包含需要连接到远程插件仓库的信息.参见repositories/repository元素-->  
 928 
 929    <pluginRepository>  
 930 
 931       
 932 
 933    </pluginRepository>  
 934 
 935   </pluginRepositories>   
 936 
 937        
 938 
 939      <!--该元素描述了项目相关的所有依赖。 这些依赖组成了项目构建过程中的一个个环节。它们自动从项目定义的仓库中下载。要获取更多信息,请看项目依赖机制。-->    
 940 
 941      <dependencies>    
 942 
 943          <dependency>  
 944 
 945     <!--依赖的group ID-->  
 946 
 947              <groupId>org.apache.maven</groupId>    
 948 
 949              <!--依赖的artifact ID-->  
 950 
 951              <artifactId>maven-artifact</artifactId>    
 952 
 953              <!--依赖的版本号。 在Maven 2里, 也可以配置成版本号的范围。-->  
 954 
 955              <version>3.8.1</version>    
 956 
 957              <!--依赖类型,默认类型是jar。它通常表示依赖的文件的扩展名,但也有例外。一个类型可以被映射成另外一个扩展名或分类器。类型经常和使用的打包方式对应,尽管这也有例外。一些类型的例子:jar,war,ejb-client和test-jar。如果设置extensions为 true,就可以在plugin里定义新的类型。所以前面的类型的例子不完整。-->  
 958 
 959              <type>jar</type>   
 960 
 961              <!--依赖的分类器。分类器可以区分属于同一个POM,但不同构建方式的构件。分类器名被附加到文件名的版本号后面。例如,如果你想要构建两个单独的构件成JAR,一个使用Java 1.4编译器,另一个使用Java 6编译器,你就可以使用分类器来生成两个单独的JAR构件。-->  
 962 
 963              <classifier></classifier>   
 964 
 965              <!--依赖范围。在项目发布过程中,帮助决定哪些构件被包括进来。欲知详情请参考依赖机制。   
 966 
 967                  - compile :默认范围,用于编译     
 968 
 969                  - provided:类似于编译,但支持你期待jdk或者容器提供,类似于classpath     
 970 
 971                  - runtime: 在执行时需要使用     
 972 
 973                  - test:    用于test任务时使用     
 974 
 975                  - system: 需要外在提供相应的元素。通过systemPath来取得     
 976 
 977                  - systemPath: 仅用于范围为system。提供相应的路径     
 978 
 979                  - optional:   当项目自身被依赖时,标注依赖是否传递。用于连续依赖时使用-->    
 980 
 981              <scope>test</scope>       
 982 
 983              <!--仅供system范围使用。注意,不鼓励使用这个元素,并且在新的版本中该元素可能被覆盖掉。该元素为依赖规定了文件系统上的路径。需要绝对路径而不是相对路径。推荐使用属性匹配绝对路径,例如${java.home}。-->   
 984 
 985              <systemPath></systemPath>    
 986 
 987              <!--当计算传递依赖时, 从依赖构件列表里,列出被排除的依赖构件集。即告诉maven你只依赖指定的项目,不依赖项目的依赖。此元素主要用于解决版本冲突问题-->   
 988 
 989              <exclusions>  
 990 
 991               <exclusion>    
 992 
 993                      <artifactId>spring-core</artifactId>    
 994 
 995                      <groupId>org.springframework</groupId>    
 996 
 997                  </exclusion>    
 998 
 999              </exclusions>      
1000 
1001              <!--可选依赖,如果你在项目B中把C依赖声明为可选,你就需要在依赖于B的项目(例如项目A)中显式的引用对C的依赖。可选依赖阻断依赖的传递性。-->    
1002 
1003              <optional>true</optional>  
1004 
1005          </dependency>  
1006 
1007      </dependencies>   
1008 
1009      <!--不赞成使用. 现在Maven忽略该元素.-->  
1010 
1011      <reports></reports>   
1012 
1013      <!--该元素描述使用报表插件产生报表的规范。当用户执行“mvn site”,这些报表就会运行。 在页面导航栏能看到所有报表的链接。-->   
1014 
1015   <reporting>   
1016 
1017    <!--true,则,网站不包括默认的报表。这包括“项目信息”菜单中的报表。-->  
1018 
1019    <excludeDefaults/>   
1020 
1021    <!--所有产生的报表存放到哪里。默认值是${project.build.directory}/site。-->  
1022 
1023    <outputDirectory/>   
1024 
1025    <!--使用的报表插件和他们的配置。-->  
1026 
1027    <plugins>   
1028 
1029     <!--plugin元素包含描述报表插件需要的信息-->  
1030 
1031     <plugin>   
1032 
1033      <!--报表插件在仓库里的group ID-->  
1034 
1035      <groupId/>   
1036 
1037      <!--报表插件在仓库里的artifact ID-->  
1038 
1039      <artifactId/>   
1040 
1041      <!--被使用的报表插件的版本(或版本范围)-->  
1042 
1043      <version/>   
1044 
1045      <!--任何配置是否被传播到子项目-->  
1046 
1047      <inherited/>   
1048 
1049      <!--报表插件的配置-->  
1050 
1051      <configuration/>   
1052 
1053      <!--一组报表的多重规范,每个规范可能有不同的配置。一个规范(报表集)对应一个执行目标 。例如,有1,2,3,4,5,6,7,8,9个报表。1,2,5构成A报表集,对应一个执行目标。2,5,8构成B报表集,对应另一个执行目标-->  
1054 
1055      <reportSets>   
1056 
1057       <!--表示报表的一个集合,以及产生该集合的配置-->  
1058 
1059       <reportSet>   
1060 
1061        <!--报表集合的唯一标识符,POM继承时用到-->  
1062 
1063        <id/>   
1064 
1065        <!--产生报表集合时,被使用的报表的配置-->  
1066 
1067        <configuration/>   
1068 
1069        <!--配置是否被继承到子POMs-->  
1070 
1071        <inherited/>   
1072 
1073        <!--这个集合里使用到哪些报表-->  
1074 
1075        <reports/>  
1076 
1077       </reportSet>  
1078 
1079      </reportSets>  
1080 
1081     </plugin>  
1082 
1083    </plugins>  
1084 
1085   </reporting>   
1086 
1087   <!--继承自该项目的所有子项目的默认依赖信息。这部分的依赖信息不会被立即解析,而是当子项目声明一个依赖(必须描述group ID和artifact ID信息),如果group ID和artifact ID以外的一些信息没有描述,则通过group ID和artifact ID匹配到这里的依赖,并使用这里的依赖信息。-->   
1088 
1089   <dependencyManagement>  
1090 
1091    <dependencies>   
1092 
1093     <!--参见dependencies/dependency元素-->  
1094 
1095     <dependency>  
1096 
1097        
1098 
1099     </dependency>  
1100 
1101    </dependencies>  
1102 
1103   </dependencyManagement>       
1104 
1105      <!--项目分发信息,在执行mvn deploy后表示要发布的位置。有了这些信息就可以把网站部署到远程服务器或者把构件部署到远程仓库。-->    
1106 
1107      <distributionManagement>   
1108 
1109          <!--部署项目产生的构件到远程仓库需要的信息-->  
1110 
1111          <repository>   
1112 
1113           <!--是分配给快照一个唯一的版本号(由时间戳和构建流水号)?还是每次都使用相同的版本号?参见repositories/repository元素-->  
1114 
1115     <uniqueVersion/>  
1116 
1117     <id>banseon-maven2</id>    
1118 
1119     <name>banseon maven2</name>    
1120 
1121              <url>file://${basedir}/target/deploy</url>    
1122 
1123              <layout/>  
1124 
1125    </repository>   
1126 
1127    <!--构件的快照部署到哪里?如果没有配置该元素,默认部署到repository元素配置的仓库,参见distributionManagement/repository元素-->    
1128 
1129    <snapshotRepository>  
1130 
1131     <uniqueVersion/>  
1132 
1133     <id>banseon-maven2</id>   
1134 
1135              <name>Banseon-maven2 Snapshot Repository</name>   
1136 
1137              <url>scp://svn.baidu.com/banseon:/usr/local/maven-snapshot</url>    
1138 
1139     <layout/>  
1140 
1141    </snapshotRepository>   
1142 
1143    <!--部署项目的网站需要的信息-->    
1144 
1145          <site>   
1146 
1147           <!--部署位置的唯一标识符,用来匹配站点和settings.xml文件里的配置-->    
1148 
1149              <id>banseon-site</id>    
1150 
1151              <!--部署位置的名称-->  
1152 
1153              <name>business api website</name>    
1154 
1155              <!--部署位置的URL,按protocol://hostname/path形式-->  
1156 
1157              <url>    
1158 
1159                  scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web     
1160 
1161              </url>    
1162 
1163          </site>   
1164 
1165    <!--项目下载页面的URL。如果没有该元素,用户应该参考主页。使用该元素的原因是:帮助定位那些不在仓库里的构件(由于license限制)。-->  
1166 
1167    <downloadUrl/>   
1168 
1169    <!--如果构件有了新的group ID和artifact ID(构件移到了新的位置),这里列出构件的重定位信息。-->  
1170 
1171    <relocation>   
1172 
1173     <!--构件新的group ID-->  
1174 
1175     <groupId/>   
1176 
1177     <!--构件新的artifact ID-->  
1178 
1179     <artifactId/>   
1180 
1181     <!--构件新的版本号-->  
1182 
1183     <version/>   
1184 
1185     <!--显示给用户的,关于移动的额外信息,例如原因。-->  
1186 
1187     <message/>  
1188 
1189    </relocation>  
1190 
1191    <!--给出该构件在远程仓库的状态。不得在本地项目中设置该元素,因为这是工具自动更新的。有效的值有:none(默认),converted(仓库管理员从Maven 1 POM转换过来),partner(直接从伙伴Maven 2仓库同步过来),deployed(从Maven 2实例部署),verified(被核实时正确的和最终的)。-->  
1192 
1193    <status/>          
1194 
1195      </distributionManagement>   
1196 
1197      <!--以值替代名称,Properties可以在整个POM中使用,也可以作为触发条件(见settings.xml配置文件里activation元素的说明)。格式是<name>value</name>。-->  
1198 
1199      <properties/>  
1200 
1201  </project>  

marven setting.xml文件详解

参考https://blog.csdn.net/zhou920786312/article/details/80541337

<?xml version="1.0" encoding="UTF-8"?>


<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

   <!-- 本地仓库的路径。默认值为${user.home}/.m2/repository。 -->
 <localRepository>E:/java/apache-maven-3.3.9/repository</localRepository>
<!--Maven是否需要和用户交互以获得输入。如果Maven需要和用户交互以获得输入,则设置成true,反之则应为false。默认为true。-->
  <!--<interactiveMode>true</interactiveMode>-->


 <!--表示是否离线,默认是false。这个属性表示在Maven进行项目编译和部署等操作时是否允许Maven进行联网来下载所需要的信息。  -->
  <!-- <offline>false</offline>
  -->

<!--当插件的组织Id(groupId)没有显式提供时,供搜寻插件组织Id(groupId)的列表。该元素包含一个pluginGroup元素列表,每个子元素包含了一个组织Id(groupId)。当我们使用某个插件,并且没有在命令行为其提供组织Id(groupId)的时候,Maven就会使用该列表。默认情况下该列表包含了org.apache.maven.plugins和org.codehaus.mojo -->
  <pluginGroups>
    <!-- pluginGroup
     | Specifies a further group identifier to use for plugin lookup.
    <pluginGroup>com.your.plugins</pluginGroup>
    -->
  </pluginGroups>

<!--其下面可以定义一系列的proxy子元素,表示Maven在进行联网时需要使用到的代理。当设置了多个代理的时候第一个标记active为true的代理将会被使用。 -->
  <proxies>
   <!--代理元素包含配置代理时需要的信息-->


    <proxy>
     <!-- 代理的唯一定义符,用来区分不同的代理元素。-->
      <id>optional</id>
<!--该代理是否是激活的那个。true则激活代理。当我们声明了一组代理,而某个时候只需要激活一个代理的时候,该元素就可以派上用处。 -->
      <active>true</active>
       <!--代理的协议。 协议://主机名:端口,分隔成离散的元素以方便配置。-->
      <protocol>http</protocol>
    <!--代理的用户名,用户名和密码表示代理服务器认证的登录名和密码。 -->
      <username>proxyuser</username>
     <!--代理的用户名,用户名和密码表示代理服务器认证的登录名和密码。 -->
      <password>proxypass</password>
       <!--代理的主机名。协议://主机名:端口,分隔成离散的元素以方便配置。  --> 
      <host>proxy.host.net</host>
       <!--代理的主机名。协议://主机名:端口,分隔成离散的元素以方便配置。  -->
      <port>80</port>
       <!--不该被代理的主机名列表。该列表的分隔符由代理服务器指定;例子中使用了竖线分隔符,使用逗号分隔也很常见。-->
      <nonProxyHosts>local.net|some.host.com</nonProxyHosts>
    </proxy>

  </proxies>

 <!--表示当需要连接到一个私有服务器的时候需要的认证信息 。-->
  <servers>
    <!--服务器元素包含配置服务器时需要的信息
  发布的服务器,发布的位置在POM中配置,以ID为关联,有很多公用的信息需要配置在POM文件里,最佳实践是定义一个公司级别的root pom - 

    -->

        <server>  
    <!--这是server的id(注意不是用户登陆的id),该id与distributionManagement中repository元素的id相匹配。-->
         <id>frame-releases</id>  
           <!--鉴权用户名。鉴权用户名和鉴权密码表示服务器认证所需要的登录名和密码。 -->
         <username>admin</username>  
           <!--鉴权用户名。鉴权用户名和鉴权密码表示服务器认证所需要的登录名和密码。 -->
         <password>admin123</password>  
       </server>  

      <server>
          <id>siteServer</id>
    <!--鉴权时使用的私钥位置。和前两个元素类似,私钥位置和私钥密码指定了一个私钥的路径(默认是${user.home}/.ssh/id_dsa)以及如果需要的话,一个密语。将来passphrase和password元素可能会被提取到外部,但目前它们必须在settings.xml文件以纯文本的形式声明。 -->
          <privateKey>/path/to/private/key</privateKey>
          <!--鉴权时使用的私钥密码。-->
          <passphrase>optional; leave empty if not used.</passphrase>
            <!--文件被创建时的权限。如果在部署的时候会创建一个仓库文件或者目录,这时候就可以使用权限(permission)。这两个元素合法的值是一个三位数字,其对应了unix文件系统的权限,如664,或者775。 -->           
           <filePermissions>664</filePermissions>
           <!--目录被创建时的权限。 -->
           <directoryPermissions>775</directoryPermissions>
        </server>


  </servers>
  <!--用于定义一系列的远程仓库的镜像。我们可以在pom中定义一个下载工件的时候所使用的远程仓库。但是有时候这个远程仓库会比较忙,所以这个时候人们就想着给它创建镜像以缓解远程仓库的压力,也就是说会把对远程仓库的请求转换到对其镜像地址的请求。每个远程仓库都会有一个id,这样我们就可以创建自己的mirror来关联到该仓库,那么以后需要从远程仓库下载工件的时候Maven就可以从我们定义好的mirror站点来下载,这可以很好的缓解我们远程仓库的压力。在我们定义的mirror中每个远程仓库都只能有一个mirror与它关联,也就是说你不能同时配置多个mirror的mirrorOf指向同一个repositoryId。-->
  <mirrors>

    <mirror>  
    <!--该镜像的唯一标识符。id用来区分不同的mirror元素。 -->
     <id>mirrorId</id>  
     <!-- 用来表示该mirror是关联的哪一个仓库,其值为其关联仓库的id。当要同时关联多个仓库时,这多个仓库之间可以用逗号隔开;当要关联所有的仓库时,可以使用“*”表示;当要关联除某一个仓库以外的其他所有仓库时,可以表示为“*,!repositoryId”;当要关联不是localhost或用file请求的仓库时,可以表示为“external:*”。-->
     <mirrorOf>repositoryId</mirrorOf>  
     <!--镜像名称 -->
     <name>Human Readable Name for this Mirror.</name>  
      <!--该镜像的URL。构建系统会优先考虑使用该URL,而非使用默认的服务器URL。 -->
     <url>http://196.160.1.211:8081/nexus/content/groups/public/</url>  
   </mirror>
  </mirrors>
  <!--用于指定一系列的profile。profile元素由activation、repositories、pluginRepositories和properties四个元素组成。当一个profile在settings.xml中是处于活动状态并且在pom.xml中定义了一个相同id的profile时,settings.xml中的profile会覆盖pom.xml中的profile。 -->
  <profiles>
     <!--根据环境参数来调整的构件的配置-->
    <profile>
     <!--该配置的唯一标识符。 -->
      <id>jdk-1.4</id>
<!--当所有的约束条件都满足的时候就会激活这个profile。-->
      <activation>
      <!--当其值为true的时候表示如果没有其他的profile处于激活状态的时候,该profile将自动被激活。-->
        <activeByDefault>false</activeByDefault>
    <!--当匹配的jdk被检测到,profile被激活。例如,1.4激活JDK1.4,1.4.0_2,而!1.4激活所有版本不是以1.4开头的JDK。
 这里的版本还可以用一个范围来表示,如
<jdk>[1.4,1.7)</jdk>表示1.4、1.5和1.6满足;
<jdk>[1.4,1.7]</jdk>表示1.4、1.5、1.6和1.7满足;-->
        <jdk>1.5</jdk>
        <!--表示当操作系统满足条件的时候激活。-->
          <os>
         <!--激活profile的操作系统的名字 -->
         <name>Windows XP</name>
         <!--激活profile的操作系统所属家族(如 'windows')  -->
         <family>Windows</family>
         <!--激活profile的操作系统体系结构  -->
         <arch>x86</arch>
         <!--激活profile的操作系统版本-->
         <version>5.1.2600</version>
        </os>

        <!--property是键值对的形式,表示当Maven检测到了这样一个键值对的时候就激活该profile。如果值字段是空的,那么存在属性名称字段就会激活profile,否则按区分大小写方式匹配属性值字段-->
        <property>
         <!--这个时候如果要激活该profile的话,可以在调用Maven指令的时候加上参数mavenVersion并指定其值为>2.0.3,如:mvn compile –DmavenVersion=>2.0.3-->
         <name>mavenVersion</name>
         <!--激活profile的属性的值 -->
         <value>2.0.3</value>
        </property>
        <!--表示当文件存在或不存在的时候激活,exists表示存在,missing表示不存在。如下面的例子表示当文件hello/world不存在的时候激活该profile。-->
        <file>
         <!--如果指定的文件存在,则激活profile。 -->
         <exists>${basedir}/file2.properties</exists>
         <!--如果指定的文件不存在,则激活profile。-->
         <missing>${basedir}/file1.properties</missing>
        </file>

      </activation>
 <!--用于定义远程仓库的,当该profile是激活状态的时候,这里面定义的远程仓库将作为当前pom的远程仓库。 -->
      <repositories>

        <repository>
          <id>jdk14</id>
          <name>Repository for JDK 1.4 builds</name>
          <url>http://www.myhost.com/maven/jdk14</url>
          <layout>default</layout>
          <snapshotPolicy>always</snapshotPolicy>
        </repository>
      </repositories>
    </profile>



    <profile>
      <id>env-dev</id>

      <activation>
        <property>
          <name>target-env</name>
          <value>dev</value>
        </property>
      </activation>

      <properties>
        <tomcatPath>/path/to/tomcat/instance</tomcatPath>
      </properties>
    </profile>


    <profile>
    <id>nexusProfile</id>  
     <!--远程仓库列表,它是Maven用来填充构建系统本地仓库所使用的一组远程项目。 -->
      <repositories>  
       <!--包含需要连接到远程仓库的信息 -->
       <repository>  
        <!--远程仓库唯一标识-->
         <id>nexusProfile</id>  
           <!--远程仓库名称 -->
        <name>nexus repository</name>  
          <!--用于定位和排序构件的仓库布局类型-可以是default(默认)或者legacy(遗留)。Maven 2为其仓库提供了一个默认的布局;然而,Maven 1.x有一种不同的布局。我们可以使用该元素指定布局是default(默认)还是legacy(遗留)。 -->
        <layout>default</layout>  
          <!--远程仓库URL,按protocol://hostname/path形式
          -->
        <url>http://196.160.1.211:8081/nexus/content/groups/public/</url>  
           <!--如何处理远程仓库里发布版本的下载-->
        <releases>
           <!--true或者false表示该仓库是否为下载某种类型构件(发布版,快照版)开启。  -->
            <enabled>true</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>true</enabled>
        </snapshots>  
       </repository>  
     </repositories>  
   </profile>  


     <profile>  
     <id>centralProfile</id>  
      <repositories>  
    <repository>  
      <id>central</id>  
      <name>Central Repository</name>  
     <!-- 虚拟的URL形式,指向镜像的URL,因为所有的镜像都是用的是nexus,这里的central实际上指向的是http://repos.d.xxx.com/nexus/content/groups/public -->  
      <url>https://repo.maven.apache.org/maven2</url>  
      <layout>default</layout>  
      <snapshots>  
        <enabled>true</enabled>  
      </snapshots>  
    </repository>  
  </repositories>  
   </profile>  


  </profiles>

 <!--手动激活profiles的列表,按照profile被应用的顺序定义activeProfile。 该元素包含了一组activeProfile元素,每个activeProfile都含有一个profile id。任何在activeProfile中定义的profile id,不论环境设置如何,其对应的
        profile都会被激活。如果没有匹配的profile,则什么都不会发生。例如,env-test是一个activeProfile,则在pom.xml(或者profile.xml)中对应id的profile会被激活。如果运行过程中找不到这样一个profile,Maven则会像往常一样运行。 -->

<activeProfile>nexusProfile</activeProfile>  
<activeProfile>centralProfile</activeProfile> 

</settings>


备注:POM配置
<distributionManagement> 
    <repository> 
     <!--frame-releases与setting文件的server id 对应 -->
        <id>frame-releases</id> 
        <name>frame-releases</name> 
        <url>http://localhost:8081/nexus/content/repositories/releases/</url> 
    </repository> 
    <snapshotRepository> 
        <id>frame-snapshots</id> 
        <name>frame Snapshots Repository</name> 
        <url>http://localhost:8081/nexus/content/repositories/snapshots/</url> 
    </snapshotRepository> 
</distributionManagement>
点赞

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注