使用Gradle构建多模块项目

开发 前端
本文将从无到有创建一个用 Gradle 构建的多模块 Spring Boot 项目,JDK 版本为8,IDEA 版本为 2022.3.1 。

哈喽,大家好,我是指北君。

今天和大家分享一下使用 Gradle 构建多模块项目。

0. 前言

相比起 Maven 的 XML 配置方式,Gradle 提供了一套简明的 DSL 用于构建Java 项目,使我们就像编写程序一样编写项目构建脚本。

本文将从无到有创建一个用 Gradle 构建的多模块 Spring Boot 项目,JDK 版本为8,IDEA 版本为 2022.3.1 。

1. 创建项目

打开IDEA,选择菜单:File -> New -> Project,在其中找到 Spring Initializr,创建一个全新的 demo 项目,创建成功后结构如下:

图片

之后,程序会自动下载 Gradle 安装包,并且通过 Gradle 下载和引入的 jar 包。由于默认使用的镜像速度较慢,我们可以先取消下载,等后面配置好国内镜像后再重新下载,当然也可以慢慢等。

2. Gradle说明

在这里就不介绍Gradle 的优缺点了,只说一下本项目涉及的部分:

  • build.gradle:管理依赖包的配置文件(相当于Maven的pom.xml)。
  • gradlew:Gradle 命令的包装,当机器上没有安装 Gradle 时,可以直接用 gradlew 命令来构建项目。
  • settings.gradle:可以视为多模块项目的总目录, Gradle 通过它来构建各个模块,并组织模块间的关系。
  • gradle/wrapper包:Gradle 的一层包装,能够让机器在不安装 Gradle 的情况下运行程序,便于在团队开发过程中统一 Gradle 构建的版本,推荐使用。
  • gradle.properties:需手动创建,配置gradle环境变量,或配置自定义变量供 build.gradle 使用。

3. Gradle最佳实践

接下来,讲一下我个人使用 Gradle 的一些经验。

修改 gradle-wrapper.properties 中的 Gradle 下载镜像改为国内镜像。

图片

新建 gradle.properties 文件,配置 Gradle 参数,提升构建速度。

图片

将 maven 仓库地址改为国内地址

将经常变更的依赖包版本、 maven 库地址等变量提取到 gradle.properties 里, build.gradle 可直接读取使用。

图片

使用 buildscript 方式引用 gradle plugins ,优点是可以使用自定义仓库,且便于子模块继承。

图片

新建 spring.gradle 配置文件,引用相关的 Spring 依赖包。

图片

在 build.gradle 里添加引用本地jar包的语句,这样配置后,仓库中没有的jar包,放到 src/libs 文件夹下就可以直接使用了,非常方便。

图片

图片

在 build.gradle 中添加一个拷贝 jar 包的 task ,在 build 或 bootJar 后执行,用于将子模块打包后,拷贝到根目录下。

图片

4. 项目模块划分

4.1. 拆分思路

新项目默认是一个单模块的 SpringBoot 工程,而我们要将其改造为一个多模块项目,思路是,将项目拆分为多个子模块,分为三类:服务、模块、组件:

项目:最顶级,与服务是一对多的关系,本项目为根目录;

服务:对应一个可启动的 SpringBoot 工程,一般只有一个启动类,建议根据服务器资源和团队规模划分,与模块是一对多的关系,位置在 services 包下;

模块:对应一个完整的业务,模块间边界清晰,将不同的业务解耦,便于扩展和维护,位置在 modules 包下;

组件:将公用的代码部分提取为一个个组件,供不同的模块调用,与模块是多对多的关系,位置在 components 包下。​

4.2. 拆分实践

服务:创建一个示例服务:demo-boot

模块:只是个框架,没有承载业务,象征性的建一个系统管理模块:demo-system ,任何系统都能用到;

组件:建一个放工具类的组件:demo-common ,所有模块都会用到。

4.3. 具体配置

声明子模块:在根目录下的 settings.gradle 里声明各个模块:

图片

服务公共依赖:在 services/build.gradle 里引用一些所有服务公用的一些依赖包,这里使用了 subprojects,表示应用于所有 services 包下的子模块,我们通过 sourceSet 的方式将根目录 src 下的文件,作为公共代码集成到每个服务中。

图片

服务包含模块:在 services/demo-boot/build.gradle 里引用模块 demo-system

图片

模块公共依赖:在 modules/build.gradle 里引用一些所有模块公用的一些依赖包,这里我们引用本地 src/libs 文件夹下的本地jar包。

图片

模块包含组件:在 modules/demo-system/build.gradle 里引用组件 demo-common

图片

4.4. 代码结构

每次修改 Gradle 配置后,需要刷新生效(可改为自动)

图片

责任编辑:武晓燕 来源: Java技术指北
相关推荐

2013-07-18 17:00:12

Gradle构建AndAndroid开发Android学习

2017-04-13 14:55:07

AndroidGradle多模块构建

2021-01-11 09:17:49

GitLabCIMonorepoDocker

2023-10-31 16:37:55

大型语言模型人工智能

2015-01-26 09:57:47

GradleMaven Centr

2021-01-07 08:43:11

微服务pipelineGitLabGroup

2024-01-11 16:24:12

人工智能RAG

2017-04-11 09:07:55

AndroidGradle构建变体

2022-01-07 15:11:27

项目Go 框架

2020-04-23 08:55:01

LinuxGradle工具

2024-05-15 08:20:08

GradleMaven工具

2015-03-20 10:01:50

Android StuGradle

2021-05-19 14:46:41

Space XRust语言

2023-11-10 08:00:00

微服务架构开发

2014-04-22 10:19:40

objection模块化开发iOS

2009-12-16 13:53:51

Ruby多继承

2020-11-05 10:40:07

Spring Boot多模块Java

2021-05-17 09:27:07

项目实战优化项目构建时间

2023-09-08 10:13:35

存储EC系统

2010-01-26 13:33:26

Android构建模块
点赞
收藏

51CTO技术栈公众号