【Maven自动化构建工具】 | 项目管理工具

目录

第1章：Maven简介

1. 传统项目开发存在的问题

2. Maven 概述

3.  Maven核心概念

4. 安装 Maven 环境

第2 章 Maven 的核心概念

1. Maven 工程约定目录结构

2. 仓库概念

3. POM文件

4. 坐标

5. 依赖

6.  Maven的生命周期、命令和插件

第 3 章 Maven 在 IDEA 中的应用

1. Maven的配置

2. IDEA 创建 Maven 版 java 工程

3. IDEA 创建 Maven 版 web 工程

4. IDEA中导入Maven工程

第 4 章 依赖管理

第 5 章 Maven常用设置

1. 全局变量

2.  指定资源位置（重要）

---

第1章：Maven简介

官网：http://maven.apache.org/

1. 传统项目开发存在的问题

（1）一个项目做成一个工程，造成工程比较庞大，需要使用多模块来划分项目；

（2）项目中需要的数量众多的 jar 包，需要手动下载并引入，并且多个项目需要的 jar 包存在重复的问题；

（3）项目中需要的 jar 包有版本兼容的问题，需要手动解决；

（4）项目中需要的 jar 包又依赖其它的 jar 包，需要手动解决。

2. Maven 概述

（1）Maven 是 Apache 软件基金会组织维护的一款自动化构建工具，专注服务于 Java 平台的项目构建和依赖管理。Maven 这个单词的本意是：专家，内行。

（2）Maven 是目前最流行的自动化构建工具，对于生产环境下多框架、多模块整合开发有重要作用，Maven 是一 款在大型项目开发过程中不可或缺的重要工具。

（3）Maven 可以整合多个项目之间的引用关系，我们可以根据业务和分层需要任意拆分一个项目；

（4）Maven 提供规范的管理各个常用 jar 包及其各个版本，并且可以自动下载和引入项目中；

（5）Maven 可以根据指定版本自动解决 jar 包版本兼容问题；

（6）Maven 可以把 jar 包所依赖的其它 jar 包自动下载并引入项目。

构建（build），是面向过程的(从开始到结尾的多个步骤)，涉及到多个环节的协同工作，构建过程中的各个环节：清理、编译、测试、报告、打包、安装、部署。

①清理：删除以前的编译结果，为重新编译做好准备。

②编译：将Java源程序编译为字节码文件。

③测试：针对项目中的关键点进行测试，确保项目在迭代开发过程中关键点的正确性。

④报告：在每一次测试后以标准的格式记录和展示测试结果。

⑤打包：将一个包含诸多文件的工程封装为一个压缩文件用于安装或部署。Java 工程对应 jar 包，Web工程对应war包。

⑥安装：在Maven环境下特指将打包的结果——jar包或war包安装到本地仓库中。

⑦部署：将打包的结果部署到远程仓库或将war包部署到服务器上运行

3.  Maven核心概念

Maven能够实现自动化构建是和它的内部原理分不开的，这里我们从 Maven的九个核心概念入手，看看Maven是如何实现自动化构建的？

①POM ： 一个文件 名称是pom.xml ,  pom翻译过来叫做项目对象模型。 maven把一个项目当做一个模型使用，控制maven构建项目的过程，管理jar依赖。

②约定的目录结构 ： maven项目的目录和文件的位置都是规定的。

③坐标 ： 是一个唯一的字符串，用来表示资源的。

④依赖管理 ： 管理项目中可以使用的jar文件

⑤仓库管理（了解） ：你的资源存放的位置

⑥生命周期 (了解) ： maven工具构建项目的过程，就是生命周期。
⑦插件和目标（了解）：执行maven构建的时候用的工具是插件
⑧继承
⑨聚合

4. 安装 Maven 环境

（1）首先要确保安装了 java 环境：maven 本身就是 java 写的，所以要求必须安装 JDK。

        查看 java 环境变量：echo %JAVA_HOME%

（2）下载并解压 maven 安装程序： https://maven.apache.org/download.cgi 

        子目录 bin ：执行程序，主要是mvn.cmd
        子目录conf ：maven工具本身的配置文件 settings.xml

（3）配置环境变量
在系统的环境变量中，指定一个M2_HOME的名称， 指定它的值是maven工具安装目录

     M2_HOME=C:\dev\maven_work\apache-maven-3.3.9

