笔记屋 笔记屋
  • 首页
  • 大数据
    • Hadoop
  • 码农碎笔
  • 杂乱无章
  • 好物收藏

Maven笔记- 核心概念

Maven 的核心概念包括:POM、约定的目录结构、坐标、依赖、仓库、生命周期、插件和目标、继承、
聚合。

POM

Project Object Model:项目对象模型。将 Java 工程的相关信息封装为对象作为便于操作和管理的模型。Maven 工程的核心配置。可以说学习 Maven 就是学习 pom.xml 文件中的配置。

约定的目录结构

现在 JavaEE 开发领域普遍认同一个观点:约定>配置>编码。意思就是能用配置解决的问题就不编码,能基于约定的就不进行配置。而 Maven 正是因为指定了特定文件保存的目录才能够对我们的 Java 工程进行
自动化构建。

Maven笔记- 核心概念-笔记屋

坐标

1)几何中的坐标

(1)在一个平面中使用 x、y 两个向量可以唯一的确定平面中的一个点。
(2)在空间中使用 x、y、z 三个向量可以唯一的确定空间中的一个点。

2)Maven 的坐标

使用如下三个向量在 Maven 的仓库中唯一的确定一个唯一的 jar。

  • (1)groupId:公司或组织的域名倒序+当前项目名称
  • (2)artifactId:当前项目的模块名称
  • (3)version:当前模块的版本

在项目的 pom.xml 文件中存储坐标


<?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.cosyblogs.maven</groupId>
<artifactId>Hello</artifactId>
<version>1.0-SNAPSHOT</version>
</project>

3)如何通过坐标到仓库中查找 jar 包?

(1)将 gav 三个向量连起来

com.atguigu.maven + Hello + 1.0-SNAPSHOT

(2)以连起来的字符串作为目录结构到仓库中查找

com/atguigu/maven/Hello/1.0-SNAPSHOT/Hello-1.0-SNAPSHOT.jar

注意:我们自己的 Maven 工程必须执行安装操作才会进入仓库。安装的命令是:mvn install

第二个 Maven 工程

1)创建 HelloFriend Module

Maven笔记- 核心概念-笔记屋
Maven笔记- 核心概念-笔记屋

2)在 pom.xml 配置文件中配置当前工程依赖 Hello


<?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.cosyblogs.maven</groupId>
 <artifactId>HelloFriend</artifactId>
 <version>1.0-SNAPSHOT</version>
 <dependencies>
 <dependency>
 <groupId>com.cosyblogs.maven</groupId>
 <artifactId>Hello</artifactId>
 <version>1.0-SNAPSHOT</version>
 </dependency>
 <dependency>
 <groupId>junit</groupId>
 <artifactId>junit</artifactId>
 <version>4.0</version>
 <scope>test</scope>
 </dependency>
 </dependencies>
 </project>

3)主程序

在 src/main/java 目录下新建文件 HelloFriend.java


public class HelloFriend {
public String sayHelloToFriend(String name){
 Hello hello = new Hello();
 String str = hello.sayHello(name)+" I am "+this.getMyName();
 return str;
 }
 public String getMyName(){
 return "Idea";
 }
}

4)测试程序

在/src/test/java 目录下新建测试文件 HelloFriendTest.java


import org.junit.Test;

public class HelloFriendTest {
 @Test
 public void testHelloFriend(){
 HelloFriend helloFriend = new HelloFriend();
 String results = helloFriend.sayHelloToFriend("Maven");
 System.out.println(results);
 }
}

5)关键:对 Hello 的依赖

这里 Hello 就是我们的第一个 Maven 工程,现在 HelloFriend 对它有依赖。那么这个依赖能否成功呢?更进一步的问题是:HelloFriend 工程会到哪里去找 Hello 呢?

答案是:本地仓库。任何一个 Maven 工程会根据坐标到本地仓库中去查找它所依赖的 jar 包。如果能够找到则可以正常工作,否则就不行。

依赖管理

1)基本概念

当 A jar 包需要用到 B jar 包中的类时,我们就说 A 对 B 有依赖。例如:HelloFriend-1.0-SNAPSHOT.jar 依赖于 Hello-1.0-SNAPSHOT.jar。

通过第二个 Maven 工程我们已经看到,当前工程会到本地仓库中根据坐标查找它所依赖的 jar 包。配置的基本形式是使用 dependency 标签指定目标 jar 包的坐标。例如:


