Maven使用教程

小灰灰 2024-03-26 18:15 53阅读 0赞

### 1.什么是Maven？ ###

当我们在创建一个使用Spring的Web项目就需要引入大量的jar包。一个项目Jar包的数量极多，并且Jar包之间的关系错综复杂，一个Jar包往往又会引用其他Jar包，缺少任何一个Jar包都会导致项目编译失败。

以往开发项目时，程序员往往需要花较多的精力在引用Jar包搭建项目环境上，而这一项工作尤为艰难，少一个Jar包、多一个Jar包往往会报一些让人摸不着头脑的异常。

而Maven就是一款帮助程序员构建项目的工具，我们只需要告诉Maven需要哪些Jar 包，它会帮助我们下载所有的Jar，极大提升开发效率。

### 2.Maven 下载 ###

Maven 下载地址：[Maven – Download Apache Maven][Maven _ Download Apache Maven]

### 3.配置maven环境变量 ###

![1f7ddd09e6f8407f84ce5f070da38bb3.png][]

## 4.Maven POM ##

POM( Project Object Model，项目对象模型 ) 是 Maven 工程的基本工作单元，是一个XML文件，包含了项目的基本信息，用于描述项目如何构建，声明项目依赖，等等。

执行任务或目标时，Maven 会在当前目录中查找 POM。它读取 POM，获取所需的配置信息，然后执行目标。

> POM 中可以指定以下配置：
> 
>  *  项目依赖
>  *  插件
>  *  执行目标
>  *  项目构建 profile
>  *  项目版本
>  *  项目开发者列表
>  *  相关邮件列表信息

在创建 POM 之前，我们首先需要描述项目组 (groupId), 项目的唯一ID。

<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.project-group</groupId>
     
        
        <artifactId>project</artifactId>
     
        
        <version>1.0</version>
    </project>

### 什么是Maven仓库？ ###

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

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

Maven 仓库能帮助我们管理构件（主要是JAR），它就是放置所有JAR文件（WAR，ZIP，POM等等）的地方。

Maven 仓库有三种类型：

*  本地（local）
 *  中央（central）
 *  远程（remote）

> ### 本地仓库 ###
> 
> Maven 的本地仓库，在安装 Maven 后并不会创建，它是在第一次执行 maven 命令的时候才被创建。
> 
> 运行 Maven 的时候，Maven 所需要的任何构件都是直接从本地仓库获取的。如果本地仓库没有，它会首先尝试从远程仓库下载构件至本地仓库，然后再使用本地仓库的构件。
> 
> 默认情况下，不管Linux还是 Windows，每个用户在自己的用户目录下都有一个路径名为 .m2/repository/ 的仓库目录。
> 
> Maven 本地仓库默认被创建在 %USER\_HOME% 目录下。要修改默认位置，在 %M2\_HOME%\\conf 目录中的 Maven 的 settings.xml 文件中定义另一个路径。
> 
> ### 中央仓库 ###
> 
> Maven 中央仓库是由 Maven 社区提供的仓库，其中包含了大量常用的库。
> 
> 中央仓库包含了绝大多数流行的开源Java构件，以及源码、作者信息、SCM、信息、许可证信息等。一般来说，简单的Java项目依赖的构件都可以在这里下载到。
> 
> 中央仓库的关键概念：
> 
>  *  这个仓库由 Maven 社区管理。
>  *  不需要配置。
>  *  需要通过网络才能访问。
> 
> 要浏览中央仓库的内容，maven 社区提供了一个 URL：[Maven Central Repository Search][]。使用这个仓库，开发人员可以搜索所有可以获取的代码库。
> 
> ### 远程仓库 ###
> 
> 如果 Maven 在中央仓库中也找不到依赖的文件，它会停止构建过程并输出错误信息到控制台。为避免这种情况，Maven 提供了远程仓库的概念，它是开发人员自己定制仓库，包含了所需要的代码库或者其他工程中用到的 jar 文件。

## Maven 构建生命周期 ##

