Maven详解

1 maven介绍

1)为什么使用maven

Maven是一个强大的项目管理和构建工具,它能够简化Java项目的构建、依赖管理和发布过程。以下是Maven的一些主要特点和功能:

  1. 项目结构管理:Maven采用约定优于配置的原则,提供了标准的项目结构模板,使得开发人员可以快速创建和维护项目。
  2. 依赖管理:Maven通过中央仓库和本地仓库的方式管理项目的依赖库,开发人员只需要在项目配置文件中声明所需的依赖,Maven会自动下载并管理依赖关系。
  3. 构建工具:Maven提供了丰富的构建生命周期和插件系统,可以执行编译、测试、打包、部署等一系列构建任务,并支持自定义插件进行扩展。
  4. 多模块管理:Maven支持多模块项目管理,可以将复杂的项目拆分为多个子模块,简化项目的管理和构建过程。
  5. 自动生成文档:Maven可以根据项目的代码注释生成项目文档,例如使用Javadoc插件生成API文档。
  6. 版本控制:Maven提供了版本管理功能,可以轻松地管理项目的版本信息,并支持快速切换不同版本的依赖库。
  7. 构建报告:Maven能够生成详细的构建报告,包括编译错误、测试结果等信息,帮助开发人员及时发现和解决问题。
  8. 发布管理:Maven支持项目的部署和发布,可以将构建好的项目发布到本地仓库、远程仓库或者私服中,方便其他开发人员使用。

标准化项目结构:

标准化构建流程:

依赖管理:

使用maven前:

使用maven后:

2)maven是什么

Apache Maven是一个开源的项目管理和构建工具,它是由Apache软件基金会开发和维护的。Maven使用基于项目对象模型(Project Object Model,简称POM)的概念来管理项目,并提供了一套规范和工具来支持项目的构建、依赖管理和发布.

Maven的项目对象模型(Project Object Model,简称POM)是一种XML文件,用于描述和定义Maven项目的结构、依赖关系、构建配置等信息。每个Maven项目都有一个对应的POM文件,位于项目根目录下,文件名为pom.xml

POM文件包含了以下主要元素:

  1. 项目坐标(Project Coordinates):包括项目的groupId、artifactId和version,用来唯一标识一个项目。
  2. 依赖管理(Dependency Management):用来声明项目所依赖的外部库或模块,包括依赖的groupId、artifactId和version等信息。
  3. 构建配置(Build Configuration):包括项目的构建生命周期、插件配置、资源目录、输出目录等与构建相关的配置信息。
  4. 源代码目录(Source Directories):指定项目源代码和测试代码的目录路径。
  5. 插件配置(Plugin Configuration):用来配置Maven插件的行为和参数。
  6. 打包类型(Packaging Type):指定项目的打包类型,例如jar、war、pom等。
  7. 仓库配置(Repository Configuration):用来配置Maven的远程仓库和本地仓库。

通过POM文件,Maven可以理解项目的结构和依赖关系,以及如何进行构建和发布。开发人员可以在POM文件中声明和管理项目的各种属性和配置,使得项目的构建和管理更加简单和可控。

POM文件还支持继承机制,可以通过父子模块关系实现项目间的代码复用和依赖管理。子模块的POM文件可以继承父模块的配置,同时可以覆盖或添加自己特定的配置。

•仓库分类:

​ 本地仓库:自己计算机上的一个目录

​ 中央仓库:由Maven团队维护的全球唯一的仓库

​ •地址:https://repo1.maven.org/maven2/

​ 远程仓库(私服):一般由公司团队搭建的私有仓库

​ 当项目中使用坐标引入对应依赖jar包后,首先会查找本地仓库中是否有对应的jar包:如果有,则在项目直接引用; 如果没有,则去中央仓库中下载对应的jar包到本地仓库。还可以搭建远程仓库,将来jar包的查找顺序则变为:本地仓库 -> 远程仓库 ->中央仓库

2 maven的基本配置

maven的配置文件: conf/setting.xml

1)本地仓库地址配置:

xml 复制代码
<!--配置本地仓库的地址-->
<localRepository>D:\repository</localRepository>

2)中央仓库地址配置:

xml 复制代码
<!--中央仓库的镜像的配置-->
<mirrors>
	<!--设置阿里云镜像-->
	<mirror>  
		<id>alimaven</id>  
		<name>aliyun maven</name>  
		<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
		<mirrorOf>central</mirrorOf>          
	</mirror>
</mirrors>

3)jdk版本配置:

