Maven （一）--- 入门和依赖 / 憋错料

部分图片来自参考资料

问题：

- maven 生命周期是怎么样的

- mvn clean install 与 mvn clean deploy 的区别是什么

概述

Maven 是一种构建项目的工具，能够帮我们自动化构建过程，从清理，测试到生成报告，再到打包和部署，不仅如此它还是一个依赖管理工具和项目信息管理工具，它提供了中央仓库，能帮我们自动下载构件。

Maven 安装注意事项

Maven 安装的教程我就不再重复讲解，主要就是先安装JDK，然后配置环境变量，正常安装即刻。Maven 用户可以选择配置安装路径下/conf/settings.xml 或是 ~/.m2/settings.xml ,前者是全局范围，后者是用户返回，只有当前用户才会受影响。例如，在我的电脑中，前后者的路径分别为：

E:\software\maven\apache-maven-3.5.4-bin\apache-maven-3.5.4\conf

C:\Users\Benjious\.m2\repository

示例 maven 文件

<?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/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.general</groupId>
    <artifactId>general-msg</artifactId>
    <packaging>pom</packaging>
    <version>1.0-SNAPSHOT</version>
    <modules>
        <module>general-msg-api</module>
        <module>general-msg-bit</module>
    </modules>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.4.2.RELEASE</version>
    </parent>

    <properties>
        <java.version>1.8</java.version>
        <mybatis.version>3.3.1</mybatis.version>
        <mybatis.spring.version>1.2.4</mybatis.spring.version>
        <mysql.connector.version>5.1.40</mysql.connector.version>
        <fasterxml.jackson.version>2.8.4</fasterxml.jackson.version>
        <spring.boot.version>1.4.2.RELEASE</spring.boot.version>
        <spring.session.version>1.2.2.RELEASE</spring.session.version>
        <spring.mongodb.version>2.0.3.RELEASE</spring.mongodb.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
                <version>${spring.boot.version}</version>
                <!--<exclusions>-->
                <!--<exclusion>-->
                <!--<groupId>org.springframework.boot</groupId>-->
                <!--<artifactId>spring-boot-starter-tomcat</artifactId>-->
                <!--</exclusion>-->
                <!--</exclusions>-->
            </dependency>

            <!-- dubbo start -->
            <dependency>
                <groupId>com.alibaba</groupId>
                <artifactId>dubbo</artifactId>
                <version>2.5.3</version>
                <exclusions>
                    <exclusion>
                        <groupId>org.springframework</groupId>
                        <artifactId>spring</artifactId>
                    </exclusion>
                </exclusions>
            </dependency>

            <dependency>
                <groupId>org.apache.zookeeper</groupId>
                <artifactId>zookeeper</artifactId>
                <version>3.4.6</version>
                <exclusions>
                    <exclusion>
                        <groupId>org.slf4j</groupId>
                        <artifactId>slf4j-log4j12</artifactId>
                    </exclusion>
                    <exclusion>
                        <groupId>log4j</groupId>
                        <artifactId>log4j</artifactId>
                    </exclusion>
                </exclusions>
            </dependency>

            <dependency>
                <groupId>com.github.sgroschupf</groupId>
                <artifactId>zkclient</artifactId>
                <version>0.1</version>
            </dependency>

            <dependency>
                <groupId>org.apache.commons</groupId>
                <artifactId>commons-lang3</artifactId>
                <version>3.4</version>
            </dependency>

            <!--mybatis相关依赖开始-->
            <dependency>
                <groupId>mysql</groupId>
                <artifactId>mysql-connector-java</artifactId>
                <version>${mysql.connector.version}</version>
            </dependency>

            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis</artifactId>
                <version>${mybatis.version}</version>
            </dependency>

            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis-spring</artifactId>
                <version>${mybatis.spring.version}</version>
            </dependency>
            <!--mybatis先关依赖结束-->

            <!--mybatis逆向工程插件-->
            <dependency>
                <groupId>org.mybatis.generator</groupId>
                <artifactId>mybatis-generator-core</artifactId>
                <version>1.3.2</version>
                <scope>compile</scope>
                <optional>true</optional>
            </dependency>

        </dependencies>
    </dependencyManagement>

    <distributionManagement>
        <!-- 两个ID必须与 setting.xml中的<service><id>nexus-releases</id></service>保持一致 -->
        <repository>
            <id>nexus-releases</id>
            <name>Nexus Release Repository</name>
            <url>http://192.168.10.241:8081/repository/maven-releases/</url>
        </repository>
        <snapshotRepository>
            <id>nexus-snapshots</id>
            <name>Nexus Snapshot Repository</name>
            <url>http://192.168.10.241:8081/repository/maven-snapshots/</url>
        </snapshotRepository>
    </distributionManagement>
    <build>
        <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.apache.maven.plugins</groupId>
                <artifactId>maven-source-plugin</artifactId>
                <version>2.4</version>
                <executions>
                    <execution>
                        <id>attach-sources</id>
                        <goals>
                            <goal>jar-no-fork</goal>
                        </goals>
                    </execution>
                </executions>
                <configuration>
                    <attach>true</attach>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

