【Java 中级】Maven setting.xml 详解

一时失言乱红尘 2024-05-04 08:07 9阅读 0赞

![在这里插入图片描述][e01dda339c714c5d8a875b3f1f0b80e4.png]

> 👉**博主介绍**： 博主从事应用安全和大数据领域，有8年研发经验，5年面试官经验，Java技术专家，WEB架构师，阿里云专家博主，华为云云享专家，51CTO 专家博主

⛪️ 个人社区：[个人社区][Link 1]  
💞 个人主页：[个人主页][Link 2]  
🙉 专栏地址： ✅ [Java 初阶][Java]  
🙉八股文专题：[剑指大厂，手撕 Java 八股文][Java 1]

#### 文章目录 ####

*   *   *  一、setting.xml 配置文件结构
         *  二、localRepository
         *  三、mirrors
         *  四、proxies
         *  五、servers
         *  六、pluginRepositories

#### 一、setting.xml 配置文件结构 ####

Maven的 `settings.xml` 文件是一个重要的配置文件，用于自定义Maven的行为和设置。它位于 `<Maven_HOME>/conf` 目录下。

1.  本地仓库： `<localRepository>` 元素指定本地仓库的路径，Maven会将下载的依赖项存储在这里。默认情况下，它设置为用户主目录下的 `.m2/repository` 目录。
2.  镜像配置： `<mirrors>` 元素允许您配置镜像仓库。镜像仓库可以用于将Maven请求重定向到不同的仓库URL。这对于加快下载速度或使用内部仓库镜像非常有用。
3.  代理配置： `<proxies>` 元素允许您为Maven配置代理服务器，以便在访问远程仓库时使用。如果您的网络需要代理访问互联网，您可以在这里指定代理的详细信息。
4.  服务器凭据： `<servers>` 元素用于定义远程仓库或服务器的身份验证凭据。您可以为需要身份验证的仓库指定服务器ID、用户名和密码。
5.  插件仓库： `<pluginRepositories>` 元素允许您指定额外的仓库来下载Maven插件。当默认仓库中没有您需要的插件时，这非常有用。

#### 二、localRepository ####

`localRepository` 是 Maven 中的一个重要配置项，用于指定本地仓库的路径。本地仓库是 Maven 在构建项目时用于存储下载的依赖项的地方。

默认情况下，Maven 会将下载的依赖项存储在用户主目录下的 `.m2/repository` 目录中。这个目录结构按照 Maven 的规范组织，以便快速查找和检索依赖项。

可以通过修改 `settings.xml` 文件中的 `<localRepository>` 元素来更改本地仓库的路径。

<localRepository>D:\software\apache-maven-3.2.3\.m2</localRepository>

![在这里插入图片描述][a7a9e078244d4aa087a4fc62b23ed008.png]

#### 三、mirrors ####

`mirrors` 是 Maven 中的一个配置项，用于配置镜像仓库。镜像仓库是指在不同的网络环境下，将 Maven 请求重定向到不同的仓库URL，以提高下载速度或满足特定需求。

当 Maven 需要从远程仓库下载依赖项时，它会首先检查 `settings.xml` 文件中配置的 `mirrors` 元素。如果配置了镜像仓库，Maven 将会使用镜像仓库的URL来代替原始仓库的URL进行下载。

镜像仓库通常用于加速下载速度，特别是在网络环境较差或远程仓库较远的情况下。通过配置镜像仓库，可以选择一个与原始仓库相对较近的镜像站点，从而加快下载速度并减少网络延迟。

在 `settings.xml` 文件中，可以使用 `<mirror>` 元素来定义镜像仓库。每个 `<mirror>` 元素包含 `<id>` 、 `<url>` 和 `<mirrorOf>` 等元素。 `<id>` 是镜像仓库的唯一标识符， `<url>` 是镜像仓库的URL， `<mirrorOf>` 是需要被镜像的原始仓库的标识符。

下面是 `<mirrors>` 元素中的每个子元素的用途：

