目录

1. Maven 简介
   1. 软件工程
   2. 软件工程的工作流程
   3. Maven 概述
   4. Maven 核心概念
2. 安装 Maven
   1. Windows 下安装
   2. Linux 下安装
   3. 配置阿里云环境
3. Maven 的核心概念
   1. Maven 工程目录结构
   2. 仓库
   3. POM
   4. 坐标
   5. 依赖
   6. 继承
   7. 聚合
   8. 生命周期
4. Maven 常用命令
5. Maven 常用设置
   1. scope 设置
   2. Maven 属性设置
   3. 资源插件设置
6. Maven 在 IDEA 中的应用
7. Maven 管理多模块应用
   1. 为什么需要多模块
   2. 模块拆分策略
      1. 按职责划分
      2. 按照功能拆分
      3. 工程结构
      4. 分层领域模型规约
8. 构建多模块应用
   1. 创建项目
   2. 修改父工程
   3. 创建子模块
   4. 父工程 pom
   5. 子模块 pom
9. 设置父工程编译级别
   1. 修改父工程 pom 文件
   2. 查看指定编译级别后
10. Maven 依赖版本管理
    1. 父工程统一管理依赖
    2. 父工程管理依赖版本号
       1. 父工程添加 dependencyManagement 标签管理依赖
       2. 父工程添加 properties 管理版本号
       3. 子模块声明式添加依赖
    3. dependencies与dependencyManagement的区别
11. 附录

¶Maven 简介

明白Maven的重要性，需要先从软件工程这件事说起

¶软件工程

软件工程，顾名思义就是软件的工程，要了解这个词就需要分别了解两个词「软件」和「工程」，其中软件顾名思义就是使用计算机编程语言所生成的应用程序

❓什么是工程？

✨什么是软件工程?

¶软件工程的工作流程

上述过程需要重复多次迭代，在大型工程中构建项目是比较复杂的，传统开发项目(没有使用自动化管理工具)存在的问题

¶Maven 概述

🤔什么是 Maven?​

❔Maven 能干什么？

构建：是面向过程的(从开始到结尾的多个步骤)，涉及到多个环节的协同工作，构建过程中各个环节执行动作如下：

¶Maven 核心概念

Maven 能够实现自动化构建和它的内部原理分不开，Maven 共有九个核心概念

¶安装 Maven

Mavan 也是一种软件，因此本小节主要记录如何安装 Maven

¶Windows 下安装

🎶Maven 安装步骤

✨Maven 软件目录结构

1. bin ：存放许多执行程序(如：mvn.cmd)
2. conf ：maven 工具本身的配置文件 settings.xml

🎶建议使用 3.3.9 版本，直接适应用 JDK1.8,避免使用最新版 Maven 出现不知道的错误

¶Linux 下安装

目前 Maven 主要维护的版本有：

👉点击查看 Maven 的版本信息

🎶选择 3.3.9 版本使用官方的源码包进行安装，主要的步骤如下：
1️⃣ 下载并解压

2️⃣ 配置

1
2
3

// 安装目录
export MAVEN_HOME=/home/homer/Apache-maven/apache-maven-3.3.9
export PATH=${MAVEN_HOME}/bin:${PATH}

3️⃣ 验证

👉如果想要更详细的步骤，点击查看官方安装步骤

¶配置阿里云环境

国内使用，总是不能友好的访问外网的资源，所以需要配置阿里云地址，具体的方法就是修改conf/settings.xml文件中的mirrors内容为如下部分

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

<mirrors>
	<mirror>
    	<id>alimaven</id>
        <mirrorOf>central</mirrorOf>
        <name>aliyun maven</name>
   <url>http://maven.aliyun.com/nexus/content/repositories/central/</url>
 	</mirror>
    <!-- 中央仓库1 -->
    	<mirror>
        	<id>repo1</id>
            <mirrorOf>central</mirrorOf>
            <name>Human Readable Name for this Mirror.</name>
            <url>http://repo1.maven.org/maven2/</url>
        </mirror>
        <!-- 中央仓库2 -->
        <mirror>
            <id>repo2</id>
            <mirrorOf>central</mirrorOf>
            <name>Human Readable Name for this Mirror.</name>
            <url>http://repo2.maven.org/maven2/</url>
        </mirror>
