程序博客网 > 阿里巴巴农村淘宝兰西

Maven仓库的布局、分类

来源：互联网 发布：阿里巴巴农村淘宝兰西 编辑：程序博客网 时间：2024/05/17 07:23

任何一个构件都有其唯一的坐标，根据这个坐标可以定义其在仓库中的唯一存储路径，这便是Maven的仓库布局方式。例如log4j:log4j:1.2.15这一依赖，其对应的仓库路径为log4j/log4j/1.2.15/log4j-1.2.15.jar，细心的读者可以观察到，该路径与坐标的大致对应关系为groupId/artifactId/version/artifactId-version.packaging。下面看一段Maven的源码并结合具体的实例来理解Maven仓库的布局方式：

Java代码  收藏代码
  1.     private static final char PATH_SEPARATOR = '/';  
  2.   
  3.     private static final char GROUP_SEPARATOR = '.';  
  4.   
  5.     private static final char ARTIFACT_SEPARATOR = '-';  
  6.   
  7.     public String pathOf( Artifact artifact )  
  8.     {  
  9.         ArtifactHandler artifactHandler = artifact.getArtifactHandler();  
  10.   
  11.         StringBuilder path = new StringBuilder( 128 );  
  12.   
  13.         path.append( formatAsDirectory( artifact.getGroupId() ) ).append( PATH_SEPARATOR );  
  14.         path.append( artifact.getArtifactId() ).append( PATH_SEPARATOR );  
  15.         path.append( artifact.getBaseVersion() ).append( PATH_SEPARATOR );  
  16.         path.append( artifact.getArtifactId() ).append( ARTIFACT_SEPARATOR ).append( artifact.getVersion() );  
  17.   
  18.         if ( artifact.hasClassifier() )  
  19.         {  
  20.             path.append( ARTIFACT_SEPARATOR ).append( artifact.getClassifier() );  
  21.         }  
  22.   
  23.         if ( artifactHandler.getExtension() != null && artifactHandler.getExtension().length() > 0 )  
  24.         {  
  25.             path.append( GROUP_SEPARATOR ).append( artifactHandler.getExtension() );  
  26.         }  
  27.   
  28.         return path.toString();  
  29. }  
  30.   
  31.     private String formatAsDirectory( String directory )  
  32.     {  
  33.         return directory.replace( GROUP_SEPARATOR, PATH_SEPARATOR );  
  34.     }  

 

该pathOf()方法的目的是根据构件信息生成其在仓库中的路径。在阅读本段代码之前，读者可以先回顾一下上一章Maven坐标的相关内容。这里，我们根据一个实际的例子来分析路径的生成，考虑这样一个构件：groupId=org.testng、artifactId=testng、version=5.8、classifier=jdk15、packaging=jar，其对应的路径按如下步骤生成：

  1. 首先基于构件的groupId准备路径，formatAsDirectory()将groupId中的句点分隔符转换成路径分隔符，该例中，groupId org.testng就会被转换成org/testng，之后再加一个路径分隔符斜杠，那么org.testng就成为了org/testng/。
  2. 基于构件的artifactId准备路径，也就是在前面的基础上加上artifactId以及一个路径分隔符，该例中的artifactId为testng，那么在这一步过后路径就成为了org/testng/testng/。
  3. 接着使用版本信息，在前面的基础上加上version和路径分隔符，该例中版本是5.8，那么路径就成为了org/testng/tesgng/5.8/。
  4. 这一步再依次加上artifactId，构件分隔符连字号，以及version，于是构建的路径就变成了org/testng/testng/5.8/testng-5.8。读者可能会注意到这里使用了artifactId.getVersion()，而上一步用的是artifactId.getBaseVersion()，version和baseVersion的区别在本章讨论SNAPSHOT的时候会具体阐述。
  5. 紧接着如果构件有classifier，就加上构件分隔符和classifier，该例中构件的classifier是jdk15，那么路径就变成org/testng/testng/5.8/testng-5.8-jdk5。
  6. 最后第检查构件的extension，若extension存在，则加上句点分隔符和extension，从代码中可以看到，extension是从artifactHandler而非artifact获取，artifactHandler是由项目的packaging决定的，因此可以说，packaging决定了构件的扩展名，该例的packaging是的jar，因此最终的路径为org/testng/testng/5.8/testng-5.8-jdk5.jar。

