Maven仓库（四）

在了解Maven如何使用仓库后，我们将能更高效的使用Maven。

前面我们已经讲过Maven的坐标机制，任何Maven项目使用任何构件的方式都是完全相同的。在此基础上，Maven可以在某个位置统一存储所有Maven项目共享的构件，这个统一的位置就是仓库。实际的Maven项目将不再各自存储其依赖文件，它们只需要声明这些依赖的坐标，在需要的时候，Maven会自动根据坐标找到仓库中的构件，并使用它们。

1. Maven仓库布局

Maven是如何根据坐标来定位路径的呢？下面举一个实际的例子：
有这样一个构件：groupId=org.testng、artifactId=testng、version=5.8、classifier=jdk15、packaging=jar，其对应的路径生成步骤如下：

1）基于groupId，将org.testng转换成org/testng/。
2）基于artifactId，路径变成org/testng/testng/。
3）使用版本信息，得到路径为org/testng/testng/5.8/。
4）依次加上artifactId，分隔符连字号，以及version,于是构件路径变成了org/testng/testng/5.8/testng-5.8。
5）如果有classifier信息，路径就变成org/testng/testng/5.8/testng-5.8-jdk5。
最后由packaging决定构件的扩展名，所以最后的路径为org/testng/testng/5.8/testng-5.8-jdk5.jar。

2. Maven仓库的分类

仓库分类：本地仓库和远程仓库。Maven根据坐标寻找构件的时候，它先会查看本地仓库，如果本地仓库存在构件，则直接使用；如果没有，则从远程仓库查找，找到后，下载到本地。

1）本地仓库
默认情况下，每个用户在自己的用户目录下都有一个路径名为.m2/repository/的仓库目录。我们也可以自定义本地仓库的地址，如下：

这样，用户的本地仓库被设置成了D:/library/maven/repository/。我们需要从Maven安装目录复制$MAVEN_HOME/conf/settings.xml文件复制到D:/library/maven下进行编辑。大家不要直接修改全局目录下的settings.xml。

我们可以将依赖从远程仓库下载到本地仓库，也可以将本地仓库安装到Maven仓库中。如对前面我们讲过的hello-world项目执行mvn clean install(Eclipse中命令为clean install),结果如下：

[INFO] Scanning for projects...
[INFO]                                                                         
[INFO] ------------------------------------------------------------------------
[INFO] Building hello-world 0.0.1-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO] 
[INFO] --- maven-clean-plugin:2.5:clean (default-clean) @ hello-world ---
[INFO] Deleting D:\code\maven\hello-world\target
[INFO] 
[INFO] --- maven-resources-plugin:2.6:resources (default-resources) @ hello-world ---
[WARNING] Using platform encoding (GBK actually) to copy filtered resources, i.e. build is platform dependent!
[INFO] skip non existing resourceDirectory D:\code\maven\hello-world\src\main\resources
[INFO] 
[INFO] --- maven-compiler-plugin:2.5.1:compile (default-compile) @ hello-world ---
[WARNING] File encoding has not been set, using platform encoding GBK, i.e. build is platform dependent!
[INFO] Compiling 1 source file to D:\code\maven\hello-world\target\classes
[INFO] 
[INFO] --- maven-resources-plugin:2.6:testResources (default-testResources) @ hello-world ---
[WARNING] Using platform encoding (GBK actually) to copy filtered resources, i.e. build is platform dependent!
[INFO] skip non existing resourceDirectory D:\code\maven\hello-world\src\test\resources
[INFO] 
[INFO] --- maven-compiler-plugin:2.5.1:testCompile (default-testCompile) @ hello-world ---
[WARNING] File encoding has not been set, using platform encoding GBK, i.e. build is platform dependent!
[INFO] Compiling 1 source file to D:\code\maven\hello-world\target\test-classes
[INFO] 
[INFO] --- maven-surefire-plugin:2.12.4:test (default-test) @ hello-world ---
[INFO] Surefire report directory: D:\code\maven\hello-world\target\surefire-reports

-------------------------------------------------------
 T E S T S
-------------------------------------------------------
Running com.alvinliang.maven.HelloWorldTest
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.661 sec

Results :

Tests run: 1, Failures: 0, Errors: 0, Skipped: 0