</mirrors>

🎶settings.xml文件需要格式化, xml 文件格式化网站

¶Maven 的核心概念

¶Maven 工程目录结构

每一个 maven 项目在磁盘中都是一个文件夹，通过项目构建工具生成的项目总是具有相应的目录结构，Maven 生成的目录结构及对应的含义如下：

1
2
3
4
5
6
7
8
9

Hello(根目录，也就是工程名)
	|---src(源代码)
	|---|---main(主程序java代码和配置文件)
	|---|---|---java(程序包和包中的java文件)
	|---|---|---resources(java程序中要使用的配置文件)
	|---|---test(放测试程序代码和文件的)
	|---|---|---java(测试程序包和包中的java文件)
	|---|---|---resources(测试java程序中要使用的配置文件)
	|---pom.xml(Maven的核心文件,Maven项目必须有)

项目创建完成,使用mvn compile编译 src/main 目录下的所有 java 文件,检查 maven 是否已经管理项目，如果成功，会下载很多插件,并在项目的根目录下生成target目录,Maven 编译的 java 程序,所有的 class 文件都放在 target 目录中

❓如何设置本机存放资源的目录位置(设置本机仓库):

¶仓库

maven 是如何做到自动帮助用户托管项目，项目依赖的 jar 包从哪儿获取呢？

🎶仓库是存放 Maven 及项目正常运行所需的 Jar 包的位置,主要存放的有:

仓库共分为两种：本地仓库和远程仓库

远程仓库分为三种，中央仓库、中央仓库的镜像、私服

maven 仓库的使用不需要人为参与，例如：开发人员需要使用 mysql 驱动，maven 会自动去仓库中查找/下载，maven 的查找顺序是：

在 Maven 构建项目的过程中如果需要某些插件，首先会到 Maven 的本地仓库中查找，如果找到则可以直接使用；如果找不到，它会自动连接外网，到远程中央仓库中查找；如果远程仓库中能找到，则先把所需要的插件下载到本地仓库，然后再使用，并且下次再用到相同的插件也可以直接使用本地仓库的；如果没有外网或者远程仓库中也找不到，则构建失败。

¶POM

POM( Project Object Model ) 即项目对象模型。 Maven 把一个项目的结构和内容抽象成一个模型，在 xml 文件中进行声明，以方便进行构建和描述， pom.xml 是 Maven 的灵魂。所以， maven 环境搭建好之后，所有的学习和操作都是关于 pom.xml 的

¶坐标

1
2
3

<groupId>公司域名的倒写</groupId>
<artifactId>自定义项目名称</artifactId>
<version>自定版本号</version>

¶依赖

dependencies 和 dependency ，相当于是 java 代码中 import

1
2
3
4
5
6
7
8

<dependencies>
	<!--依赖  java代码中 import -->
	<dependency>
		<groupId>mysql</groupId>
		<artifactId>mysql-connector-java</artifactId>
		<version>5.1.9</version>
		</dependency>
</dependencies>

properties：设置属性

build ： maven 在进行项目的构建时， 配置信息，例如指定编译 java 代码使用的 jdk 的版本等

¶继承

¶聚合

¶生命周期

🎶maven 的插件： maven 命令执行时，真正完成功能的是插件，插件就是一些 jar 文件， 一些类

¶Maven 常用命令

Maven 提供一个项目构建的模型，把编译、测试、打包、部署等都对应成一个个的生命周期阶段，并对每一个阶段提供相应的命令，程序员只需要掌握一些命令，就可以完成项目的构建过程

mvn compile 详解

¶Maven 常用设置

了解了常用命令以及一些基础概念之后，某些项目可能有更详细的配置，接下来介绍 Maven 常用的设置

