• Maven 命令行环境


    1. 根据坐标创建 Maven 工程

    1.1 Maven 核心概念:坐标

    ① 数学中的坐标

    使用 x、y、z 三个『向量』作为空间的坐标系,可以在『空间』中唯一的定位到一个『点』。

    ② Maven中的坐标

    [1]向量说明

    使用三个『向量』在『Maven的仓库』中唯一的定位到一个『jar』包。

    • groupId:公司或组织的 id
    • artifactId:一个项目或者是项目中的一个模块的 id
    • version:版本号

    [2]三个向量的取值方式

    • groupId:公司或组织域名的倒序,通常也会加上项目名称
      • 例如:com.atguigu.maven
    • artifactId:模块的名称,将来作为 Maven 工程的工程名
    • version:模块的版本号,根据自己的需要设定
      • 例如:SNAPSHOT 表示快照版本,正在迭代过程中,不稳定的版本
      • 例如:RELEASE 表示正式版本

    举例:

    • groupId:com.atguigu.maven
    • artifactId:pro01-atguigu-maven
    • version:1.0-SNAPSHOT

    ③ 坐标和仓库中 jar 包的存储路径之间的对应关系

    坐标:

    1. <groupId>javax.servletgroupId>
    2. <artifactId>servlet-apiartifactId>
    3. <version>2.5version>

    上面坐标对应的 jar 包在 Maven 本地仓库中的位置:

    Maven本地仓库根目录\javax\servlet\servlet-api\2.5\servlet-api-2.5.jar

    一定要学会根据坐标到本地仓库中找到对应的 jar 包。

    1.2 实验操作

    ① 创建目录作为后面操作的工作空间

    例如:E:\software\apache-maven-3.8.6-bin\maven-workspace\space001

    WARNING

    此时我们已经有了三个目录,分别是:

    • Maven 核心程序:中军大帐
    • Maven 本地仓库:兵营
    • 本地工作空间:战场

    ② 在工作空间目录下打开命令行窗口

    ③ 使用命令生成Maven工程

     运行 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: :【直接回车,使用默认值(1.0版本)】

            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 再回车。】

    ④ 调整

            Maven 默认生成的工程,对 junit 依赖的是较低的 3.8.1 版本,我们可以改成较适合的 4.12 版本。

            自动生成的 App.java 和 AppTest.java 可以删除。

    ⑤ 自动生成的 pom.xml 解读

    1. <project xmlns="http://maven.apache.org/POM/4.0.0"
    2. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
    4. http://maven.apache.org/xsd/maven-4.0.0.xsd">
    5. <modelVersion>4.0.0modelVersion>
    6. <groupId>com.chenyixin.mavengroupId>
    7. <artifactId>pro01-maven-javaartifactId>
    8. <version>1.0-SNAPSHOTversion>
    9. <packaging>jarpackaging>
    10. <name>pro01-maven-javaname>
    11. <url>http://maven.apache.orgurl>
    12. <properties>
    13. <project.build.sourceEncoding>UTF-8project.build.sourceEncoding>
    14. properties>
    15. <dependencies>
    16. <dependency>
    17. <groupId>junitgroupId>
    18. <artifactId>junitartifactId>
    19. <version>4.12version>
    20. <scope>testscope>
    21. dependency>
    22. dependencies>
    23. project>

    1.3 Maven核心概念:POM

    ① 含义

            POM:Project Object Model,项目对象模型。和 POM 类似的是:DOM(Document Object Model),文档对象模型。它们都是模型化思想的具体体现。

    ② 模型化思想

            POM 表示将工程抽象为一个模型,再用程序中的对象来描述这个模型。这样我们就可以用程序来管理项目了。我们在开发过程中,最基本的做法就是将现实生活中的事物抽象为模型,然后封装模型相关的数据作为一个对象,这样就可以在程序中计算与现实事物相关的数据。

    ③ 对应的配置文件

            POM 理念集中体现在 Maven 工程根目录下 pom.xml 这个配置文件中。所以这个 pom.xml 配置文件就是 Maven 工程的核心配置文件。其实学习 Maven 就是学这个文件怎么配置,各个配置有什么用。

    1.4 Maven核心概念:约定的目录结构

    ① 各个目录的作用

             另外还有一个 target 目录专门存放构建操作输出的结果。

    ② 约定目录结构的意义

            Maven 为了让构建过程能够尽可能自动化完成,所以必须约定目录结构的作用。例如:Maven 执行编译操作,必须先去 Java 源程序目录读取 Java 源代码,然后执行编译,最后把编译结果存放在 target 目录。

    ③ 约定大于配置

            Maven 对于目录结构这个问题,没有采用配置的方式,而是基于约定。这样会让我们在开发过程中非常方便。如果每次创建 Maven 工程后,还需要针对各个目录的位置进行详细的配置,那肯定非常麻烦。

            目前开发领域的技术发展趋势就是:约定大于配置,配置大于编码。

    2. 在 Maven 工程中编写代码

    2.1 主体程序

     主体程序指的是被测试的程序,同时也是将来在项目中真正要使用的程序。

    1. package com.chenyixin.maven;
    2. public class Calculator {
    3. public int sum(int i, int j){
    4. return i + j;
    5. }
    6. }

    2.2 测试程序

    1. package com.chenyixin.maven;
    2. import org.junit.Test;
    3. import com.chenyixin.maven.Calculator;
    4. // 静态导入的效果是将Assert类中的静态资源导入当前类
    5. // 这样一来,在当前类中就可以直接使用Assert类中的静态资源,不需要写类名
    6. import static org.junit.Assert.*;
    7. public class CalculatorTest{
    8. @Test
    9. public void testSum(){
    10. // 1.创建Calculator对象
    11. Calculator calculator = new Calculator();
    12. // 2.调用Calculator对象的方法,获取到程序运行实际的结果
    13. int actualResult = calculator.sum(5, 3);
    14. // 3.声明一个变量,表示程序运行期待的结果
    15. int expectedResult = 8;
    16. // 4.使用断言来判断实际结果和期待结果是否一致
    17. // 如果一致:测试通过,不会抛出异常
    18. // 如果不一致:抛出异常,测试失败
    19. assertEquals(expectedResult, actualResult);
    20. }
    21. }

    3. 执行 Maven 的构建命令

    3.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.2 编译操作

            主程序编译:mvn compile

            测试程序编译:mvn test-compile

            主体程序编译结果存放的目录:target/classes

            测试程序编译结果存放的目录:target/test-classes

    3.3 清理操作

            mvn clean

            效果:删除 target 目录

    3.4 测试操作

            mvn test

            测试的报告存放的目录:target/surefire-reports

    3.5 打包操作

            mvn package

            打包的结果——jar 包,存放的目录:target

     jar 包名:项目名-版本名.jar

    3.6 安装操作

            mvn install (命令指令可以组合使用,如:mvn clean install)

            安装的效果是将本地构建过程中生成的 jar 包存入 Maven 本地仓库。这个 jar 包在 Maven 仓库中的路径是根据它的坐标生成的。

    安装成功结果:

    1. [INFO] Installing E:\software\apache-maven-3.8.6-bin\maven-workspace\space001\pro01-maven-java\target\pro01-maven-java-1.0-SNAPSHOT.jar to E:\software\apache-maven-3.8.6-bin\localRepository\com\chenyixin\maven\pro01-maven-java\1.0-SNAPSHOT\pro01-maven-java-1.0-SNAPSHOT.jar
    2. [INFO] Installing E:\software\apache-maven-3.8.6-bin\maven-workspace\space001\pro01-maven-java\pom.xml to E:\software\apache-maven-3.8.6-bin\localRepository\com\chenyixin\maven\pro01-maven-java\1.0-SNAPSHOT\pro01-maven-java-1.0-SNAPSHOT.pom

    坐标信息如下:

    1. <groupId>com.chenyixin.mavengroupId>
    2. <artifactId>pro01-maven-javaartifactId>
    3. <version>1.0-SNAPSHOTversion>

    在 Maven 仓库中生成的路径如下:

    E:\software\apache-maven-3.8.6-bin\localRepository\com\chenyixin\maven\pro01-maven-java\1.0-SNAPSHOT

            另外,安装操作还会将 pom.xml 文件转换为 XXX.pom 文件一起存入本地仓库。所以我们在 Maven 的本地仓库中想看一个 jar 包原始的 pom.xml 文件时,查看对应 XXX.pom 文件即可,它们是名字发生了改变,本质上是同一个文件。

    4. 创建 Maven 版的 Web 工程

    4.1 说明

            使用 mvn archetype:generate 命令生成 Web 工程时,需要使用一个专门的 archetype。这个专门生成 Web 工程骨架的 archetype 可以参照官网看到它的用法:       

            参数 archetypeGroupId、archetypeArtifactId、archetypeVersion 用来指定现在使用的 maven-archetype-webapp 的坐标。

    4.2 操作

            注意:如果在上一个工程的目录下执行 mvn archetype:generate 命令,那么 Maven 会报错:不能在一个非 pom 的工程下再创建其他工程。所以不要再刚才创建的工程里再创建新的工程,请回到工作空间根目录来操作

    然后运行生成工程的命令:

    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: :【直接回车,使用默认值(1.0版本)】

            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: :【直接回车,表示确认】

    4.3 生成的pom.xml

     

    4.4 生成的Web工程的目录结构

            webapp 目录下有 index.jsp        

            WEB-INF 目录下有 web.xml

    4.5 创建 Servlet

    ① 在 main 目录下创建 java 目录

    ② 在 java 目录下创建 Servlet 类所在的包的目录

    ③ 在包下创建 Servlet 类

    1. package com.chenyixin.maven;
    2. import javax.servlet.http.HttpServlet;
    3. import javax.servlet.http.HttpServletRequest;
    4. import javax.servlet.http.HttpServletResponse;
    5. import javax.servlet.ServletException;
    6. import java.io.IOException;
    7. public class HelloServlet extends HttpServlet{
    8. protected void doGet(HttpServletRequest request, HttpServletResponse response)
    9. throws ServletException, IOException {
    10. response.getWriter().write("hello maven web");
    11. }
    12. }

    ④ 在 web.xml 中注册 Servlet

    1. web-app PUBLIC
    2. "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
    3. "http://java.sun.com/dtd/web-app_2_3.dtd" >
    4. <web-app>
    5. <display-name>Archetype Created Web Applicationdisplay-name>
    6. <servlet>
    7. <servlet-name>helloServletservlet-name>
    8. <servlet-class>com.atguigu.maven.HelloServletservlet-class>
    9. servlet>
    10. <servlet-mapping>
    11. <servlet-name>helloServletservlet-name>
    12. <url-pattern>/helloServleturl-pattern>
    13. servlet-mapping>
    14. web-app>

    4.6 在 index.jsp 页面编写超链接

    1. <html>
    2. <body>
    3. <h2>Hello World!h2>
    4. <a href="helloServlet">Access Servleta>
    5. body>
    6. html>

    TIP

            JSP全称是 Java Server Page,和 Thymeleaf 一样,是服务器端页面渲染技术。这里我们不必关心 JSP 语法细节,编写一个超链接标签即可。        

    4.7 编译

    此时直接执行 mvn compile 命令出错:

    DANGER

            程序包 javax.servlet.http 不存在

            程序包 javax.servlet 不存在

            找不到符号

            符号: 类 HttpServlet

            ……

            上面的错误信息说明:我们的 Web 工程用到了 HttpServlet 这个类,而 HttpServlet 这个类属于 servlet-api.jar 这个 jar 包。此时我们说,Web 工程需要依赖 servlet-api.jar 包。

    4.8 配置对 servlet-api.jar 包的依赖

            对于不知道详细信息的依赖可以到 https://mvnrepository.com/ 网站查询。使用关键词搜索,然后在搜索结果列表中选择适合的使用。

    比如,我们找到的 servlet-api 的依赖信息: 

    1. <dependency>
    2. <groupId>javax.servletgroupId>
    3. <artifactId>javax.servlet-apiartifactId>
    4. <version>4.0.1version>
    5. <scope>providedscope>
    6. dependency>

    这样就可以把上面的信息加入 pom.xml。

    重新执行 mvn compile 命令:

    4.9 将 Web 工程打包为 war 包

    运行 mvn package 命令,生成 war 包的位置如下图所示:

    war 包名:项目名.war 

    4.10 将 war 包部署到 Tomcat 上运行

    将 war 包复制到 Tomcat/webapps 目录下

     启动 Tomcat:

     通过浏览器尝试访问:http://localhost:8080/pro02-maven-web/index.jsp

    5. 让 Web 工程依赖 Java 工程

    5.1 观念

            明确一个意识:从来只有 Web 工程依赖 Java 工程,没有反过来 Java 工程依赖 Web 工程。本质上来说,Web 工程依赖的 Java 工程其实就是 Web 工程里导入的 jar 包。

            最终 Java 工程会变成 jar 包,放在 Web 工程的 WEB-INF/lib 目录下。

    5.2 操作

            在 pro02-maven-web 工程的 pom.xml 中,找到 dependencies 标签,在 dependencies 标签中做如下配置:

    1. <dependency>
    2. <groupId>com.chenyixin.mavengroupId>
    3. <artifactId>pro01-maven-javaartifactId>
    4. <version>1.0-SNAPSHOTversion>
    5. dependency>

    5.3 在 Web 工程中,编写测试代码

    1. 补充创建目录

            pro02-maven-web\src\test\java\com\chenyixin\maven

    2.确认 Web 工程依赖了 junit

    1. <dependency>
    2. <groupId>junitgroupId>
    3. <artifactId>junitartifactId>
    4. <version>4.12version>
    5. <scope>testscope>
    6. dependency>

    3. 创建测试类

            把 Java 工程的 CalculatorTest.java 类复制到 pro02-maven-wb\src\test\java\com\chenyixin\maven 目录下

    5.4 执行Maven命令

    ① 测试命令

            mvn test

            说明:测试操作中会提前自动执行编译操作,测试成功就说明编译也是成功的。

    ② 打包命令

            mvn package

    通过查看 war 包内的结构,我们看到被 Web 工程依赖的 Java 工程确实是会变成 Web 工程的 WEB-INF/lib 目录下的 jar 包。

    ③ 查看当前 Web 工程所依赖的 jar 包的列表

            mvn dependency:list

     说明:javax.servlet:javax.servlet-api:jar:3.1.0:provided 格式显示的是一个 jar 包的坐标信息。格式是:

               groupId:artifactId:打包方式:version:依赖的范围

            这样的格式虽然和我们 XML 配置文件中坐标的格式不同,但是本质上还是坐标信息,大家需要能够认识这样的格式,将来从 Maven 命令的日志或错误信息中看到这样格式的信息,就能够识别出来这是坐标。进而根据坐标到Maven 仓库找到对应的jar包,用这样的方式解决我们遇到的报错的情况。

    ④ 以树形结构查看当前 Web 工程的依赖信息

            mvn dependency:tree

             我们在 pom.xml 中并没有依赖 hamcrest-core,但是它却被加入了我们依赖的列表。原因是:junit 依赖了hamcrest-core,然后基于依赖的传递性,hamcrest-core 被传递到我们的工程了。

    6. 依赖的范围

            标签的位置:dependencies/dependency/scope

            标签的可选值:compile/test/provided/system/runtime/import

    各属性的依赖范围:

    main目录(空间)test目录(空间)开发过程(时间)部署到服务器(时间)
    compile有效有效有效有效
    test无效有效有效无效
    provided有效有效有效无效

    结论:

            compile:通常使用的第三方框架的 jar 包这样在项目实际运行时真正要用到的 jar 包都是以 compile 范围进行依赖的。比如 SSM 框架所需jar包。

            test:测试过程中使用的 jar 包,以 test 范围依赖进来。比如 junit。

            provided:在开发过程中需要用到的“服务器上的 jar 包”通常以 provided 范围依赖进来。比如 servlet-api、jsp-api。而这个范围的 jar 包之所以不参与部署、不放进 war 包,就是避免和服务器上已有的同类 jar 包产生冲突,同时减轻服务器的负担。说白了就是:“服务器上已经有了,你就别带啦!”

    7. 依赖的传递性

    7.1 依赖的传递性

    ① 概念

    A 依赖 B,B 依赖 C,那么在 A 没有配置对 C 的依赖的情况下,A 里面能不能直接使用 C?

    ② 传递的原则

    在 A 依赖 B,B 依赖 C 的前提下,C 是否能够传递到 A,取决于 B 依赖 C 时使用的依赖范围。

    • B 依赖 C 时使用 compile 范围:可以传递
    • B 依赖 C 时使用 test 或 provided 范围:不能传递,所以需要这样的 jar 包时,就必须在需要的地方明确配置依赖才可以。

    7.2 使用 compile 范围依赖 spring-core

            测试方式:让 pro01-maven-java 工程依赖 spring-core

            具体操作:编辑 pro01-maven-java 工程根目录下 pom.xml

    1. <dependencies>
    2. <dependency>
    3. <groupId>junitgroupId>
    4. <artifactId>junitartifactId>
    5. <version>4.12version>
    6. <scope>testscope>
    7. dependency>
    8. <dependency>
    9. <groupId>org.springframeworkgroupId>
    10. <artifactId>spring-coreartifactId>
    11. <version>4.0.0.RELEASEversion>
    12. dependency>
    13. dependencies>

            注意:需要重新将 pro01-maven-java 安装到仓库 (即更新)

            使用 mvn dependency:tree 命令查看效果:

    7.3 验证 test 和 provided 范围不能传递

            从上面的例子已经能够看到,pro01-maven-java 依赖了 junit,但是在 pro02-maven-web 工程中查看依赖树的时候并没有看到 junit。

            要验证 provided 范围不能传递,可以在 pro01-maven-java 工程中加入 servlet-api 的依赖。

    1. <project xmlns="http://maven.apache.org/POM/4.0.0"
    2. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
    4. http://maven.apache.org/xsd/maven-4.0.0.xsd">
    5. <modelVersion>4.0.0modelVersion>
    6. <groupId>com.chenyixin.mavengroupId>
    7. <artifactId>pro02-maven-webartifactId>
    8. <version>1.0-SNAPSHOTversion>
    9. <packaging>warpackaging>
    10. <name>pro02-maven-web Maven Webappname>
    11. <url>http://www.example.comurl>
    12. <properties>
    13. <project.build.sourceEncoding>UTF-8project.build.sourceEncoding>
    14. <maven.compiler.source>1.7maven.compiler.source>
    15. <maven.compiler.target>1.7maven.compiler.target>
    16. properties>
    17. <dependencies>
    18. <dependency>
    19. <groupId>junitgroupId>
    20. <artifactId>junitartifactId>
    21. <version>4.12version>
    22. <scope>testscope>
    23. dependency>
    24. <dependency>
    25. <groupId>javax.servletgroupId>
    26. <artifactId>javax.servlet-apiartifactId>
    27. <version>4.0.1version>
    28. <scope>providedscope>
    29. dependency>
    30. <dependency>
    31. <groupId>com.chenyixin.mavengroupId>
    32. <artifactId>pro01-maven-javaartifactId>
    33. <version>1.0-SNAPSHOTversion>
    34. <scope>compilescope>
    35. dependency>
    36. dependencies>
    37. project>

            再将 pro01-maven-java 工程 重新安装到本地仓库

          使用 mvn dependency:tree 命令查看 pro02-maven-web工程 效果:

     可以看出 工程2 没有依赖 javax.servlet-api:3.1.0 

    8. 依赖的排除

    8.1 概念

            当 A 依赖 B,B 依赖 C 而且 C 可以传递到 A 的时候,A 不想要 C,需要在 A 里面把 C 排除掉。而往往这种情况都是为了避免 jar 包之间的冲突。

             所以配置依赖的排除其实就是阻止某些 jar 包的传递。因为这样的 jar 包传递过来会和其他 jar 包冲突。        

    8.2 测试

    测试的方式:在 pro02-maven-web 工程中配置对 commons-logging 的排除

    配置方式:

    1. <dependency>
    2. <groupId>com.chenyixin.mavengroupId>
    3. <artifactId>pro01-maven-javaartifactId>
    4. <version>1.0-SNAPSHOTversion>
    5. <scope>compilescope>
    6. <exclusions>
    7. <exclusion>
    8. <groupId>commons-logginggroupId>
    9. <artifactId>commons-loggingartifactId>
    10. exclusion>
    11. exclusions>
    12. dependency>

    运行 mvn dependency:tree 命令查看效果:

     发现在 spring-core 下面就没有 commons-logging 了。

    9. 继承

    9.1 概念

    Maven工程之间,A 工程继承 B 工程

    • B 工程:父工程
    • A 工程:子工程

    本质上是 A 工程的 pom.xml 中的配置继承了 B 工程中 pom.xml 的配置。

    9.2 作用

    在父工程中统一管理项目中的依赖信息,具体来说是管理依赖信息的版本。

    它的背景是:

    • 对一个比较大型的项目进行了模块拆分。
    • 一个 project 下面,创建了很多个 module。
    • 每一个 module 都需要配置自己的依赖信息。

    它背后的需求是:

    • 在每一个 module 中各自维护各自的依赖信息很容易发生出入,不易统一管理。
    • 使用同一个框架内的不同 jar 包,它们应该是同一个版本,所以整个项目中使用的框架版本需要统一。
    • 使用框架时所需要的 jar 包组合(或者说依赖信息组合)需要经过长期摸索和反复调试,最终确定一个可用组合。这个耗费很大精力总结出来的方案不应该在新的项目中重新摸索。

    通过在父工程中为整个项目维护依赖信息的组合既保证了整个项目使用规范、准确的 jar 包;又能够将以往的经验沉淀下来,节约时间和精力。

    9.3 举例

    在一个工程中依赖多个 Spring 的 jar 包:

    [INFO] +- org.springframework:spring-core:jar:4.0.0.RELEASE:compile
    [INFO] | \- commons-logging:commons-logging:jar:1.1.1:compile
    [INFO] +- org.springframework:spring-beans:jar:4.0.0.RELEASE:compile
    [INFO] +- org.springframework:spring-context:jar:4.0.0.RELEASE:compile
    [INFO] +- org.springframework:spring-expression:jar:4.0.0.RELEASE:compile
    [INFO] +- org.springframework:spring-aop:jar:4.0.0.RELEASE:compile
    [INFO] | \- aopalliance:aopalliance:jar:1.0:compile

            使用 Spring 时要求所有 Spring 自己的 jar 包版本必须一致。为了能够对这些 jar 包的版本进行统一管理,我们使用继承这个机制,将所有版本信息统一在父工程中进行管理。

    9.4 操作

    ① 创建父工程

    创建的过程和前面创建 pro01-maven-java 一样。

    工程名称:pro03-maven-parent

    工程创建好之后,要修改它的打包方式:

    1. <groupId>com.chenyixin.mavengroupId>
    2. <artifactId>pro03-maven-parentartifactId>
    3. <version>1.0-SNAPSHOTversion>
    4. <packaging>pompackaging>

            只有打包方式为 pom 的 Maven 工程能够管理其他 Maven 工程。打包方式为 pom 的 Maven 工程中不写业务代码,它是专门管理其他 Maven 工程的工程。

    ② 创建模块工程

            模块工程类似于 IDEA 中的 module,所以需要进入 pro03-maven-parent 工程的根目录,然后运行 mvn archetype:generate 命令来创建模块工程。

    假设,我们创建三个模块工程:

     ③ 查看被添加新内容的父工程 pom.xml

    1. <modules>
    2. <module>pro04-maven-modulemodule>
    3. <module>pro05-maven-modulemodule>
    4. <module>pro06-maven-modulemodule>
    5. modules>

    ④ 解读子工程的pom.xml

    1. <parent>
    2. <groupId>com.chenyixin.mavengroupId>
    3. <artifactId>pro03-maven-parentartifactId>
    4. <version>1.0-SNAPSHOTversion>
    5. parent>
    6. <artifactId>pro04-maven-moduleartifactId>

    ⑤ 在父工程中配置依赖的统一管理

    1. <dependencyManagement>
    2. <dependencies>
    3. <dependency>
    4. <groupId>org.springframeworkgroupId>
    5. <artifactId>spring-coreartifactId>
    6. <version>4.0.0.RELEASEversion>
    7. dependency>
    8. <dependency>
    9. <groupId>org.springframeworkgroupId>
    10. <artifactId>spring-beansartifactId>
    11. <version>4.0.0.RELEASEversion>
    12. dependency>
    13. <dependency>
    14. <groupId>org.springframeworkgroupId>
    15. <artifactId>spring-contextartifactId>
    16. <version>4.0.0.RELEASEversion>
    17. dependency>
    18. <dependency>
    19. <groupId>org.springframeworkgroupId>
    20. <artifactId>spring-expressionartifactId>
    21. <version>4.0.0.RELEASEversion>
    22. dependency>
    23. <dependency>
    24. <groupId>org.springframeworkgroupId>
    25. <artifactId>spring-aopartifactId>
    26. <version>4.0.0.RELEASEversion>
    27. dependency>
    28. dependencies>
    29. dependencyManagement>

    ⑥ 子工程中引用那些被父工程管理的依赖

    关键点:省略版本号

    1. <dependencies>
    2. <dependency>
    3. <groupId>org.springframeworkgroupId>
    4. <artifactId>spring-coreartifactId>
    5. dependency>
    6. <dependency>
    7. <groupId>org.springframeworkgroupId>
    8. <artifactId>spring-beansartifactId>
    9. dependency>
    10. <dependency>
    11. <groupId>org.springframeworkgroupId>
    12. <artifactId>spring-contextartifactId>
    13. dependency>
    14. <dependency>
    15. <groupId>org.springframeworkgroupId>
    16. <artifactId>spring-expressionartifactId>
    17. dependency>
    18. <dependency>
    19. <groupId>org.springframeworkgroupId>
    20. <artifactId>spring-aopartifactId>
    21. dependency>
    22. dependencies>

    ⑦ 在父工程中升级依赖信息的版本

    1. <dependencyManagement>
    2. <dependencies>
    3. <dependency>
    4. <groupId>org.springframeworkgroupId>
    5. <artifactId>spring-coreartifactId>
    6. <version>4.1.4.RELEASEversion>
    7. dependency>
    8. <dependency>
    9. <groupId>org.springframeworkgroupId>
    10. <artifactId>spring-beansartifactId>
    11. <version>4.1.4.RELEASEversion>
    12. dependency>
    13. <dependency>
    14. <groupId>org.springframeworkgroupId>
    15. <artifactId>spring-contextartifactId>
    16. <version>4.1.4.RELEASEversion>
    17. dependency>
    18. <dependency>
    19. <groupId>org.springframeworkgroupId>
    20. <artifactId>spring-expressionartifactId>
    21. <version>4.1.4.RELEASEversion>
    22. dependency>
    23. <dependency>
    24. <groupId>org.springframeworkgroupId>
    25. <artifactId>spring-aopartifactId>
    26. <version>4.1.4.RELEASEversion>
    27. dependency>
    28. dependencies>
    29. dependencyManagement>

    然后在子工程中运行mvn dependency:list,效果如下:

    ⑧ 在父工程中声明自定义属性

    1. <project xmlns="http://maven.apache.org/POM/4.0.0"
    2. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
    4. http://maven.apache.org/xsd/maven-4.0.0.xsd">
    5. <modelVersion>4.0.0modelVersion>
    6. <groupId>com.chenyixin.mavengroupId>
    7. <artifactId>pro03-maven-parentartifactId>
    8. <version>1.0-SNAPSHOTversion>
    9. <packaging>pompackaging>
    10. <name>pro03-maven-parentname>
    11. <url>http://maven.apache.orgurl>
    12. <properties>
    13. <project.build.sourceEncoding>UTF-8project.build.sourceEncoding>
    14. <chenyixin.spring.version>4.3.6.RELEASEchenyixin.spring.version>
    15. properties>
    16. <modules>
    17. <module>pro04-maven-modulemodule>
    18. modules>
    19. <dependencyManagement>
    20. <dependencies>
    21. <dependency>
    22. <groupId>org.springframeworkgroupId>
    23. <artifactId>spring-coreartifactId>
    24. <version>${chenyixin.spring.version}version>
    25. dependency>
    26. <dependency>
    27. <groupId>org.springframeworkgroupId>
    28. <artifactId>spring-beansartifactId>
    29. <version>${chenyixin.spring.version}version>
    30. dependency>
    31. <dependency>
    32. <groupId>org.springframeworkgroupId>
    33. <artifactId>spring-contextartifactId>
    34. <version>${chenyixin.spring.version}version>
    35. dependency>
    36. <dependency>
    37. <groupId>org.springframeworkgroupId>
    38. <artifactId>spring-expressionartifactId>
    39. <version>${chenyixin.spring.version}version>
    40. dependency>
    41. <dependency>
    42. <groupId>org.springframeworkgroupId>
    43. <artifactId>spring-aopartifactId>
    44. <version>${chenyixin.spring.version}version>
    45. dependency>
    46. dependencies>
    47. dependencyManagement>
    48. project>

    真正实现“一处修改,处处生效”。

    然后在子工程中运行mvn dependency:list,效果如下:

     

    9.5 实际意义

            编写一套符合要求、开发各种功能都能正常工作的依赖组合并不容易。如果公司里已经有人总结了成熟的组合方案,那么再开发新项目时,如果不使用原有的积累,而是重新摸索,会浪费大量的时间。为了提高效率,我们可以使用工程继承的机制,让成熟的依赖组合方案能够保留下来。

            如上图所示,公司级的父工程中管理的就是成熟的依赖组合方案,各个新项目、子系统各取所需即可。

    10. 聚合

    10.1 Maven 中的聚合

    使用一个“总工程”将各个“模块工程”汇集起来,作为一个整体对应完整的项目。

    • 项目:整体
    • 模块:部分

    概念的对应关系:

    从继承关系角度来看:

    • 父工程
    • 子工程

    从聚合关系角度来看:

    • 总工程
    • 模块工程

    10.2 好处

    • 一键执行 Maven 命令:很多构建命令都可以在“总工程”中一键执行。

      以 mvn install 命令为例:Maven 要求有父工程时先安装父工程;有依赖的工程时,先安装被依赖的工程。我们自己考虑这些规则会很麻烦。但是工程聚合之后,在总工程执行 mvn install 可以一键完成安装,而且会自动按照正确的顺序执行。

    • 配置聚合之后,各个模块工程会在总工程中展示一个列表,让项目中的各个模块一目了然。

    10.3 聚合的配置

    在总工程中配置 modules 即可:

    1. <modules>
    2. <module>pro04-maven-modulemodule>
    3. <module>pro05-maven-modulemodule>
    4. <module>pro06-maven-modulemodule>
    5. modules>

    10.4 依赖循环问题

            如果 A 工程依赖 B 工程,B 工程依赖 C 工程,C 工程又反过来依赖 A 工程,那么在执行构建操作时会报下面的错误:

    [ERROR] [ERROR] The projects in the reactor contain a cyclic reference:

    这个错误的含义是:循环引用。

  • 相关阅读:
    一文搞懂RESTful开发
    执行日志(1)
    零信任迈入2.0时代
    Linux常用基本命令详解(二)-------磁盘分区和磁盘管理类命令
    【web】java多线程(吐血万字超详解)
    运行十几年都没出现BUG的软件都是怎么做的?
    Vue 获取/设置指定组件高度
    Visual Studio 2022 cmake编译 PP-OCRv4
    csv文件用excel打开乱码
    深度学习入门(9)神经网络Affine与Softmax层的计算图表示方式及其误差反向传播的代码实现
  • 原文地址:https://blog.csdn.net/weixin_65637841/article/details/126217882