再把M2_HOME加入到Path之中：

    %M2_HOME%\bin;     

（4）验证，新的命令行中，执行mvn -v

第2 章 Maven 的核心概念

1. Maven 工程约定目录结构

Hello ：根目录，也就是工程名
 |---src ：源代码
         |---|---main ：主程序
                 |---|---|---java： 主程序的 java 源码
                 |---|---|---resources： 主程序的配置文件
        |---|---test ：测试程序
                |---|---|---java ：测试程序的 java 源码
                |---|---|---resources ：测试程序的配置文件
 |---pom.xml：Maven 工程的核心配置文件

（1）首先编写一个类放入java目录下的com.bjpowernode包下；进入src目录下输入：

mvn compile （编译src/main目录下的所有java文件）第一次编译会出现大量的下载操作！

①为什么要下载？

maven工具执行的操作需要很多插件完成的

②下载了什么东西？

 jar文件--叫做插件--插件是完成某些功能

③下载的东西存放到哪里了？

默认仓库（本机仓库）：C:\Users\（登录操作系统的用户名）Administrator\.m2\repository

（2）执行mvn compile， 结果是在项目的根目录下生成target目录（结果目录），maven编译的java程序，最后的class文件都放在target目录中！

 （3）修改本地仓库地址

第一步：修改maven的配置文件， maven安装目录/conf/settings.xml（先备份 settings.xml）

第二步：修改这个标签，进行目录的指定指定的目录

2. 仓库概念

（1）仓库是什么： 仓库是存放东西的， 存放maven使用的插件 和 我们项目使用的jar

例如：在没有网络的情况下，我们可以提前把所有的资源下载好，放到一个文件夹里面，然后把这个文件夹配置到指定目录里作为本地仓库使用，例：C:/dev/maven_work/repository

（2）仓库的分类

本地仓库：就是你的个人计算机上的文件夹，存放各种jar

远程仓库：在互联网上的，使用网络才能使用的仓库

①：中央仓库，最权威的， 所有的开发人员都共享使用的一个集中的仓库，https://repo.maven.apache.org：中央仓库的地址
②：中央仓库的镜像：就是中央仓库的备份， 在各大洲，重要的城市都有这种镜像。

③：私服，在公司内部，在局域网中使用的， 不是对外使用的。

（3）仓库的使用

maven仓库的使用不需要人为参与，例如：开发人员需要使用mysql驱动，maven首先查本地仓库、然后从私服、再从镜像、最后再从中央仓库中查找。

3. POM文件

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

POM文件-坐标：唯一值， 唯一标识一个项目的名称

①公司域名的倒写
②自定义项目名称
③自定版本号

 https://mvnrepository.com/ 搜索使用的中央仓库， 使用groupId 或者 artifactId作为搜索条件

 POM文件-打包：打包后压缩文件的扩展名，默认是jar；web应用时war

POM文件-依赖： dependencies 和dependency ，相当于是 java代码中import

例如：直接从仓库中找到对应的jar包，然后复制坐标放入dependencies标签即可。

 POM文件-设置属性：

 POM文件-构建：

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

4. 坐标

（1）Maven 把任何一个插件都作为仓库中的一个项目进行管理，用一组(三个)向量组成的坐标来表示。坐标在仓库中可以唯一定位一个 Maven 项目。

①groupId：组织名，通常是公司或组织域名倒序+项目名

②artifactId：模块名，通常是工程名

③version：版本号

（2）需要特别指出的是，项目在仓库中的位置是由坐标来决定的：groupId、artifactId 和 version 决定项目在仓库中 的路径，artifactId 和 version 决定 jar 包的名称。

  com.bjpwoernode.maven
  ch01-maven
  1.0-SNAPSHOT

5. 依赖

（1）一个 Maven 项目正常运行需要其它项目的支持，Maven 会根据坐标自动到本地仓库中进行查找。对于程序员自己的 Maven 项目需要进行安装，才能保存到仓库中。

（2）不用 maven 的时候所有的 jar 都不是你的，需要去各个地方下载拷贝，用了 maven 所有的 jar 包都是你的，想要谁，叫谁的名字就行，maven 帮你下载。

  
       
       
            mysql
            mysql-connector-java
            5.1.9
       

6.  Maven的生命周期、命令和插件

