maven(6)仓库

【0】README

1）本文部分文字转自 “maven实战”，旨在 review  “maven(6)仓库” 的相关知识；

【1】何为 Maven仓库

1）intro to 构件：在maven中，任何一个依赖，插件或者项目构建的输出，都可以称为 构件；任何一个构件都由一组坐标唯一标识；（干货——构件的定义）

2）仓库：得益于坐标机制，任何 maven项目 使用任何一个构件的方式都是相同的。在此基础上，maven 可以在某个位置上统一存储 所有maven 项目共享的构件，这个统一的位置就是仓库；（干货——仓库的定义）

【2】仓库的布局

1）仓库的布局方式：任何一个构件都有其唯一的坐标，根据这个坐标可以定义其 仓库中的唯一存储路径，这便是  maven 的仓库布局方式；（干货——仓库的布局方式定义）

2）路径与坐标的对应关系：为 groupId/artifactId/artifactId-version.packaging；

3）有兴趣的童鞋，可以看看 maven的源码，其如何 根据构件信息生成仓库中的路径（其实就是一个截取字符串 和 拼接字符串的过程， 和 tomcat 对请求路径进行解析是同样的道理）

【3】仓库的分类

1）仓库分为两类： 本地仓库 和 远程仓库；

2）maven 搜寻构件的方法： 当maven 根据坐标寻找构件的时候，它首先查看本地仓库，若本地仓库中有，则直接使用；如果没有，或者需要查看是否有更新的构建版本的时候，maven 就会去 远程仓库查找了；发现需要的构建后，下载到本地仓库中再使用；

3）私服（私有服务器）：私服是另一种特殊的远程仓库，为了节省带宽和时间，应该在局域网内 架设一个私有的仓库服务器，用其代理所有外部的远程仓库，且内部的项目还能部署到私服上共其他项目使用；（干货——私服的定义）

Attention）

A1）除了中央仓库 （http://repo1.maven.org/maven2/）和 私服作为 远程仓库外，还有其他公开的 远程仓库：如  java .net maven 库( http://download.java.net/maven/2 )   和 JBoss maven 库（http://repository.jboss.com/maven/2）

A2）maven 仓库的分类如下：

【3.1】本地仓库

1）intro：默认case下，每个用户在自己的用户目录都有一个路径名为  ~/.me/repository 的仓库目录；

2）自定义本地仓库目录地址：可以编辑 settings.xml ，设置 localRepository 的值；（你需要从 maven 安装目录/conf/ 目录下 copy setting 到 .m2 目录下）（干货——如何自定义本地仓库）

 <!-- localRepository
   | The path to the local repository maven will use to store artifacts.
   |
   | Default: ${user.home}/.m2/repository
  -->
  <localRepository>D:\classical_books\java_set\maven_in_action\local_repo\</localRepository>

3）problem+solution：

3.1）problem： 构件如何进入到本地仓库中？ 一个构件只有在本地仓库中之后，才能被其他 maven 项目使用；

3.2）solution：执行 mvn clean install 命令；

【3.2】远程仓库

1）intro：安装好 maven 后，如果不执行maven命令，本地仓库目录是不会存在的；当用户输入第一条 maven 命令后，maven 才会创建 本地仓库；然后根据配置需要，从远程仓库下载构件到本地仓库；

【3.3】中央仓库（属于远程仓库，https://repo.maven.apache.org/maven2）

1）intro： 中央仓库是默认的远程仓库（远程仓库可由多个），maven的安装自带了中央仓库的配置；（D:\classical_books\java_set\maven_in_action\apache-maven-3.3.9\lib\maven-model-builder-3.3.9\org\apache\maven\model\pom.xml 文件内容如下）

<project>
  <modelVersion>4.0.0</modelVersion>

  <repositories>
    <repository>
      <id>central</id>
      <name>Central Repository</name>
      <url>https://repo.maven.apache.org/maven2</url> 
      <layout>default</layout>
      <snapshots>
        <enabled>false</enabled>
      </snapshots>
    </repository>
  </repositories>

对以上代码的分析（Analysis）：看到 snapshots 里的 enabled 子元素 设置为 false，表示不从该中央仓库下载 快照版本的构件；

【3.4】私服

1）intro：私服是一种特殊的远程仓库，它是架设在局域网中的仓库服务，私服代理广域网上的 远程仓库，供局域网内的 maven 用户使用；

2）一些无法从 外部仓库下载到的构件也能从本地上传到私服上供大家使用，如下图所示：

【4】远程仓库的配置

1）默认的远程仓库：是<url>https://repo.maven.apache.org/maven2</url>，如下述代码所示，该代码来源于 D:\classical_books\java_set\maven_in_action\apache-maven-3.3.9\lib\maven-model-builder-3.3.9\org\apache\maven\model\pom.xml （即 maven安装目录/lib/.....）

<!-- START SNIPPET: superpom -->
<project>
  <modelVersion>4.0.0</modelVersion>

  <repositories>
    <repository>
      <id>central</id>
      <name>Central Repository</name>
      <url>https://repo.maven.apache.org/maven2</url>
      <layout>default</layout>
      <snapshots>
        <enabled>false</enabled>
      </snapshots>
    </repository>
  </repositories>

对以上代码的分析（Analysis）：在 repositories 元素下，可以使用 repository 子元素声明一个或多个 远程仓库；

2） release 和 snapshot 来说，有3个子元素 enabled + updatePolicy + checksumPolicy；

