maven的基本原理和使用

我不是女神ヾ 2022-09-30 09:48 229阅读 0赞

一、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

<project ...>
    <repositories>
        <repository>
          <id>java.net</id>
          <url>https://maven.java.net/content/repositories/public/</url>
        </repository>
     </repositories>
    </project>

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

<project ...>
        <repositories>
          <repository>
    	<id>JBoss repository</id>
    	<url>http://repository.jboss.org/nexus/content/groups/public/</url>
          </repository>
        </repositories>
    </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中的配置

<dependency>  
            <groupId>com.google.code</groupId>  
            <artifactId>kaptcha</artifactId>  
            <version>2.3.2</version>  
        </dependency>

注意要和仓库中的groupId、artifactId和version保持一致。  
3、完成  
构建它，现在 “kaptcha” jar 能够从你的 Maven 本地存储库检索了。  
  
  
四、pom.xml  
如果使用过Ant都知道Ant是通过build.xml执行构建任务的，Maven中是通过pom.xml来执行任务。  
POM,全名project object model，即项目对象模型，maven通过这个pom.xml描述一个项目的构建以及信息。下面是个具体的配置信息。

pom.xml
    <?<?xml version="1.0" encoding="UTF-8"?>
    <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/maven-v4_0_0.xsd">
      <modelVersion>4.0.0</modelVersion>
      <groupId>com.kang</groupId>
      <artifactId>maven-web</artifactId>
      <packaging>war</packaging>
      <version>0.0.1-SNAPSHOT</version>
      <name>maven-web Maven Webapp</name>
      <url>http://maven.apache.org</url>
      <dependencies>
        <dependency>
          <groupId>junit</groupId>
          <artifactId>junit</artifactId>
          <version>3.8.1</version>
          <scope>test</scope>
        </dependency>
        <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>servlet-api</artifactId>
        <version>2.5</version>
        <scope>provided</scope>
        </dependency>
      </dependencies>
      <build>
        <finalName>maven-web</finalName>
      </build>
    </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中配置依赖  
依赖可以声明如下：

<?xml version="1.0" encoding="UTF-8"?>
    <project>
    	...
    	<dependencies>
    		<dependency>
    			<groupId>group-a</groupId>
    			<artifactId>artifact-a</artifactId>
    			<version>1.0</version>
    			<exclusions>
    				<exclusion>
    					<groupId>group-c</groupId>
    					<artifactId>excluded-artifact</artifactId>
    				</exclusion>
    			</exclusions>
    		</dependency>
    		<dependency>
    			<groupId>group-a</groupId>
    			<artifactId>artifact-b</artifactId>
    			<version>1.0</version>
    			<type>bar</type>
    			<scope>runtime</scope>
    		</dependency>
    	</dependencies>
    </project>

例如junit的依赖如下;

<dependency>
          <groupId>junit</groupId>
          <artifactId>junit</artifactId>
          <version>3.8.1</version>
          <scope>test</scope>
        </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依赖。如下：

<dependency>  
      <groupId>commons-logging</groupId>   
      <artifactId>commons-logging</artifactId>   
      <version>1.1.1</version>   
    </dependency>

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

<dependency>  
      <groupId>xxxxx</groupId>   
      <artifactId>xxxxxx</artifactId>   
      <version>xxxx</version>   
    </dependency>

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

<dependency>    
         <groupId>org.springframework</groupId>  
         <artifactId>spring-core</artifactId>  
         <version>2.5.6</version>  
         <exclusions>  
               <exclusion>      
                    <groupId>commons-logging</groupId>          
                    <artifactId>commons-logging</artifactId>  
               </exclusion>  
         </exclusions>  
    </dependency>

这样的话项目将不会引入依赖commons-logging。  
  
  
六、在Eclipse中管理依赖

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

![20170320220112148][]

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

![20170320220120866][]

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

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

![20170320220442509][]

解决方案：

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

![20170320220336086][]

2、Window ---> Show View---> Maven Repositories ---> Global Repositories  
![20170320220220382][]

[20170320220112148]: /images/20220706/2adaf214068e441dad703370fadb01cc.png
[20170320220120866]: /images/20220706/fe08dbab0ffd42649b2bd606b5352422.png
[20170320220253008]: /images/20220706/8638d56f7b6c413e9ba7900b8e05be45.png
[20170320220442509]: /images/20220706/58b7975f7f534e4c96bc5f7854a885de.png
[20170320220336086]: /images/20220706/92b9544f79934a70a3b008f2a9e159ba.png
[20170320220220382]: /images/20220706/670393ec7ed44995a449bae2b95fc55b.png