Maven 构建生命周期定义了一个项目构建跟发布的过程。

一个典型的 Maven 构建（build）生命周期是由以下几个阶段的序列组成的：

![be59de9987cd4553ad29d83028ce5756.png][]

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <th>阶段</th> 
   <th>处理</th> 
   <th>描述</th> 
  </tr> 
  <tr> 
   <td>验证 validate</td> 
   <td>验证项目</td> 
   <td>验证项目是否正确且所有必须信息是可用的</td> 
  </tr> 
  <tr> 
   <td>编译 compile</td> 
   <td>执行编译</td> 
   <td>源代码编译在此阶段完成</td> 
  </tr> 
  <tr> 
   <td>测试 Test</td> 
   <td>测试</td> 
   <td>使用适当的单元测试框架（例如JUnit）运行测试。</td> 
  </tr> 
  <tr> 
   <td>包装 package</td> 
   <td>打包</td> 
   <td>创建JAR/WAR包如在 pom.xml 中定义提及的包</td> 
  </tr> 
  <tr> 
   <td>检查 verify</td> 
   <td>检查</td> 
   <td>对集成测试的结果进行检查，以保证质量达标</td> 
  </tr> 
  <tr> 
   <td>安装 install</td> 
   <td>安装</td> 
   <td>安装打包的项目到本地仓库，以供其他项目使用</td> 
  </tr> 
  <tr> 
   <td>部署 deploy</td> 
   <td>部署</td> 
   <td>拷贝最终的工程包到远程仓库中，以共享给其他开发人员和工程</td> 
  </tr> 
 </tbody> 
</table>

为了完成 default 生命周期，这些阶段（包括其他未在上面罗列的生命周期阶段）将被按顺序地执行。

Maven 有以下三个标准的生命周期：

*  **clean**：项目清理的处理
 *  **default(或 build)**：项目部署的处理
 *  **site**：项目站点文档创建的处理

![9716932703cc45359832deb23b23e1e9.png][]

### 什么是“坐标”？ ###

在Maven中，坐标是Jar包的唯一标识，Maven通过坐标在仓库中找到项目所需的Jar包。

如下代码中，groupId和artifactId构成了一个Jar包的坐标。

<dependency>
       <groupId>cn.missbe.web.search</groupId>
       <artifactId>resource-search</artifactId>
       <packaging>jar</packaging>
       <version>1.0-SNAPSHOT</version>
    </dependency>

*  **groupId**:所需Jar包的项目名
 *  **artifactId**:所需Jar包的模块名
 *  **version**:所需Jar包的版本号

> **传递依赖 与 排除依赖：**
> 
>   
> **传递依赖**：如果我们的项目引用了一个Jar包，而该Jar包又引用了其他Jar包，那么在默认情况下项目编译时，Maven会把直接引用和间接引用的Jar包都下载到本地。  
>  **排除依赖**：如果我们只想下载直接引用的Jar包，那么需要在pom.xml中做如下配置：(将需要排除的Jar包的坐标写在中)

### maven依赖冲突 ###

若项目中多个Jar同时引用了相同的Jar时，会产生依赖冲突，但Maven采用了两种避免冲突的策略，因此在Maven中是不存在依赖冲突的。

**1.短路优先**

本项目——>A.jar——>B.jar——>X.jar
    本项目——>C.jar——>X.jar

若本项目引用了A.jar，A.jar又引用了B.jar，B.jar又引用了X.jar，并且C.jar也引用了X.jar。

在此时，Maven只会引用引用路径最短的Jar。

**2.声明优先**

若引用路径长度相同时，在pom.xml中谁先被声明，就使用谁。

### 聚合 ###

1.  什么是聚合？
    
    将多个项目同时运行就称为聚合。
2.  如何实现聚合？
    
    只需在pom中作如下配置即可实现聚合：

<modules>
        <module>web-connection-pool</module>
        <module>web-java-crawler</module>
    </modules>

### maven的继承（父子结构） ###

