Maven 仓库

maven 仓库

在 maven 的术语中,仓库是一个位置(place)。

maven 仓库是项目中依赖的第三方库,这个库所在的位置叫做仓库。

在 maven 中,任何一个依赖、插件或者项目构建的输出,都可以称之为构件。

maven 仓库能帮助我们管理构件(主要是jar),它就是放置所有jar文件(war,zip,pom等等)的地方。

maven 仓库有三种类型:

  • 本地(local)
  • 中央(central)
  • 远程(remote)

 

1. 本地仓库

maven 的本地仓库,在安装 maven 后并不会创建,它是在第一次执行 maven 命令的时候才被创建。

运行 maven 的时候,maven 所需要的任何构件都是直接从本地仓库获取的。如果本地仓库没有,它会首先尝试从远程仓库下载构件至本地仓库,然后再使用本地仓库的构件。

默认情况下,不管linux还是 windows,每个用户在自己的用户目录下都有一个路径名为 .m2/respository/ 的仓库目录。

maven 本地仓库默认被创建在 %user_home% 目录下。要修改默认位置,在 %m2_home%\conf 目录中的 maven 的 settings.xml 文件中定义另一个路径。

<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>c:/mylocalrepository</localrepository>
</settings>

当你运行 maven 命令,maven 将下载依赖的文件到你指定的路径中。

 

2. 中央仓库

maven 中央仓库是由 maven 社区提供的仓库,其中包含了大量常用的库。

中央仓库包含了绝大多数流行的开源java构件,以及源码、作者信息、scm、信息、许可证信息等。一般来说,简单的java项目依赖的构件都可以在这里下载到。

中央仓库的关键概念:

  • 这个仓库由 maven 社区管理。
  • 不需要配置。
  • 需要通过网络才能访问。

要浏览中央仓库的内容,maven 社区提供了一个 url:http://search.maven.org/#browse。使用这个仓库,开发人员可以搜索所有可以获取的代码库。

 

3. 远程仓库

如果 maven 在中央仓库中也找不到依赖的文件,它会停止构建过程并输出错误信息到控制台。为避免这种情况,maven 提供了远程仓库的概念,它是开发人员自己定制仓库,包含了所需要的代码库或者其他工程中用到的 jar 文件。

举例说明,使用下面的 pom.xml,maven 将从远程仓库中下载该 pom.xml 中声明的所依赖的(在中央仓库中获取不到的)文件。

<project xmlns="http://maven.apache.org/pom/4.0.0"
   xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"
   xsi:schemalocation="http://maven.apache.org/pom/4.0.0
   http://maven.apache.org/xsd/maven-4.0.0.xsd">
   <modelversion>4.0.0</modelversion>
   <groupid>com.companyname.projectgroup</groupid>
   <artifactid>project</artifactid>
   <version>1.0</version>
   <dependencies>
      <dependency>
         <groupid>com.companyname.common-lib</groupid>
         <artifactid>common-lib</artifactid>
         <version>1.0.0</version>
      </dependency>
   <dependencies>
   <repositories>
      <repository>
         <id>companyname.lib1</id>
         <url>http://download.companyname.org/maven2/lib1</url>
      </repository>
      <repository>
         <id>companyname.lib2</id>
         <url>http://download.companyname.org/maven2/lib2</url>
      </repository>
   </repositories>
</project>

 

4. maven 依赖搜索顺序

当我们执行 maven 构建命令时,maven 开始按照以下顺序查找依赖的库:

  • 步骤 1 - 在本地仓库中搜索,如果找不到,执行步骤 2,如果找到了则执行其他操作。
  • 步骤 2 - 在中央仓库中搜索,如果找不到,并且有一个或多个远程仓库已经设置,则执行步骤 4,如果找到了则下载到本地仓库中以备将来引用。
  • 步骤 3 - 如果远程仓库没有被设置,maven 将简单的停滞处理并抛出错误(无法找到依赖的文件)。
  • 步骤 4 - 在一个或多个远程仓库中搜索依赖的文件,如果找到则下载到本地仓库以备将来引用,否则 maven 将停止处理并抛出错误(无法找到依赖的文件)。

 

5. maven 阿里云(aliyun)仓库

maven 仓库默认在国外, 国内使用难免很慢,我们可以更换为阿里云的仓库。

修改 maven 根目录下的 conf 文件夹中的 settings.xml 文件,在 mirrors 节点上,添加内容如下:

<mirrors>
    <mirror>
      <id>alimaven</id>
      <name>aliyun maven</name>
      <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
      <mirrorof>central</mirrorof>        
    </mirror>
</mirrors>

第二步: pom.xml文件里添加:

<repositories>  
        <repository>  
            <id>alimaven</id>  
            <name>aliyun maven</name>  
            <url>http://maven.aliyun.com/nexus/content/groups/public/</url>  
            <releases>  
                <enabled>true</enabled>  
            </releases>  
            <snapshots>  
                <enabled>false</enabled>  
            </snapshots>  
        </repository>  
</repositories>

下一节:maven 插件

maven 教程

相关文章