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

古城微笑少年丶 2022-10-09 05:55 9阅读 0赞

# 一、背景 #

最近公司在做微服务项目，考虑到产品线比较庞大，包含的项目模块繁多，极有可能发生各模块间版本管理不一致，如果需要升级某一个公共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...][loading... 1]

## 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>
    
      
      <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>
    
      
      <dependencyManagement>
        <dependencies>
          
          <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-dependencies</artifactId>
            <version>2.2.2.RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
          </dependency>
          
          <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>Hoxton.SR1</version>
            <type>pom</type>
            <scope>import</scope>
          </dependency>
          
          <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... 2]  
![loading...][loading... 3]  
![loading...][loading... 4]  
![loading...][loading... 5]  
点击完finish后，子组件添加成功。

[loading...]: /images/20221005/e7c6c1e570f94986a1ca0ccf3d9912b3.png
[loading... 1]: /images/20221005/e5c9cd45e695478780c8a98aea4c668b.png
[loading... 2]: /images/20221005/6a33e5c1790747a4b89829c23147d85b.png
[loading... 3]: /images/20221005/9dfc9a4771f0409aac1f5b684298bf16.png
[loading... 4]: /images/20221005/3f20b2c61ada4238963213867c371be9.png
[loading... 5]: /images/20221005/b974d06352374ac4a04518ba553610e8.png