Maven进阶系列-仓库和镜像
文章目录
1. 仓库
1.1 仓库类型
本地仓库、远程中央仓库、公司自己搭建的私有仓库
1.2 寻找jar的基本优先级顺序:
本地仓库 > settings.xml的profile的仓库 > pom.xml的profile的仓库 >pom.xml的仓库 > 中央仓库
maven 寻找得顺序大致可以理解为:
1. 在本地仓库中寻找,如果没有则进入下一步。
2. 在全局应用的私服仓库中寻找,如果没有则进入下一步。
3. 在项目自身的私服仓库中寻找,如果没有则进入下一步。
4. 在中央仓库中寻找,如果没有则终止寻找。
补充:
1. 如果在找寻的过程中,如果发现该仓库有镜像设置,则用镜像的地址代替。
2. 如果仓库的 id 设置成 “central”,则该配置会覆盖 maven 默认的中央仓库配置。
设置仓库的方式有两种,一种是在项目最顶级POM.xml中设置,另一种是在settings.xml中设置。
1.3 仓库优先次序验证示例
在pom.xml中设置
<repositories>
<repository>
<id>pom-repository-first</id>
<name>pom-repository-first</name>
<url>http://192.168.100.100:8181/nexus/content/groups/public</url>
</repository>
<repository>
<id>pom-repository-second</id>
<name>pom-repository-second</name>
<url>http://192.168.100.100:8182/nexus/content/repositories/thirdparty/</url>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>nexus</id>
<name>Team Nexus Repository</name>
<url>http://192.168.100.100:8181/nexus/content/groups/public</url>
</pluginRepository>
</pluginRepositories>
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
<profiles>
<profile>
<id>pom-profile-first</id>
<repositories>
<repository>
<id>pom-repository-first</id>
<name>pom-repository-first</name>
<url>http://192.168.100.100:8084/nexus/content/groups/public</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
<!--配置默认的,配置文件,右侧的maven中,profiles默认选中dev-->
<activation>
<activeByDefault>true</activeByDefault>
</activation>
</profile>
</profiles>
settings.xml中设定:
<?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>D:\Program Files\apache-maven-3.6.1\repository</localRepository>
<mirrors>
<!-- 设置多个mirrors镜像,镜像只会执行第一个位置mirror。-->
<!-- 配置的多个mirror可以都放着不影响,选取一个镜像下载比较快的放在第一个就行。比如你设置使用自己公司的私有仓库-->
<!--只有当前一个mirror无法连接的时候,才会去找后一个,类似于备份和容灾。所以当第一个mirror中不存在a.jar的时候,并不会去第二个mirror中查找,甚至于,maven根本不会去其他的mirror地址查询-->
<mirror>
<!--当有id为B,A,C的顺序的mirror在mirrors节点中,maven会根据字母排序来指定第一个,所以不管怎么排列,一定会找到A这个mirror来进行查找,当A无法连接,出现意外的情况下,才会去B查询-->
<id>aliyun</id>
<name>阿里云仓库地址</name>
<url>http://maven.aliyun.com/nexus/content/groups/public</url>
<!--覆盖了Maven自带的central-->
<mirrorOf>central</mirrorOf>
</mirror>
</mirrors>
<profiles>
<!-- 全局JDK1.8配置 -->
<profile>
<id>jdk1.8</id>
<activation>
<activeByDefault>true</activeByDefault>
<jdk>1.8</jdk>
</activation>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
<maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
</properties>
</profile>
<!-- 阿里云配置: 提高国内的jar包下载速度 -->
<profile>
<id>settings-profile-aliyun</id>
<repositories>
<repository>
<id>settings-repository-aliyun</id>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
</profile>
<profile>
<id>settings-profile-first</id>
<repositories>
<repository>
<id>settings-repository-first</id>
<name>settings-repository-first</name>
<url>http://192.168.100.100:8183/nexus/content/groups/public</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
</profile>
<profile>
<id>settings-profile-second</id>
<repositories>
<repository>
<id>settings-repository-second</id>
<name>settings-repository-second</name>
<url>http://192.168.100.100:8084/nexus/content/groups/public</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
</profile>
</profiles>
<!--激活仓库配置,拉取依赖会在这些仓库中逐个去找-->
<activeProfiles>
<activeProfile>jdk1.8</activeProfile>
<activeProfile>settings-profile-aliyun</activeProfile>
<activeProfile>settings-profile-first</activeProfile>
<activeProfile>settings-profile-second</activeProfile>
</activeProfiles>
</settings>
2. settings.xml文件
settings 主要由mirrors、servers 和profiles 三部分组成。
2.1 mirrors
mirror相当于一个拦截器,它会拦截 maven 对 remote repository 的相关请求,把请求里的 remote repository 地址,重定向到 mirror 里配置的地址。
2.1.1 没有配置mirror
2.1.2 配置了mirror
上述图中B仓库被称为A仓库的镜像。
2.1.3
<mirrorOf>
标签用于配置镜像仓库的匹配规则,可以指定某个仓库镜像另一个仓库。这样可以加快构建过程中的依赖下载速度,特别是在国内访问外国仓库的情况下。
具体来说,<mirrorOf>
标签用于指定那些仓库将会被当前配置的镜像仓库所代理。比如,如果你在 settings.xml 中配置了一个阿里云的镜像仓库,你可以通过 <mirrorOf>
标签指定这个镜像仓库将代理中央仓库(Central Repository)
的某些或全部内容。
例如,以下是一个 Maven settings.xml
配置文件中镜像仓库的示例:
<mirror>
<id>nexus</id>
<url>http://nexus/content/groups/public</url>
<mirrorOf>central</mirrorOf>
</mirror>
在这个示例中,通过 <mirrorOf>
标签配置,表示 naxus
镜像仓库将代理中央仓库(Central Repository
),这意味着所有指向中央仓库的请求都会被重定向到 nexus
镜像仓库。
Maven
还支持更高级的镜像配置:
<mirrorOf>*</mirrorOf>
:匹配所有远程仓库<mirrorOf>repo1,repo2</mirrorOf>
:匹配仓库 repo1 和 repo2,使用逗号分隔多个远程仓库。<mirrorOf>*,!repo1</miiroOf>
: 匹配所有远程仓库,repo1 除外,使用感叹号将仓库从匹配中排除。
2.2 servers
在Maven的配置文件(settings.xml)中,标签用于配置 Maven 与远程仓库的认证信息,以便于 Maven 在构建或发布时进行认证。
例如,我们要发布 Maven 项目到 Nexus 私服,可以在 标签中配置私服的地址和认证凭证(用户名、密码等)。这样,当 Maven 在构建或发布时访问私服仓库时,会自动使用这里配置的凭证进行认证。以下是一个 标签的示例配置:
<servers>
<server>
<id>nexus-releases</id>
<username>myusername</username>
<password>mypassword</password>
</server>
</servers>
其中, 标签指定了私服的 ID,这个 ID 通常是 Nexus 中仓库的名称,例如 “nexus-releases”。 和 分别是私服的访问用户名和密码,用于 Maven 认证访问私服。
这样配置后,在 Maven 执行构建或发布时,就会自动使用这里配置的凭证去访问私服,确保 Maven 在发布时具有足够的权力和权限进行发布操作。
2.3 profiles
在 Maven 的配置文件(settings.xml 或 pom.xml)中, 标签用于配置不同环境下的不同构建选项。例如,有些项目会在开发环境下使用 H2 数据库,而在生产环境下使用 MySQL 数据库,这时就可以使用 标签定义两个不同环境。
每个 标签可以包含独立的一组配置,例如 、、、 等,这些配置将仅在该 激活时生效。可以使用 标签来定义激活该 的条件,例如指定操作系统、Maven 版本、当前构建环境等等。
以下是一个 标签的示例配置:
<profiles>
<profile>
<id>dev</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<database.driver>org.h2.Driver</database.driver>
<database.url>jdbc:h2:mem:testdb</database.url>
</properties>
</profile>
<profile>
<id>prod</id>
<properties>
<database.driver>com.mysql.jdbc.Driver</database.driver>
<database.url>jdbc:mysql://localhost/mydb</database.url>
</properties>
</profile>
</profiles>
在上述示例中,定义了两个 ,一个 ID 为“dev”,另一个为“prod”。 中设置了 “dev” 是默认激活的配置。在 中配置了不同环境下的数据库驱动和数据库连接 URL。在 Maven 的命令执行中,可以选择使用不同的 Profile 从而达到构建不同的环境的目的。例如:
# 构建 dev 环境
mvn -Pdev clean package
# 构建 prod 环境
mvn -Pprod clean package
通过 标签的使用,可以方便地管理多环境下的不同构建配置,提高了项目的灵活性和可维护性,同时也可以更好地符合软件开发的标准流程。