[INFO] 
[INFO] --- maven-jar-plugin:2.4:jar (default-jar) @ hello-world ---
[INFO] Building jar: D:\code\maven\hello-world\target\hello-world-0.0.1-SNAPSHOT.jar
[INFO] 
[INFO] --- maven-install-plugin:2.4:install (default-install) @ hello-world ---
[INFO] Installing D:\code\maven\hello-world\target\hello-world-0.0.1-SNAPSHOT.jar to D:\library\maven\repository\com\alvinliang\maven\hello-world\0.0.1-SNAPSHOT\hello-world-0.0.1-SNAPSHOT.jar
[INFO] Installing D:\code\maven\hello-world\pom.xml to D:\library\maven\repository\com\alvinliang\maven\hello-world\0.0.1-SNAPSHOT\hello-world-0.0.1-SNAPSHOT.pom
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 13.245s
[INFO] Finished at: Thu Nov 28 22:22:25 CST 2013
[INFO] Final Memory: 10M/55M
[INFO] ------------------------------------------------------------------------

从上述输出，我们可以看到构件的hello-world-0.0.1-SNAPSHOT.jar，安装到了本地仓库D:\library\maven\repository下。

2）远程仓库
本地仓库好比书房，而远程仓库就像是书店。对于Maven来说，每个用户只有一个本地仓库，但是可以配置多个远程仓库。

a.中央仓库
Maven必须要知道至少一个可用的远程仓库，中央仓库就是这样一个默认的远程仓库，Maven的安装文件自带了中央仓库的配置。在settings文件有如下配置：

中央仓库包含了这个世界的绝大多数流行的开源Java构件,源码等。

b）私服
私服是一种特殊的远程仓库，它是架设在局域网内的仓库服务，私服代理广域网上的远程仓库，供局域网内的Maven用户使用。当Maven需要下载构件的时候，它先从私服请求，如果私服上没有构件，测从外部的远程仓库下载，存在私服上，再为Maven用户下载。现在可以使用最流行的Maven私服软件--Nexus。后面专门介绍如何搭建私服。

3. 远程仓库的配置

见如下代码清单：

<repositories>
  	<repository>
  		<id>central</id>
  		<name>Central Repository</name>
  		<url>https://nexus/sourcesense.com/nexus/content/repositories/public/</url>
  		<layout>default</layout>
  		<snapshots>
  			<enabled>false</enabled>
  		</snapshots>
  	</repository>
<repositories>

注意上面的id设置为central，使用nexus官方的仓库地址来代替中央仓库，因为有时候中央仓库很慢。上述配置中设置snapshots为false表示关闭central仓库对快照版本的下载支持。

4. 远程仓库的认证

在局部文件settings.xml中，在servers元素下配置，如下：

 <servers>
    <server>
      <id>central</id>
      <username>lb</username>
      <password>123456</password>
    </server>
<servers>

上述配置中id为关键元素，表示对那个远程仓库进行认证，这里配置的是中央仓库central。其中认证的用户名为lb,密码为123456。

5. 镜像

如果仓库X可以提供仓库Y存储的所有内容，那么就可以认为X是Y的一个镜像。也就是说，任何一个可以从仓库Y获得的构件，都可以从它的镜像中获取。例如：http://maven.net.cn/content/groups/public/是重要仓库http://repo1.maven.org/maven2/在中国的镜像。由于地理位置的原因，镜像玩玩能够提供比中央仓库更快的服务。下面就是本人使用Nexus镜像来代替中央仓库的配置，编辑settings.xml,如下：

  <mirrors>
  
    <mirror>
      <id>central</id>
      <mirrorOf>*</mirrorOf>
      <name>Human Readable Name for this Mirror.</name>
      <url>http://localhost:8081/nexus/content/groups/public/</url>
    </mirror>
	
    <!-- 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>

上述配置中，mirrorOf指的是为那个仓库提供镜像，如果设置为central，表示为中央仓库的镜像，设置为*表示为任意仓库设置的镜像配置。

6. 仓库搜索服务

最后我们在为Maven编写依赖的时候，是不是不知道从何处开始，如何寻找到需要的依赖呢？下面我提供几个非常不错的网址：
http://mvnrepository.com/ 

https://repository.sonatype.org/

打开其中一个页面，直接搜索关键字，可以得到依赖配置，如下图：