maven的生命周期：就是maven构建项目的过程，清理，编译，测试，报告，打包，安装，部署等过程。
maven的命令：maven可以独立使用，通过命令完成maven的生命周期的执行。

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

（1）单元测试

①单元测试（测试方法）：用的是junit， junit是一个专门测试的框架（工具）。
②junit测试的内容： 测试的是类中的方法， 每一个方法都是独立测试的。
                                 方法是测试的基本单位（单元）。

③maven借助单元测试，批量的测试你类中的大量方法是否符合预期的。

（2）使用步骤

加入依赖，在pom.xml加入单元测试依赖

        
			junit
			junit
			4.11
			test
		

在maven项目中的src/test/java目录下，创建测试程序； 推荐的创建类和方法的提示：

①测试类的名称是：Test + 要测试的类名

例如：要测试HelloMaven，创建测试类 TestHelloMaven

public class TestHelloMaven{
    @Test
	public void testAdd(){
        测试HelloMaven的add方法是否正确
	}
}

 其中testAdd叫做测试方法，它的定义规则：
①方法是public的，必须的
②方法没有返回值， 必须的
③方法名称是自定义的，推荐是Test + 方法名称
④在方法的上面加入 @Test

（3）Maven的常用命令

mvn clean：清理(会删除原来编译和测试的目录，即 target 目录，但是已经 install 到仓库里的包不会删除)

mvn compile：编译主程序(会在当前目录下生成一个 target，里边存放编译主程序之后生成的字节码文件)

mvn test-compile：编译测试程序(会在当前目录下生成一个 target，里边存放编译测试程序之后生成的字节码文件)

mvn test：测试(会生成一个目录surefire-reports，保存测试结果)

mvn package：打包主程序(会编译、编译测试、测试、并且按照 pom.xml 配置把主程序打包生成 jar 包或者 war 包)

mvn install：安装主程序(会把本工程打包，并且按照本工程的坐标保存到本地仓库中)

mvn deploy：部署主程序(会把本工程打包，按照本工程的坐标保存到本地库中，并且还会保存到私服仓库中；还会自动把项目部署到 web 容器中)。

①mvn clean：用到maven-clean-plugin插件完成清空操作，清除原先生成的target文件

②mvn compile：用到两个插件maven-resources-plugin和maven-compiler-plugin，

前者是把main/resources目录下的文件拷贝到target/classes目录下；

后者是把编译的主程序代码的class文件放到target/classes目录下

③mvn test-compile：还是使用上述两个插件进行编译，编译的是测试程序的代码，编译后的class文件放到target\test-classes目录下

④mvn test：执行测试程序的代码，并且在\target\surefire-reports下保存测试结果的文件

⑤mvn package：就是把原来的项目生成一个压缩文件；使用maven-jar-plugin插件，生成的文件放到target\ch01-maven-1.0-SNAPSHOT.jar生成一个jar文件；生成名字的来源是标签和标签的结合体；并且生成的jar包文件，只包含src/main目录下的所有文件，没有test目录下的文件

⑥mvn install：把打包好的项目，安装到我们本地的仓库当中

（4）插件配置

插件可以在自己的项目中设置，最常使用的是 maven 编译插件。设置项目使用的 jdk 版本时通过编译插件指定；pom.xml 文件中设置：

 
	 
	  
		 
		  
			 
			 org.apache.maven.plugins 
			 maven-compiler-plugin 
			 3.8.1
			 
			  
				 
				 1.8 
				 1.8 
			  
		  
	  
 

第 3 章 Maven 在 IDEA 中的应用

1. Maven的配置

（1）IDEA中内置了maven ，一般不使用内置的， 因为用内置修改maven的设置不方便。可以使用自己安装的maven， 需要覆盖IDEA中的默认的设置。

（2）配置的入口 ：配置当前工程的设置/其它工程设置， file--settings/other settings(两个都要设置) ---Build, Excution,Deployment--Build Tools--Maven 

注：settings是当前的模块使用，other settings（New Projects Setup---->Settings for New Projects..中设置）表示以后只要创建项目都采用这个配置

①Maven Home directory: maven的安装目录
②User Settings File :  就是maven安装目录conf/setting.xml配置文件
③Local Repository :    本机仓库的目录位置，上面配置好，会自动配置这一项

 （3）在配置一下Build Tools--Maven--Runner配置以下两个选项：

① VM Options : -DarchetypeCatalog=internal
②JRE: 项目的jdk

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

