maven相关入门

maven是什么？

Apache Maven是一个软件项目管理和综合工具。 基于项目对象模型(Project Object Model ，POM)的概念，Maven可以从一个中心信息块管理项目的构建、报告和文档。

maven是一款专门针对java工程的构建、管理工具。

创建构建工具的演变：Make–>Ant–>Maven–>Gradle

编译：将java源文件（.java)经过编译器(javac)变成class字节码文件（.class)的过程。前者是人类编写、阅读、维护的。后者是在JVM上执行的。

构建：以“java源文件”、“框架配置文件”、“jsp"、”html“、“图片”等资源未原材料，去“生产”一个可以运行的项目的过程

为什么需要maven？

传统不适用maven的项目存在以下问题：

1. 一个项目就是一个工程

   比如一个项目需要web工程、APP工程等多个工程，项目很大时，工程会很多。每个工程都需要的一些公共模块需要重复性的放到每个工程中去。这样会导致整个项目非常臃肿也不便于团队协作。使用maven，可以将每个工程彼此独立，便于不同的研发团队分别负责各自的工程。

2. 项目中需要用到的jar包需要手动复制、粘贴到WEB-INF/lib目录下；

   导致同样的jar包重复的出现在项目工程中，浪费存储空间，也不便于jar的管理（比如需要替换jar时）。使用maven时，只需要将jar包放到仓库中，有需要使用的工程只需引用即可

3. jar包需要别人准备好或者到官网手动下载

   不同技术提供的jar包下载的形式五花八门，使用maven，可以按其统一的规范，直接从中央仓或者中央仓库镜像中拉取相关的jar包

4. 一个jar包依赖的其他jar需要自己手动加入到项目中；

   jar包之间的相互依赖需要手动解决，使用maven可以帮我们自动解析jar的相互依赖关系，自动从仓库中拉取相关jar包

maven安装？

前提条件

• Maven 3.3+ 需要 JDK 1.7 or above
• 磁盘：maven本身安装需要10MB左右，具体磁盘需求取决于本地仓库内的文件大小
• OS：windows或者linux都是可以的。

安装步骤

1. 下载 https://maven.apache.org/download.cgi zip格式的二进制包（tar.gz格式的类似）

2. 解压到指定目录

    unzip apache-maven-3.8.5-bin.zip  -d /usr/local/
    mv /usr/local/apache-maven-3.8.5/ /usr/local/apache-maven/
   

3. 修改本地仓库（按需）

   <localRepository>/path/to/local/repo</localRepository>
   

4. 修改中央仓库镜像（推荐，否则会很慢设置失败）

   在<mirrors></mirrors>对中加如下配置，删除默认的配置
   	<mirror>
   	  <id>aliyunmaven_public</id>
   	  <mirrorOf>*</mirrorOf>
   	  <name>阿里云public仓库</name>
   	  <url>https://maven.aliyun.com/repository/public</url>
   	</mirror>
   	<mirror>
   	  <id>aliyunmaven_central</id>
   	  <mirrorOf>*</mirrorOf>
   	  <name>阿里云central仓库</name>
   	  <url>https://maven.aliyun.com/repository/central</url>
   	</mirror>
   

5. 设置环境变量

   vim ~/.bash_profile
   #添加
   PATH=/usr/local/apache-maven/bin:/usr/local/rocketmq/rocketmq-nameserver/bin/:$PATH
   export PATH
   
   source ~/.bash_profile
   

6. 测试

   如下说明maven安装成功

   [root@k8s-master ~]# mvn -v
   Apache Maven 3.8.5 (3599d3414f046de2324203b78ddcf9b5e4388aa0)
   Maven home: /usr/local/apache-maven
   Java version: 1.8.0_192, vendor: Oracle Corporation, runtime: /usr/local/paas-agent/jdk1.8.0_192/jre
   Default locale: en_US, platform encoding: UTF-8
   OS name: "linux", version: "3.10.0-957.27.2.el7.x86_64", arch: "amd64", family: "unix"
   

maven核心概念

maven工程的目录结构

├─HelloWorld 工程名
│ ├─.idea
│ └─src 源码
│ ├─main 存放主程序
│ │ ├─java 存放java源文件
│ │ └─resources 存放框架或者其他工具的配置文件
│ └─test 存放测试程序
│ ├─java 存放java源文件
│ └─resources 存放框架或者其他工具的配置文件
├─pom.xml maven的核心配置文件

POM #整个maven工程的核心配置文件

pom：含义即Project Object Model，项目对象模型
pom.xml是整个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>org.example</groupId>   <!--坐标-->
    <artifactId>HelloWorld</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>			<!--依赖-->
        <maven.compiler.source>18</maven.compiler.source>
        <maven.compiler.target>18</maven.compiler.target>
    </properties>

</project>

坐标（简称GAV）

数学中的坐标：

• 平面：通过x，y两个向量可以唯一的定义平面中的任何一个点；
• 空间：通过x，y，z三个向量可以唯一的定义空间的任何一个点