2.1）子元素 enabled：（true or  false）表示开启或关闭 快照版本的下载支持；

2.2）子元素 updatePolicy：（daily, never, always, interval:X）：分别表示 每天检查一次，其他可用的值包括： never 从不检查更新；always每次构建都检查更新；interval:X 每个X 分钟检查一次更新；

2.3）子元素 checksumPolicy：用来配置 maven 检查检验 和 文件的 策略。当构件被部署到 maven 仓库中时，会同时部署对应的校验和文件；（value 可设置为 ignore）

【4.1】 远程仓库认证

1）在settings.xml 中配置 仓库认证信息；（为 id==my-proj 的仓库配置认证信息）

2）配置认证信息和 配置仓库信息不同： 仓库信息可以直接配置在 POM 文件中，但是 认证信息必须配置在 settings.xml 文件中；因为 POM 往往是被提交到代码仓库中所有成员访问的，而settings.xml 是放在本机的；

3）假设需要为一个id==my-proj 的仓库配置认证信息，修改 settings.xml 如下：

4） maven 使用 settings.xml 文件中的 servers 元素 和server 子元素配置仓库认证信息；

Attention）本机子的本地仓库就是 其他机子的远程仓库；

【4.2】部署至远程仓库

1）maven 能将项目生成的构件部署到仓库中。部署steps 如下：

step1）需要编辑 项目的 pom.xml 文件，配置 distributionManagement 元素；

对以上代码的分析（Analysis）：

A0）配置 id， name， url 分别作为 远程仓库的唯一标识， 名称 和 地址；

A1）distributionManagement 包含 repository 和 snapshotRepository 子元素，前者表示发布版本构件的仓库，后者表示快照版本的 仓库；

A2）关键是url：它表示 远程仓库的地址；

step2）往远程仓库部署构件的时候，往往需要认证。 简而言之，就是需要在 settings.xml 中创建一个 server元素，其 id 与 远程仓库的 id 匹配，并配置正确的认证信息；（参见 【6.4.1】 远程仓库认证 中的认证内容）

step3）配置正确后，在命令行运行 mvn clean deploy： maven 就会将项目构建输出的构件部署到对应的远程仓库了；

【5】 快照版本

1）intro：快照版本(SNAPSHOT)是不稳定的版本，而发布版本(RELEASE)是稳定的版本；

【6】从仓库解析依赖的机制

1）intro：当本地仓库没有依赖构件的时候，maven 会自动从 远程仓库下载；当依赖版本为 快照版本的时候，maven 会自动找到最新的 快照。这背后的 依赖解析机制可以概括如下：

mechanism1）当依赖的范围是 system，maven 直接从 本地文件系统解析构件；

mechanism2）根据依赖坐标计算仓库路径后，尝试直接从 本地仓库寻找构件，如果发现相应构件，则解析成功；

mechanism3）在本地仓库不存在相应构件的case下， 如果依赖的版本是显式的发布版本构件，如1.2 等，则遍历所有的远程仓库，发现后，下载并解析使用；

mechanism4）如果依赖的版本是 RELEASE OR  LATEST ，则基于更新策略读取所有远程仓库的 元数据 groupId/artifactId/maven-metadata.xml，将其与本地仓库的对应元数据合并后，计算出 RELEASE OR  LATEST 真实的值，然后基于该值检查本地仓库 和 远程仓库；

mechanism5）如果依赖的版本是 SNAPSHOT，则基于更新策略读取所有远程仓库的元数据 groupId/artifactId/version/ maven-metadata.xml，将其与  本地仓库的对应元数据合并后，得到的最新快照版本的值，然后基于该值检查本地仓库，或者从 远程仓库下载；

mechanism6）如果最后解析得到的 构件版本 是 时间戳格式的快照，如 1.4.1-200911-4.121450-121，则复制其时间戳格式的文件 至 非时间戳格式，如 SNAPSHOT ，并使用该 非 时间戳格式的构件；

....... 此处省略1000字

【7】 镜像

1）intro：如果仓库X 可以提供仓库 Y 存储的所有内容，那么就可以人为 X 是 Y 的一个镜像；换句话说，任何一个可以从仓库Y 获得的构件，都能够从他的镜像中获取；（干货——镜像的定义）

2）编辑 settings.xml，配置中央仓库镜像

<mirrors>
    <!-- mirror
     | Specifies a repository mirror site to use instead of a given repository. The repository that
     | this mirror serves has an ID that matches the mirrorOf element of this mirror. IDs are used
     | for inheritance and direct lookup purposes, and must be unique across the set of mirrors.
     |
    <mirror>
      <id>mirrorId</id>
      <mirrorOf>repositoryId</mirrorOf>
      <name>Human Readable Name for this Mirror.</name>
      <url>http://my.repository.com/repo/path</url>
    </mirror>
     -->
  </mirrors>

对上述代码的分析（Analysis）：mirrorOf 指定了 中央仓库的镜像；

3）镜像的另一种用法是结合 私服：任何需要的构件都可以从私服获得，私服就是所有仓库的镜像；

4）为了满足一些复杂的要求，maven 还支持更高级的镜像配置：

【8】仓库搜索服务

1）problem+solution：

1.1）problem：如何寻找需要的依赖，因为添加 maven 依赖需要提供所确切的 maven 坐标；

1.2）使用 maven 仓库搜索服务

 Sonatype Nexus（https://repository.sonatype.org/）

 http://mvnbrowser.com/

http://mvnrepository.com/ （访问速度最快）