xml 复制代码
<profiles>
	<!--设置maven编译的jdk的版本-->
	<profile>         
		  <id>JDK-1.8</id>           
		  <activation>               
				<activeByDefault>true</activeByDefault>               
				<jdk>1.8</jdk>          
		  </activation>           
		  <properties>               
			<maven.compiler.source>1.8</maven.compiler.source>               
			<maven.compiler.target>1.8</maven.compiler.target>               
			<maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
		</properties>       
	</profile>
  </profiles>

4)idea上maven的配置

在idea的setting选项中:

使用本地上安装并且配置好的maven;

使用本地配置好的maven配置文件;

使用本地仓库;

在setting中配置完maven后, 需要在New Projects Setup中也配置一下, 否则每次新建项目都需要重新配置maven

3 maven的基本使用

1)常用的maven指令

compile :编译 clean:清理 test:测试 package:打包 install:安装

2)maven的声明周期

Maven 构建项目生命周期描述的是一次构建过程经历经历了多少个事件;

Maven 对项目构建的生命周期划分为3套

clean:清理工作:

default:核心工作,例如编译,测试,打包,安装等

site:产生报告,发布站点等

validate(校验)			校验项目是否正确并且所有必要的信息可以完成项目的构建过程。
initialize(初始化)			初始化构建状态,比如设置属性值。
generate-sources(生成源代码)		生成包含在编译阶段中的任何源代码。
process-sources(处理源代码)		处理源代码,比如说,过滤任意值。
generate-resources(生成资源文件)		生成将会包含在项目包中的资源文件。
process-resources (处理资源文件)		复制和处理资源到目标目录,为打包阶段最好准备。
compile(编译)			编译项目的源代码。
process-classes(处理类文件)		处理编译生成的文件,比如说对Java class文件做字节码改善优化。
generate-test-sources(生成测试源代码)		生成包含在编译阶段中的任何测试源代码。
process-test-sources(处理测试源代码)		处理测试源代码,比如说,过滤任意值。
generate-test-resources(生成测试资源文件)	为测试创建资源文件。
process-test-resources(处理测试资源文件)		复制和处理测试资源到目标目录。
test-compile(编译测试源码)		编译测试源代码到测试目标目录.
process-test-classes(处理测试类文件)		处理测试源码编译生成的文件。
test(测试)			使用合适的单元测试框架运行测试(Juint是其中之一)。
prepare-package(准备打包)		在实际打包之前,执行任何的必要的操作为打包做准备。
package(打包)			将编译后的代码打包成可分发格式的文件,比如JAR、WAR或者EAR文件。
pre-integration-test(集成测试前)		在执行集成测试前进行必要的动作。比如说,搭建需要的环境。
integration-test(集成测试)		处理和部署项目到可以运行集成测试环境中。
post-integration-test(集成测试后)		在执行集成测试完成后进行必要的动作。比如说,清理集成测试环境。
verify (验证)			运行任意的检查来验证项目包有效且达到质量标准。
install(安装)			安装项目包到本地仓库,这样项目包可以用作其他本地项目的依赖。
deploy(部署)			将最终的项目包复制到远程仓库中与其他开发者和项目共享。

4 IDEA上Maven项目的基本使用

1)项目创建

Maven中每个项目都有一个坐标, 只有

什么是坐标?

​ Maven 中的坐标是资源的唯一标识

​ 使用坐标来定义项目或引入项目中需要的依赖

Maven 坐标主要组成

​ groupId:定义当前Maven项目隶属组织名称(通常是域名反写,例如:com.itheima)

​ artifactId:定义当前Maven项目名称(通常是模块名称,例如 order-service、goods-service)

​ version:定义当前项目版本号

2)依赖导入

pom.xml文件中 里面是设置的所有依赖信息;

单个的依赖信息是 标签中来设置, 是通过 , 以及 的坐标来确定依赖的位置;

