Maven之pom.xml与setting.xml配置文件详解
一.pom.xml详解1.概述pom中节点如下分布projectxmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http:
文章共39,012字 · 阅读需要大约131分钟
一.Maven相关问题
Maven常用命令
显示maven版本：
mvn -version/-v
显示详细错误 信息:
mvn -e
运行任何检查，验证包是否有效且达到质量标准:
mvn verify
1.编译源代码：
mvn compile
2.编译测试代码：
mvn test-compile
3.运行测试
mvn test
4.打包
mvn package
5.清除产生的项目：
mvn clean
6.只打包不测试
mvn -Dtest package
7.只测试不编译，也不测试编译
mvn test -skipping compile -skipping test-compile
8.查看当前项目已被解析的依赖：
mvn dependency:list
9.上传到私服
mvn deploy
| mvn deploy:deploy-file -DgroupId=com.example -DartifactId=myproject -Dversion=1.0.0 -Dpackaging=jar -Dfile=myproject.jar -DrepositoryId=myrepo -Durl=http://myrepo.com https://www.fke6.com/html/79779.html |
10.配置好了之后执行
mvn clean install -Dmaven.test.skip=false
就能运行那些测试的类了
11.给任何目标添加maven.test.skip 属性就能跳过测试 :
mvn install -Dmaven.test.skip=true
12.mvn compile与mvn install、mvn deploy的区别
mvn compile，编译类文件
mvn install，包含mvn compile，mvn package，然后上传到本地仓库
mvn deploy,包含mvn install,然后，上传到私服
13.常用命令:
1>. 跳过测试:-Dmaven.test.skip(=true)
2>. 指定端口:-Dmaven.tomcat.port=9090
3>. 忽略测试失败:-Dmaven.test.failure.ignore=true 当然,如果你的其它关联项目有过更新的话,一定要在项目根目录下运行mvn clean install来执行更新,再运行mvn tomcat:run使改动生效.
14.mvnDebug tomcat:run
这条命令主要用来远程测试,它会监听远程测试用的8000端口,在eclipse里打开远程测试后,它就会跑起来了,设断点,调试
15.mvn dependency:sources
故名思义,有了它,你就不用到处找源码了,运行一下,你项目里所依赖的jar包的源码就都有了
16.其他
安 装指定文件到本地仓库:mvn install:install-file -DgroupId=<groupId> -DartifactId=<artifactId> -Dversion=1.0.0 -Dpackaging=jar -Dfile=<myfile.jar>
查看实际pom信息: mvn help:effective-pom
分析项目的依赖信息：mvn dependency:analyze 或 mvn dependency:tree
查看帮助信息：mvn help:help 或 mvn help:help -Ddetail=true
查看插件的帮助信息：mvn <plug-in>:help，比如：mvn dependency:help 或 mvn ant:help 等等。
生成站点目录: mvn site
生成站点目录并发布：mvn site-deploy
验证项目是正确的并且所有的信息是可用的:mvn validate
https://www.cnblogs.com/nanao/p/16067663.html
内置属性(Maven预定义,用户可以直接使用)
${basedir}表示项目根目录,即包含pom.xml文件的目录;
${version}表示项目版本;
${project.basedir}同${basedir};
${project.baseUri}表示项目文件地址;
${maven.build.timestamp}表示项目构件开始时间;
${maven.build.timestamp.format}表示属性${maven.build.timestamp}的展示格式,默认值为yyyyMMdd-HHmm,可自定义其格式,其类型可参考
${project.basedir}/lib/alipay-sdk-java20170307171631.jar 本地项目jar包地址
mvn install安装jar到本地仓库
mvn install:install-file -Dfile=jar路径 -DgroupId=组id -DartifactId=组件id
-Dversion=安装版本 -Dpackaging=jar
默认使用C:\Users\用户名\.m2中的setting文件,如果没有则使用maven安装地址conf目录下的setting文件,安装到配置文件中定义的路径
打包到本地库*.pom文件打包不完整的解决思路
当写好基础的jar包打包之后，mvn install 到本地仓库，新建maven项目依赖此jar包，发现基础jar包所依赖的所有jar都没有引入进来。但是经过几番测试发现一下规律：
（1）、在idea中install 的jar包可以正常使用。
（2）、mvn install:install-file -DgroupId=gid -DartifactId=aid -Dversion=version -Dfile=xxx.jar -Dpackaging=jar 命令生成的jar则不会自动导入基础jar包所依赖的jar。
解决思路
1.对比两种方式生成的jar, 发现安装后有的 *.pom的文件内容不一样导致的。
以下是由mvn install:install-file -DgroupId=gid -DartifactId=aid -Dversion=version -Dfile=xxx.jar -Dpackaging=jar生成错误的*.pom
idea也是mvn install 生成的，命令行也是mvn install。 于是猜测是命令少指定了某个参数导致的，于是查阅官方文档：
https://maven.apache.org/plugins/maven-install-plugin/examples/custom-pom-installation.html
于是修改命令 添加参数，正确打包。
| mvn install:install-file -DgroupId=gid -DartifactId=aid -Dversion=version -Dfile=xxx.jar -Dpackaging=jar -DpomFile=本地的pom.xml路径 |
https://blog.csdn.net/qq_16291159/article/details/109576252
maven仓库的优先级顺序
在 maven 中，仓库可以分为：本地仓库、远程仓库。
远程仓库可以分为：中央仓库、私服仓库。
中央仓库是 maven 官方指定的仓库，可以理解为 “寻找的最后一站”。
私服仓库可以是自己建的，也可以是其它主体建的 (比如 aliyun 的 maven 仓库，jboss 的 maven 仓库等)。私服可以分为：全局应用的私服仓库、应用到项目自身的私服仓库。
maven 寻找得顺序大致可以理解为：
1，在本地仓库中寻找，如果没有则进入下一步。
2，在全局应用的私服仓库中寻找，如果没有则进入下一步。
3，在项目自身的私服仓库中寻找，如果没有则进入下一步。
4，在中央仓库中寻找，如果没有则终止寻找。
补充：
1，如果在找寻的过程中，如果发现该仓库有镜像设置，则用镜像的地址代替。
2，如果仓库的 id 设置成 “central”，则该配置会覆盖 maven 默认的中央仓库配置。
mirror相当于一个拦截器，它会拦截 maven 对 remote repository 的相关请求，把请求里的 remote repository 地址，重定向到 mirror 里配置的地址。
<mirrorOf><mirrorOf>
<mirrorOf></mirrorOf> 标签里面放置的是要被镜像的 Repository ID。为了满足一些复杂的需求，Maven 还支持更高级的镜像配置：
<mirrorOf>*</mirrorOf> ：匹配所有远程仓库
<mirrorOf>repo1,repo2</mirrorOf>：匹配仓库 repo1 和 repo2，使用逗号分隔多个远程仓库。
<mirrorOf>*,!repo1</miiroOf>： 匹配所有远程仓库，repo1 除外，使用感叹号将仓库从匹配中排除。
Repository 与 Mirror
其实，mirror 表示的是两个 Repository 之间的关系，在 maven 配置文件（setting.xml )里配置了<mirrors><mirror>..........</mirror></mirrors>，即定义了两个 Repository 之间的镜像关系。
配置两个 Repository 之间的镜像关系，一般是出于访问速度和下载速度考虑。
https://blog.csdn.net/sinat_39809957/article/details/127404382
releases 和 snapshots
在 pom.xml 中，经常会看到代码仓库中的某些项目版本以 release 或 snapshots 结尾
开发标准：snapshots 版本代表正在开发中的版本，release 代表比较稳定的发布版本.
对于上面的 <repositories></repositories> releases=true、snapshots=false，表示只会去仓库查找稳定版本，不回去查找开发中的版本
file协议设置镜像为本地文件
了解mirror
配置私服的
| <mirror> <id>nexus</id> <mirrorOf>central</mirrorOf> <name>internal nexus repository</name> <url>http://localhost:8081/nexus/content/groups/public/</url>这一段配置，描述的便是 上一步中提到的那个Public Reposiories的信息，这个地址便是他的地址，这些写都可以再界面上看到 </mirror>这里的是localhost是在本机搭建测试用的,如果是公司内部的仓库的话，可自行修改成公司内网ip地址。 </mirrors> https://blog.csdn.net/qq_37394476/article/details/124185814 |
File协议
| <mirror> </mirror> linux同样认此协议 <url>file:///root/.m2/repo</url> |
插件仓库配置file协议
| <profiles> <profile> <id>maven-local</id> <repositories> <repository> <id>maven-local</id> <url>file:///D:/.m2/repository</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <!-- 插件库，应对一些自定义插件下载不到情况 --> <pluginRepository> <id>central</id> <url>file:///D:/.m2/repository</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>false</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile> </profiles> <activeProfiles> <activeProfile>maven-local</activeProfile> </activeProfiles> |
文件协议file///
打开本地或网络驱动器上的文件。
句法
| file:///sDrives[|sFile] sDrives 指定本地或网络驱动器。 sFile 可选。指定要打开的文件。如果省略sFile并且访问驱动器的帐户有权浏览目录，则会显示可访问文件和目录的列表。 |
文件协议和sDrives参数可以省略，只替换为驱动器号和文件位置的命令行表示。例如，要浏览 My Documents 目录，可以将文件协议指定为 file:///C|/My Documents/ 或 C:\My Documents\。此外，单个“\”相当于指定主本地驱动器上的根目录。在大多数计算机上，这是 C:\。
下面的示例演示了四种使用 File 协议的方法。
| //Specifying a drive and a file name. file:///C|/My Documents/ALetter.html //Specifying only a drive and a path to browse the directory. file:///C|/My Documents/ //Specifying a drive and a directory using the command line representation of the directory location. C:\My Documents\ //Specifying only the directory on the local primary drive. \My Documents\ |
file协议只能在本地访问
本地搭建http服务器开放端口后他人也可以通过http访问到你电脑中的文件，但是file协议做不到
file协议对应有一个类似http的远程访问，就是ftp协议，即文件传输协议。
file协议无法实现跨域
https://docs.microsoft.com/en-us/previous-versions//aa767731(v=vs.85)?redirectedfrom=MSDN
scope:system
引入本地jar包
| <dependency> |
概述：
maven 的<dependency>的scope属性可以为system，因为有些你依赖的jar包可能是没有maven坐标的，它完全不在maven体系中，这时候你可以把它下载到本地硬盘，然后通过system来引用
不过不推荐使用system，因为一个项目的pom.xml如果使用了scope为system的depend后，会导致传递依赖中断，即所有其他依赖本项目的项目都无法传递依赖了。
比如：假设A项目依赖了m.jar, n.jar, x.jar, 然后我们把A项目打包成了a.jar, 如果此时B项目依赖了A项目，则B项目通常自然就已经默认传递依赖了m.jar, n.jar, x.jar。
但是如果A项目的pom.xml文件出现了scope为system的depend,则B项目就只能依赖a.jar, 将无法传递依赖m.jar, n.jar, x.jar
解决方案：
1、使用maven私服，这样就不需要设置scope为system了
- 由于scope设置的system会导致第三方jar的依赖传递中断，这就会导致缺少第三方jar需要的一些依赖，这个就需要人工补齐缺少的dependency，或者第三方如果有源码，可以作为module引入项目，这样也可以解决
解决打包时scope为system的jar没有打进jar的问题：
主要起作用的是：
<configuration>
<!--将scope为system的依赖也打进jar包-->
<includeSystemScope>true</includeSystemScope>
</configuration>
| <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <configuration> <!--将scope为system的依赖也打进jar包--> <includeSystemScope>true</includeSystemScope> </configuration> </plugin> </plugins> <!--如果不加package打包中没有mapper.xml文件--> <resources> <resource> <directory>src/main/resources</directory> <filtering>true</filtering> </resource> <resource> <directory>src/main/java</directory> <includes> <include>**/*.properties</include> <include>**/*.xml</include> </includes> </resource> </resources> </build> |
https://blog.csdn.net/b13001216978/article/details/118438998
Maven仓库文件
lastUpdated
Maven在下载仓库中找不到相应资源时，会生成一个.lastUpdated为后缀的文件
假设我们更换了私服地址,并且该私服不存在该资源,那么就会生成xxxx.lastUpdated
_remote.repositories
_remote.repositories的作用是当maven本地仓库缓存了jar/pom的情况下修改了maven的配置文件(settings.xml)后依然会去远程仓库获取。
也就是说,_remote.repositories文件，标示该资源的来源，如果你有这个_remote.repositories，那就会在访问本地的同时，必须确保远程上有才行(这里的远程是setting文件中配置的镜像或远程仓库,用id来进行关联)，否则就会报错;
如果文件从私服下载,后因为网络问题连不上私服,可以把_remote.repositories删除,然后重新Reload All Maven Project,刷新下项目,重启idea
以org.slf4j:slf4j-api-1.5.6.jar为例，本地仓库中的_remote.repositories文件内容如下：
| #NOTE: This is a Maven Resolver internal implementation file, its format can be changed without prior notice. #Thu Jan 28 21:37:13 CST 2021 slf4j-api-1.5.6.jar>alimaven= slf4j-api-1.5.6.jar>central= slf4j-api-1.5.6.pom>alimaven= slf4j-api-1.5.6.pom>central= |
其中alimaven是我的maven配置文件中的私服id。
https://blog.csdn.net/lovepeacee/article/details/103094247
*.pom
管理描述文件
Pom文件记录了jar包自身的依赖,如果idea引入此jar包,没有解析到自身的依赖,说明传递依赖失败,应检查此文件,此文件是maven私服生成的
关于jar包依赖传递性的问题
maven实现原理
maven工具通过dependency标签和坐标查找指定的jar包文件
maven加载完成jar包之后，扫描当前文件的xxx.pom文件
之后根据坐标继续添加jar包依赖项，直到将所有的依赖信息全部加载完成
https://blog.csdn.net/u010898329/article/details/106056990
*.sha1
校验文件
maven下载的jar包文件中会有一个.sha1的文件，用于保证下载jar包的安全性
SHA1算法
SHA-1(Secure Hash Algorithm 1,安全散列算法1)是一种密码散列函数，美国国家安全局设计，并由美国国家标准技术研究所（NIST）发布为联邦数据处理标准（FIPS）。SHA-1可以生成一个被成为消息摘要的160位(20字节)散列值，散列值通常时1呈现形式为40个十六进制数。0-9 A-F
eclipse遇到的问题
一、应用场景
项目在内网构建，为了能使用maven2，只能使用本地仓库依赖策略。
但是，有时候明明本地仓库确确实实存在相应的依赖包，但是在eclipse环境下依然会报错，即：在pom.xml显示错误提示信息。
可以通过如下方式解决。
二、示例讲解
以依赖commons-io-2.0.1为例讲解：
在pom.xml中配置：
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.0.1</version>
</dependency>
三、解决方案
1、
首先，从其他可以在外网下载相应依赖包的地方下载好相应的依赖包到本地仓库，再将该本地仓库拷贝到项目相应位置，便于引用。
2、安装Maven2并进行相应配置，关于Maven2具体安装和配置，略过。
注意：在Maven2的配置文件setting.xml一定要修改如下属性：
<offline>true</offline>
该属性配置默认为false，因为是在内网，无法到外网下载依赖包，所以一定要配置离线属性为true。
3、如果本地仓库确实存在该依赖包，且eclipse没有报错，那么在本地仓库中找到该依赖包所在的位置，相应目录下必定存在如下6个文件：
_maven.repositories
commons-io-2.0.1.jar
commons-io-2.0.1.jar.sha1
commons-io-2.0.1.pom
commons-io-2.0.1.pom.sha1
m2e-lastUpdated.properties
依赖配置正确且eclipse没有报错时依赖包目录下包含的文件
当然，如下载了源码的话，应该还包括如下2个文件：
commons-io-2.0.1-sources.jar
commons-io-2.0.1-sources.jar.sha1
所以，如果当本地仓库中确实存在相应的依赖jar包，但是在eclipse中依然报错的话，请进入到相应依赖包的目录位置，观察该目录下是否对应的6个文件。
通常情况下，当在eclipse中报错的话，在依赖包目录下还存在一个“xxx.lastUpdated”文件。
如果确实存在“xxx.lastUpdated”文件的话，请先删除该文件。并确认是否存在如下2个文件：
_maven.repositories
m2e-lastUpdated.properties
通常在eclipse中报错的话，是不会存在这2个文件的，到别的依赖正确的jar包目录下去拷贝这2个文件到当前目录下，并修改相应私服id
完成后，在eclipse中clean一下项目，并执行“Maven->Update
Project...”
https://zhidao.baidu.com/question/2144469377992920868.html
Jar包版本升级
对于私服上jar包冲突问题,可通过升级版本号来解决,升级内容包括
- jar包本身的版本号
- jar包依赖的jar包版本号
- jar包的parent父pom文件版本号
注意,同名不同版本的jar包,idea优先使用高本版jar包
二.pom文件配置
1.概述
pom中节点如下分布
| <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>...</groupId> <artifactId>...</artifactId> <version>...</version> <packaging>...</packaging> <!-- 依赖配置 --> <dependencies>...</dependencies> <parent>...</parent> <dependencyManagement>...</dependencyManagement> <modules>...</modules> <properties>...</properties> <!-- 构建配置 --> <build>...</build> <reporting>...</reporting> <!-- 项目信息 --> <name>...</name> <description>...</description> <url>...</url> <inceptionYear>...</inceptionYear> <licenses>...</licenses> <organization>...</organization> <developers>...</developers> <contributors>...</contributors> <!-- 环境设置 --> <issueManagement>...</issueManagement> <ciManagement>...</ciManagement> <mailingLists>...</mailingLists> <scm>...</scm> <prerequisites>...</prerequisites> <repositories>...</repositories> <pluginRepositories>...</pluginRepositories> <distributionManagement>...</distributionManagement> <profiles>...</profiles> </project> |
2.基本配置
modelVersion：pom模型版本，maven2和3只能为4.0.0
groupId：组ID，maven用于定位
artifactId：在组中的唯一ID用于定位
version：项目版本
packaging：项目打包方式，有以下值：pom, jar, maven-plugin, ejb, war, ear, rar, par
3.依赖配置
3.1 parent
用于确定父项目的坐标。
| <parent> <groupId>com.learnPro</groupId> <artifactId>SIP-parent</artifactId> <relativePath></relativePath> <version>0.0.1-SNAPSHOT</version> </parent> |
groupId：父项目的构件标识符
artifactId：父项目的唯一标识符
relativePath：Maven首先在当前项目的找父项目的pom，然后在文件系统的这个位置（relativePath），然后在本地仓库，再在远程仓库找。
version：父项目的版本
3.2 modules
有些maven项目会做成多模块的，这个标签用于指定当前项目所包含的所有模块。之后对这个项目进行的maven操作，会让所有子模块也进行相同操作。
| <modules> <module>com-a</> <module>com-b</> <module>com-c</> </> |
3.3 properties
用于定义pom常量
| <properties> <java.version>1.7</java.version> </properties> |
上面这个常量可以在pom文件的任意地方通过${java.version}来引用
3.4 dependencies
项目相关依赖配置，如果在父项目写的依赖，会被子项目引用，一般父项目会将子项目公用的依赖引入（将在之后详细讲解）
| <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.12</version> </dependency> </dependencies> |
这边依赖和中央仓库中的一致，就可以引入对应的jar
scope
Dependency scope 是用来限制Dependency的作用范围的, 影响maven项目在各个生命周期时导入的package的状态。
compile
默认的scope，表示 dependency 都可以在生命周期中使用。而且，这些dependencies 会传递到依赖的项目中。
provided
跟compile相似，但是表明了dependency 由JDK或者容器提供，例如Servlet AP和一些Java EE APIs。这个scope 只能作用在编译和测试时，同时没有传递性。
使用这个时，不会将包打入本项目中，只是依赖过来。
使用默认或其他时，会将依赖的项目打成jar包，放入本项目的Lib里
runtime
表示dependency不作用在编译时，但会作用在运行和测试时
test
表示dependency作用在测试时，不作用在运行时。
system
跟provided 相似，但是在系统中要以外部JAR包的形式提供，maven不会在repository查找它。 例如：
| <dependency> ${project.basedir} |
import (Maven 2.0.9 之后新增)
它只使用在<dependencyManagement>中，表示从其它的pom中导入dependency的配置
3.5 dependencyManagement
配置写法同dependencies
| <dependencyManagement> <dependencies> ..... </dependencies> </dependencyManagement> |
在父模块中定义后，子模块不会直接使用对应依赖，但是在使用相同依赖的时候可以不加版本号：
父项目：
| <dependencyManagement> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.12</version> <scope>test</scope> </dependency> </dependencies> </dependencyManagement> |
子项目：
| <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> </dependency> |
这样的好处是，父项目统一了版本，而且子项目可以在需要的时候才引用对应的依赖
4.构建配置
4.1 build
用于配置项目构建相关信息
| <build> <!--该元素设置了项目源码目录，当构建项目的时候，构建系统会编译目录里的源码。该路径是相对于pom.xml的相对路径。 --> <sourceDirectory /> <!--该元素设置了项目脚本源码目录，该目录和源码目录不同：绝大多数情况下，该目录下的内容 会被拷贝到输出目录(因为脚本是被解释的，而不是被编译的)。 --> <scriptSourceDirectory /> <!--该元素设置了项目单元测试使用的源码目录，当测试项目的时候，构建系统会编译目录里的源码。该路径是相对于pom.xml的相对路径。 --> <testSourceDirectory /> <!--被编译过的应用程序class文件存放的目录。 --> <outputDirectory /> <!--被编译过的测试class文件存放的目录。 --> <testOutputDirectory /> <!--使用来自该项目的一系列构建扩展 --> <extensions> <!--描述使用到的构建扩展。 --> <extension> <groupId /> <artifactId /> <version /> </extension> </extensions> <!--当项目没有规定目标（Maven2 叫做阶段）时的默认值 --> <defaultGoal /> <!--这个元素描述了项目相关的所有资源路径列表，例如和项目相关的属性文件，这些资源被包含在最终的打包文件里。 --> <resources> <!--这个元素描述了项目相关或测试相关的所有资源路径 --> <resource> <!--是否使用参数值代替参数名。参数值取自properties元素或者文件里配置的属性，文件在filters元素里列出。 --> <filtering /> <!--描述存放资源的目录，该路径相对POM路径 --> <directory /> <!--包含的模式列表，例如**/*.xml. --> <includes /> <!--排除的模式列表，例如**/*.xml --> <excludes /> <!-- 描述了资源的目标路径。该路径相对target/classes目录（例如${project.build.outputDirectory}）。举个例子，如果你想资源在特定的包里(org.apache.maven.messages)，你就必须该元素设置为org/apache/maven /messages。然而，如果你只是想把资源放到源码目录结构里，就不需要该配置。 --> <targetPath /> </resource> </resources> <!--这个元素描述了单元测试相关的所有资源路径，例如和单元测试相关的属性文件。 --> <testResources> <!--这个元素描述了测试相关的所有资源路径，参见build/resources/resource元素的说明 --> <testResource> <targetPath /> <filtering /> <directory /> <includes /> <excludes /> </testResource> </testResources> <!--构建产生的所有文件存放的目录 --> <directory /> <!--产生的构件的文件名，默认值是${artifactId}-${version}。 --> <finalName /> <!--当filtering开关打开时，使用到的过滤器属性文件列表 --> <filters />
<!--子项目可以引用的默认插件信息。该插件配置项直到被引用时才会被解析或绑定到生命周期。给定插件的任何本地配置都会覆盖这里的配置 --> <pluginManagement> <!--使用的插件列表 。 --> <plugins> <!--plugin元素包含描述插件所需要的信息。 --> <plugin> <groupId /> <artifactId /> <version /> <!--是否从该插件下载Maven扩展（例如打包和类型处理器），由于性能原因，只有在真需要下载时，该元素才被设置成enabled。 --> <extensions /> <!--在构建生命周期中执行一组目标的配置。每个目标可能有不同的配置。 --> <executions> <!--execution元素包含了插件执行需要的信息 --> <execution> <!--执行目标的标识符，用于标识构建过程中的目标，或者匹配继承过程中需要合并的执行目标 --> <id /> <!--绑定了目标的构建生命周期阶段，如果省略，目标会被绑定到源数据里配置的默认阶段 --> <phase /> <!--配置的执行目标 --> <goals /> <!--配置是否被传播到子POM --> <inherited /> <!--作为DOM对象的配置 --> <configuration /> </execution> </executions> <!--项目引入插件所需要的额外依赖 --> <dependencies> <!--参见dependencies/dependency元素 --> <dependency> ...... </dependency> </dependencies> <!--任何配置是否被传播到子项目 --> <inherited /> <!--作为DOM对象的配置 --> <configuration /> </plugin> </plugins> </pluginManagement> <!--使用的插件列表 --> <plugins> <!--参见build/pluginManagement/plugins/plugin元素 --> <plugin> <groupId /> <artifactId /> <version /> <extensions /> <executions> <execution> <id /> <phase /> <goals /> <inherited /> <configuration /> </execution> </executions> <dependencies> <!--参见dependencies/dependency元素 --> <dependency> ...... </dependency> </dependencies> <goals /> <inherited /> <configuration /> </plugin> </plugins> </build> |
4.2 reporting
该元素描述使用报表插件产生报表的规范。当用户执行“mvn site”，这些报表就会运行。 在页面导航栏能看到所有报表的链接。
| <reporting> <!--true，则，网站不包括默认的报表。这包括“项目信息”菜单中的报表。--> <excludeDefaults/> <!--所有产生的报表存放到哪里。默认值是${project.build.directory}/site。--> <outputDirectory/> <!--使用的报表插件和他们的配置。--> <plugins> <!--plugin元素包含描述报表插件需要的信息--> <plugin> <!--报表插件在仓库里的group ID--> <groupId/> <!--报表插件在仓库里的artifact ID--> <artifactId/> <!--被使用的报表插件的版本（或版本范围）--> <version/> <!--任何配置是否被传播到子项目--> <inherited/> <!--报表插件的配置--> <configuration/> <!--一组报表的多重规范，每个规范可能有不同的配置。一个规范（报表集）对应一个执行目标 。例如，有1，2，3，4，5，6，7，8，9个报表。1，2，5构成A报表集，对应一个执行目标。2，5，8构成B报表集，对应另一个执行目标--> <reportSets> <!--表示报表的一个集合，以及产生该集合的配置--> <reportSet> <!--报表集合的唯一标识符，POM继承时用到--> <id/> <!--产生报表集合时，被使用的报表的配置--> <configuration/> <!--配置是否被继承到子POMs--> <inherited/> <!--这个集合里使用到哪些报表--> <reports/> </reportSet> </reportSets> </plugin> </plugins> </reporting> |
5.项目信息
name：给用户提供更为友好的项目名
description：项目描述，maven文档中保存
url：主页的URL，maven文档中保存
inceptionYear：项目创建年份，4位数字。当产生版权信息时需要使用这个值
licenses：该元素描述了项目所有License列表。 应该只列出该项目的license列表，不要列出依赖项目的license列表。如果列出多个license，用户可以选择它们中的一个而不是接受所有license。（如下）
| <license> <!--license用于法律上的名称--> <name>...</name> <!--官方的license正文页面的URL--> <url>....</url> <!--项目分发的主要方式：repo，可以从Maven库下载 manual， 用户必须手动下载和安装依赖--> <distribution>repo</distribution> <!--关于license的补充信息--> <comments>....</comments> </license> |
organization：1.name组织名2.url组织主页url
developers：项目开发人员列表（如下）
contributors：项目其他贡献者列表，同developers
| <developers> <!--某个开发者信息 --> <developer> <!--开发者的唯一标识符 --> <id>....</id> <!--开发者的全名 --> <name>...</name> <!--开发者的email --> <email>...</email> <!--开发者的主页 --> <url> ... <url /> <!--开发者在项目中的角色 --> <roles> <role>Java Dev</role>
<role>Web UI</role>
</roles> <!--开发者所属组织 -->
<organization>sun</organization> <!--开发者所属组织的URL --> <organizationUrl>...</organizationUrl> <!--开发者属性，如即时消息如何处理等 --> <properties> <!-- 和主标签中的properties一样，可以随意定义子标签 --> </properties> <!--开发者所在时区， -11到12范围内的整数。 --> <timezone>-5</timezone> </developer> </developers>
|
6.环境设置
6.1 issueManagement
目的问题管理系统(Bugzilla, Jira, Scarab)的名称和URL
| <issueManagement> <system>Bugzilla</system> <url>http://127.0.0.1/bugzilla/</url> </issueManagement> |
system：系统类型
url：路径
6.2 ciManagement
项目的持续集成信息
| <ciManagement> <system>continuum</system> <url>http://127.0.0.1:8080/continuum</url> <notifiers> <notifier> <type>mail</type> <sendOnError>true</sendOnError> <sendOnFailure>true</sendOnFailure> <sendOnSuccess>false</sendOnSuccess> <sendOnWarning>false</sendOnWarning> <address>continuum@127.0.0.1</address> <configuration></configuration> </notifier> </notifiers> </ciManagement> |
system：持续集成系统的名字
url：持续集成系统的URL
notifiers：构建完成时，需要通知的开发者/用户的配置项。包括被通知者信息和通知条件（错误，失败，成功，警告）
type：通知方式
sendOnError：错误时是否通知
sendOnFailure：失败时是否通知
sendOnSuccess：成功时是否通知
sendOnWarning：警告时是否通知
address：通知发送到的地址
configuration：扩展项
6.3 mailingLists
项目相关邮件列表信息
| <mailingLists> <mailingList> <name>User List</name> <subscribe>user-subscribe@127.0.0.1</subscribe> <unsubscribe>user-unsubscribe@127.0.0.1</unsubscribe> <post>user@127.0.0.1</post> <archive>http://127.0.0.1/user/</archive> <otherArchives> <otherArchive>http://base.google.com/base/1/127.0.0.1</otherArchive> </otherArchives> </mailingList> ..... </mailingLists> |
subscribe, unsubscribe: 订阅邮件（取消订阅）的地址或链接，如果是邮件地址，创建文档时，mailto:链接会被自动创建
archive：浏览邮件信息的URL
post：接收邮件的地址
6.4 scm
允许你配置你的代码库，供Maven web站点和其它插件使用
| <scm> <connection>scm:svn:http://127.0.0.1/svn/my-project</connection> <developerConnection>scm:svn:https://127.0.0.1/svn/my-project</developerConnection> <tag>HEAD</tag> <url>http://127.0.0.1/websvn/my-project</url> </scm> |
connection, developerConnection：这两个表示我们如何连接到maven的版本库。connection只提供读，developerConnection将提供写的请求
写法如：scm:[provider]:[provider_specific]
如果连接到CVS仓库，可以配置如下：scm:cvs:pserver:127.0.0.1:/cvs/root:my-project
tag：项目标签，默认HEAD
url：共有仓库路径
6.5 prerequisites
项目构建的前提
| <prerequisites> <maven>2.0.6</maven> </prerequisites> |
6.6 repositories与pluginRepositories
依赖和扩展的远程仓库列表，同setting.xml配置中介绍的。
| <repositories>
|
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。
6.7 distributionManagement
它管理的分布在整个构建过程生成的工件和支持文件
| <distributionManagement> ... <downloadUrl>http://mojo.codehaus.org/my-project</downloadUrl> <status>deployed</status> </distributionManagement> |
downloadUrl: 其他pom可以通过此url的仓库抓取组件
status：给出该构件在远程仓库的状态
none: 默认
converted: 将被早期Maven 2 POM转换过来
partner: 这个项目会从合作者仓库同步过来
deployed: 从Maven 2或3实例部署
verified: 被核实时正确的和最终的
repository
指定Maven pom从远程下载控件到当前项目的位置和方式，如果snapshotRepository没有被定义则使用repository相关的配置
| <distributionManagement> <repository> <uniqueVersion>false</uniqueVersion> <id>corp1</id> <name>Corporate Repository</name> <url>scp://repo/maven2</url> <layout>default</layout> </repository> <snapshotRepository> <uniqueVersion>true</uniqueVersion> <id>propSnap</id> <name>Propellors Snapshots</name> <url>sftp://propellers.net/maven</url> <layout>legacy</layout> </snapshotRepository> ... </distributionManagement> |
id, name：仓库的唯一标识
uniqueVersion：true或false，指明控件部署的时候是否获取独立的版本号。
url：repository元素的核心。指定位置和部署协议发布控件到仓库。
layout：布局，default或legacy
site
多分布存储库,distributionManagement负责定义如何部署项目的网站和文档。
| <distributionManagement> ... <site> <id>mojo.website</id> <name>Mojo Website</name> <url>scp://beaver.codehaus.org/home/projects/mojo/public_html/</url> </site> ... </distributionManagement> |
id, name, url: 这些元素与distributionManagement repository中的相同
relocation
重新部署-项目不是静态的，是活的。他们需要被搬到更合适的地方。如：当你的下个成功的开源项目移到Apache下，重命名为org.apache:my-project:1.0对你项目更有好处。
| <distributionManagement> ... <relocation> <groupId>org.apache</groupId> <artifactId>my-project</artifactId> <version>1.0</version> <message>We have moved the Project underApache</message> </relocation> ... </distributionManagement> |
6.8 profiles
配置重点-可以让我们定义一系列的配置信息，然后指定其激活条件。
根据每个profile对应不同的激活条件和配置信息，从而达到不同环境使用不同配置。
例子：通过profile定义jdk1.5以上使用一套配置，jdk1.5以下使用另外一套配置；或者通过操作系统来使用不同的配置信息。Setting文件下同样有一个此类属性,相关配置进行对比参考setting文件配置-profiles
实战:
| POM文件: <profiles> <mail.switch>false</mail.switch> <mail.switch>true</mail.switch> properties文件 jdbc.url=jdbc:mysql://${p.jdbc.url}?characterEncoding=utf-8&allowMultiQueries=true mail.switch=${mail.switch} JAVA文件 private static final String MAIL_SMTP_SWITCH = PropertiesUtil.getMailValue("mail.switch"); |
配置命令:idea打开:Run-Edit Configurations-Add New configuratons-Maven
在Parameters-Command line输入mvn package -P uat,其中mvn package是打包的意思,-P是有参数打包意思,执行id为uat的配置
或者直接在Maven的选项卡上输入命令
三.setting文件配置
1.文件概览
| <?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"> <localRepository/> <interactiveMode/> <offline/> <pluginGroups/> <servers/> <mirrors/> <proxies/> <profiles/> <activeProfiles/> </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 |
2.localRepository
localRepository用于构建系统的本地仓库的路径。
默认的值是${user.home}/.m2/repository。
| Default: ${user.home}/.m2/repository <localRepository>/path/to/local/repo</localRepository> |
3.interactiveMode
interactiveMode 用于决定maven是否在需要输出的时候提示你，默认true。如果是false，它将使用合理的默认值，或者基于一些设置。
4.offline
决定maven是否在构建的时候进行网络传输。
默认false，表示联网状态，true为取消联网。
在某些情况下设置为true是很有用的，比如jar无法从网上下载等
5.pluginGroups
pluginGroups 插件组
| <pluginGroups> <pluginGroup>org.mortbay.jetty</pluginGroup> </pluginGroups> |
这样Maven可以使用简单的命令执行org.morbay.jetty:jetty-maven-plugin:run
| mvn jetty run |
我们同样可以在pom文件中看到相似的配置，只是在这配置了就起到全局的作用，而不用每个项目中pom配置jetty
6.proxies
此项用于设置http代理
有时候由于安全问题，需要配置http代理，通过代理服务才能正常访问外部仓库下载资源可以ping repo1.maven.org来访问中央仓库
telnet 218.14.227.197 3128 来查看代理地址以及端口是否畅通
| <proxies> <proxy> <id>optional</id> <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> |
id：proxy的唯一标识，用来区别proxy元素。
active：表示是否激活代理，如果配置多个，默认是第一个生效
username，password：提供连接代理服务器时的认证。
host，port：主机地址，端口号
nonProxyHosts：用来表示哪些主机名不需要代理，可以用|来分
割多个，此外也支持通配符，
如：*.goole.com表示所有以goole.com结尾的都不需要通过代理
7.servers
这是一个认证配置的列表,根据系统中使用的server-id控制。认证配置在maven连接到远程服务时使用。
| <servers> <!--使用登录方式--> <server> <id>deploymentRepo</id> <username>repouser</username> <password>repopwd</password> </server> <!-- 使用秘钥认证 --> <server> <id>siteServer</id> <privateKey>/path/to/private/key</privateKey> <passphrase>可空</passphrase> </server> </servers> |
8.mirrors
指定镜像仓库位置用于从远程仓库下载资源
repository
repository就是个仓库.maven里有两种仓库，本地仓库和远程仓库。远程仓库相当于公共的仓库，大家都能看到。本地仓库是你本地的缓存副本，只有你看的到，主要起缓存作用。当你向仓库请求插件或依赖的时候，会先检查本地仓库里是否有。如果有则直接返回，否则会向远程仓库请求，并被缓存到本地仓库。远程仓库可以在工程的pom.xml文件里指定。本地仓库默认在你本地的用户目录下的.m2/repository目录下。
| //目标仓库 <repository> <snapshots> |
mirror
mirror就是镜像，主要提供一个方便地切换远程仓库地址的途径。
比如，上班的时候在公司，用电信的网络，连的是电信的仓库。回到家后，是网通的网络，我想连网通的仓库，就可以通过mirror配置，统一把我工程里的仓库地址都改成联通的，而不用到具体工程pom配置文件里一个个地改地址。比如给上面id为central的远程仓库做个镜像。
| <mirror> |
<mirrorOf>的值为central,表示该配置为中央仓库的镜像,任何对于中央仓库的请求,都会转至该镜像
以后向central这个仓库发的请求都会发到http://my.repository.com/repo/path而不是http://repo1.maven.org/maven2,简单而言, mirror可以拦截对远程仓库的请求 , 改变对目标仓库的下载地址
<mirrorOf>central</mirrorOf>里是要替代的仓库的id。如果填*，就会替代所有仓库。所有的仓库都被镜像到这个url
私服
关于镜像的一个更为常见的用法是结合私服,由于私服可以代理任何外部的公共仓库(包括中央仓库),因此对于组织内部的maven用户来说,使用一个私服地址就等于使用了所有需要的外部仓库,这样可以将配置集中到私服,从而简化maven本身的配置,在这种情况下,任何需要的构件都可以从私服获得,私服就是所有仓库的镜像,这时,可以把<mirrorOf>的值改为*,标识该配置是所有maven仓库的镜像,任何对于远程仓库的请求都会转到http://my.repository.com/repo/path,如果该镜像仓库需要认证,则配置一个id为mirrorId的<server>即可
如果想有些仓库使用镜像,有些仓库不想被镜像,可以在pom文件中配置,
| <repositories> </repositories> |
也可以在setting文件中配置
| <profiles> |
mirror中的mirrorOf不要配置为*或者maven-aliyun
高级配置
为满足一些复杂的需求,maven还支持更高级的镜像配置
| <mirrorOf>*</mirrorOf>:匹配所有远程仓库 当您使用高级语法并配置多个镜像时，声明顺序很重要。当 Maven 查找某个存储库的镜像时，它首先检查<mirrorOf>与存储库标识符完全匹配的镜像。如果没有找到直接匹配，Maven 会根据上述规则（如果有）选择第一个匹配的镜像声明。因此，您可以通过更改定义的顺序来影响匹配顺序settings.xml |
如果maven的setting.xml中配置了镜像mirror , 而镜像mirror配置里mirrorOf的规则，匹配到目标仓库时 ,maven认为目标仓库被镜像了, 不会再去被镜像仓库下载依赖jar包, 而是直接去镜像仓库下载。即maven里面设置的repository会被setting.xml里面的mirror所屏蔽。
| 镜像仓库: |
镜像配置的规则 <mirrorOf>repotest</mirrorOf> 匹配到目标仓库 <id>repotest</id>，所以maven认为目标仓库repotest被镜像了, 不再去https://repo.maven.apache.org/maven2/地址下载jar包，而是去镜像仓库http://maven.aliyun.com/nexus/content/groups/public/下载jar包。
需要注意的是,由于镜像仓库完全屏蔽了被镜像仓库,当镜像仓库不稳定或者停止服务的时候,maven仍将无法访问被镜像仓库,因此无法下载构件
mirror的mirrorOf不能和任何mirror的id一致，因为id在setting中唯一，mirrorOf要和库的id一致，所以势必不能和mirror的id一致
默认仓库
maven下面的pom.xml的中央仓库，缺省了模板仓库id为central，url为maven中央仓库url：https://repo.maven.apache.org/maven2/。默认包含的主 Maven 中央存储库的 ID 是central
| # 默认中央仓库 |
配置多个镜像时的使用顺序
精确匹配 > 通配符匹配(*)
配置优先级
需要注意的是：局部配置优先于全局配置。
配置优先级从高到低：pom.xml> user settings > global settings
如果这些文件同时存在，在应用配置时，会合并它们的内容，如果有重复的配置，优先级高的配置会覆盖优先级低的。
Setting.xml中repository的配置与pom.xml中repository的配置有什么不同?
Setting.xml中配置repository与pom.xml中配置repository的作用是相同的，都是为了指定多个存储库的使用(you can specify the use of multiple repositories)。但在pom.xml中配置只对当前项目与子项目有用，而在setting.xml中配置为全局性配置，用于所用的项目。
参考:
mirrorof的官方文档解:Maven – Guide to Mirror Settings
maven的setting配置文件中mirror和repository的区别 - 简书
mirror镜像和repository远程仓库、mirrorof - 简书
9.profiles
配置重点
1. settings.xml中时意味着该profile是全局的，所以只能配置范围宽泛一点配置信息，比如远程仓库等。而一些比较细致一点的需要定义在项目的pom.xml中。
2.profile可以让我们定义一系列的配置信息，然后指定其激活条件。
根据每个profile对应不同的激活条件和配置信息，从而达到不同环境使用不同配置。
例子：通过profile定义jdk1.5以上使用一套配置，jdk1.5以下使用另外一套配置；或者通过操作系统来使用不同的配置信息。
3.settings.xml中的信息有repositories、pluginRepositories和properties。定义在properties的值可以在pom.xml中使用。
activation
| <profiles> |
jdk：检测到对应jdk版本就激活
os：针对不同操作系统
property：当maven检测到property（pom中如${name}这样的）profile将被激活
file：如果存在文件，激活，不存在文件激活
通过以下命令查看哪些profile将生效
| mvn help:active-profiles |
properites
Maven的属性是值占位符，如果X是一个属性的话，在POM中可以使用${X}来进行任意地方的访问。他们来自于五种不同的风格，所有都可以从settings.xml文件中访问到。
1.env.x：“env.”前缀会返回当前的环境变量。如${env.PATH}就是使用了$path环境变量（windosws中的%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系统属性：通过java.lang.System.getProperties()来访问的属性都可以像POM中的属性一样访问，例如：${java.home}
5.x：被<properties/>或者外部文件定义的属性，值可以这样访问${someVar}
| <profiles> |
上面这个profile如果被激活，那么在pom中${user.install}就可以被访问了。
Repositories
名为仓库，解决项目依赖的第三方jar包存放位置，以及多个项目公用第三方jar包。
repositories是远程项目集合maven用来移植到本地仓库用于构建系统。如果来自本地仓库，Maven调用它的插件和依赖关系。不同的远程仓库可能包含不同的项目，当profile被激活，他们就会需找匹配的release或者snapshot构件。
| <profiles> |
1.releases，snapshots：这是各种构件的策略，release或者snapshot。这两个集合，POM就可以根据独立仓库任意类型的依赖改变策略。如：一个人可能只激活下载snapshot用来开发。
2.enable：true或者false，决定仓库是否对于各自的类型激活(release或者snapshot)。
3.updatePolicy:这个元素决定更新频率。maven将比较本地pom的时间戳（存储在仓库的maven数据文件中）和远程的.有以下选择: always, daily (默认), interval:X (x是代表分钟的整型)，never.
4.checksumPolicy：当Maven向仓库部署文件的时候，它也部署了相应的校验和文件。可选的为：ignore，fail，warn，或者不正确的校验和。
5.layout：在上面描述仓库的时候，提到他们有统一的布局。Maven 2有它仓库默认布局。然而，Maven 1.x有不同布局。使用这个元素来表明它是default还是legacy。
pluginRepositories
pluginRepositories 名为插件仓库，存放maven插件的仓库，告诉项目您使用的插件应该去什么地方下载,字段和用法与repositories中的repository基本一致。
10.activeProfiles
| <activeProfiles> |
每个activeProfile元素对应一个profile id的值，任何profile id被定义到activeProfile的profile将被激活。
Pom:Maven实战（三）--Pom.xml详解-CSDN博客
Setting:Maven实战（二）--setting.xml详解_maven 3.6setting-CSDN博客
整合:https://blog.csdn.net/qq877507054/article/details/79138294?spm=1001.2014.3001.5501
旨在为数千万中国开发者提供一个无缝且高效的云端环境，以支持学习、使用和贡献开源项目。
更多推荐
11
0- 0
已为社区贡献3条内容
所有评论(0)