1.  什么是继承？
    
    在聚合多个项目时，如果这些被聚合的项目中需要引入相同的Jar，那么可以将这些Jar写入父pom中，各个子项目继承该pom即可。
2.  如何实现继承？

*  父pom配置：将需要继承的Jar包的坐标放入标签即可。

<dependencyManagement>
        <dependencies>
              <dependency>
                <groupId>cn.missbe.web.search</groupId>
                <artifactId>resource-search</artifactId>
                <packaging>pom</packaging>
                <version>1.0-SNAPSHOT</version>
              </dependency> 
        </dependencies>
    </dependencyManagement>

*  子pom配置：

<parent>
          <groupId>父pom所在项目的groupId</groupId>
          <artifactId>父pom所在项目的artifactId</artifactId>
          <version>父pom所在项目的版本号</version>
    </parent>
     <parent>
          <artifactId>resource-search</artifactId>
          <groupId>cn.missbe.web.search</groupId>
          <version>1.0-SNAPSHOT</version>
    </parent>

### 使用Maven构建Web项目 ###

1.  New Maven项目：选择WebApp：
2.  若使用JSP，需添加Servlet依赖：
    
    注：Servlet依赖只在编译和测试时使用！

<dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.0.1</version>
        
        <scope>provided</scope>
    </dependency>

1.  在Bulid Path中设置resource输出目录：
2.  勾选：Dynamic Web Module
3.  删掉测试目录
4.  在pom中加入jetty的插件，并设置JDK版本：

<plugins> 
      <plugin> 
        <groupId>org.apache.maven.plugins</groupId>  
        <artifactId>maven-compiler-plugin</artifactId>  
        <configuration> 
          <source>1.8</source>  
          <target>1.8</target> 
        </configuration> 
      </plugin>  
      <plugin> 
        <groupId>org.eclipse.jetty</groupId>  
        <artifactId>jetty-maven-plugin</artifactId>  
        <version>9.3.10.v20160621</version>  
        <executions> 
          <execution> 
            <phase>package</phase> 
          </execution> 
        </executions> 
      </plugin> 
    </plugins>

1.  运行项目：
2.  输入：jetty:run
3.  访问127.0.0.1:8080
    
    若出现如下界面，表示成功！

### pom.xml详解 ###

pom.xml是Maven的核心，你的项目需要什么Jar包就在pom.xml里面配置。当编译项目时Maven读取该文件，并从仓库中下载相应的Jar包。

