文章目录
- 一、setting.xml 配置文件结构
- 二、localRepository
- 三、mirrors
- 四、proxies
- 五、servers
- 六、pluginRepositories
一、setting.xml 配置文件结构
Maven的 settings.xml 文件是一个重要的配置文件，用于自定义Maven的行为和设置。它位于 <Maven_HOME>/conf 目录下。
- 本地仓库：
<localRepository>元素指定本地仓库的路径，Maven会将下载的依赖项存储在这里。默认情况下，它设置为用户主目录下的.m2/repository目录。 - 镜像配置：
<mirrors>元素允许您配置镜像仓库。镜像仓库可以用于将Maven请求重定向到不同的仓库URL。这对于加快下载速度或使用内部仓库镜像非常有用。 - 代理配置：
<proxies>元素允许您为Maven配置代理服务器，以便在访问远程仓库时使用。如果您的网络需要代理访问互联网，您可以在这里指定代理的详细信息。 - 服务器凭据：
<servers>元素用于定义远程仓库或服务器的身份验证凭据。您可以为需要身份验证的仓库指定服务器ID、用户名和密码。 - 插件仓库：
<pluginRepositories>元素允许您指定额外的仓库来下载Maven插件。当默认仓库中没有您需要的插件时，这非常有用。
二、localRepository
localRepository 是 Maven 中的一个重要配置项，用于指定本地仓库的路径。本地仓库是 Maven 在构建项目时用于存储下载的依赖项的地方。
默认情况下，Maven 会将下载的依赖项存储在用户主目录下的 .m2/repository 目录中。这个目录结构按照 Maven 的规范组织，以便快速查找和检索依赖项。
可以通过修改 settings.xml 文件中的 <localRepository> 元素来更改本地仓库的路径。
<localRepository>D:\software\apache-maven-3.2.3\.m2</localRepository>
三、mirrors
mirrors 是 Maven 中的一个配置项，用于配置镜像仓库。镜像仓库是指在不同的网络环境下，将 Maven 请求重定向到不同的仓库URL，以提高下载速度或满足特定需求。
当 Maven 需要从远程仓库下载依赖项时，它会首先检查 settings.xml 文件中配置的 mirrors 元素。如果配置了镜像仓库，Maven 将会使用镜像仓库的URL来代替原始仓库的URL进行下载。
镜像仓库通常用于加速下载速度，特别是在网络环境较差或远程仓库较远的情况下。通过配置镜像仓库，可以选择一个与原始仓库相对较近的镜像站点，从而加快下载速度并减少网络延迟。
在 settings.xml 文件中，可以使用 <mirror> 元素来定义镜像仓库。每个 <mirror> 元素包含 <id> 、 <url> 和 <mirrorOf> 等元素。 <id> 是镜像仓库的唯一标识符， <url> 是镜像仓库的URL， <mirrorOf> 是需要被镜像的原始仓库的标识符。
下面是 <mirrors> 元素中的每个子元素的用途：
-
<mirror>：定义一个镜像仓库。 -
<id>：镜像仓库的唯一标识符，用于在配置中引用该镜像仓库。 -
<url>：镜像仓库的URL，即替代原始仓库的URL。 -
<mirrorOf>：指定需要被镜像的原始仓库的标识符。可以使用通配符来匹配多个原始仓库。 -
<name>：镜像仓库的名称，用于描述该镜像仓库。 -
<layout>：指定镜像仓库使用的仓库布局。默认为default。
<mirrors>
<mirror>
<id>alimaven</id>
<name>aliyun maven</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<mirrorOf>central</mirrorOf>
</mirror>
</mirrors>四、proxies
proxies 是 Maven 中的一个配置项，用于指定代理服务器的设置。代理服务器充当 Maven 构建工具与需要访问的远程仓库之间的中间人。当 Maven 需要从远程仓库下载依赖项时，可以配置使用代理服务器来进行连接。
下面是每个子元素的详细说明：
-
<id>：代理服务器的唯一标识符，用于在配置中引用该代理服务器。 -
<active>：指定代理服务器是否处于活动状态。可以设置为true或false，默认为true。如果设置为false，Maven将不会使用该代理服务器。 -
<protocol>：指定代理服务器支持的协议。常见的协议有http和https。根据需要设置相应的协议。 -
<host>：指定代理服务器的主机名或IP地址。 -
<port>：指定代理服务器的端口号。 -
<username>：指定连接代理服务器所需的用户名（如果需要身份验证）。 -
<password>：指定连接代理服务器所需的密码（如果需要身份验证）。
样例如下：
<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>五、servers
在 Maven 中， servers 是一个用于配置服务器凭据的元素。它用于指定需要进行身份验证的远程仓库或服务器的凭据信息。以下是 servers 元素中每个子元素的详细说明：
-
<server>：定义一个服务器配置。 -
<id>：服务器的唯一标识符，用于在配置中引用该服务器。 -
<username>：连接到服务器所需的用户名。 -
<password>：连接到服务器所需的密码。 -
<privateKey>：连接到服务器所需的私钥文件路径。 -
<passphrase>：如果私钥文件有密码保护，则指定私钥文件的密码。 -
<filePermissions>：指定上传到服务器的文件的权限。 -
<directoryPermissions>：指定在服务器上创建的目录的权限。
<servers>
<server>
<id>nexus-releases</id>
<username>admin</username>
<password>xxxxx</password>
</server>
<server>
<id>nexus-snapshots</id>
<username>snapshots</username>
<password>xxxxx</password>
</server>
</servers>六、pluginRepositories
在 Maven 中， pluginRepositories 是一个配置元素，用于指定额外的仓库来下载 Maven 插件。每个子元素都有特定的用途。以下是 pluginRepositories 元素的详细说明：
-
<pluginRepository>：定义一个插件仓库。 -
<id>：插件仓库的唯一标识符，用于在配置中引用该插件仓库。 -
<url>：插件仓库的URL，用于指定插件的下载地址。 -
<layout>：指定插件仓库使用的仓库布局。默认为default。 -
<snapshots>：用于配置插件仓库是否允许使用快照版本的插件。可以设置为enabled、disabled或update。 -
<releases>：用于配置插件仓库是否允许使用正式版本的插件。可以设置为enabled、disabled或update。
<profiles>
<profile>
<id>dev</id>
<repositories>
<repository>
<id>nexus</id>
<url>http://maven.aliyun.com/nexus/#view-repositories;public~browsestorage</url>
<releases>
<enabled>true</enabled>
<updatePolicy></updatePolicy>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>nexus</id>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>
</profile>
</profiles>