¶scope 设置

scope 表示依赖使用的范围，也就是在 maven 构建项目的那些阶段中起作用，scope 的值有 compile，test，provided，默认是 compile，不同 scope 对项目的影响如下：

具体配置的实例如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

  junit的依赖范围是 test
<dependency>
     <groupId>junit</groupId>
     <artifactId>junit</artifactId>
     <version>4.11</version>
     <scope>test</scope>
   </dependency>

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

¶Maven 属性设置

<properties>声明项目中的变量，具体使用方式如下：

变量声明的配置如下：

1
2
3
4
5
6
7
8
9
10

<!--定义全局变量-->
<properties>
	<spring.version>4.3.10.RELEASE</spring.version>
</properties>
<!--引用全局变量-->
<dependency>
	<groupId>org.springframework</groupId>
	<artifactId>spring-context</artifactId>
	<version>${spring.version}</version>
</dependency>

¶资源插件设置

资源插件的配置如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

<build>
	<resources>
		<resource>
            <!--所在的目录-->
			<directory>src/main/java</directory>
				<includes>
                <!--包括目录下的.properties,.xml 文件都会扫描到-->
					<include>**/*.properties</include>
					<include>**/*.xml</include>
				</includes>
<!--filtering 选项 false 不启用过滤器， *.property 已经起到过滤的作用了 -->
				<filtering>false</filtering>
		</resource>
	</resources>
</build>

🎶常见的问题就是 MyBatis 的 Mapper 文件的配置

¶Maven 在 IDEA 中的应用

idea 中内置了 maven ，一般不使用内置的，因为用内置修改 maven 的设置不方便，使用自己安装的 maven，需要覆盖 idea 中的默认的设置。让 idea 指定 maven 安装位置等信息

1️⃣ 配置当前工程的设置， file--settings ---Build, Excution,Deployment--Build Tools

1
2
3
4
5
6
7
8
9
10

--Maven
    Maven Home directory: maven的安装目录
    	User Settings File :  就是maven安装目录conf/setting.xml配置文件
    	Local Repository :    本机仓库的目录位置
--Build Tools--Maven--Runner
    VM Options : archetypeCatalog=internal
    JRE: 你项目的jdk

archetypeCatalog=internal , maven项目创建时，会联网下载模版文件，比较大，
        使用DarchetypeCatalog=internal，不用下载， 创建maven项目速度快

2️⃣ 配置以后为新建工程的设置， file–other settings–Settings for New Project

¶Maven 管理多模块应用

多模块应用是大型项目必备的一种状态，本小节主要记录如何使用 Maven 进行多模块应用的管理

¶为什么需要多模块

😣随着项目的不断发展，需求的不断细化与添加，代码越来越多，结构也越来越复杂，这时候就会遇到如下各种问题：

👍将一个复杂项目拆分成多个模块是解决上述问题的一个重要方法，通过将应用模块化具有如下好处：

¶模块拆分策略

¶按职责划分

1
2
3
4
5
6
7

-- module-test
 --module-test-service
 --module-test-po
 --module-test-controller
 --module-test-dao
 --module-test-common
 --module-test-util

¶按照功能拆分

在电商系统中如下 module

1
2
3
4
5
6
7
8
9

--module-test
 --module-test-common 公共部分
 --module-test-order 订单
 --module-test-checkout 购物车
 --module-test-pay 支付
 --module-test-catory 类目
 --module-test-product 商品
 --module-test-price 价格
 --module-test-account 账号

¶工程结构

阿里爸爸推荐的分层架构如下，默认上层依赖下层，箭头关系表示可直接依赖

✨Manager 层有如下特征：

1. 对第三方平台封装的层，预处理返回结果及转化异常信息，适配上层接口
2. 对 Service 层通用能力的下沉，如缓存方案，中间件通用处理
3. 与 DAO 层交互，对多个 DAO 的组合复用

¶分层领域模型规约

