maven的基本原理和使用

一、Maven中央存储库
当你建立一个 Maven 的项目，Maven 会检查你的 pom.xml 文件，以确定哪些依赖下载。首先，Maven 将从本地资源库获得 Maven 的本地资源库依赖资源，如果没有找到，然后把它会从默认的 Maven 中央存储库  http://search.maven.org/  查找下载。
在Maven中，当你声明的库不存在于本地存储库中，也没有不存在于Maven中心储存库，该过程将停止并将错误消息输出到 Maven 控制台。

二、添加远程仓库
默认情况下，Maven从Maven中央仓库下载所有依赖关系。但是，有些库丢失在中央存储库，只有在Java.net或JBoss的储存库远程仓库中能找到。
1. Java.net资源库
添加Java.net远程仓库的详细信息在“pom.xml”文件。
pom.xml

1. <project ...>
2. <repositories>
3. <repository>
4. <id>java.net </id>
5. <url>https://maven.java.net/content/repositories/public/ </url>
6. </repository>
7. </repositories>
8. </project>

2. JBoss Maven存储库
添加JBoss远程仓库的详细信息在 “pom.xml” 文件中。
pom.xml

1. <project ...>
2. <repositories>
3. <repository>
4. <id>JBoss repository </id>
5. <url>http://repository.jboss.org/nexus/content/groups/public/ </url>
6. </repository>
7. </repositories>
8. </project>

现在，Maven的依赖库查询顺序更改为：
在 Maven 本地资源库中搜索，如果没有找到，进入下一步，否则退出。
在 Maven 中央存储库搜索，如果没有找到，进入下一步，否则退出。
在Maven的远程存储库搜索，如果没有找到，提示错误信息，否则退出。


三、定制库到Maven本地资源库
如果我们自己创建了一个自定义的jar ，而另一个 Maven 项目需要使用。或者我们需要的jar包没有maven的支持，这时我们可以将其加入本地仓库中。
例如，kaptcha，它是一个流行的第三方Java库，它被用来生成 “验证码” 的图片，以阻止垃圾邮件，但它不在 Maven 的中央仓库中。下面我们来安装“kaptcha”jar到Maven 的本地资源库。
1、mvn安装
首先下载jar包
下载地址：http://code.google.com/p/kaptcha/downloads/list 
然后添加到本地Maven库中命令如下。可根据自己情况修改对应文件路径。
mvn install:install-file -DgroupId=com.google.code -DartifactId=kaptcha -Dversion=2.3.2 -Dfile=D:\kaptcha-2.3.jar -Dpackaging=jar -DgeneratePom=true


2、pom.xml中的配置

1. <dependency>
2. <groupId>com.google.code </groupId>
3. <artifactId>kaptcha </artifactId>
4. <version>2.3.2 </version>
5. </dependency>

注意要和仓库中的groupId、artifactId和version保持一致。
3、完成
构建它，现在 “kaptcha” jar 能够从你的 Maven 本地存储库检索了。


四、pom.xml
如果使用过Ant都知道Ant是通过build.xml执行构建任务的，Maven中是通过pom.xml来执行任务。
POM,全名project object model，即项目对象模型，maven通过这个pom.xml描述一个项目的构建以及信息。下面是个具体的配置信息。

1. pom.xml
2. <?<?xml version="1.0" encoding="UTF-8"?>
3. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4. xsi:schemaLocation= "http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
5. <modelVersion>4.0.0 </modelVersion>
6. <groupId>com.kang </groupId>
7. <artifactId>maven-web </artifactId>
8. <packaging>war </packaging>
9. <version>0.0.1-SNAPSHOT </version>
10. <name>maven-web Maven Webapp </name>
11. <url>http://maven.apache.org </url>
12. <dependencies>
13. <dependency>
14. <groupId>junit </groupId>
15. <artifactId>junit </artifactId>
16. <version>3.8.1 </version>
17. <scope>test </scope>
18. </dependency>
19. <dependency>
20. <groupId>javax.servlet </groupId>
21. <artifactId>servlet-api </artifactId>
22. <version>2.5 </version>
23. <scope>provided </scope>
24. </dependency>
25. </dependencies>
26. <build>
27. <finalName>maven-web </finalName>
28. </build>
29. </project>

第一行指定了文档的XML版本和编码。
第二行即每个pom.xml的核心元素——project。
project下面有几个子元素，这几个子元素一般是每个项目都会使用到的：
1、modelVersion
这个元素指定了POM的版本，Maven2或者Maven3 都只能是4.0.0。
2、groupId 
这是项目组的ID，一般是com.公司组织名.项目名。
3、artifactId 
这是该项目在项目组中的ID,比如当前的项目是一个web应用，就可以叫做maven-web。
4、packaging
这个属性可以指明项目的类型。常用的是jar（普通java工程）和war（web工程）。当不定义packaging的时候，Maven 会使用默认值jar。
5、version 是项目的版本号，用于维护项目的升级和发布。
6、name 一般没有实际的用处，只是用于标识该项目。
比较重要的参数是 groupId、artifactId、version，这三个属性确定唯一的一个项目。



五、Maven如何管理jar包
我们项目中用到的jar包可以通过依赖的方式引入，构建项目的时候从Maven仓库下载即可。
1、在pom.xml中配置依赖 
依赖可以声明如下： 