xml 复制代码
<!--设置maven的依赖管理-->
	<dependencies>
		<dependency>
			<groupId>javax.servlet</groupId>
			<artifactId>jstl</artifactId>
			<version>1.2</version>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-jdbc</artifactId>
			<version>5.3.3</version>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-webmvc</artifactId>
			<version>5.3.3</version>
		</dependency>
		<dependency>
			<groupId>javax.servlet</groupId>
			<artifactId>servlet-api</artifactId>
			<version>2.5</version>
			<scope>provided</scope>
		</dependency>
		<dependency>
			<groupId>com.fasterxml.jackson.core</groupId>
			<artifactId>jackson-databind</artifactId>
			<version>2.11.0</version>
		</dependency>
		<dependency>
			<groupId>com.fasterxml.jackson.core</groupId>
			<artifactId>jackson-core</artifactId>
			<version>2.11.0</version>
		</dependency>
		<dependency>
			<groupId>com.fasterxml.jackson.core</groupId>
			<artifactId>jackson-annotations</artifactId>
			<version>2.11.0</version>
		</dependency>
		<dependency>
			<groupId>com.alibaba</groupId>
			<artifactId>druid</artifactId>
			<version>1.1.10</version>
		</dependency>
		<dependency>
			<groupId>org.projectlombok</groupId>
			<artifactId>lombok</artifactId>
			<version>1.18.8</version>
		</dependency>
		<dependency>
			<groupId>com.github.pagehelper</groupId>
			<artifactId>pagehelper</artifactId>
			<version>5.2.0</version>
		</dependency>
		<dependency>
			<groupId>mysql</groupId>
			<artifactId>mysql-connector-java</artifactId>
			<version>8.0.21</version>
		</dependency>
		<dependency>
			<groupId>org.mybatis</groupId>
			<artifactId>mybatis-spring</artifactId>
			<version>2.0.5</version>
		</dependency>
		<dependency>
			<groupId>org.mybatis</groupId>
			<artifactId>mybatis</artifactId>
			<version>3.5.6</version>
		</dependency>
	</dependencies>

POM文件修改后, 需要重新加载maven项目;

3)项目打包类型

在Maven中,packaging是用来指定项目打包的类型。它定义了项目构建后生成的最终产物的格式和类型。

常见的几种packaging类型包括:

  1. jar:生成一个可执行的JAR文件,适用于Java项目。
  2. war:生成一个可部署的WAR文件,适用于Web应用程序项目。
  3. pom:不生成任何实际的产物,仅作为父项目或聚合项目的pom.xml文件存在。
  4. ear:生成一个可部署的EAR文件,适用于企业级Java应用程序项目。
  5. bundle:生成一个OSGi模块的bundle文件,适用于基于OSGi的应用程序项目。
  6. maven-plugin:生成一个可扩展Maven生命周期的插件,适用于自定义Maven插件项目。
xml 复制代码
<!--设置项目的打包类型  web需用tomcat的是war -->
<packaging>war</packaging>

4)依赖的可传递性

在Maven中,依赖的可传递性是指当一个项目依赖于其他项目时,是否会自动引入这些被依赖项目所声明的依赖项。

默认情况下,Maven启用了依赖的传递性。也就是说,如果项目A依赖于项目B,而项目B又依赖于项目C,那么项目A将会自动引入项目B和项目C的依赖项。

依赖传递冲突问题:

路径优先:当依赖中出现相同的资源时,层级越深,优先级越低,层级越浅,优先级越高

声明优先:当资源在相同层级被依赖时,配置顺序靠前的覆盖配置顺序靠后的

特殊优先:当同级配置了相同资源的不同版本,后配置的覆盖先配置的

5)tomcat运行maven项目

1)添加项目的war到tomcat中;

2)运行tomcat

3)部署当前项目(会自动运行maven指令, 生成target文件夹和打包的项目)

5 依赖的设置

1)依赖排除

当导入依赖spring-webmvc时, 由于spring-webmvc会依赖其他的相关依赖, 所以同时也会导入其他依赖, 利用 可以指定排除spring-webmvc中所带的其他依赖.

<dependency>
	<groupId>org.springframework</groupId>
	<artifactId>spring-webmvc</artifactId>
	<version>5.3.3</version>
	<exclusions>
		<exclusion>
			<groupId>org.springframework</groupId>
			<artifactId>spring-core</artifactId>
		</exclusion>
	</exclusions>
</dependency>

2)依赖的有效范围

引入依赖后, 可以使用scope对该依赖的有效范围进行设置;

scope取值 有效范围(compile, runtime, test) 依赖传递 例子
compile all spring-core
provided compile, test servlet-api
runtime runtime, test JDBC驱动
test test JUnit
system compile, test
xml 复制代码
<dependency>
	<groupId>javax.servlet</groupId>
	<artifactId>servlet-api</artifactId>
	<version>2.5</version>
	<scope>provided</scope>
</dependency>

3)依赖的可选设置

在Maven中,Optional是一个用于指定依赖项的元数据标记。它提供了一种机制,用于在构建项目时指定某个依赖项是否是可选的。

当Optional设置为true时, 表示依赖为可选; 默认为false, 表示依赖为不可选;

