赞
踩
目录
这个系列讲解项目的构建方式,主要使用 父项目 parent 和 自定义 starter 结合。项目使用最新的 springboot3 和 jdk19。本系列的代码仓库看查看 gitee 仓库
这篇我们学习一下父级项目的构建,为以后创建的 Spring Boot 项目构建出所需的项目依赖包。
如果你使用过Spring Boot,那么你肯定知道项目需要引入一个spring-boot-starter-parent,这是 Spring Boot 的父级依赖,它用来提供相关的 Maven 默认依赖。
那么我们也可以类似的,构建属于自己的父级依赖,其他的项目引入后就可以继承父级相关依赖。
我们创建一个父级项目,以 Spring Initializr 的方式创建,项目命名为 backend-parent 。
Spring Boot 使用目前最新的 3.0.0 版本,下面的依赖不需要勾选,直接点击 "Create" 创建项目。
项目创建好后,我们删掉不需要的代码包,只需要留一个pom.xml文件即可。
贴上 pom 文件引入的 Maven 依赖包,这里可以根据自己的实际项目情况,引入所需的依赖包。
- <?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">
- <parent>
- <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter-parent</artifactId>
- <version>3.0.0</version>
- <relativePath />
- </parent>
- <modelVersion>4.0.0</modelVersion>
-
- <modules>
- <module>backend-cloud-parent</module>
- </modules>
-
- <groupId>org.liurb.springboot.scaffold</groupId>
- <artifactId>backend-parent</artifactId>
- <packaging>pom</packaging>
- <version>1.0.0</version>
- <name>backend-parent</name>
-
- <properties>
- <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
- <java.version>19</java.version>
- <maven.compiler.source>${java.version}</maven.compiler.source>
- <maven.compiler.target>${java.version}</maven.compiler.target>
-
- <fastjson.version>2.0.19</fastjson.version>
- <hutool.version>5.8.10</hutool.version>
- <commons-pool2.version>2.11.1</commons-pool2.version>
- <mybatis-plus-boot-starter.version>3.5.2.7-SNAPSHOT</mybatis-plus-boot-starter.version>
- <mybatis-plus-generator.version>3.5.3</mybatis-plus-generator.version>
- <mybatis-plus-join.version>1.3.7</mybatis-plus-join.version>
- <javax.mail.version>1.4.7</javax.mail.version>
- <bcprov-jdk15on.version>1.70</bcprov-jdk15on.version>
- <java-jwt.version>4.2.1</java-jwt.version>
- <mysql-connector-java.version>8.0.31</mysql-connector-java.version>
- <commons-lang3.version>3.12.0</commons-lang3.version>
- <okhttp.version>4.10.0</okhttp.version>
- <mapstruct.version>1.5.3.Final</mapstruct.version>
-
- <gson.version>2.10</gson.version>
-
- <junit.version>4.11</junit.version>
- </properties>
-
- <dependencyManagement>
-
- <dependencies>
-
- <dependency>
- <groupId>cn.hutool</groupId>
- <artifactId>hutool-all</artifactId>
- <version>${hutool.version}</version>
- </dependency>
-
- <dependency>
- <groupId>com.alibaba.fastjson2</groupId>
- <artifactId>fastjson2</artifactId>
- <version>${fastjson.version}</version>
- </dependency>
-
- <dependency>
- <groupId>com.alibaba.fastjson2</groupId>
- <artifactId>fastjson2-extension</artifactId>
- <version>${fastjson.version}</version>
- </dependency>
-
- <dependency>
- <groupId>org.apache.commons</groupId>
- <artifactId>commons-pool2</artifactId>
- <version>${commons-pool2.version}</version>
- </dependency>
-
- <dependency>
- <groupId>com.baomidou</groupId>
- <artifactId>mybatis-plus-boot-starter</artifactId>
- <version>${mybatis-plus-boot-starter.version}</version>
- </dependency>
-
- <dependency>
- <groupId>com.baomidou</groupId>
- <artifactId>mybatis-plus-generator</artifactId>
- <version>${mybatis-plus-generator.version}</version>
- </dependency>
-
- <dependency>
- <groupId>com.github.yulichang</groupId>
- <artifactId>mybatis-plus-join</artifactId>
- <version>${mybatis-plus-join.version}</version>
- </dependency>
-
- <dependency>
- <groupId>javax.mail</groupId>
- <artifactId>mail</artifactId>
- <version>${javax.mail.version}</version>
- </dependency>
-
- <dependency>
- <groupId>org.bouncycastle</groupId>
- <artifactId>bcprov-jdk15on</artifactId>
- <version>${bcprov-jdk15on.version}</version>
- </dependency>
-
- <dependency>
- <groupId>com.auth0</groupId>
- <artifactId>java-jwt</artifactId>
- <version>${java-jwt.version}</version>
- </dependency>
-
- <dependency>
- <groupId>com.mysql</groupId>
- <artifactId>mysql-connector-j</artifactId>
- <version>${mysql-connector-java.version}</version>
- </dependency>
-
- <dependency>
- <groupId>org.apache.commons</groupId>
- <artifactId>commons-lang3</artifactId>
- <version>${commons-lang3.version}</version>
- </dependency>
-
- <dependency>
- <groupId>com.squareup.okhttp3</groupId>
- <artifactId>okhttp</artifactId>
- <version>${okhttp.version}</version>
- </dependency>
-
- <dependency>
- <groupId>org.mapstruct</groupId>
- <artifactId>mapstruct</artifactId>
- <version>${mapstruct.version}</version>
- </dependency>
-
- <dependency>
- <groupId>org.mapstruct</groupId>
- <artifactId>mapstruct-processor</artifactId>
- <version>${mapstruct.version}</version>
- </dependency>
-
- <dependency>
- <groupId>com.google.code.gson</groupId>
- <artifactId>gson</artifactId>
- <version>${gson.version}</version>
- </dependency>
-
- <dependency>
- <groupId>junit</groupId>
- <artifactId>junit</artifactId>
- <version>${junit.version}</version>
- </dependency>
-
- </dependencies>
-
- </dependencyManagement>
-
- </project>
父级项目通过 dependencyManagement 标签可以先声明一些公共的依赖包,子项目如果需要用到哪个依赖包,就只需要在该项目的 pom 文件声明即可,不需要填版本号,这样就可以继承父级项目的版本号,以后就可以通过父级项目统一管理依赖的版本号。
Maven 可以通过 dependencyManagement 元素对依赖进行管理,它具有以下 2 大特性:
- 在该元素下声明的依赖不会实际引入到模块中,只有在 dependencies 元素下同样声明了该依赖,才会引入到模块中。
- 该元素能够约束 dependencies 下依赖的使用,即 dependencies 声明的依赖若未指定版本,则使用 dependencyManagement 中指定的版本,否则将覆盖 dependencyManagement 中的版本。
因为一般 Spring Cloud 项目都是一个 Spring Boot 项目,所以我们只需要继承上面创建的父级项目,来构建 Spring Cloud 父级项目即可。
这里我们以模块的方式创建,命令为 backend-cloud-parent 。
同样的,项目创建好后,我们删掉不需要的代码包,只需要留一个pom.xml文件即可。
贴上 pom 文件引入的 Maven 依赖包,因为是继承上面定义的父级项目,所以这里只需要声明 Spring Cloud 项目需要用到的依赖包即可。
- <?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">
- <parent>
- <artifactId>backend-parent</artifactId>
- <groupId>org.liurb.springboot.scaffold</groupId>
- <version>1.0.0</version>
- </parent>
- <modelVersion>4.0.0</modelVersion>
-
- <artifactId>backend-cloud-parent</artifactId>
- <packaging>pom</packaging>
- <version>1.0.0</version>
-
- <name>backend-cloud-parent</name>
-
- <properties>
- <spring-cloud.version>2021.0.5</spring-cloud.version>
- </properties>
-
- <dependencyManagement>
-
- <dependencies>
-
- <dependency>
- <groupId>org.springframework.cloud</groupId>
- <artifactId>spring-cloud-dependencies</artifactId>
- <version>${spring-cloud.version}</version>
- <type>pom</type>
- <scope>import</scope>
- </dependency>
-
- </dependencies>
-
- </dependencyManagement>
-
- </project>
需要特别注意的是 type 标签是以 pom 的方式引入,而 scope 标签为 import ,即强制子模块使用与父模块完全一致的版本号。
父级项目已经构建好了,那么要怎么使用这两个父级项目呢?答案是将它们打包,通过其他项目即可通过 Maven 依赖引入。
目前创建好的两个父级项目的结构如下。
一般生产上,我们都会将这种项目放在服务器私服仓库中(如阿里云的云效),因为我们这边只是演示,所以我们只需要打到本地仓库即可。
打开 Idea 右侧的 Maven 标签,点开 backend-parent ,双击 package ,执行完成后,双击 install ,即可安装到本地仓库。
这里是从根(root)项目打包,那么将会子项目 backend-cloud-parent 也一块打包,如果只需要将子项目打包,那么就打开对应的项目下的命令进行打包。
这时候,打开本地仓库,就可以看到我们刚才打包的两个目录。
依次打开 backend-parent 目录,会发现里面只有一个 pom 文件,因为我们定义的类型就是 pom
到此,属于自己的父级项目即构建完成,以后创建子项目时,我们就可以引入这个父级项目。
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。