【spring-cloud】父工程Project空间新建

2023-08-02 69

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

本文涉及的产品

云数据库 RDS MySQL，集群版 2核4GB 100GB

RDS MySQL Serverless 基础系列，0.5-2RCU 50GB

云数据库 RDS MySQL，高可用版 2核4GB 50GB

简介： 【spring-cloud】父工程Project空间新建

一、背景

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

二、父工程的优势

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

三、父工程注意事项

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

四、父工程Project空间新建

1. 创建项目

新建maven项目

聚合总父工程名称

maven版本选取

工程名字

2. 父空间设置

设置字符编码utf-8

注解生效激活

选择jdk版本

file type过滤

五、父工程pom文件

1. pom主要结构

2. 标签讲解

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