2. IDEA 创建 Maven 版 java 工程

（1）使用模版创建项目，maven-archetype-quickstart : 普通的java项目

 （2）填写 maven 工程的坐标

（3） 填写工程名和存储路径

（4） pom.xml 加入依赖

    4.0.0

    
    com.bjpowernode
    module001-maven
    1.0-SNAPSHOT
    
    
        UTF-8
        1.8
        1.8
    
    
    
        
            junit
            junit
            4.12
            test
        
    

（5）编写程序进行测试

主程序

package com.bjpowernode;

public class HelloMaven {
    public int add(int m,int n){
        return n+m;
    }

    public static void main(String[] args) {
        HelloMaven hello = new HelloMaven();
        int res = hello.add(10, 20);
        System.out.println(res);
    }
}

测试程序：直接ctrl+shift+T就可以生成测试程序，也可以手动创建

package com.bjpowernode;

import org.junit.Assert;
import org.junit.Test;

// 直接点击三角形就能运行，不需要主方法
public class TestHelloMaven {
    @Test
    public void testAdd(){
        System.out.println("testAdd方法执行了");
        HelloMaven hello = new HelloMaven();
        int res = hello.add(10, 20);
        Assert.assertEquals(30,res);
    }
}

（6）查看后视图

3. IDEA 创建 Maven 版 web 工程

选择模板maven-archetype-webapp : 创建web工程；步骤和上面的步骤一样，创建好以后，我们编写servlet和jsp不需要在导入两个jar包，只需要在pom.xml引入依赖：

（1）创建缺省文件夹：创建好的结构是没有java目录和resources目录的

 （2）pom.xml添加依赖：servlet和jsp的依赖

    4.0.0
    war

    module002-moven
    com.bjpowernode
    module002-moven
    1.0-SNAPSHOT

    
        
        
            junit
            junit
            4.12
            test
        
        
        
            javax.servlet
            javax.servlet-api
            3.1.0
            provided
        
        
        
            javax.servlet.jsp
            jsp-api
            2.1
            provided
        
    

（3）创建一个Servlet进行测试

index.jsp发送请求

<%@ page contentType="text/html;charset=UTF-8" language="java" %>


    


    访问jsp

编写Servlet

package com.bjpowernode;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;


public class HelloServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

    }

    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        out.print("Hello");
    }
}

属性配置文件web.xml

    
        HelloServlet
        com.bjpowernode.HelloServlet
    
    
        HelloServlet
        /hello
    

        

4. IDEA中导入Maven工程

（1）File-->Project Structure

（2） 选择要导入的Module

（3） 选择导入方式

第 4 章 依赖管理

（1）依赖范围， 使用标签表示。
（2）scope的值有：compile, test, provided ，默认是compile
（3）scope：表示依赖使用的范围，也就是在maven构建项目的那些阶段中起作用。
（4）maven构建项目  编译， 测试 ，打包， 安装 ，部署 过程（阶段）
①对于compile是整个过程都起作用

②对于test只在测试阶段起作用

③对于provided表示提供者，只在编译和测试起作用

第 5 章 Maven常用设置

1. 全局变量

（1）maven的属性设置：  设置maven的常用属性

（2）自定义全局变量一般是定义 依赖的版本号， 当项目中要使用多个相同的版本号，先使用全局变量定义， 在使用${变量名}；例如：

定义全局变量

    
    4.3.10.RELEASE 
 

引用全局变量

   
    org.springframework   
    spring-context   
    ${spring.version} 
 

2.  指定资源位置（重要）

（1）src/main/java和src/test/java 这两个目录中的所有*.java文件会分别在compile和test-compile阶段被编译，编译结果.class文件分别放到了target/classes和targe/test-classes目录中，但是这两个目录中的其他文件都会被忽略掉！

（2）如果需要把src/main/java目录下的其它非 ".java" 文件包在编译时放到target/classes目录，作为输出的jar一部分；就需要指定资源文件位置，以下内容放到标签中：

    
        
            src/main/java
            
                **/*.properties
                **/*.xml
            
            
            false
        
    

（3）以上代码的意思就是：把src/main/java目录下的.properties文件和.xml文件全都扫描到，在编译时会生成到target/classes目录下！

注：使用这个标签设置后，原来放入resources目录下的文件编译时默认就会放到target/classes目录下了！