到这里笔者（包括读者你）都应该感谢Maven开源社区，正是由于Maven的所有源代码都是开放的，我们才能仔细得深入到其内部工作的所有细节。
由于Maven仓库是基于简单文件系统存储的，现在我们又理解了其存储方式，因此当遇到一些与仓库相关的问题时，可以很方便的查找相关文件，方便定位问题。例如当Maven无法获得项目声明的依赖时，可以简单该依赖对应的文件在仓库中是否存在，如果不存在，是否有其它版本可用，等等。

================================================================================

对于maven来说，仓库只分为两类：本地仓库和远程仓库。当maven根据坐标寻找构件的时候，它首先会查看本地仓库，如果本地仓库存在此构件，则直接使用；如果本地仓库不存在此构件，或者需要查看是否有更新的构件版本，maven就会去远程仓库查找，发现需要的构件之后，下载到本地仓库再使用。如果本地仓库和远程仓库都没有需要的构件，maven就会报错。
在这个最基本分类的基础上，还有必要介绍一些特殊的远程仓库。中央仓库是maven核心自带的远程仓库，它包含了绝大部分开源的构件。在默认配置下，当本地仓库没有maven需要的构件的时候，它就会尝试从中央仓库下载。私服是另一种特殊的远程仓库，为了节省带宽和时间，应该在局域网内架设一个私有的仓库服务器，用其代理所有外部的远程仓库。内部的项目还能部署到私服上供其他项目使用。除了中央仓库和私服，还有很多其他公开的远程仓库，常见的有Java.NET Maven库(http://download.java.net/maven/2/)和jboss Maven库(http://repository.jboss.com/maven2/)等。

1.本地仓库
默认情况下，不管是在windows还是Linux上，每个用户在自己的用户目录下都有一个路径名为.m2/repository/的仓库目录。有时候，因为某些原因(例如C盘空间不够)，用户会想要自定义本地仓库目录地址。这时，可以编辑文件~/.m2/settings.xml，设置localRepository元素的值为想要的仓库地址。例如：

  1. <settings>  
  2.     <localRepository>D:\java\repository\</localRepository>  
  3. </settings>  

这样，该用户的本地仓库地址就被设置成了 D:\java\repository\。需要注意的是，默认情况下，~/.m2/settings.xml文件是不存在的，用户需要从Maven安装目录复制$M2_HOME/conf/settings.xml文件再进行编辑。
一个构件只有在本地仓库中之后，才能由其他Maven项目使用，那么构件如何进入到本地仓库中呢？最常见的是依赖Maven从远程仓库下载到本地仓库中。还有一种常见的情况是，将本地项目的构件安装到Maven仓库中。例如本地有两个项目A和B，两者都无法从远程仓库获得，而同时A又依赖于B，为了能构建A，B就必须首先得以构建并安装到本地仓库中。为了安装项目，我们可以在项目中执行: mvn clean install命令。Install插件的install目标将项目的构建输出文件安装到本地仓库。

2.远程仓库
安装好Maven后，如果不执行任何Maven命令，本地仓库目录是不存在的。当用户输入第一条Maven命令之后，Maven才会创建本地仓库，然后根据配置和需要，从远程仓库下载构件至本地仓库。

3.中央仓库
由于最原始的本地仓库是空的，Maven必须知道至少一个可用的远程仓库，才能在执行Maven命令的时候下载到需要的构件。中央仓库就是这样一个默认的远程仓库，Maven的安装文件自带了中央仓库的配置。读者可以使用解压工具打开jar文件$M2_HOME/lib/maven-model-builder-3.0.jar(在Maven2中，jar文件路径类似于$M2_HOME/lib/maven-2.2.1-uber.jar),然后访问路径：org/apache/maven/model/pom-4.0.0.xml，可以看到如下的配置：

 

  1. <repositories>  
  2.     <repository>  
  3.         <id>central</id>  
  4.         <name>Maven Repository Switchboard</name>  
  5.         <url>http://repo1.maven.org/maven2</url>  
  6.         <layout>default</layout>  
  7.         <snapshots>  
  8.             <enabled>false</enabled>  
  9.         </snapshots>  
  10.     </repository>  
  11. </repositories>  

包含这段配置的文件是所有Maven项目都会继承的超级POM。这段配置使用id central对中央仓库进行唯一标识，其名称为Maven Repository Switchboard,它使用default仓库布局。最后需要注意的是snapshots元素，其子元素enabled的值为false，表示不从该中央仓库下载快照版本的构件【快照版本的项目是版本不稳定的项目，所以中央仓库默认是关闭的】。

4.私服
私服是一种特殊的远程仓库，它是架设在局域网内的仓库服务，私服代理广域网上的远程仓库，供局域网内的Maven用户使用。当Maven需要下载构件的时候，它从私服请求，如果私服上不存在该构件，则从外部的远程仓库下载，缓存在私服上之后，再为Maven的下载请求提供服务。此外，一些无法从外部仓库下载到的构件也能从本地上传到私服上供大家使用。


=============================================================================================

1. 简介

maven可以在某个位置统一存储所有maven项目共享的构件，这个统一的位置就是仓库。实际的Maven项目将不会各自存储其依赖文件，它们只需要声明这些依赖的坐标，在需要的时候(例如，编译项目的时候需要将依赖加入到classpath中)，maven会自动根据坐标找到仓库中的构件，并使用它们。为了实现重用，项目构建完毕后生成的构件也可以安装或者部署到仓库中，供其他项目使用。

2. 仓库分类

对于maven来说，仓库只分为两类：本地仓库和远程仓库。当maven根据坐标寻找构件的时候，它首先会查看本地仓库，如果本地仓库存在此构件，则直接使用；如果本地仓库不存在此构件，或者需要查看是否有更新的构件版本，maven就会去远程仓库查找，发现需要的构件之后，下载到本地仓库再使用。如果本地仓库和远程仓库都没有需要的构件，maven就会报错。

在这个最基本分类的基础上，还有必要介绍一些特殊的远程仓库。中央仓库是maven核心自带的远程仓库，它包含了绝大部分开源的构件。在默认配置下，当本地仓库没有maven需要的构件的时候，它就会尝试从中央仓库下载。私服是另一种特殊的远程仓库，为了节省带宽和时间，应该在局域网内架设一个私有的仓库服务器，用其代理所有外部的远程仓库。内部的项目还能部署到私服上供其他项目使用。除了中央仓库和私服，还有很多其他公开的远程仓库，常见的有java.net Maven库(http://download.java.net/maven/2/)和jboss Maven库(http://repository.jboss.com/maven2/)等。
8.png

3. 本地仓库

默认情况下，不管是在windows还是linux上，每个用户在自己的用户目录下都有一个路径名为.m2/repository/的仓库目录。有时候，因为某些原因(例如C盘空间不够，或者要重装系统等等)，用户会想要自定义本地仓库目录地址。这时，可以编辑文件~/.m2/settings.xml，设置localRepository元素的值为想要的仓库地址。例如：
<settings>
  <localRepository>D:\IT\maven\repo</localRepository>
<settings>
这样，该用户的本地仓库地址就被设置成了 D:\IT\maven\repo。需要注意的是，默认情况下，~/.m2/settings.xml文件是不存在的，用户需要从Maven安装目录复制$M2_HOME/conf/settings.xml文件再进行编辑。

一个构件只有在本地仓库中之后，才能由其他Maven项目使用，那么构件如何进入到本地仓库中呢？
（1）最常见的是Maven从远程仓库下载到本地仓库中。当我们第一次运行某个命令时，例如mvn compile时，会下载大量文件当本地仓库中。
（2）还有一种常见的情况是，将本地项目的构件安装到Maven仓库中。使用命令：mvn clean install即可完成安装。install目标就是将项目的构建输出文件安装到本地仓库。

4. 远程仓库

安装好Maven后，如果不执行任何Maven命令，本地仓库目录是不存在的。当用户输入第一条Maven命令之后，Maven才会创建本地仓库，然后根据配置和需要，从远程仓库下载构件至本地仓库。
4.png


本地仓库好比书房，我需要读书的时候先从书房找，相应的，Maven需要构件的时候先从本地仓库找。远程仓库就好比书店，当我无法从自己的书房找到需要的书的时候，就会从书店购买后放到书房。相应的，当Maven无法从本地仓库找到需要的书的时候，就会从远程仓库下载构件到本地仓库。一般的，对于每个人来说，书房只有一个，但外面的书店却有很多，类似的，对于Maven来说，每个用户只有一个本地仓库，但可以配置很多远程仓库。

5. 中央仓库

由于最原始的本地仓库是空的，Maven必须知道至少一个可用的远程仓库，才能在执行Maven命令的时候下载到需要的构件。中央仓库就是这样一个默认的远程仓库，Maven的安装文件自带了中央仓库的配置。读者可以使用解压工具打开jar文件$M2_HOME/lib/maven-model-builder-3.3.9.jar,然后访问路径：org/apache/maven/model/pom-4.0.0.xml，可以看到如下的配置：
  <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>

包含这段配置的文件是所有Maven项目都会继承的超级POM。这段配置使用central对中央仓库进行唯一标识，其名称为Central Repository,它使用default进行仓库布局。最后需要注意的是snapshots元素，其子元素enabled的值为false，表示不从该中央仓库下载快照版本的构件。

6. 镜像仓库

如果仓库X可以提供仓库Y存储的所有内容，那么就可以认为X是Y的一个镜像。换句话说，任何一个可以从仓库Y获得的构件，都能够从它的镜像中获取。举个例子，http://maven.oschina.net/content/groups/public/ 是中央仓库http://repo1.maven.org/maven2/ 在中国的镜像，由于地理位置的因素，该镜像往往能够提供比中央仓库更快的服务。因此，可以配置Maven使用该镜像来替代中央仓库。编辑settings.xml（apache-maven-3.3.9\conf\settings.xml），代码如下：
  <mirrors>
     <mirror>
      <id>maven.oschina.net</id>
      <mirrorOf>central</mirrorOf>
      <name>maven mirror in China</name>
      <url>http://maven.oschina.net/content/groups/public/</url>
    </mirror>
  </mirrors>

该例中，mirrorOf的值为central，表示该配置为中央仓库的镜像，任何对于中央仓库的请求都会转至该镜像，用户也可以使用同样的方法配置其他仓库的镜像。id表示镜像的唯一标识符，name表示镜像的名称，url表示镜像的地址。

关于镜像的一个更为常见的用法是结合私服。由于私服可以代理任何外部的公共仓库(包括中央仓库)，因此，对于组织内部的Maven用户来说，使用一个私服地址就等于使用了所有需要的外部仓库，这可以将配置集中到私服，从而简化Maven本身的配置。在这种情况下，任何需要的构件都可以从私服获得，私服就是所有仓库的镜像。以后再慢慢介绍私服的使用。 


下面提供一些别的镜像仓库：
<mirror>
  <id>CN</id>  
  <name>OSChina Central</name>
  <url>http://maven.oschina.net/content/groups/public/</url>
  <mirrorOf>central</mirrorOf>
</mirror>
 
<mirror>
  <id>repo2</id>
  <mirrorOf>central</mirrorOf>
  <name>Human Readable Name for this Mirror.</name>
  <url>http://repo2.maven.org/maven2/</url>    
</mirror>
 
<mirror>
  <id>net-cn</id>
  <mirrorOf>central</mirrorOf>
  <name>Human Readable Name for this Mirror.</name>
  <url>http://maven.net.cn/content/groups/public/</url>     
</mirror>    
 
<mirror>
  <id>ibiblio</id>
  <mirrorOf>central</mirrorOf>
  <name>Human Readable Name for this Mirror.</name>
  <url>http://mirrors.ibiblio.org/pub/mirrors/maven2/</url>    
</mirror>    
   
<mirror>
  <id>jboss-public-repository-group</id>
  <mirrorOf>central</mirrorOf>
  <name>JBoss Public Repository Group</name>
  <url>http://repository.jboss.org/nexus/content/groups/public</url>    
</mirror>  
 
<mirror>
  <id>JBossJBPM</id>
  <mirrorOf>central</mirrorOf>
  <name>JBossJBPM Repository</name>
  <url>https://repository.jboss.org/nexus/content/repositories/releases/</url>  
</mirror>
==========================================

镜像是为了提供更快的服务


如图：X就认为是Y的一个镜像。

编辑settings.xml配置中央仓库镜像：

  1. <settings>  
  2.   ...  
  3.   <mirrors>  
  4.     <mirror>  
  5.       <id>maven.net.cn</id>  
  6.       <name>one of the central mirrors in china</name>  
  7.       <url>http://maven.net.cn/content/groups/public/</url>  
  8.       <mirrorOf>central</mirrorOf>  
  9.     </mirror>  
  10.   </mirrors>  
  11.   ...  
  12. </settings>  


该例中，<mirrorOf>的值为central，表示该配置为中央仓库的镜像，任何对于中央仓库的请求都会转至该镜像，用户也可以使用同样的方法配置其他仓库的镜像。另外三个元素id,name,url与一般仓库配置无异，表示该镜像仓库的唯一标识符、名称以及地址。类似地，如果该镜像需认证，也可以基于该id配置仓库认证。

任何需要的构件都可以从私服获得，私服就是所有仓库的镜像。这时，可以配置这样的一个镜像，如例： 

 

  1. <settings>  
  2.   ...  
  3.   <mirrors>  
  4.     <mirror>  
  5.       <id>internal-repository</id>  
  6.       <name>Internal Repository Manager</name>  
  7.       <url>http://192.168.1.100/maven2</url>  
  8.       <mirrorOf>*</mirrorOf>  
  9.     </mirror>  
  10.   </mirrors>  
  11.   ...  
  12. </settings>  


该例中<mirrorOf>的值为星号，表示该配置是所有Maven仓库的镜像， 任何对于远程仓库的请求都会被转至http://192.168.1.100/maven2/。如果该镜像仓库需要认证，则配置一个Id为 internal-repository的<server>即可。为了满足一些复杂的需求，Maven还支持更高级的镜像配置：

1.<mirrorOf>*</mirrorOf>

匹配所有远程仓库。

2.<mirrorOf>external:*</mirrorOf>

匹配所有远程仓库，使用localhost的除外，使用file://协议的除外。也就是说，匹配所有不在本机上的远程仓库。

3.<mirrorOf>repo1,repo2</mirrorOf>

匹配仓库repo1和repo2，使用逗号分隔多个远程仓库。

4.<mirrorOf>*,!repo1</miiroOf>

匹配所有远程仓库，repo1除外，使用感叹号将仓库从匹配中排除。

需要注意的是，由于镜像仓库完全屏蔽了被镜像仓库，当镜像仓库不稳定或者停止服务的时候，Maven仍将无法访问被镜像仓库，因而将无法下载构件。



阅读全文
0 0
阿里巴巴农村淘宝兰西 阿里巴巴农村淘宝兰西
原创粉丝点击
热门IT博客
果宝特攻3玩具淘宝果宝特攻3玩具淘宝
淘宝首页文案范文淘宝首页文案范文
新闻类数据库设计
扶桑级战列舰知乎
手机网络信号差怎么办
lte是什么网络类
淘宝手机端宝贝图片
php 正则函数
什么是云计算技术
帝国cms邀请码
淘宝店铺视频教程
中英飞耀速录软件
mac bash alias
淘宝店铺宝贝排序
手游网游推荐 知乎
象过河仓库软件
c语言标准函数库手册
数控车床g73编程实例
淘宝找西瓜刀打什么
手机视频截动图软件
热门问题 老师的惩罚 人脸识别 我在镇武司摸鱼那些年 重生之率土为王 我在大康的咸鱼生活 盘龙之生命进化 天生仙种 凡人之先天五行 春回大明朝 姑娘不必设防，我是瞎子 丶怎么打出来 破折号怎么打 方向盘怎么打 网络电话怎么打 小孩打呼噜怎么回事 麻将怎么打初学规则 衣服蝴蝶结怎么打 手机打不出去电话怎么回事 气球怎么打结 丶怎么打出来电脑 biang字手机怎么打出来 手机怎么打 度怎么打 如何打 盖农怎么打 阿卡伊勒怎么打 ,怎么打 战斗机怎么折 星星怎么折 坦克怎么折 蝴蝶结怎么折 钱包怎么折 怎么折星星 风车怎么折 手里剑怎么折 跳青蛙怎么折 折怎么读 东西南北怎么折 5折怎么算 正方体怎么折 兔子怎么折 怎么折爱心皇冠 剑怎么折 怎么折公主手提包 陀螺怎么折 折线图怎么做 9折怎么算 飞机怎么折飞得远 东南西北怎么折步骤 7折怎么算 七折怎么算

程序博客网，程序员的互联网技术博客家园。csdn论坛精品 msdn技术资料都在这里