<?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.0http://maven.apache.org/maven-v4_0_0.xsd">  
        
      <parent> 
          
        <artifactId/>  
          
        <groupId/>  
          
        <version/> 
      </parent>  
        
      <modelVersion>4.0.0</modelVersion>  
        
      <groupId>cn.missbe.web</groupId>  
        
      <artifactId>search-resources</artifactId>  
        
      <packaging>war</packaging>  
        
      <version>1.0-SNAPSHOT</version>  
        
      <name>search-resources</name>  
        
      <url>http://www.missbe.cn</url>  
        
      <description>A maven project to study maven.</description>  
        
      <prerequisites> 
          
        <maven/> 
      </prerequisites>  
        
      <build> 
          
        <sourceDirectory/>  
          
        <scriptSourceDirectory/>  
          
        <testSourceDirectory/>  
          
        <outputDirectory/>  
          
        <testOutputDirectory/>  
          
        <extensions> 
            
          <extension> 
              
            <groupId/>  
              
            <artifactId/>  
              
            <version/> 
          </extension> 
        </extensions>  
          
        <resources> 
            
          <resource> 
              
            <targetPath/>  
              
            <filtering/>  
              
            <directory/>  
              
            <includes/>  
              
            <excludes/> 
          </resource> 
        </resources>  
          
        <testResources> 
            
          <testResource> 
            <targetPath/>
            <filtering/>
            <directory/>
            <includes/>
            <excludes/> 
          </testResource> 
        </testResources>  
          
        <directory/>  
          
        <finalName/>  
          
        <filters/>  
          
        <pluginManagement> 
            
          <plugins> 
              
            <plugin> 
                
              <groupId/>  
                
              <artifactId/>  
                
              <version/>  
                
              <extensions/>  
                
              <executions> 
                  
                <execution> 
                    
                  <id/>  
                    
                  <phase/>  
                    
                  <goals/>  
                    
                  <inherited/>  
                    
                  <configuration/> 
                </execution> 
              </executions>  
                
              <dependencies> 
                  
                <dependency>......</dependency> 
              </dependencies>  
                
              <inherited/>  
                
              <configuration/> 
            </plugin> 
          </plugins> 
        </pluginManagement>  
          
        <plugins> 
            
          <plugin> 
            <groupId/>
            <artifactId/>
            <version/>
            <extensions/>  
            <executions> 
              <execution> 
                <id/>
                <phase/>
                <goals/>
                <inherited/>
                <configuration/> 
              </execution> 
            </executions>  
            <dependencies> 
                
              <dependency>......</dependency> 
            </dependencies>  
            <goals/>
            <inherited/>
            <configuration/> 
          </plugin> 
        </plugins> 
      </build>  
        
      <modules/>  
        
      <repositories> 
          
        <repository> 
            
          <releases> 
              
            <enabled/>  
              
            <updatePolicy/>  
              
            <checksumPolicy/> 
          </releases>  
            
          <snapshots> 
            <enabled/>
            <updatePolicy/>
            <checksumPolicy/> 
          </snapshots>  
            
          <id>banseon-repository-proxy</id>  
            
          <name>banseon-repository-proxy</name>  
            
          <url>http://192.168.1.169:9999/repository/</url>  
            
          <layout>default</layout> 
        </repository> 
      </repositories>  
        
      <pluginRepositories> 
          
        <pluginRepository>......</pluginRepository> 
      </pluginRepositories>  
        
      <dependencies> 
        <dependency> 
            
          <groupId>org.apache.maven</groupId>  
            
          <artifactId>maven-artifact</artifactId>  
            
          <version>3.8.1</version>  
            
          <type>jar</type>  
            
          <classifier/>  
            
          <scope>test</scope>  
            
          <systemPath/>  
            
          <exclusions> 
            <exclusion> 
              <artifactId>spring-core</artifactId>  
              <groupId>org.springframework</groupId> 
            </exclusion> 
          </exclusions>  
            
          <optional>true</optional> 
        </dependency> 
      </dependencies>  
        
      <dependencyManagement> 
        <dependencies> 
            
          <dependency>......</dependency> 
        </dependencies> 
      </dependencyManagement>  
        
      <distributionManagement> 
          
        <repository> 
            
          <uniqueVersion/>  
          <id>banseon-maven2</id>  
          <name>banseon maven2</name>  
          <url>file://${basedir}/target/deploy</url>  
          <layout/> 
        </repository>  
          
        <snapshotRepository> 
          <uniqueVersion/>  
          <id>banseon-maven2</id>  
          <name>Banseon-maven2 Snapshot Repository</name>  
          <url>scp://svn.baidu.com/banseon:/usr/local/maven-snapshot</url>  
          <layout/> 
        </snapshotRepository>  
          
        <site> 
            
          <id>banseon-site</id>  
            
          <name>business api website</name>  
            
          <url>scp://svn.baidu.com/banseon:/var/www/localhost/banseon-web</url> 
        </site>  
          
        <downloadUrl/>  
          
        <status/> 
      </distributionManagement>  
        
      <properties/> 
    </project>

[Maven _ Download Apache Maven]: http://maven.apache.org/download.cgi
[1f7ddd09e6f8407f84ce5f070da38bb3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/7bd4d88b0a004797bf939bfa2af6454c.png
[Maven Central Repository Search]: http://search.maven.org/#browse
[be59de9987cd4553ad29d83028ce5756.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/5242c83ca624484f918db0b3f855bffe.png
[9716932703cc45359832deb23b23e1e9.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/26/4005244b348644c98a05ddb6524b2669.png