<dependency>
 <!--坐标-->
 <dependency>
 <groupId>com.cosyblogs.maven</groupId>
 <artifactId>Hello</artifactId>
 <version>1.0-SNAPSHOT</version>
 </dependency>
 
 <dependency>
 <groupId>junit</groupId>
 <artifactId>junit</artifactId>
 <version>4.0</version>
 <scope>test</scope>
 </dependency>
</dependency>

2)直接依赖和间接依赖

如果 A 依赖 B,B 依赖 C,那么 A→B 和 B→C 都是直接依赖,而 A→C 是间接依赖。

依赖的范围

1)compile(默认就是这个范围)

  • (1)main 目录下的 Java 代码可以访问这个范围的依赖
  • (2)test 目录下的 Java 代码可以访问这个范围的依赖
  • (3)部署到 Tomcat 服务器上运行时要放在 WEB-INF 的 lib 目录下

例如:对 Hello 的依赖。主程序、测试程序和服务器运行时都需要用到。

2)test

  • (1)main 目录下的 Java 代码不能访问这个范围的依赖
  • (2)test 目录下的 Java 代码可以访问这个范围的依赖
  • (3)部署到 Tomcat 服务器上运行时不会放在 WEB-INF 的 lib 目录下

例如:对 junit 的依赖。仅仅是测试程序部分需要。
3)provided

  • (1)main 目录下的 Java 代码可以访问这个范围的依赖
  • (2)test 目录下的 Java 代码可以访问这个范围的依赖
  • (3)部署到 Tomcat 服务器上运行时不会放在 WEB-INF 的 lib 目录下

例如:servlet-api 在服务器上运行时,Servlet 容器会提供相关 API,所以部署的时候不需要。

4)其他:runtime、import、system 等。

各个依赖范围的作用可以概括为下图:

Maven笔记- 核心概念-笔记屋

依赖的传递性

当存在间接依赖的情况时,主工程对间接依赖的 jar 可以访问吗?这要看间接依赖的 jar 包引入时的依赖范围——只有依赖范围为 compile 时可以访问。例如:

Maven笔记- 核心概念-笔记屋

1)路径最短者优先

Maven笔记- 核心概念-笔记屋

2)路径相同时先声明者优先

Maven笔记- 核心概念-笔记屋

这里“声明”的先后顺序指的是 dependency 标签配置的先后顺序。

依赖的排除

有的时候为了确保程序正确可以将有可能重复的间接依赖排除。请看如下的例子:

假设当前工程为 MakeFriend,直接依赖 OurFriends。

OurFriends 依赖 commons-logging 的 1.1.1 对于 MakeFriend 来说是间接依赖。

当前工程 MakeFriend 直接依赖 commons-logging 的 1.1.2。

加入 exclusions 配置后可以在依赖 OurFriends 的时候排除版本为 1.1.1 的 commons-logging 的间接依赖。


<dependency>
 <groupId>com.cosyblogs.maven</groupId>
 <artifactId>OurFriends</artifactId>
 <version>1.0-SNAPSHOT</version>
 <!--依赖排除-->
 <exclusions>
 <exclusion>
 <groupId>commons-logging</groupId>
 <artifactId>commons-logging</artifactId>
 </exclusion>
 </exclusions>
</dependency>
<dependency>
 <groupId>commons-logging</groupId>
 <artifactId>commons-logging</artifactId>
 <version>1.1.2</version>
</dependency>

统一管理目标 Jar 包的版本

以对 Spring 的 jar 包依赖为例:Spring 的每一个版本中都包含 spring-context,springmvc 等 jar 包。我们应该导入版本一致的 Spring jar 包,而不是使用 4.0.0 的 spring-context 的同时使用 4.1.1 的 springmvc。


<dependency>
 <groupId>org.springframework</groupId>
 <artifactId>spring-context</artifactId>
 <version>4.0.0.RELEASE</version>
</dependency>
<dependency>
 <groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
 <version>4.0.0.RELEASE</version>
</dependency>
<dependency>
 <groupId>org.springframework</groupId>
 <artifactId>spring-jdbc</artifactId>
 <version>4.0.0.RELEASE</version>
</dependency>
<dependency>
 <groupId>org.springframework</groupId>
 <artifactId>spring-orm</artifactId>
 <version>4.0.0.RELEASE</version>
</dependency>

问题是如果我们想要将这些 jar 包的版本统一升级为 4.1.1,是不是要手动一个个修改呢?显然,我们有统一配置的方式:


<!--统一管理当前模块的 jar 包的版本-->
<properties>
 <spring.version>4.0.0.RELEASE</spring.version>