1. <?xml version="1.0" encoding="UTF-8"?>
2. <project>
3. ...
4. <dependencies>
5. <dependency>
6. <groupId>group-a </groupId>
7. <artifactId>artifact-a </artifactId>
8. <version>1.0 </version>
9. <exclusions>
10. <exclusion>
11. <groupId>group-c </groupId>
12. <artifactId>excluded-artifact </artifactId>
13. </exclusion>
14. </exclusions>
15. </dependency>
16. <dependency>
17. <groupId>group-a </groupId>
18. <artifactId>artifact-b </artifactId>
19. <version>1.0 </version>
20. <type>bar </type>
21. <scope>runtime </scope>
22. </dependency>
23. </dependencies>
24. </project>

例如junit的依赖如下;

1. <dependency>
2. <groupId>junit </groupId>
3. <artifactId>junit </artifactId>
4. <version>3.8.1 </version>
5. <scope>test </scope>
6. </dependency>

2、依赖标签详解
依赖会包含基本的groupId, artifactId,version等元素，根元素project下的dependencies可以包含一个或者多个dependency元素，以声明一个或者多个依赖。
每个依赖可以包含的元素：
groupId,artifactId和version：依赖的基本坐标，对于任何一个依赖来说，基本坐标是最重要的，Maven根据坐标才能找到需要的依赖。
type: 依赖的类型，对应于项目坐标定义的packaging。大部分情况下，该元素不必声明，其默认值是jar。
scope: 依赖的范围。
optional: 标记依赖是否可选。
exclusions: 用来排除传递性依赖。
大部分依赖声明只包含基本坐标。
（1）scope详解
Maven在编译主代码的时候需要使用一套classpath,在编译和执行测试的时候会使用另一套classpath,实际运行项目的时候，又会使用一套classpath。
依赖范围就是用来控制依赖与这三种classpath(编译classpath、测试classpath、运行classpath)的关系，Maven有以下几种依赖范围：
compile: 编译依赖范围。如果没有指定，就会默认使用该依赖范围。使用此依赖范围的Maven依赖，对于编译、测试、运行三种classpath都有效。
test: 测试依赖范围。使用此依赖范围的Maven依赖，只对于测试classpath有效，在编译主代码或者运行项目的使用时将无法使用此类依赖。典型的例子就是JUnit，它只有在编译测试代码及运行测试的时候才需要。
provided: 已提供依赖范围。使用此依赖范围的Maven依赖，对于编译和测试classpath有效，但在运行时无效。典型的例子是servlet-api，编译和测试项目的时候需要该依赖，但在运行项目的时候，由于容器已经提供，就不需要Maven重复地引入一遍。
runtime: 运行时依赖范围。使用此依赖范围的Maven依赖，对于测试和运行classpath有效，但在编译主代码时无效。典型的例子是JDBC驱动实现，项目主代码的编译只需要JDK提供的JDBC接口，只有在执行测试或者运行项目的时候才需要实现上述接口的具体JDBC驱动。
system: 系统依赖范围。该依赖与三种classpath的关系，和provided依赖范围完全一致。但是，使用system范围依赖时必须通过systemPath元素显式地指定依赖文件的路径。由于此类依赖不是通过Maven仓库解析的，而且往往与本机系统绑定，可能造成构建的不可移植，因此应该谨慎使用。
import(Maven 2.0.9及以上): 导入依赖范围。该依赖范围不会对三种classpath产生实际的影响。
（2）optional详解
首先来看依赖的传递性。
假如我们项目引入依赖spring-core，我们可以在Maven仓库中查找spring-core构件，而该构件包含了一个commons-logging依赖。如下：

1. <dependency>
2. <groupId>commons-logging </groupId>
3. <artifactId>commons-logging </artifactId>
4. <version>1.1.1 </version>
5. </dependency>

那么该依赖会传递到当前项目中，这就是依赖的传递性。
有时候我们不想让依赖传递，那么可配置该依赖为可选依赖，将元素optional设置为true即可。

1. <dependency>
2. <groupId>xxxxx </groupId>
3. <artifactId>xxxxxx </artifactId>
4. <version>xxxx </version>
5. </dependency>

这样的话，依赖该项目的其他项目将不会得到此依赖xxxxx的传递。
（3）exclusions详解
 当我们引入第三方jar包的时候，难免会引入传递性依赖，有些时候这是好事，然而有些时候我们不需要其中的一些传递性依赖
比如上例中的项目，我们不想引入传递性依赖commons-logging，我们可以使用exclusions元素声明排除依赖，exclusions可以包含一个或者多个exclusion子元素，因此可以排除一个或者多个传递性依赖。需要注意的是，声明exclusions的时候只需要groupId和artifactId，而不需要version元素，这是因为只需要groupId和artifactId就能唯一定位依赖图中的某个依赖。换句话说，Maven解析后的依赖中，不可能出现groupId和artifactId相同，但是version不同的两个依赖。

1. <dependency>
2. <groupId>org.springframework </groupId>
3. <artifactId>spring-core </artifactId>
4. <version>2.5.6 </version>
5. <exclusions>
6. <exclusion>
7. <groupId>commons-logging </groupId>
8. <artifactId>commons-logging </artifactId>
9. </exclusion>
10. </exclusions>
11. </dependency>

这样的话项目将不会引入依赖commons-logging。


六、在Eclipse中管理依赖

如图，在该项目的pom.xml中点击Dependency Hierarchy可以看到依赖树。

点击Dependencies可以添加新的依赖，点击选择一个依赖，点击remove可以删除，点击Add可以新增一个依赖。

如下图，搜素org.springframework（此处是从Maven中心仓库进行搜索），选择你想要的模块和版本，点击OK即可：

如果出现Index downloads are disabled, search results may be incomplete.的错误

解决方案：

1、Window --> Preferences-->Maven 勾选"Download repository index updates on startup"

2、Window ---> Show View---> Maven Repositories ---> Global Repositories