当依赖设置为可选时,只有在项目明确声明需要这个依赖时,它才会被包含在构建中。换句话说,可选依赖不会隐式传递到依赖于当前项目的其他项目中;

例如1: 假设我们正在开发一个名为library-a的库,它依赖于另一个名为library-b的库。然而,library-b有一些我们并不需要的依赖项。为了避免这些不必要的依赖项传递给使用library-a的项目,我们可以将它们设置为可选。

xml 复制代码
library-a.xml

<dependency>
  <groupId>com.example</groupId>
  <artifactId>library-b</artifactId>
  <version>1.0.0</version>
  <optional>true</optional>
</dependency>

例如2: 一个日志库可能支持多种日志框架,但我们希望让用户选择他们要使用的框架,而不是强制将所有可能的依赖项包含在构建中。

xml 复制代码
<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-api</artifactId>
  <version>1.7.30</version>
</dependency>
<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-simple</artifactId>
  <version>1.7.30</version>
  <optional>true</optional>
</dependency>
<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-log4j12</artifactId>
  <version>1.7.30</version>
  <optional>true</optional>
</dependency>

slf4j-api是必需的依赖项,而slf4j-simple和slf4j-log4j12是可选的。使用我们的日志库的项目用户可以根据需要选择要使用的日志框架;

总之,Maven Optional依赖提供了一种灵活的方式来管理项目的依赖关系。通过将某些依赖项设置为可选,我们可以精简依赖传递、避免依赖冲突,以及减少构建大小。此外,Optional依赖还可以帮助我们实现可插拔的功能和支持可选的扩展模块,使我们的库更加灵活和易于使用

4)依赖类型

在Maven中,type是用来指定依赖项的类型的属性。它用于区分不同类型的依赖项,例如JAR文件、WAR文件、POM文件等。

type属性对于Maven来说是很重要的,因为它可以告诉Maven如何处理这个依赖项。当你在pom.xml文件中声明一个依赖项时,可以使用type属性来显式地指定该依赖项的类型。

常见的几种依赖项类型包括:

  1. JAR(默认):表示依赖项是一个Java库或模块的JAR文件。
  2. WAR:表示依赖项是一个Web应用程序的WAR文件。
  3. POM:表示依赖项是一个Maven项目的POM文件。
  4. ZIP:表示依赖项是一个压缩文件。
  5. EJB:表示依赖项是一个企业级JavaBean。
  6. DLL:表示依赖项是一个动态链接库文件(适用于特定平台)。

通过使用type属性,你可以明确指定依赖项的类型,以便Maven在构建和部署过程中正确地处理它们。这有助于确保项目正确地引入和使用所需的依赖项,并且避免混淆和错误。

xml 复制代码
<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-dependencies</artifactId>
	<version>2.7.11</version>
	<type>pom</type>
</dependency>

6 继承和聚合

在Maven中,继承是一种机制,允许创建一个父项目(也称为聚合项目)来共享和管理子项目的配置信息。通过继承关系,子项目可以继承和覆盖父项目的设置,从而避免重复配置。

实现继承的方式是通过在子项目的pom.xml文件中使用 标签来指定父项目。例如:

xml 复制代码
<parent>
  <groupId>com.example</groupId>
  <artifactId>parent-project</artifactId>
  <version>1.0.0</version>
</parent>

父项目的坐标(groupId、artifactId和version)会被显式地指定在子项目中, 子类项目就不用再设置groupId、artifactId;

在继承关系中,子项目可以覆盖或添加属性、依赖、插件和插件配置等。通过在子项目中声明相同的元素,子项目可以覆盖父项目中相应元素的值或配置。

在继承关系中,通常会将各个理, 那么所有的子类项目在按需使用这些依赖时, 就不需要再指定版本, 这样可以避免各个依赖之间的版本冲突等, 也简化了很多代码;

继承关系可以帮助简化项目的配置和管理。当有多个项目共享相同的配置或依赖关系时,可以将这些设置提取到父项目中,以减少冗余和重复的配置。

|

在进行依赖的版本管理时, 使用 标签统一设置依赖的版本号, 然后使用 将依赖的版本信息传递给子类项目;

  1. 创建父类(聚合项目)

​ 就是创建普通的maven项目, 然后设置pom.xml文件中的 pom , 然后删除掉src文件夹;

​ 在父类项目的pom.xml文件中加入依赖的版本管理信息;

