Maven第二章:Maven基本概念与生命周期
前言
本章主要内容,介绍Maven基本概念,包括maven坐标含义,命名规则,继承与聚合、了解与理解生命周期,如何通过Maven进行依赖和版本管理。
什么是Maven的坐标?
Maven坐标是一种标识Maven项目的信息,它包含了项目的唯一标识符和项目的版本号等信息。Maven坐标的作用是唯一地定位一个Maven项目,使得在不同的环境中可以正确地找到和解析该项目。
Maven坐标的含义与作用
-
groupId:表示项目的组织域名,通常是企业或组织的反向域名,用于区分不同的组织。groupId是Maven坐标中的一个必需元素。
-
artifactId:表示项目的实际名称,通常是一个简单的单词或短语,用于区分不同的项目。artifactId是Maven坐标中的一个必需元素。
-
version:表示项目的版本号,用于区分同一项目中的不同版本。version是Maven坐标中的一个可选元素,但通常对于每个项目都需要指定一个版本号。
Maven坐标命名规范
-
groupId:定义当前Maven项目隶属的实际项目。通常,如果项目属于某个公司或组织,groupId就应该使用该组织或公司的域名。对于一个公司来说,不同的项目可能会有不同的groupId,但通常同一个项目中的所有模块都会使用相同的groupId。
-
artifactId:该元素定义实际项目中的一个Maven项目(模块)。推荐格式是:使用实际项目名称作为artifactId的前缀,紧接着为模块名称。例如:nexus-indexer、spring-mvc、hibernate-c3po等。
-
version:该元素定义了Maven项目当前所处的版本。在打包方式(packaging)为jar的情况下,Maven生成的构件的文件名会以artifactId作为开头,接着中划线,然后是版本信息。例如:nexus-indexer-2.0.0.jar。
Maven如何管理依赖
-
在项目的POM文件中,使用元素来定义依赖项列表,每个依赖项使用元素来指定其groupId、artifactId和version等信息。
-
在其他项目中引用依赖项时,只需要指定该依赖项的groupId、artifactId和version等信息,Maven就会根据这些坐标信息自动解析出该依赖项的正确版本,并将其添加到项目的构建路径中。
-
Maven仓库:Maven仓库是一种用于存储和管理Maven依赖项的集中式存储库。通过使用Maven仓库,可以将依赖项的坐标信息与具体的项目分离,使得不同的项目之间可以共享相同的依赖项。
-
在项目的POM文件中,使用元素来定义可用的Maven仓库列表,每个仓库使用元素来指定其id、url等信息。通过指定多个仓库,可以覆盖默认的中央仓库,从而获取到更多的依赖项和版本选择。
Maven如何版本管理
- maven 作为标准的Java项目结构目录
-
Maven作为标准的Java项目结构目录,约定了一套统一的目录结构,使得项目的目录结构规范化。在通过Maven创建项目后,项目的目录结构会以这套目录结构作为模板创建。
-
这套默认的目录结构包括以下几个主要目录:
-
${basedir}
:项目的根目录,其中包含pom.xml文件和项目的子目录结构。src/main/java
:项目的源代码所在的目录。src/main/resources
:项目的资源文件所在的目录。src/main/filters
:项目的资源过滤文件所在的目录。src/test/java
:测试代码所在的目录。src/test/resources
:测试相关的资源文件所在的目录。src/test/filters
:测试相关的资源过滤文件所在的目录。
-
其中,
src/main/webapp
是web项目的特有目录,用于存放web应用源代码,如html文件和web.xml等。 -
使用Maven作为标准的Java项目结构目录,可以使得不同IDE中创建的项目目录结构保持一致,有利于代码的管理和维护。同时,Maven的插件机制和一致的构建模型也使得项目的构建过程更加规范化和一致化,提高了项目的可维护性和可扩展性。
- Maven的版本管理主要有以下特点:
- 依赖管理系统:Maven为Java世界引入了一个新的依赖管理系统。在Java世界中,可以用groupid、artifactid和version组成的坐标(Coordinate)唯一标识一个依赖。任何基于Maven构建的项目自身也必须定义这三项属性,生成的包可以是jar包,也可以是war包或者ear包。当jar包升级时,只需要修改配置文件即可。
- 多模块构建:Maven中的多模块构建可以将一个项目分解为多个模块,方便代码的管理和维护。在parent POM中可以通过标签来定义一组子模块,parent POM中的build配置以及依赖配置都会自动继承给子module。
- 一致的项目构建:Maven在设计之初的理念就是约定大于配置(Convention over Configuration),其制定了一套项目目录结构作为标准的Java项目结构,解决了不同IDE带来的文件目录不一致问题。使用Maven后,无论在IntelliJ IDEA、Eclipse还是其他IDE中创建的项目,目录结构都是一样的。
- 一致的构建模型和插件机制:Maven使用了一致的构建模型和插件机制,使得项目的构建过程和工具具有一致性。当需要使用不同的工具或者服务器时,只需要将相应的插件引入到pom.xml文件中即可。
Maven的继承和聚合
Maven的继承:在Maven中,可以通过继承来共享父POM的配置。子POM可以继承父POM中的配置,包括打包类型、依赖、插件等。
Maven的继承基本步骤
- 创建一个父POM,定义所有子模块共用的配置。在父POM的pom.xml文件中,可以定义打包类型、依赖、插件等。
- 创建子POM,使用标签继承父POM。在子POM的pom.xml文件中,添加标签,并指定父POM的groupid、artifactid和version。这样,子POM就可以继承父POM的配置了。
- 在子POM中添加自己的配置。子POM可以在标签下面添加自己的配置,如依赖、插件等。这些配置将和父POM的配置一起被继承到子模块中。
- 使用依赖管理元素()来统一管理依赖。可以在父POM中使用元素来管理所有子模块的依赖。子模块只需要指定依赖的groupid和artifactid,而不需要指定具体的版本号。这样,子模块就可以自动继承父POM中定义的依赖版本号。
以下是一个关于Maven继承的示例:
xml
<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.example</groupId>
<artifactId>parent-pom</artifactId>
<version>1.0</version>
<packaging>pom</packaging>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.1</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
</configuration>
</plugin>
</plugins>
</build>
</project>
现在,我们创建一个子POM,名为child-pom
,并继承父POM:
xml
<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/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>com.example</groupId>
<artifactId>parent-pom</artifactId>
<version>1.0</version>
</parent>
<artifactId>child-pom</artifactId>
<dependencies>
<dependency>
<groupId>com.google.guava</groupId>
<artifactId>guava</artifactId>
<version>28.2-jre</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>3.2.0</version>
<configuration>
<archive>
<manifestEntries>
<Class-Path>.</Class-Path>
</manifestEntries>
</archive>
</configuration>
</plugin>
</plugins>
</build>
</project>
Maven的继承注意事项
-
首先,当您创建一个子POM并使用``元素继承父POM时,子POM将继承父POM中定义的所有配置。这包括依赖项、插件、构建配置等。子POM可以选择性地覆盖这些配置,或者根据需要添加更多的配置。
-
其次,Maven的继承是单向的,即父POM不能继承子POM的配置。父POM只能向下传递配置给子POM,而不能向上传递配置给父POM。
-
最后使用继承时,需要注意以下几点:
-
确保父POM的配置是可重用的,并且可以在多个子POM中共享。如果父POM的配置是特定于项目的,或者只在一个子POM中使用,那么最好不要将其定义为父POM。
-
在子POM中,您可以使用
<dependencyManagement>
标签来管理依赖项的版本。这将允许您在子POM中指定依赖项的版本,而不需要在父POM中定义该版本。 -
如果您需要在多个项目之间重用构建逻辑,可以考虑使用Maven的聚合功能。聚合允许您创建一个父POM,并在其中定义一个或多个子项目。每个子项目可以有自己的构建配置,同时也可以继承父POM的配置。通过这种方式,您可以在多个项目之间重用构建逻辑。
-
Maven的Archetype插件
使用Maven的Archetype插件可以快速生成项目的基础结构和文件,以下是如何使用Archetype插件的步骤:
- 安装Maven Archetype插件:首先,确保你的Maven环境已经配置好,并且你已经安装了Archetype插件。你可以通过在命令行中输入以下命令来安装Archetype插件:
bash
mvn install
- 选择一个Archetype:Archetype插件有很多种,包括用于不同类型的项目(如Web应用程序、Spring应用程序等)。你可以通过运行以下命令查看所有可用的Archetype插件:
bash
mvn archetype:list
- 生成项目:一旦你选择了一个Archetype,你可以使用以下命令生成项目:
bash
mvn archetype:generate <archetype-groupId> <archetype-artifactId> <archetype-version>
你需要替换上述命令中的 、
和 `` 为你选择的Archetype的groupId、artifactId和版本号。
-
配置项目 :一旦项目生成,你需要在
src/main/resources/archetype-resources
目录下进行一些配置。这可能包括修改pom.xml
文件、添加或修改配置文件等。 -
构建和测试项目:完成配置后,你可以使用以下命令构建和测试你的项目:
bash
mvn clean install
- 查看生成的代码 :生成的代码将会在项目的
target
目录下。你可以直接在该目录下查看生成的代码。
Maven的Archetype插件生成Spring Boot项目的示例:
- 确保已经安装了Maven和Java。你可以在命令行中输入
mvn -v
和java -version
来检查它们的版本。 - 打开命令行,然后输入以下命令以生成Spring Boot项目:
shell
mvn archetype:generate -DgroupId=com.example -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
其中,groupId
是你的项目的组织唯一标识符,通常是你的公司或组织的域名,反方向加上项目的名称;artifactId
是你的项目的唯一标识符,通常是你项目的名称;archetypeArtifactId
指定了生成项目的模板,maven-archetype-quickstart
会生成一个基础的Java项目,而spring-boot-archetype
会生成一个Spring Boot项目。
- 进入到项目的目录中:
shell
cd my-app
- 运行项目:
如果你使用的是Spring Boot 2.x,则使用以下命令:
shell
mvn spring-boot:run
如果你使用的是Spring Boot 1.x,则使用以下命令:
shell
mvn spring-boot:start
-
等待项目启动。一旦项目启动成功,你就可以在浏览器中访问你的应用程序了。默认情况下,Spring Boot应用程序在端口8080上运行。你可以在浏览器中输入
localhost:8080
来访问你的应用程序。 -
在你的项目中,你可以根据你的需求添加更多的Maven依赖项和配置文件。你可以在项目的根目录下找到
pom.xml
文件,它包含了Maven的配置信息。你可以在这个文件中添加更多的依赖项和插件。