</properties>
......
<dependency>
 <groupId>org.springframework</groupId>
 <artifactId>spring-context</artifactId>
 <version>${spring.version}</version>
</dependency>
<dependency>
 <groupId>org.springframework</groupId>
 <artifactId>spring-webmvc</artifactId>
 <version>${spring.version}</version>
</dependency>
<dependency>
 <groupId>org.springframework</groupId>
 <artifactId>spring-jdbc</artifactId>
 <version>${spring.version}</version>
</dependency>
<dependency>
 <groupId>org.springframework</groupId>
 <artifactId>spring-orm</artifactId>
 <version>${spring.version}</version>
</dependency>

这样一来,进行版本调整的时候只改一改地方就行了。

仓库

1)分类

(1)本地仓库:为当前本机电脑上的所有 Maven 工程服务。
(2)远程仓库

–a)私服:架设在当前局域网环境下,为当前局域网范围内的所有 Maven 工程服务。

Maven笔记- 核心概念-笔记屋

–b)中央仓库:架设在 Internet 上,为全世界所有 Maven 工程服务。

–c)中央仓库的镜像:架设在各个大洲,为中央仓库分担流量。减轻中央仓库的压力,同时更快的
响应用户请求。

2)仓库中的文件

  • (1)Maven 的插件
  • (2)我们自己开发的项目的模块
  • (3)第三方框架或工具的 jar 包

不管是什么样的 jar 包,在仓库中都是按照坐标生成目录结构,所以可以通过统一的方式查询或依赖。

生命周期

1)什么是 Maven 的生命周期?

Maven 生命周期定义了各个构建环节的执行顺序,有了这个清单,Maven 就可以自动化的执行构建命令了。Maven 有三套相互独立的生命周期,分别是:

  • Clean Lifecycle 在进行真正的构建之前进行一些清理工作。
  • Default Lifecycle 构建的核心部分,编译,测试,打包,安装,部署等等。
  • Site Lifecycle 生成项目报告,站点,发布站点。

再次强调一下它们是相互独立的,你可以仅仅调用 clean 来清理工作目录,仅仅调用 site 来生成站点。当然你也可以直接运行 mvn clean install site 运行所有这三套生命周期。

每套生命周期都由一组阶段(Phase)组成,我们平时在命令行输入的命令总会对应于一个特定的阶段。比如,运行 mvn clean,这个 clean 是 Clean 生命周期的一个阶段。有 Clean 生命周期,也有 clean 阶段。

2)clean 生命周期

Clean 生命周期一共包含了三个阶段:

  • pre-clean 执行一些需要在 clean 之前完成的工作
  • clean 移除所有上一次构建生成的文件
  • post-clean 执行一些需要在 clean 之后立刻完成的工作

3)Site 生命周期

  • pre-site 执行一些需要在生成站点文档之前完成的工作
  • site 生成项目的站点文档
  • post-site 执行一些需要在生成站点文档之后完成的工作,并且为部署做准备
  • site-deploy 将生成的站点文档部署到特定的服务器上

这里经常用到的是 site 阶段和 site-deploy 阶段,用以生成和发布 Maven 站点,这可是 Maven 相当强大的功能,Manager 比较喜欢,文档及统计数据自动生成,很好看。

4)Default 生命周期

Default 生命周期是 Maven 生命周期中最重要的一个,绝大部分工作都发生在这个生命周期中。这里,只解释一些比较重要和常用的阶段:

  • 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 将最终的包复制到远程的仓库,以让其它开发人员与项目共享或部署到服务器上运行。

5)生命周期与自动化构建

运行任何一个阶段的时候,它前面的所有阶段都会被运行,例如我们运行 mvn install 的时候,代码会被编译,测试,打包。这就是 Maven 为什么能够自动执行构建过程的各个环节的原因。此外,Maven 的插件机制是完全依赖 Maven 的生命周期的,因此理解生命周期至关重要。

插件和目标

  • (1)Maven 的核心仅仅定义了抽象的生命周期,具体的任务都是交由插件完成的。
  • (2)每个插件都能实现多个功能,每个功能就是一个插件目标。
  • (3)Maven 的生命周期与插件目标相互绑定,以完成某个具体的构建任务。

例如:compile 就是插件 maven-compiler-plugin 的一个功能;pre-clean 是插件 maven-clean-plugin 的一
个目标。

有帮助?
Maven笔记-Maven如何使用
Maven笔记-继承
Copyright © 2022 笔记屋. 苏ICP备20033168号