一、背景

最近公司在做微服务项目,考虑到产品线比较庞大,包含的项目模块繁多,极有可能发生各模块间版本管理不一致,如果需要升级某一个公共jar的版本信号时,可能需要改十几个项目,甚至有可能有遗漏,导致项目出现未知bug,基于以上考虑决定采用父工程。那父工程有什么有点?怎么创建呢?

二、父工程的优势

  1. 便于管理(版本控制)
  2. 提升开发效率,只需关注当前模块
  3. 纵向切分:将一个项目的多个功能模块分开,使项目结构更加清楚;横向切分:然后再对每个模块进行拆分,也就是我们平常说的mvc架构,即表现层(controller)、业务层(service)和持久层(mapper)。
  4. 项目整合,即聚合,方便整体打包和发布。

三、父工程注意事项

  1. 该父工程本身也做为一个Maven项目,它必须有自己的POM
  2. 它的打包方式必须为: pom
  3. 引入了新的元素(聚合):modules—module
  4. 版本:父模块的版本和被子模块版本一致
  5. relative path:每个module的值都是一个当前POM的相对目录
  6. 目录名称:为了方便的快速定位内容,模块所处的目录应当与其artifactId一致(Maven约定而不是硬性要求),总之,模块所处的目录必须和模块所处的目录相一致。
  7. 习惯约定:方便构建,通常将(父)聚合模块放在项目目录层的最顶层,其它聚合(子)模块作为子目录。打开项目的时,首先看到的就是父(聚合)模块的POM
  8. 父(聚合)模块的内容:父(聚合)模块的内容仅仅是一个pom.xml文件,因为它只是抽象出来的版本管理工具,本身并没有实质的内容。
  9. 如果父(聚合)项目的子模块进行了删除操作,一定要在父(聚合)项目中pom.xml中的modules选项卡中将这个子模块进行删除

四、父工程Project空间新建

1. 创建项目

  1. 新建maven项目
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-40LZLJlL-1624490227354)(https://note.youdao.com/yws/api/personal/file/DCA82242BD29411FBCE26DFC624BC2AE?method=download&shareKey=9cabc59ecc4cd07a470fbbce498548ec)]
  2. 聚合总父工程名称
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-yvrTCmwT-1624490227361)(https://note.youdao.com/yws/api/personal/file/E468943036B2486A97F7E4AADC3D2DD3?method=download&shareKey=b66123b0b3f2dc473bc9a7a85590042c)]
  3. maven版本选取
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-PQLdMzsf-1624490227366)(https://note.youdao.com/yws/api/personal/file/4E650602D3E04BE48142233B86AA7824?method=download&shareKey=503376c933aeda4151a2bf117795f88f)]
  4. 工程名字
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-2mPMqgpR-1624490227372)(https://note.youdao.com/yws/api/personal/file/EF396D00FF3A4B2092B0051219064E22?method=download&shareKey=71d720ac7580ec77ebf3f14debdcd3bb)]
  5. 删除目录下src文件夹
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-djFfcBrB-1624490227376)(https://note.youdao.com/yws/api/personal/file/D2852E36C8A64110A90D41432F30A078?method=download&shareKey=9dad15c09652e3ed38f8189a29f3a440)]

2. 父空间设置

  1. 设置字符编码utf-8
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-C52YsPOi-1624490227380)(https://note.youdao.com/yws/api/personal/file/9B07CCCEA8184E1A80F3C831CAC0E2B4?method=download&shareKey=8e0bdad87222ec31069b31b035e2a867)]
  2. 注解生效激活
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-iz65OtVB-1624490227383)(https://note.youdao.com/yws/api/personal/file/5117344D85D1416AA59AE69AD581EB64?method=download&shareKey=393c020fab7d28dbdfb703a9a44f7073)]
  3. 选择jdk版本
    loading...
  4. file type过滤
    [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-cP7VwnLx-1624490227391)(https://note.youdao.com/yws/api/personal/file/BFB44F1DBB304D9B9D7815FB9388FDB7?method=download&shareKey=370ea6b0787252ea38dc2fc5ec968f1a)]

五、父工程pom文件

1. pom主要结构

loading...

2. 标签讲解

  1. properties:统一jar版本管理
  2. dependencyManagement:只做版本管理,不引入jar包;通过它元素来管理jar包的版本,让子项目中引用一个依赖而不用显示的列出版本号。Maven会沿着父子层次向上走,直到找到一个拥有dependencyManagement元素的项目,然后它就会使用在这个dependencyManagement元素中指定的版本号。作用:统一管理项目的版本号,确保应用的各个项目的依赖和版本一致,才能保证测试的和发布的是相同的成果,因此,在顶层pom中定义共同的依赖关系。同时可以避免在每个使用的子项目中都声明一个版本号,这样想升级或者切换到另一个版本时,只需要在父类容器里更新,不需要任何一个子项目的修改;如果某个子项目需要另外一个版本号时,只需要在dependencies中声明一个版本号即可。子类就会使用子类声明的版本号,不继承于父类版本号。
  3. modules:聚合模块,填写子模块的相对坐标
  4. build:打包插件

3. 完整父pom文件展示

<?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.yuyue.online.springcloud</groupId>
  <artifactId>CarWash</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>pom</packaging>

  <!-- 统一管理jar包版本 -->
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <junit.version>4.12</junit.version>
    <mysql.version>5.1.47</mysql.version>
    <lombok.version>1.16.18</lombok.version>
    <druid.version>1.1.16</druid.version>
    <mybatis-plus-boot.version>3.3.1</mybatis-plus-boot.version>

  </properties>

  <!-- 子模块继承之后,提供作用:锁定版本+子modlue不用写groupId和version-->
  <dependencyManagement>
    <dependencies>
      <!--spring boot 2.2.2-->
      <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-dependencies</artifactId>
        <version>2.2.2.RELEASE</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
      <!-- spring cloud Hoxton.SR1-->
      <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-dependencies</artifactId>
        <version>Hoxton.SR1</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
      <!-- spring cloud alibaba 2.1.0.RELEASE-->
      <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-alibaba-dependencies</artifactId>
        <version>2.1.0.RELEASE</version>
      </dependency>
      <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>${mysql.version}</version>
      </dependency>
      <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid</artifactId>
        <version>${druid.version}</version>
      </dependency>
      <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>${lombok.version}</version>
      </dependency>

      <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>${mybatis-plus-boot.version}</version>
      </dependency>
    </dependencies>
  </dependencyManagement>

  <!--子模块-->
  <modules>

  </modules>

  <!--打包-->
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.1</version>
        <configuration>
          <source>${maven.compiler.source}</source>
          <target>${maven.compiler.target}</target>
          <encoding>${project.build.sourceEncoding}</encoding>
        </configuration>
      </plugin>
    </plugins>
  </build>
</project>

六、创建子模块

loading...
loading...
loading...
loading...
点击完finish后,子组件添加成功。

Logo

权威|前沿|技术|干货|国内首个API全生命周期开发者社区

更多推荐