maven中的坐标：使用下面三个向量在仓库中唯一定位一个maven工程

• groupid：公司或者组织域名倒序 + 项目名
  <groupId>org.example</groupId>
• artifactid：模块名
  <artifactId>HelloWorld</artifactId>
• version：版本
  <version>1.0-SNAPSHOT</version>
  maven工程的坐标与仓库中的路径的关系：
  仓库路径：将groupI中的点号换成‘/’,然后按如下格式：groupId/artifactId/version/artifactId-version.jar 生成的便是仓库中文件的路径。

仓库

分类：本地仓库和远程仓库（①私服：架设在局域网环境下，为当前局域网范围内的所有maven工程服务；②中央仓库：架设在internet上，为世界上所有maven工程服务；③中央仓库的镜像：架设在各大洲，为中央仓库分担流量。减轻中央仓库的压力，同时更快的响应用户请求。）
内容：

• maven自身所需要的插件
• 第三方框架或者工具的jar包
• 我们自己开发的maven工程

依赖

Maven解析pom.xml中的依赖信息（dependency）会到本地仓库中查找被依赖的jar包。对于我们自己开发的maven工程，使用maven intall命令安装后就可以进入仓库。

依赖的范围（scope）：

1）compile范围依赖：

• 对主程序（main）是否有效：有效
• 对测试程序（test）是否有效：有效
• 是否参与打包：参与

2）test范围依赖

• 对主程序（main）是否有效：无效
• 对测试程序（test）是否有效：有效
• 是否参与打包：不参与

3）provided范围依赖：

• 对主程序（main）是否有效：有效
• 对测试程序（test）是否有效：有效
• 是否参与打包：不参与

生命周期

生命周期：定义了各个构建环节的执行顺序，有了这个清单，maven就可以自动化的执行构建命令了。

maven有三套独立的生命周期分别如下：

“独立”表示：可以仅仅调用clean来清理工作目录；可以仅仅调用site来生成站点；也可以调用mvn clean install site来运行这三套生命周期。

1）Clean Lifecycle：在进行真正构建之前进行一些清理工作；

2）Default Lifecycle：构建的核心部分，编译、测试、打包、安装、部署等

3）Site Lifecycle：生成项目报告、站点、发布站点。

阶段

每套生命周期都由一系列“阶段（phase）组成，阶段即定义了对应的任务是什么，相当于大步骤中的小步骤。每个阶段都特定的插件来完成。

比如：Default生命周期，有如下这些常用的阶段：

• validate
• generate-sources
• process-sources
• generate-resources
• process-resources （复制并处理资源文件到目标目录，准备打包）
• compile （编译项目的源代码）
• process-classes
• generate-test-sources
• process-test-sources
• generate-test-resources
• process-test-resources (复制并处理资源文件到测试目录)
• test-compile （编译测试源代码）
• process-test-classes
• test （使用合适的单元测试框架进行测试，这些测试代码不会被打包或者部署）
• prepare-package
• package （接受编译好的代码，打包成可发布的格式，比如jar）
• pre-integration-test
• integration-test
• post-integration-test
• verify
• install （将包安装到本地仓库，以便能让其他项目依赖）
• deploy （将最终的包复制到远程的仓库，以便让其他开发人员与项目共享或者部署到服务器上运行）

注意：运行任意阶段，则它前面的所有阶段都会执行。

比如：mvn packge 时，则从validate 到prepare-package的所有阶段都会执行。

插件

阶段、目标、插件 关系

生命周期阶段	插件目标	插件
……
compile	compile	maven-compiler-plugin:3.8.0
default-testResources	testResources	maven-resources-plugin:3.1.0
default-testCompile	testCompile	maven-compiler-plugin:3.8.0
……

常用的maven命令

注意：执行与构建过程相关的maven命令，必须进入pom.xml所在的目录。比如：编译、测试、打包

• mvn clean：清理(删除maven工程根目录下的target目录）
• mvn compile：编译主程序
• mvn test-compile：编译测试程序
• mvn test：执行测试
• mvn package：打包

maven的核心程序中仅仅定义了抽象的生命周期，但是具体的工作必须有特定的插件来完成。而插件本身并不包含在maven的核心程序中。
当执行的maven命令需要用到某些插件时，maven核心程序会首先到本地仓库查找（本地仓库默认在用户的家目录\.m2\repository\），若查找不到则会到maven配置的中央仓库查找。若无法联网，则会构建失败。

如何修改maven仓库位置？
1）修改本地仓库位置
修改maven解压目录下conf/setting.xml中的
<localRepository>/path/to/local/repo</localRepository>
2）修改在线中央仓库的位置
修改maven解压目录下conf/setting.xml中的

	<mirror>
	  <id>aliyunmaven_public</id>
	  <mirrorOf>*</mirrorOf>
	  <name>阿里云public仓库</name>
	  <url>https://maven.aliyun.com/repository/public</url>
	</mirror>