初步实践

我们先使用maven构建一个简单的项目，新建文件和文件夹如下图，test 文件夹和main 文件夹同级。

以下是 Main.java 文件和 pom.xml 文件。

package com.vb.bengmall;
public class Main{
	public  String sayHello(){
		return "Hello Maven";
	}

	public static void main(String[] args){
		System.out.print(new Main().sayHello());
	}
}

<?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/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.vb.bengmall</groupId>
    <artifactId>bengmall</artifactId>
    <version>1.0-SNAPSHOT</version>
    <name>Maven Hello World Project</name>
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
    </dependencies>

</project>

还有test测试文件：

import com.vb.bengmall.Main;

import static org.junit.Assert.assertEquals;

import org.junit.Test;

public class MainTest {
    @Test
    public void testSayHello() {
        Main m = new Main();
        String result = m.sayHello();
        assertEquals("Hello Maven",result);
    }
}

然后在src 目录下依次执行： mvn clean compile 和 mvn clean test ，就会发现 src 生成了一个 target目录，里面就是我们编译和测试生成的文件，执行过程如图：

接下来是 mvn clean package ，我们看到执行日志，maven 执行的是插件的 clean ,resources,compiles,testResources,testCompile,test ,jar 几个步骤，我们后面再详细学习这几个过程，现在打开target 文件夹下你就会发现里面有个jar,这正是我们打包出来的jar 文件，好了，打包成功后，我们需要将项目放在maven 仓库中，方便以后其他项目引用，这里就要执行 mvn clean install

打开以下路径（见下图），你就发现自己项目生成的jar放在了maven 仓库中了。

要是每次构建项目都要自己建文件夹，配置pom 难免有些繁琐麻烦，maven 也提供一些骨架供大家下载使用，执行mvn archetype:generate 命令，maven就会弹出来让你选择哪种框架，选择后就会让你填写 groupid等等基本信息，然后生成一个开发骨架。

通过上面的小实例，我们从compile ,test ,package 到最后的install 我们相当于把构建项目的过程走了一遍，当然实际中可能需要更多的步骤，以上步骤是让读者对maven 有个初步的印象。

依赖

maven 坐标

maven 通过定义groupId, artifactId, version , packaging , classifier 。在maven的世界里，任何一个依赖，插件或者项目构建的输出，都可以称为构件。坐标详解：

groupId : 定义当前 Maven 项目隶属的实际项目。
artifactId : 该元素定义实际项目中的一个 Maven 项目（模块），推荐的做法是使用实际项目名称作为 artifactId 的前缀。
version : 版本，需要注意快照版本（SNAPSHOT）的学习和理解
packaging : 打包方式
classifier : 该元素用来帮助定义构建输出一些附属构件。

依赖配置

<project>
	<dependencies>
		<dependency>
			<groupId>...</groupId>
			<artifactId>...</artifactId>
			<version>...</version>
			<type>...</type>
			<scope>...</scope>
			<optional>...</optional>
			<exclusions>
				<exclusion>...</exclusion>
			</exclusions>
		</dependency>

		<dependency>
			...
		</dependency>

		<dependency>
			...
		</dependency>
	</dependencies>

</project>

groupId , artifaceId , version 三者可以定义一个依赖的坐标，另外的配置：

type : 依赖的类型，大部分不必声明。
scope : 依赖范围，下文详解
optional : 少用
exclusions : 用来排除传递性依赖

依赖的范围有

compile : 没指定，默认是这个范围
test : 测试范围，在编译主代码或者运行项目的时候无法使用该类依赖
provided : 在编译和测试有效，但在运行中无效，典型的就是 servlet-api , 编译和测试项目的时候是需要该依赖的，但在运行时由于容器有提供这不需要。
runtime : 测试和运行有效，但在编译主代码时无效。典型的就是 JDBC 驱动实现了，项目编译只要 JDK 提供的JDBC 接口，只有在执行测试或者运行项目的时候才需要实现上述接口的具体JDBC 驱动。
system : 系统依赖范围，和provided 依赖范围完全一致，由于该类依赖不是通过maven 仓库解析的，而且往往与本机系统绑定，可能造成构建的不可移植，应谨慎使用。
import : 后面介绍

传递性依赖和传递性的依赖范围

假如我们有一个叫 account-email 的项目，依赖如下：

那么 account-email 和 commons-logging 之间就存在一个传递性依赖。具体的依赖类型如下图：

依赖调解

