mave 配置文件
1、什么是pom
pom（Project Object Model）代表项目对象模型，它是maven中工作的基本组件，是一个xml文件。它被放在工程跟目录下，文件命名为pom.xml。pom包含了关于工程和各种配置的详细信息，Maven使用这些信息构建工程。
2、pom文件节点
1 <project xmlns="http://maven.apache.org/POM/4.0.0" 2 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 3 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 4 http://maven.apache.org/xsd/maven-4.0.0.xsd"> 5 <modelVersion>4.0.0</modelVersion> 6 7 <!-- 基本配置 --> 8 <groupId>...</groupId> 9 <artifactId>...</artifactId> 10 <version>...</version> 11 <packaging>...</packaging> 12 13 14 <!-- 依赖配置 --> 15 <dependencies>...</dependencies> 16 <parent>...</parent> 17 <dependencyManagement>...</dependencyManagement> 18 <modules>...</modules> 19 <properties>...</properties> 20 21 <!-- 构建配置 --> 22 <build>...</build> 23 <reporting>...</reporting> 24 25 <!-- 项目信息 --> 26 <name>...</name> 27 <description>...</description> 28 <url>...</url> 29 <inceptionYear>...</inceptionYear> 30 <licenses>...</licenses> 31 <organization>...</organization> 32 <developers>...</developers> 33 <contributors>...</contributors> 34 35 <!-- 环境设置 --> 36 <issueManagement>...</issueManagement> 37 <ciManagement>...</ciManagement> 38 <mailingLists>...</mailingLists> 39 <scm>...</scm> 40 <prerequisites>...</prerequisites> 41 <repositories>...</repositories> 42 <pluginRepositories>...</pluginRepositories> 43 <distributionManagement>...</distributionManagement> 44 <profiles>...</profiles> 45 </project>
3、各节点解释说明
3.1、基本配置信息
1 <project xmlns="http://maven.apache.org/POM/4.0.0" 2 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 3 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 4 http://maven.apache.org/xsd/maven-4.0.0.xsd"> 5 <!-- pom模型版本，maven2和3只能为4.0.0--> 6 <modelVersion>4.0.0</modelVersion> 7 <!-- 项目的组ID，用于maven定位--> 8 <groupId>com.company.bank</groupId> 9 <!-- 项目ID，通常是项目的名称,唯一标识符--> 10 <artifactId>parent</artifactId> 11 <!-- 项目的版本--> 12 <version>1.0</version> 13 <!-- 项目的打包方式--> 14 <packaging>war</packaging> 15 <project>
3.2、依赖配置
1 <!--项目相关依赖配置，如果在父项目写的依赖，会被子项目引用。一般会在父项目中定义子项目中所有共用的依赖--> 2 <dependencies> 3 <dependency> 4 <groupId>junit</groupId> 5 <artifactId>junit</artifactId> 6 <version>4.12</version> 7 </dependency> 8 </dependencies> 9 10 <!--用于确定父项目的坐标位置--> 11 <parent> 12 <groupId>com.learnPro</groupId> 13 <artifactId>SIP-parent</artifactId> 14 <!--Maven首先在当前项目中找父项目的pom，然后在文件系统的这个位置（relativePath），然后在本地仓库，再在远程仓库找--> 15 <relativePath></relativePath> 16 <version>0.0.1-SNAPSHOT</version> 17 </parent> 18 19 <!--有些maven项目会做成多模块的，这个标签用于指定当前项目所包含的所有模块。之后对这个项目进行的maven操作，会让所有子模块也进行相同操作--> 20 <modules> 21 <module>com-a</> 22 <module>com-b</> 23 <module>com-c</> 24 <modules/> 25 26 <!--用于定义pom常量,这个常量可以在pom文件的任意地方通过${Java.version}来引用--> 27 <properties> 28 <java.version>1.7</java.version> 29 </properties> 30 31 <!--在父模块中定义后，子模块不会直接使用对应依赖，但是在使用相同依赖的时候可以不加版本号,这样的好处是，父项目统一了版本，而且子项目可以在需要的时候才引用对应的依赖--> 32 <dependencyManagement> 33 <dependencies> 34 ..... 35 </dependencies> 36 </dependencyManagement>
3.3、构建配置
1 <build> 2 <!--该元素设置了项目源码目录，当构建项目的时候，构建系统会编译目录里的源码。该路径是相对于pom.xml的相对路径。--> 3 <sourceDirectory/> 4 <!--该元素设置了项目脚本源码目录，该目录和源码目录不同：绝大多数情况下，该目录下的内容 会被拷贝到输出目录(因为脚本是被解释的，而不是被编译的)。--> 5 <scriptSourceDirectory/> 6 <!--该元素设置了项目单元测试使用的源码目录，当测试项目的时候，构建系统会编译目录里的源码。该路径是相对于pom.xml的相对路径。--> 7 <testSourceDirectory/> 8 <!--被编译过的应用程序class文件存放的目录。--> 9 <outputDirectory/> 10 <!--被编译过的测试class文件存放的目录。--> 11 <testOutputDirectory/> 12 <!--使用来自该项目的一系列构建扩展--> 13 <extensions> 14 <!--描述使用到的构建扩展。--> 15 <extension> 16 <!--构建扩展的groupId--> 17 <groupId/> 18 <!--构建扩展的artifactId--> 19 <artifactId/> 20 <!--构建扩展的版本--> 21 <version/> 22 </extension> 23 </extensions> 24 <!--当项目没有规定目标（Maven2 叫做阶段）时的默认值--> 25 <defaultGoal/> 26 <!--这个元素描述了项目相关的所有资源路径列表，例如和项目相关的属性文件，这些资源被包含在最终的打包文件里。--> 27 <resources> 28 <!--这个元素描述了项目相关或测试相关的所有资源路径--> 29 <resource> 30 <!-- 描述了资源的目标路径。该路径相对target/classes目录（例如${project.build.outputDirectory}）。举个例 子，如果你想资源在特定的包里(org.apache.maven.messages)，你就必须该元素设置为org/apache/maven /messages。然而，如果你只是想把资源放到源码目录结构里，就不需要该配置。--> 31 <targetPath/> 32 <!--是否使用参数值代替参数名。参数值取自properties元素或者文件里配置的属性，文件在filters元素里列出。--> 33 <filtering/> 34 <!--描述存放资源的目录，该路径相对POM路径--> 35 <directory/> 36 <!--包含的模式列表，例如**/*.xml.--> 37 <includes/> 38 <!--排除的模式列表，例如**/*.xml--> 39 <excludes/> 40 </resource> 41 </resources> 42 <!--这个元素描述了单元测试相关的所有资源路径，例如和单元测试相关的属性文件。--> 43 <testResources> 44 <!--这个元素描述了测试相关的所有资源路径，参见build/resources/resource元素的说明--> 45 <testResource> 46 <targetPath/><filtering/><directory/><includes/><excludes/> 47 </testResource> 48 </testResources> 49 <!--构建产生的所有文件存放的目录--> 50 <directory/> 51 <!--产生的构件的文件名，默认值是${artifactId}-${version}。--> 52 <finalName/> 53 <!--当filtering开关打开时，使用到的过滤器属性文件列表--> 54 <filters/> 55 <!--子项目可以引用的默认插件信息。该插件配置项直到被引用时才会被解析或绑定到生命周期。给定插件的任何本地配置都会覆盖这里的配置--> 56 <pluginManagement> 57 <!--使用的插件列表 。--> 58 <plugins> 59 <!--plugin元素包含描述插件所需要的信息。--> 60 <plugin> 61 <!--插件在仓库里的group ID--> 62 <groupId/> 63 <!--插件在仓库里的artifact ID--> 64 <artifactId/> 65 <!--被使用的插件的版本（或版本范围）--> 66 <version/> 67 <!--是否从该插件下载Maven扩展（例如打包和类型处理器），由于性能原因，只有在真需要下载时，该元素才被设置成enabled。--> 68 <extensions/> 69 <!--在构建生命周期中执行一组目标的配置。每个目标可能有不同的配置。--> 70 <executions> 71 <!--execution元素包含了插件执行需要的信息--> 72 <execution> 73 <!--执行目标的标识符，用于标识构建过程中的目标，或者匹配继承过程中需要合并的执行目标--> 74 <id/> 75 <!--绑定了目标的构建生命周期阶段，如果省略，目标会被绑定到源数据里配置的默认阶段--> 76 <phase/> 77 <!--配置的执行目标--> 78 <goals/> 79 <!--配置是否被传播到子POM--> 80 <inherited/> 81 <!--作为DOM对象的配置--> 82 <configuration/> 83 </execution> 84 </executions> 85 <!--项目引入插件所需要的额外依赖--> 86 <dependencies> 87 <!--参见dependencies/dependency元素--> 88 <dependency> 89 ...... 90 </dependency> 91 </dependencies> 92 <!--任何配置是否被传播到子项目--> 93 <inherited/> 94 <!--作为DOM对象的配置--> 95 <configuration/> 96 </plugin> 97 </plugins> 98 </pluginManagement> 99 <!--使用的插件列表--> 100 <plugins> 101 <!--参见build/pluginManagement/plugins/plugin元素--> 102 <plugin> 103 <groupId/><artifactId/><version/><extensions/> 104 <executions> 105 <execution> 106 <id/><phase/><goals/><inherited/><configuration/> 107 </execution> 108 </executions> 109 <dependencies> 110 <!--参见dependencies/dependency元素--> 111 <dependency> 112 ...... 113 </dependency> 114 </dependencies> 115 <goals/><inherited/><configuration/> 116 </plugin> 117 </plugins> 118 </build>
1 <reporting> 2 <!--true，则，网站不包括默认的报表。这包括“项目信息”菜单中的报表。--> 3 <excludeDefaults/> 4 <!--所有产生的报表存放到哪里。默认值是${project.build.directory}/site。--> 5 <outputDirectory/> 6 <!--使用的报表插件和他们的配置。--> 7 <plugins> 8 <!--plugin元素包含描述报表插件需要的信息--> 9 <plugin> 10 <!--报表插件在仓库里的group ID--> 11 <groupId/> 12 <!--报表插件在仓库里的artifact ID--> 13 <artifactId/> 14 <!--被使用的报表插件的版本（或版本范围）--> 15 <version/> 16 <!--任何配置是否被传播到子项目--> 17 <inherited/> 18 <!--报表插件的配置--> 19 <configuration/> 20 <!--一组报表的多重规范，每个规范可能有不同的配置。一个规范（报表集）对应一个执行目标 。例如，有1，2，3，4，5，6，7，8，9个报表。1，2，5构成A报表集，对应一个执行目标。2，5，8构成B报表集，对应另一个执行目标--> 21 <reportSets> 22 <!--表示报表的一个集合，以及产生该集合的配置--> 23 <reportSet> 24 <!--报表集合的唯一标识符，POM继承时用到--> 25 <id/> 26 <!--产生报表集合时，被使用的报表的配置--> 27 <configuration/> 28 <!--配置是否被继承到子POMs--> 29 <inherited/> 30 <!--这个集合里使用到哪些报表--> 31 <reports/> 32 </reportSet> 33 </reportSets> 34 </plugin> 35 </plugins> 36 </reporting>
3.4、项目信息
1 <!--给用户提供更为友好的项目名--> 2 <name>...</name> 3 <!--项目描述，maven文档中保存--> 4 <description>...</description> 5 <!--主页的URL，maven文档中保存--> 6 <url>...</url> 7 <!--项目创建年份，4位数字。当产生版权信息时需要使用这个值--> 8 <inceptionYear>...</inceptionYear> 9 <!--该元素描述了项目所有License列表。 应该只列出该项目的--> 10 <licenses> 11 <license> 12 <!--license用于法律上的名称--> 13 <name>...</name> 14 <!--官方的license正文页面的URL--> 15 <url>....</url> 16 <!--项目分发的主要方式：repo，可以从Maven库下载 manual， 用户必须手动下载和安装依赖--> 17 <distribution>repo</distribution> 18 <!--关于license的补充信息--> 19 <comments>....</comments> 20 </license> 21 </licenses> 22 <!--1.name 组织名 2.url 组织主页url--> 23 <organization>...</organization> 24 <!--项目开发人员列表--> 25 <developers> 26 <!--某个开发者信息--> 27 <developer> 28 <!--开发者的唯一标识符--> 29 <id>....</id> 30 <!--开发者的全名--> 31 <name>...</name> 32 <!--开发者的email--> 33 <email>...</email> 34 <!--开发者的主页--> 35 <url>...<url/> 36 <!--开发者在项目中的角色--> 37 <roles> 38 <role>Java Dev</role> 39 <role>Web UI</role> 40 </roles> 41 <!--开发者所属组织--> 42 <organization>sun</organization> 43 <!--开发者所属组织的URL--> 44 <organizationUrl>...</organizationUrl> 45 <!--开发者属性，如即时消息如何处理等--> 46 <properties> 47 <!-- 和主标签中的properties一样，可以随意定义子标签 --> 48 </properties> 49 <!--开发者所在时区， -11到12范围内的整数。--> 50 <timezone>-5</timezone> 51 </developer> 52 </developers>
53 <!--项目其他贡献者列表--> 54 <contributors>...</contributors>
3.5、环境信息
1 <!--目的问题管理系统(Bugzilla, Jira, Scarab)的名称和URL--> 2 <issueManagement> 3 <system>Bugzilla</system> 4 <url>http://127.0.0.1/bugzilla/</url> 5 </issueManagement> 6 7 <!--项目的持续集成信息--> 8 <ciManagement> 9 <!--持续集成系统的名字--> 10 <system>continuum</system> 11 <!--持续集成系统的名字--> 12 <url>http://127.0.0.1:8080/continuum</url> 13 <!--构建完成时，需要通知的开发者/用户的配置项。包括被通知者信息和通知条件（错误，失败，成功，警告）--> 14 <notifiers> 15 <notifier> 16 <!--通知方式--> 17 <type>mail</type> 18 <!--错误时是否通知--> 19 <sendOnError>true</sendOnError> 20 <!--失败时是否通知--> 21 <sendOnFailure>true</sendOnFailure> 22 <!--成功时是否通知--> 23 <sendOnSuccess>false</sendOnSuccess> 24 <!--警告时是否通知--> 25 <sendOnWarning>false</sendOnWarning> 26 <!--通知发送到的地址--> 27 <address>continuum@127.0.0.1</address> 28 <!--扩展项--> 29 <configuration></configuration> 30 </notifier> 31 </notifiers> 32 </ciManagement> 33 34 <!--项目相关邮件列表信息--> 35 <mailingLists> 36 <mailingList> 37 <name>User List</name> 38 <!--订阅邮件（取消订阅）的地址或链接，如果是邮件地址，创建文档时，mailto: 链接会被自动创建--> 39 <subscribe>user-subscribe@127.0.0.1</subscribe> 40 <unsubscribe>user-unsubscribe@127.0.0.1</unsubscribe> 41 <!--接收邮件的地址--> 42 <post>user@127.0.0.1</post> 43 <!--浏览邮件信息的URL--> 44 <archive>http://127.0.0.1/user/</archive> 45 <otherArchives> 46 <otherArchive>http://base.google.com/base/1/127.0.0.1</otherArchive> 47 </otherArchives> 48 </mailingList> 49 ..... 50 </mailingLists> 51 52 <!--许你配置你的代码库，供Maven web站点和其它插件使用--> 53 <scm> 54 <!--这两个表示我们如何连接到maven的版本库。connection只提供读，developerConnection将提供写的请求--> 55 <connection>scm:svn:http://127.0.0.1/svn/my-project</connection> 56 <developerConnection>scm:svn:https://127.0.0.1/svn/my-project</developerConnection> 57 <!--项目标签，默认HEAD--> 58 <tag>HEAD</tag> 59 <url>http://127.0.0.1/websvn/my-project</url> 60 </scm> 61 62 <!--项目构建的前提--> 63 <prerequisites> 64 <maven>2.0.6</maven> 65 </prerequisites> 66 67 <!--依赖和扩展的远程仓库列表,同setting.xml配置--> 68 <repositories> 69 <repository> 70 <!--种构件的策略--> 71 <releases> 72 <!--决定仓库是否对于各自的类型激活(release 或者 snapshot)--> 73 <enabled>false</enabled> 74 <!--这个元素决定更新频率。maven将比较本地pom的时间戳（存储在仓库的maven数据文件中）和远程的. 有以下选择: always, daily (默认), interval:X (x是代表分钟的整型) ， never--> 75 <updatePolicy>always</updatePolicy> 76 <!--当Maven向仓库部署文件的时候，它也部署了相应的校验和文件。可选的为：ignore，fail，warn，或者不正确的校验和--> 77 <checksumPolicy>warn</checksumPolicy> 78 </releases> 79 <!--种构件的策略--> 80 <snapshots> 81 <!--决定仓库是否对于各自的类型激活(release 或者 snapshot)--> 82 <enabled>true</enabled> 83 <!--这个元素决定更新频率。maven将比较本地pom的时间戳（存储在仓库的maven数据文件中）和远程的. 有以下选择: always, daily (默认), interval:X (x是代表分钟的整型) ， never--> 84 <updatePolicy>never</updatePolicy> 85 <!--当Maven向仓库部署文件的时候，它也部署了相应的校验和文件。可选的为：ignore，fail，warn，或者不正确的校验和--> 86 <checksumPolicy>fail</checksumPolicy> 87 </snapshots> 88 <id>codehausSnapshots</id> 89 <name>Codehaus Snapshots</name> 90 <url>http://snapshots.maven.codehaus.org/maven2</url> 91 <!--在上面描述仓库的时候，提到他们有统一的布局。Maven 2有它仓库默认布局。然而，Maven 1.x有不同布局。使用这个元素来表明它是default还是legacy--> 92 <layout>default</layout> 93 </repository> 94 </repositories> 95 <pluginRepositories> 96 ... 97 </pluginRepositories>