1.  `<mirror>` ：定义一个镜像仓库。
2.  `<id>` ：镜像仓库的唯一标识符，用于在配置中引用该镜像仓库。
3.  `<url>` ：镜像仓库的URL，即替代原始仓库的URL。
4.  `<mirrorOf>` ：指定需要被镜像的原始仓库的标识符。可以使用通配符来匹配多个原始仓库。
5.  `<name>` ：镜像仓库的名称，用于描述该镜像仓库。
6.  `<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 需要从远程仓库下载依赖项时，可以配置使用代理服务器来进行连接。

下面是每个子元素的详细说明：

1.  `<id>` ：代理服务器的唯一标识符，用于在配置中引用该代理服务器。
2.  `<active>` ：指定代理服务器是否处于活动状态。可以设置为 `true` 或 `false` ，默认为 `true` 。如果设置为 `false` ，Maven将不会使用该代理服务器。
3.  `<protocol>` ：指定代理服务器支持的协议。常见的协议有 `http` 和 `https` 。根据需要设置相应的协议。
4.  `<host>` ：指定代理服务器的主机名或IP地址。
5.  `<port>` ：指定代理服务器的端口号。
6.  `<username>` ：指定连接代理服务器所需的用户名（如果需要身份验证）。
7.  `<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` 元素中每个子元素的详细说明：

1.  `<server>` ：定义一个服务器配置。
2.  `<id>` ：服务器的唯一标识符，用于在配置中引用该服务器。
3.  `<username>` ：连接到服务器所需的用户名。
4.  `<password>` ：连接到服务器所需的密码。
5.  `<privateKey>` ：连接到服务器所需的私钥文件路径。
6.  `<passphrase>` ：如果私钥文件有密码保护，则指定私钥文件的密码。
7.  `<filePermissions>` ：指定上传到服务器的文件的权限。
8.  `<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` 元素的详细说明：

1.  `<pluginRepository>` ：定义一个插件仓库。
2.  `<id>` ：插件仓库的唯一标识符，用于在配置中引用该插件仓库。
3.  `<url>` ：插件仓库的URL，用于指定插件的下载地址。
4.  `<layout>` ：指定插件仓库使用的仓库布局。默认为 `default` 。
5.  `<snapshots>` ：用于配置插件仓库是否允许使用快照版本的插件。可以设置为 `enabled` 、 `disabled` 或 `update` 。
6.  `<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>

>  精彩专栏推荐订阅：在下方专栏👇🏻  
>  ✅ [2023年华为OD机试真题（A卷&B卷）+ 面试指导 ][2023_OD_A_B_ _]  
>  ✅ [ 精选100套 Java 项目案例 ][_100_ Java _]  
>  ✅ [面试需要避开的坑（活动）][Link 3]  
>  ✅ [你找不到的核心代码][Link 4]  
>  ✅ [带你手撕 Spring][Spring]

> 💕💕 本文由激流原创，原创不易，希望大家关注、点赞、收藏，给博主一点鼓励，感谢！！！

![在这里插入图片描述][7b7478e55aa24a948b358051ef941b6a.webp_pic_center]

[e01dda339c714c5d8a875b3f1f0b80e4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/04/f60ff40de0fa45278741ed4acdcc4cba.png
[Link 1]: https://bbs.csdn.net/forums/45c04d3f41cc4dadaf312be1d1379b45?category=10003
[Link 2]: https://jiliu.blog.csdn.net/
[Java]: https://blog.csdn.net/qq_37967783/category_9902143.html
[Java 1]: https://blog.csdn.net/qq_37967783/article/details/130940512
[a7a9e078244d4aa087a4fc62b23ed008.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/05/04/9aebaec33c414dd2a188b83e130ec9d1.png
[2023_OD_A_B_ _]: https://blog.csdn.net/qq_37967783/category_12389634.html
[_100_ Java _]: https://blog.csdn.net/qq_37967783/category_12388267.html
[Link 3]: https://blog.csdn.net/qq_37967783/category_12380337.html
[Link 4]: https://blog.csdn.net/qq_37967783/category_12391346.html
[Spring]: https://blog.csdn.net/qq_37967783/category_12391987.html
[7b7478e55aa24a948b358051ef941b6a.webp_pic_center]: https://img-blog.csdnimg.cn/7b7478e55aa24a948b358051ef941b6a.webp#pic_center