xml 复制代码
 	 <properties>
		<maven.compiler.source>8</maven.compiler.source>
		<maven.compiler.target>8</maven.compiler.target>
		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
		<!--  所有依赖的版本 -->
		<spring-version>5.3.3</spring-version>
		<mybatis-version>3.5.6</mybatis-version>
		<mybatis-spring-version>2.0.5</mybatis-spring-version>
		<jackson-version>2.11.2</jackson-version>
		<mysql-version>8.0.20</mysql-version>
		<druid-version>1.1.20</druid-version>
		<hibernate-validator-version>6.0.20.Final</hibernate-validator-version>
		<validation-api-version>2.0.1.Final</validation-api-version>
		<commons-io-version>1.3.2</commons-io-version>
		<commons-fileupload-version>1.3.2</commons-fileupload-version>
		<pagehelper-version>5.2.0</pagehelper-version>
	</properties>
	
	<dependencyManagement>
		<dependencies>
			<!-- 上传-->
			<dependency>
				<groupId>commons-fileupload</groupId>
				<artifactId>commons-fileupload</artifactId>
				<version>${commons-fileupload-version}</version>
			</dependency>
			<dependency>
				<groupId>org.apache.commons</groupId>
				<artifactId>commons-io</artifactId>
				<version>${commons-io-version}</version>
			</dependency>
			<!-- 数据校验 -->
			<dependency>
				<groupId>javax.validation</groupId>
				<artifactId>validation-api</artifactId>
				<version>${validation-api-version}</version>
			</dependency>
			<dependency>
				<groupId>org.hibernate.validator</groupId>
				<artifactId>hibernate-validator</artifactId>
				<version>${hibernate-validator-version}</version>
			</dependency>
			<!--分页-->
			<dependency>
				<groupId>com.github.pagehelper</groupId>
				<artifactId>pagehelper</artifactId>
				<version>${pagehelper-version}</version>
			</dependency>
			<!--连接池-->
			<dependency>
				<groupId>com.alibaba</groupId>
				<artifactId>druid</artifactId>
				<version>${druid-version}</version>
			</dependency>
			<dependency>
				<groupId>mysql</groupId>
				<artifactId>mysql-connector-java</artifactId>
				<version>${mysql-version}</version>
			</dependency>
			<!--json-->
			<dependency>
				<groupId>com.fasterxml.jackson.core</groupId>
				<artifactId>jackson-annotations</artifactId>
				<version>${jackson-version}</version>
			</dependency>
			<dependency>
				<groupId>com.fasterxml.jackson.core</groupId>
				<artifactId>jackson-databind</artifactId>
				<version>${jackson-version}</version>
			</dependency>
			<dependency>
				<groupId>com.fasterxml.jackson.core</groupId>
				<artifactId>jackson-core</artifactId>
				<version>${jackson-version}</version>
			</dependency>
			<!--mybatis-->
			<dependency>
				<groupId>org.mybatis</groupId>
				<artifactId>mybatis-spring</artifactId>
				<version>${mybatis-spring-version}</version>
			</dependency>
			<dependency>
				<groupId>org.mybatis</groupId>
				<artifactId>mybatis</artifactId>
				<version>${mybatis-version}</version>
			</dependency>
			<!--spring-->
			<dependency>
				<groupId>org.springframework</groupId>
				<artifactId>spring-jdbc</artifactId>
				<version>${spring-version}</version>
			</dependency>
			<dependency>
				<groupId>org.springframework</groupId>
				<artifactId>spring-webmvc</artifactId>
				<version>${spring-version}</version>
			</dependency>
		</dependencies>
	</dependencyManagement>

2)创建子类项目

按照上图分别创建ssm-common, ssm-dao,ssm-pojo,ssm-service,ssm-web等5个子类项目;

ssm-web的pom.xml

依赖ssm-service项目, ssm-service项目的依赖也会传递到ssm-web中;

xml 复制代码
<parent>
	<groupId>cn.guotu</groupId>
	<artifactId>ssm-parent</artifactId>
	<version>1.0-SNAPSHOT</version>
</parent>

<dependencies>
	<dependency>
		<groupId>cn.guotu</groupId>
		<artifactId>ssm-service</artifactId>
		<version>1.0-SNAPSHOT</version>
	</dependency>
</dependencies>

ssm-service的pom.xml

添加的spring-webmvc依赖无需设置版本号;

xml 复制代码
<dependencies>
		<dependency>
			<groupId>cn.guotu</groupId>
			<artifactId>ssm-dao</artifactId>
			<version>1.0-SNAPSHOT</version>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-webmvc</artifactId>
		</dependency>
</dependencies>

所有的配置文件都放在web项目中:

3)编写完成各个子类项目后, 部署web项目到tomcat运行;

7 私服