对于依赖有两个重要的原则：

路径最近者优先
第一声明者优先

最佳实践

排除依赖，例如由于传递性依赖中引入了不稳定的SNAPSHOT版本依赖，现在想把它移除掉，

pom 文件示例如下：

  <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>com.juvenxu.mvnbook</groupId>
                <artifactId>project-b</artifactId>
                <version>${spring.boot.version}</version>
                <exclusions>
                    <exclusion>
                        <groupId>org.springframework.boot</groupId>
                        <artifactId>spring-boot-starter-tomcat</artifactId>
                    </exclusion>
                </exclusions>
            </dependency>
            ....
  <dependencyManagement>

查看当前 maven 中已经解析的依赖：

mvn dependency:list

仓库

maven 仓库是基于简单文件系统存储的，例如在我们的logback 这个构件存在在我们本地仓库的位置。如下图：

不同版本的logback 以文件的形式在本地存储。

仓库分类

可以知道大体分为远程仓库和本地仓库两类。

本地仓库

本地仓库的地址默认是 ~/.m2/resposity ，我们可以通过 setting.xml 文件来进行修改。

<settings>
	<localRepository>D:\java\repository\</localRepository>
</settings>

私服

可以说私服就像是浏览器一样，帮助客户请求远程服务器的资源，用户也可以上传和下载构件。

远程仓库

mvn clean deploy 就是将项目部署到远程仓库中去，在本篇的示例代码中，部署到远程仓库中的配置如下：

<distributionManagement>
        <!-- 两个ID必须与 setting.xml中的<service><id>nexus-releases</id></service>保持一致 -->
        <repository>
            <id>nexus-releases</id>
            <name>Nexus Release Repository</name>
            <url>http://192.168.10.241:8081/repository/maven-releases/</url>
        </repository>
        <snapshotRepository>
            <id>nexus-snapshots</id>
            <name>Nexus Snapshot Repository</name>
            <url>http://192.168.10.241:8081/repository/maven-snapshots/</url>
        </snapshotRepository>
    </distributionManagement>

生命周期

可以说maven 构建项目的过程分为： 编译，测试，打包，部署。而maven 本身有三套独立的生命周期，分别为： clean(清理项目)，default(构建项目)，site(建立项目站点) 。

插件

插件的执行实际就是声明周期的过程，插件与生命周期有一个绑定的关系，例如：

聚合与继承

聚合

聚合的作用主要是使编译的时候一起编译。

    <modules>
        <module>general-msg-api</module>
        <module>general-msg-bit</module>
    </modules>

继承

继承的作用主要是让子类省去一些重复的工作。

    <parent>
        <artifactId>general-msg</artifactId>
        <groupId>com.general</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>

可继承的属性有

依赖管理

我们从上面也可以知道 dependencies 和 dependencyManagement 都是可从父类中继承的，例如在父类的 dependencyManagement 中定义的

            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
                <version>${spring.boot.version}</version>
            </dependency>

            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-jdbc</artifactId>
                <version>${spring.boot.version}</version>
            </dependency>

在子类中可以直接省略了版本号，这样也方便项目管理，使得多个子类和父类都使用同一个版本，不会造成混乱。

         <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>

maven 提供的 dependencyManagement 元素既能让子模块继承到福模块的依赖配置，又能保证子模块依赖使用的灵活性。在 dependencyManagement 元素下的依赖声明不会不会引入实际的依赖，不过它能够约束 dependencies 下的依赖使用。

问题

mvn clean install 与 mvn clean deploy 的区别是什么

总结

本文主要介绍maven 的工作过程，需要重点把握的是maven的生命周期和继承聚合以及依赖的相关概念，在学习中最好结合文章开头的实例进行比对学习。

参考资料

maven 实战
工匠人生公众号 --- 【朝花夕拾】Maven拾遗一文

原文地址：https://www.cnblogs.com/Benjious/p/10947069.html

时间： 2024-10-17 03:55:26

Maven （一）--- 入门和依赖

概述

Maven 安装注意事项

示例 maven 文件

初步实践

依赖

maven 坐标

依赖配置

传递性依赖和传递性的依赖范围

依赖调解

最佳实践

仓库

仓库分类

本地仓库

私服

远程仓库

生命周期

插件

聚合与继承

聚合

继承

依赖管理

问题

总结

参考资料

Maven （一）--- 入门和依赖的相关文章

Maven 快速入门及简单使用

maven使用入门（pom）

Maven 系列一：Maven 快速入门及简单使用【转】

Maven 系列一： Maven 快速入门及简单使用

Maven入门指南：Maven 快速入门及简单使用

Maven入门指南 Maven 快速入门及简单使用

Maven 简单入门

maven（入门一）

maven(5)坐标和依赖

Maven之——坐标和依赖（上）