🎶不要使用不稳定的工具包或者 Utils 类, 不稳定指的是提供方无法做到向下兼容，在编译阶段正常，但在运行时产生异常，因此，尽量使用业界稳定的二方工具包

¶构建多模块应用

搭建多模块项目，需要使用 maven 的继承和聚合

✨Maven 中聚合和继承的特点

¶创建项目

¶修改父工程

¶创建子模块

¶父工程 pom

此时父工程的pom.xml文件发生了如下变化

1
2
3
4
5
6
7

<groupId>org.example</groupId>
<artifactId>crowfunding</artifactId>
<packaging>pom</packaging>
<version>1.0-SNAPSHOT</version>
<modules>
    <module>crowfundint-01-admin-parent</module>
</modules>

🎶module 的值是子模块相对于当前 POM 的路径

✨更改打包方式为pom的原因

¶子模块 pom

1
2
3
4
5
6
7
8

<parent>
    <artifactId>crowdfunding</artifactId>
    <groupId>com.pineappleman</groupId>
    <version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>

<artifactId>crowdfunding-01-admin-parent</artifactId>

🎶声明了该模块继承自com.pineappleman:crowdfunding:1.0-SNAPSHOT,其实这里面还省略了 <relativePath></relativePath> 由于 relativePath 默认是 ../pom.xml 而我们的子项目确实在父项目的下一级目录中，所以是可以不用填写的。artifactId 是子模块的组件 id，由于继承了父 pom，所以groupId、version 也可以不写，默认继承自父 pom

¶设置父工程编译级别

¶修改父工程 pom 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <!--编译级别-->
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <!--编码格式-->
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>
    </plugins>
</build>

¶查看指定编译级别后

在 File -> Settings -> Build, Execution, Deployment -> Compiler -> Java Compiler查看

¶Maven 依赖版本管理

Maven 中另一个重点的就是依赖管理，接下来详细讲解如何在 idea 中进行依赖管理

¶父工程统一管理依赖

📖在父工程<dependencies>标签中添加三方依赖，子模块会无条件继承父工程所有依赖，例如在父工程的pom.xml中加入下面的依赖，最终每一个子模块都会拥有这个依赖

1
2
3
4
5
6
7

<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.2.8</version>
    </dependency>
</dependencies>

子模块的依赖如下：

¶父工程管理依赖版本号

✨父工程管理的是所有项目模块的依赖，而不是某一个项目模块的依赖，所以某一个项目模块不需要继承父工程中的所有依赖。子项目模块向父工程声明需要的依赖即可（声明式依赖），此时父工程只需要管理依赖的版本号即可

¶父工程添加 dependencyManagement 标签管理依赖

1
2
3
4
5
6
7
8
9

<dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.mybatis</groupId>
                <artifactId>mybatis</artifactId>
                <version>3.2.8</version>
            </dependency>
    </dependencies>
</dependencyManagement>

🎶 由于父工程通过 dependencyManagement 标签管理依赖，之前子模块无条件继承的依赖就全部消失，仅用来声明依赖，并不不导入，只有子模块真正需要使用的时候才导入依赖（<dependency>在子模块中详细声明）

✨dependencyManagement特点

¶父工程添加 properties 管理版本号

🎶 Maven 会沿着父子层次向上走，直到找到一个拥有 dependencyManagement 组件的项目，然后在其中查找，如果找到则返回申明的依赖，没有继续往上找

¶子模块声明式添加依赖

由于父工程管理依赖的版本号，那么子模块要想继承依赖，只能通过声明式来添加依赖，实际上，子模块中的依赖是继承父工程依赖的版本号；如果子模块已定义依赖版本号，那么以子模块定义的版本号为准

¶dependencies与dependencyManagement的区别

¶附录

Maven 多模块管理
maven 依赖版本管理
Maven 与 gradle 的对比
Gradle 与 Maven 的区别
Maven 报错：The packaging for this project did not assign a file to the build artifact
Spring Boot Maven Plugin 打包异常及三种解决方法：Unable to find main class
阿里巴巴开发手册