- Maven是Apache软件基金会组织维护的一款专门为Java项目提供构建和依赖管理支持的工具。
- Java项目开发过程中，构建指的是使用【原材料生产产品】的过程。
- 原材料：
- Java源代码
- 基于Html的Thymeleaf文件
- 图片
- 配置文件
- 产品：
- 一个可以在服务器上运行的项目
- 原材料：
- 构建过程包含的主要环节：
- 清理：删除上一次构建的结果。一般指的是删除target目录
- 编译：将Java源程序编译成*.class字节码文件
- 测试：运行提前准备好的测试程序
- 报告：针对刚才测试的结果生成一个全面的信息
- 打包：
- Java工程：jar包
- Web工程：war包
- 安装：把一个Maven工程经过打包操作生成的jar包或war包存入Maven仓库
- 部署：
- 部署jar包：把一个jar包部署到Nexus私服服务器上
- 部署war包：借助Maven相关插件(例如cargo)，将war包部署到Tomcat服务器上
- 如果A工程里用到了B工程的类、接口、配置文件等等资源，那么我们就可以说A依赖B。
- 例如：
junit-4.12 依赖 hamcrest-core-1.3 thymeleaf-3.0.12.RELEASE 依赖 ognl-3.1.26 ognl-3.1.26 依赖 javassist-3.20.0-GA thymeleaf-3.0.12.RELEASE 依赖 attoparser-2.0.5.RELEASE thymeleaf-3.0.12.RELEASE 依赖 unbescape-1.1.6.RELEASE thymeleaf-3.0.12.RELEASE 依赖 slf4j-api-1.7.26
- 依赖管理中要解决的具体问题：
- jar包的下载：使用Maven之后,jar包会从规范的远程仓库下载到本地仓库。
- jar包的依赖：通过依赖的传递性自动完成。
- jar包的冲突：通过对依赖的配置进行调整，让某些jar包不会被导入。
Maven官网地址：https://maven.apache.org/download.cgi
2.2 下载解压Maven- 核心程序压缩包：apache-maven-3.8.5-bin.zip
- 解压到非中文、没有空格的目录下
在解压过程中：我们需要着重关注Maven的核心配置文件：conf/settings.xml
- 本地仓库默认路径：${user.home}/.m2/repository
- 建议将Maven的本地仓库放在非C盘下
注意：本地仓库的目录也需要是一个非中文和没有空格的。
- Maven下载jar包默认访问境外的中央仓库，而国外网站速度很慢。
- 因此改成阿里云提供的镜像仓库，访问国内网站，可以使得下载速度变快。
2.4.2 加入阿里云镜像
将下面的mirror标签复制到配置文件的mirros标签内部
2.5 配置Maven工程的基础JDK版本nexus-aliyun central Nexus aliyun http://maven.aliyun.com/nexus/content/groups/public
- 如果按照默认配置运行，Java工程使用默认的JDK版本是1.5，而我们熟悉和常用的JDK是1.8的。
- 将profile标签赋值到配置文件的profiles标签内
2.6 配置Maven环境变量jdk-1.8 true 1.8 1.8 1.8 1.8
- Maven是一个用Java语言开发的程序，它必须基于JDK来运行；
- 可以在cmd窗口中使用java -version 来检验jdk是否安装
C:Users10204>mvn -v Apache Maven 3.8.4 (9b656c72d54e5bacbed989b64718c159fe39b537) Maven home: D:developMavenapache-maven-3.8.4 Java version: 1.8.0_321, vendor: Oracle Corporation, runtime: D:developjava8jdk1.8jre Default locale: zh_CN, platform encoding: GBK OS name: "windows 11", version: "10.0", arch: "amd64", family: "windows"三、使用Maven：命令行环境 3.1 根据坐标创建Maven工程 3.1.1 Maven核心概念：坐标
- groupId：公司或组织域名的倒序
- 例如：com.atguigu.maven
- artifactId：模块的名称，将来作为Maven工程的工程名
- version：模块的版本号
- 例如：SNAPSHOT表示快照版本
- 例如：RELEASE表示正式版本
- 坐标：
javax.servlet servlet-api 2.5
- 上面的坐标对应的jar包在Maven本地仓库的位置：
Maven本地仓库根目录javaxservletservlet-api2.5servlet-api-2.5.jar
- 一定要学会根据坐标到本地仓库中找到对应的jar包
运行mvn archetype:generate命令
下面根据提示操作
TIP Choose a number or apply filter (format: [groupId:]artifactId, case sensitive contains): 7:【直接回车，使用默认值】 Define value for property 'groupId': com.atguigu.maven Define value for property 'artifactId': pro01-maven-java Define value for property 'version' 1.0-SNAPSHOT: :【直接回车，使用默认值】 Define value for property 'package' com.atguigu.maven: :【直接回车，使用默认值】 Confirm properties configuration: groupId: com.atguigu.maven artifactId: pro01-maven-java version: 1.0-SNAPSHOT package: com.atguigu.maven Y: :【直接回车，表示确认。如果前面有输入错误，想要重新输入，则输入 N 再回车。】3.2.3 调整
- Maven默认生成的工程，junit版本是较低的3.8.1版本，我们可以改成较合适的4.12版本
- 自动生成的App.java和AppTest.java可以删除
3.2.4 自动生成的pom.xml解读junit junit 4.12 test
3.3 Maven核心概念：POM 3.3.1 含义4.0.0 com.atguigu.maven pro01-maven-java 1.0-SNAPSHOT jar pro01-maven-java http://maven.apache.org UTF-8 junit junit 4.12 test
- POM：Project Object Model，项目对象模型。和POM类似的是：DOM（Document Object Model）文档对象模型。它们都是模型化思想的具体体现。
POM 表示将工程抽象为一个模型，再用程序中的对象来描述这个模型。这样我们就可以用程序来管理项目了。我们在开发过程中，最基本的做法就是将现实生活中的事物抽象为模型，然后封装模型相关的数据作为一个对象，这样就可以在程序中计算与现实事物相关的数据。3.3.3 对应的配置文件
- POM理念集中体现在Maven工程根目录下pom.xml这个配置文件中。所以这个pom.xml配置文件就是Maven工程的核心配置文件。
Maven 为了让构建过程能够尽可能自动化完成，所以必须约定目录结构的作用。例如：Maven 执行编译操作，必须先去 Java 源程序目录读取 Java 源代码，然后执行编译，最后把编译结果存放在 target 目录。3.4.3 约定大于配置
Maven 对于目录结构这个问题，没有采用配置的方式，而是基于约定。这样会让我们在开发过程中非常方便。如果每次创建 Maven 工程后，还需要针对各个目录的位置进行详细的配置，那肯定非常麻烦。 目前开发领域的技术发展趋势就是：约定大于配置，配置大于编码。3.5 在Maven工程中编写代码 3.5.1 主体工程
主体程序指的是被测试的程序，同时也是将来在项目中真正要使用的程序。
package com.atguigu.maven;
public class Calculator {
public int sum(int i, int j){
return i + j;
}
}
3.5.2 测试程序
package com.atguigu.maven;
import org.junit.Test;
import com.atguigu.maven.Calculator;
// 静态导入的效果是将Assert类中的静态资源导入当前类
// 这样一来，在当前类中就可以直接使用Assert类中的静态资源，不需要写类名
import static org.junit.Assert.*;
public class CalculatorTest{
@Test
public void testSum(){
// 1.创建Calculator对象
Calculator calculator = new Calculator();
// 2.调用Calculator对象的方法，获取到程序运行实际的结果
int actualResult = calculator.sum(5, 3);
// 3.声明一个变量，表示程序运行期待的结果
int expectedResult = 8;
// 4.使用断言来判断实际结果和期待结果是否一致
// 如果一致：测试通过，不会抛出异常
// 如果不一致：抛出异常，测试失败
assertEquals(expectedResult, actualResult);
}
}
3.6 执行Maven的构建命令
3.6.1 要求
- 运行Maven中和构建操作相关的命令时，必须进入到pom.xml所在的目录。
- 如果没有在pom.xml所在目录运行的Maven构建命令，那么就会看到下面的错误信息。
The goal you specified requires a project to execute but there is no POM in this directory
TIP mvn -v命令和构建操作无关,只要正确了配置PATH,在任何目录下执行都可以。 而构建相关的命令要在pom.xml所在目录下运行——操作哪个工程，就进入这个工程的pom.xml目录3.6.2 清理操作
- 命令：mvn clean
- 效果：删除target目录
- 主程序编译：mvn compile
- 测试程序编译：mvn test-compile
- 主程序编译结果存放的目录：target/classes
- 测试程序编译结果存放的目录：target/test-classes
- 命令：mvn test
- 测试的报告存放的目录：target/surefire-reports
- 命令：mvn package
- 打包的结果：
- java程序——jar包
- web程序——war包
- 存放的目录：target
- 命令：mvn install
- 安装的效果：将本地生成的jar包/war包存入本地仓库中。这个jar包在Maven本地仓库中的目录是根据坐标生成的。
[INFO] Installing D:developIdeaProjectspro01-maven-javatargetpro01-maven-java-1.0-SNAPSHOT.jar to D:developMavenMaven_Repositorycomatguigumavenpro01-maven-java1.0-SNAPSHOTpro01-maven-java-1.0-SNAPSHOT.jar [INFO] Installing D:developIdeaProjectspro01-maven-javapom.xml to D:developMavenMaven_Repositorycomatguigumavenpro01-maven-java1.0-SNAPSHOTpro01-maven-java-1.0-SNAPSHOT.pom
- 注意：mvn install会将pom.xml文件转换成xxx.pom文件一起存入本地仓库。
- 使用mvn archetype:generate命令可以生成Web工程时，**需要使用一个专门的archetype。**这个专门生成Web工程骨架的archetype可以参照官网看到它的用法
生成Web工程命令：mvn archetype:generate -DarchetypeGroupId=org.apache.maven.archetypes -DarchetypeArtifactId=maven-archetype-webapp -DarchetypeVersion=1.4
- 注意：需要在工作空间根目录来操作。
- 然后运行生成工程的命令
mvn archetype:generate -DarchetypeGroupId=org.apache.maven.archetypes -DarchetypeArtifactId=maven-archetype-webapp -DarchetypeVersion=1.4
- 下面的操作按照提示进行：
TIP Define value for property 'groupId': com.atguigu.maven Define value for property 'artifactId': pro02-maven-web Define value for property 'version' 1.0-SNAPSHOT: :【直接回车，使用默认值】 Define value for property 'package' com.atguigu.maven: :【直接回车，使用默认值】 Confirm properties configuration: groupId: com.atguigu.maven artifactId: pro02-maven-web version: 1.0-SNAPSHOT package: com.atguigu.maven Y: :【直接回车，表示确认】3.7.3 生成的pom.xml
- 确认打包的方式是war包形式
3.7.4 生成的Web工程的目录结构war
- webapp目录下有index.jsp
- WEB-INF目录下有web.xml
1.在main目录下创建java目录
2.在java目录下创建对应的包以及Servlet类
package com.atguigu.maven;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.ServletException;
import java.io.IOException;
public class HelloServlet extends HttpServlet{
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
response.getWriter().write("hello maven web");
}
}
3.在web.xml中注册Servlet
3.7.6 在index.jsp页面编写超链接helloServlet com.atguigu.maven.HelloServlet helloServlet /helloServlet
Hello World! Access Servlet3.7.7 编译
- 此时直接执行mvn compile命令会报错：
程序包 javax.servlet.http 不存在 程序包 javax.servlet 不存在 找不到符号 符号: 类 HttpServlet ...
上面的错误信息说明：我们的Web工程用到了HttpServlet类，而HttpServlet这个类属于servlet-api.jar这个包。
因此我们需要引入servlet-api.jar
- 对于不知道详细信息的依赖可以到https://mvnrepository.com/网站查询。使用关键词搜索，然后在搜索结果列表中选择适合的使用。
javax.servlet javax.servlet-api 3.1.0 provided
- 引入之后，重新执行mvn compile 命令
- 命令：mvn package
进入到tomcat/bin目录：启动startup.bat
访问：http://localhost:8080/pro02-maven-web-1.0-SNAPSHOT/index.jsp
- 明确一个意识：从来只有web工程依赖java工程，没有反过来java工程依赖web工程的。本质上说，web工程依赖的java工程其实就是web工程中引入java工程的jar包。最终jar包会存放在web工程的WEB-INF/lib目录下
在pro02-maven-web工程的pom.xml中引入pro01-maven-java的jar包
3.8.3 在web工程中,编写测试代码com.atguigu.maven pro01-maven-java 1.0-SNAPSHOT
1.在web工程的test目录中创建包com.atguigu.maven
2.确保web工程引入了junit依赖
junit junit 4.12 test
3.创建测试类：将java工程中的CalculatorTest.java复制到web工程的test目录中
3.8.4 执行Maven命令- 测试命令
- mvn test
- mvn test
- 打包命令
- mvn package
通过查看war包内的结构，我们看到被Web工程依赖的Java工程确实是会变成Web工程的WEB-INF/lib目录下的jar包
- mvn package
- 查看当前工程所依赖的jar包的列表命令
- mvn dependency:list
- **mvn:dependcy:tree：**以树形结构查看
- 标签scope
- scope标签的可选值：compile/test/provided/system/runtime/import
| main目录 | test目录 | 开发过程 | 部署到服务器 | |
|---|---|---|---|---|
| compile | 有效 | 有效 | 有效 | 有效 |
| test | 无效 | 有效 | 有效 | 无效 |
| main目录 | test目录 | 开发过程 | 部署到服务器 | |
|---|---|---|---|---|
| compile | 有效 | 有效 | 有效 | 有效 |
| provided | 有效 | 有效 | 有效 | 无效 |
- compile：在项目的开发和实际运行中都用到的jar包
- test：测试过程中使用的jar包。
- 例如：junit
- provided：在开发过程中若服务器上自带该jar包，通常以provided范围依赖进来。
- 比如：servlet-api、jsp-api，这两个jar包之所以不参与部署、不放进war包，就是避免和服务器上已有的同类jar包产生冲突
- A依赖B，B依赖C，那么在A没有配置对C的依赖情况下，A里面能不能直接使用C ？
- 在A依赖B，B依赖C的前提下，C能否传递到A，取决于B依赖C时的依赖范围，也就是scope范围
- B依赖C时使用compile范围：C可以传递到A
- B依赖C时使用test或者provided范围：C不可以传递到A
- 当A依赖B，B依赖C而且C可以传递到A的时候，A不想要C，需要在A里面把C排除掉。而往往这种情况都是为了避免jar包之间的冲突。
- 因此配置依赖的排除其实就是阻止某些jar包的传递。因为这样的jar包传递过来和其他jar包会冲突。
3.12 继承 3.12.1 概念com.atguigu.maven pro01-maven-java 1.0-SNAPSHOT compile commons-logging commons-logging
在Maven中,若A工程继承B工程
- B工程：父工程
- A工程：子工程
本质上是A工程的pom.xml中的配置继承了B工程中的pom.xml的配置
- 在父工程中统一管理项目中的依赖信息，具体来说是管理依赖信息的版本。
- 每一个Project下创建了很多的module模块。
编写一套符合要求、开发各种功能都能正常工作的依赖组合并不容易。如果公司里已经有人总结了成熟的组合方案，那么再开发新项目时，如果不使用原有的积累，而是重新摸索，会浪费大量的时间。为了提高效率，我们可以使用工程继承的机制，让成熟的依赖组合方案能够保留下来。
3.13 聚合 3.13.1 聚合的含义- 部分组成整体
- 在项目中就代表多个模块组成一个项目(工程)
- 创建 Project 后，IDEA 会自动弹出下面提示，我们选择『Enable Auto-Import』，意思是启用自动导入。
- 这个自动导入一定要开启，因为 Project、Module 新创建或 pom.xml 每次修改时都应该让 IDEA 重新加载 Maven 信息。这对 Maven 目录结构认定、Java 源程序编译、依赖 jar 包的导入都有非常关键的影响。
- 另外也可以通过 IDEA 的 Settings 设置来开启：
- 每次创建 Project 后都需要设置 Maven 家目录位置，否则 IDEA 将使用内置的 Maven 核心程序（不稳定）并使用默认的本地仓库位置。这样一来，我们在命令行操作过程中已下载好的 jar 包就白下载了，默认的本地仓库通常在 C 盘，还影响系统运行。
- 配置之后，IDEA 会根据我们在这里指定的 Maven 家目录自动识别到我们在 settings.xml 配置文件中指定的本地仓库
- 按照前面的同样操作创建模块，此时这个模块其实还是一个Java模块
- 打包方式设置成war包
4.4.3 web设置war
- 首先打开项目结构菜单：
- 然后到Facts 查看IDEA是否已经帮我们自动生成了web设定。
- 正常来说只要我们确实设置了打包方式为war，那么IDEA就会自动生成Web设定。
- 若IDEA未自动生成Web设定，那么参照下面两图，自行创建：
- web资源的根目录需要设置为src/main/webapp目录
- 直接执行
- 手动输入
- 如果有需要，还可以给命令后面附加参数：
# -D 表示后面要附加命令的参数，字母 D 和后面的参数是紧挨着的，中间没有任何其它字符 # maven.test.skip=true 表示在执行命令的过程中跳过测试 mvn clean install -Dmaven.test.skip=true4.5.2 在IDEA查看某个模块的依赖信息 4.5.3 工程导入 ① 来自版本控制系统 ② 来自工程目录
-
在打开项目的时候只要确认可以看到pom.xml就可以打开
-
打开一个新的 Maven 工程，和新创建一个 Maven 工程是一样的，此时 IDEA 的 settings 配置中关于 Maven 仍然是默认值：
-
所以我们还是需要像新建 Maven 工程那样，指定一下 Maven 核心程序位置：
在实际开发中，通常会忽略模块（也就是module）所在的项目（也就是project）仅仅导入某一个模块本身。这么做很可能是类似这样的情况：比如基于 Maven 学习 SSM 的时候，做练习需要导入老师发给我们的代码参考。
【1】找到老师发的工程目录
【2】复制我们想要导入的模块目录
【3】粘贴到我们自己工程目录下
【4】在IDEA进行导入
【6】修改pom.xml
刚刚导入的 module 的父工程坐标还是以前的，需要改成我们自己的 project。
【6】最终结果
为了让构建过程自动化完成，Maven设定了三个周期，生命周期中的每一个环节对应构建过程中的一个操作。
② 三个生命周期| 生命周期名称 | 作用 | 各个环节 |
|---|---|---|
| clean | 清理操作 |
- 三个生命周期彼此独立。
- 在任何一个生命周期内部，执行任何一个具体环节的操作，都是从本生命周期最初的位置开始执行，直到指定地方
- Maven 的核心程序仅仅负责宏观调度，不做具体工作。具体工作都是由 Maven 插件完成的。
- 一个插件可以对应多个目标，而每一个目标都和生命周期中的某一个环节对应。
- Default 生命周期中有 compile 和 test-compile 两个和编译相关的环节，这两个环节对应 compile 和 test-compile 两个目标，而这两个目标都是由 maven-compiler-plugin-3.1.jar 插件来执行的。
- 本地仓库：在当前电脑上，为电脑上所有 Maven 工程服务
- 远程仓库：需要联网
- 局域网：我们自己搭建的 Maven 私服，例如使用 Nexus 技术。
- Internet：
- 中央仓库：
- 镜像仓库：内容和中央仓库保持一致，但是能够分担中央仓库的负载，同时让用户能够就近访问提高下载速度，例如：Nexus aliyun
- 建议：不要中央仓库和阿里云镜像混用，否则 jar 包来源不纯，彼此冲突。
