一、背景
最近公司在做微服务项目,考虑到产品线比较庞大,包含的项目模块繁多,极有可能发生各模块间版本管理不一致,如果需要升级某一个公共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版本选取
- 工程名字
- 删除目录下src文件夹
2. 父空间设置
- 设置字符编码utf-8
- 注解生效激活
- 选择jdk版本
- file type过滤
五、父工程pom文件
1. pom主要结构
loading...
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>
六、创建子模块
点击完finish后,子组件添加成功。