Java 高级技术之Gradle
1、Gradle 入门
链接: https://pan.baidu.com/s/11uvQBRfBttjPoDTXv8gGTA?pwd=6hnc 提取码: 6hnc 复制这段内容后打开百度网盘手机App,操作更方便哦
1.1、Gradle 简介
Gradle 是一款Google 推出的基于JVM、通用灵活的项目构建工具,支持Maven,JCenter 多种第三方仓库;支持传递性
依赖管理、废弃了繁杂的xml 文件,转而使用简洁的、支持多种语言(例如:java、groovy 等)的build 脚本文件。
官网地址: https://gradle.org/
学习Gradle 的原因:
总之,虽然目前市面上常见的项目构建工具有Ant、Maven、Gradle,主流还是Maven,但是未来趋势Gradle。
1.2、常见的项目构建工具
Ant: 2000 年Apache 推出的纯Java 编写构建工具,通过xml[build.xml]文件管理项目
- 优点:使用灵活,速度快(快于gradle 和maven),
- 缺点:Ant 没有强加任何编码约定的项目目录结构,开发人员需编写繁杂XML
文件构建指令,对开发人员是一个挑战。
Maven: 2004 年Apache 组织推出的再次使用xml 文件[pom.xml]管理项目的构建工具。
- 优点: 遵循一套约定大于配置的项目目录结构,使用统一的GAV 坐标进行依赖管理,侧重于包管理。
- 缺点:项目构建过程僵化,配置文件编写不够灵活、不方便自定义组件,构建速度慢于gradle。
Gradle: 2012 年Google 推出的基于Groovy 语言的全新项目构建工具,集合了Ant 和Maven 各自的优势。
- 优点:集Ant 脚本的灵活性+Maven 约定大于配置的项目目录优势,支持多种远程仓库和插件,侧重于大项目构建。
- 缺点:学习成本高、资料少、脚本灵活、版本兼容性差等。
Whatever:无论哪种项目构建工具,都有自身的优势和劣势,所以选择一款最适合自己的就是最好的。
1.3、Gradle 安装
1.3.1、Gradle 安装说明
SpringBoot 官方文档明确指出,目前SpringBoot 的Gradle 插件需要gradle6.8 版本及以上,所以我们这里选择7.x 版本。
其中SpringBoot 与Gradle 存在版本兼容问题,Gradle 与Idea 也存在兼容问题,所以考虑到java 程序员会使用SpringBoot,
所以要选择6.8 版本及高于6.8 版本的Gradle,那么相应的idea 版本也要升级,不能太老哦。
具体参考文档:https://docs.spring.io/spring-boot/docs/2.5.0/gradle-plugin/reference/htmlsingle/#getting-started
1.3.2、安装JDK
要求Jdk 为1.8 或者1.8 版本以上。
1.3.3、下载并解压到指定目录
- 下载
- 解压到指定目录: D:\software\gradle-7.4.1
1.3.4、配置环境变量
特别注意:这里我们接着再配置一个GRALE_USER_HOME 环境变量:
GRALE_USER_HOME 相当于配置Gradle 本地仓库位置和Gradle Wrapper 缓存目录。
1.3.5、检测是否安装成功
gradle -v 或者gradle --version: 通过gradle -v或者gradle --version检测是否安装成功
1.4、Gradle 项目目录结构
Gradle 项目默认目录结构和Maven 项目的目录结构一致,都是基于约定大于配置【Convention Over Configuration】。其完整项目目录结构如下所示:
只有war工程才有webapp目录,对于普通的jar工程并没有webapp目录
gradlew与gradlew.bat执行的指定wrapper版本中的gradle指令,不是本地安装的gradle指令哦。
1.5、Gradle 创建第一个项目
借助于spring 脚手架创建gradle 第一个项目:https://start.spring.io/
查看生成的gradle 项目目录结构如下所示:
与上图对比会发现:总体的目录结构与上图说明的是一致的。
1.5.1、Gradle 中的常用指令
需要注意的是:gradle 的指令要在含有build.gradle 的目录执行。
1.5.2、修改maven 下载源
Gradle 自带的Maven 源地址是国外的,该Maven 源在国内的访问速度是很慢的,除非使用了特别的手段。一般情况下,我们建议使用国内的第三方开放的Maven 源或企业内部自建Maven 源。
认识init.d 文件夹
我们可以在gradle 的init.d 目录下创建以.gradle 结尾的文件,.gradle 文件可以实现在build 开始之前执行,所以你可以在这个文件配置一些你想预先加载的操作。
在init.d 文件夹创建init.gradle 文件
allprojects {repositories {mavenLocal()maven { name "Alibaba" ; url "https://maven.aliyun.com/repository/public" }maven { name "Bstek" ; url "https://nexus.bsdn.org/content/groups/public/" }mavenCentral()}buildscript {repositories {maven { name "Alibaba" ; url 'https://maven.aliyun.com/repository/public' }maven { name "Bstek" ; url 'https://nexus.bsdn.org/content/groups/public/' }maven { name "M2" ; url 'https://plugins.gradle.org/m2/' }}}
}
拓展1:启用init.gradle 文件的方法有:
- 在命令行指定文件,例如:gradle --init-script yourdir/init.gradle -q taskName。你可以多次输入此命令来指定多个init文件
- 把init.gradle文件放到USER_HOME/.gradle/ 目录下
- 把以.gradle结尾的文件放到USER_HOME/.gradle/init.d/ 目录下
- 把以.gradle结尾的文件放到GRADLE_HOME/init.d/ 目录下
如果存在上面的4种方式的2种以上,gradle会按上面的1-4序号依次执行这些文件,如果给定目录下存在多个init脚本,会按拼音a-z顺序执行这些脚本,每个init脚本都存在一个对应的gradle实例,你在这个文件中调用的所有方法和属性,都会委托给这个gradle实例,每个init脚本都实现了Script接口。
拓展2:仓库地址说明
mavenLocal():指定使用maven本地仓库,而本地仓库在配置maven时settings文件制定的仓库位置。如E:/repositiory,gradle查找jar包顺序如下,USER_HOME/.m2/settings,xml
->M2_HOME/conf/settings,xml ->USER_HOME/.m2/repository
maven{url 地址} ,指定maven仓库,一般用私有仓库地址或者其他的第三方库【比如阿里景象仓库地址】。
mavenCentral(): 这是Maven的中央仓库,无需配置,直接声明就可以使用。
jcenter(): jCtenter中央仓库,时机也是用的maven搭建的,但相比Maven仓库更友好,通过CDN分发,并且支持https访问,在新版本中已经废弃,替换为mavenCentral()
总之,gradle可以通过指定仓库地址为本地maven仓库地址和远程仓库地址相结合的方式,避免每次都会去远程仓库下载依赖库,这种方式也有一定的问题,如果本地maven仓库有这个依赖,就会直接加载本地依赖,如果本地仓库没有改依赖,那么还是会从远程下载。但是下载的jar不是存储在本地maven仓库中,而是放在自己的缓存目录中,默认在USER_HOME/.gradle/.cache目录,当然如果我们配置过GRADLE_USER_HOME环境变量,则会放在GRADLE_USER_HOME/cache目录,那么可不可以将gradle caches指向maven repository。我们说这是不行的,caches下载文件不是按照maven仓库中存放的方式。
拓展3:阿里云仓库地址请参考:https://developer.aliyun.com/mvn/guide
在gradle 中的使用说明:
1.5.3、Wrapper 包装器
Gradle Wrapper 实际上就是对Gradle 的一层包装,用于解决实际开发中可能会遇到的不同的项目需要不同版本的Gradle
问题。例如:把自己的代码共享给其他人使用,可能出现如下情况:
1.对方电脑没有安装gradle
2.对方电脑安装过gradle,但是版本太旧了
这时候,我们就可以考虑使用Gradle Wrapper 了。这也是官方建议使用Gradle Wrapper 的原因。实际上有了GradleWrapper 之后,我们本地是可以不配置Gradle 的,下载Gradle 项目后,使用gradle 项目自带的wrapper 操作也是可以的。
那如何使用Gradle Wrapper 呢?
项目中的gradlew、gradlew.cmd脚本用的就是wrapper中规定的gradle版本。参见源码
而我们上面提到的gradle指令用的是本地gradle,所以gradle指令和gradlew指令所使用的gradle版本有可能是不一样的。
gradlew、gradlew.cmd的使用方式与gradle使用方式完全一致,只不过把gradle指令换成了gradlew指令。
当然,我们也可在终端执行gradlew 指令时,指定指定一些参数,来控制Wrapper 的生成,比如依赖的版本等,如下:
具体操作如下所示:
gradle wrapper --gradle-version=4.4:升级wrapper版本号,只是修改gradle.properties中wrapper版本,未实际下载
gradle wrapper --gradle-version 5.2.1 --distribution-type all :关联源码用
GradleWrapper 的执行流程:
- 当我们第一次执行./gradlew build 命令的时候,gradlew 会读取gradle-wrapper.properties文件的配置信息
- 准确的将指定版本的gradle 下载并解压到指定的位置(GRADLE_USER_HOME目录下的wrapper/dists目录中)
- 并构建本地缓存(GRADLE_USER_HOME目录下的caches目录中),下载再使用相同版本的gradle就不用下载了
- 之后执行的./gradlew 所有命令都是使用指定的gradle 版本。如下图所示:
gradle-wrapper.properties 文件解读:
注意:前面提到的GRALE_USER_HOME 环境变量用于这里的Gradle Wrapper 下载的特定版本的gradle 存储目录。如果我们没有配置过GRALE_USER_HOME 环境变量,默认在当前用户家目录下的.gradle 文件夹中。
那什么时候选择使用gradle wrapper、什么时候选择使用本地gradle?
下载别人的项目或者使用操作以前自己写的不同版本的gradle项目时:用Gradle wrapper,也即:gradlew
什么时候使用本地gradle?新建一个项目时: 使用gradle指令即可。
2、Gradle 与Idea 整合
2.1、Groovy 简介
在某种程度上,Groovy 可以被视为Java 的一种脚本化改良版,Groovy 也是运行在JVM 上,它可以很好地与Java 代码及其相关库进行交互操作。它是一种成熟的面向对象编程语言,既可以面向对象编程,又可以用作纯粹的脚本语言。大多数有效的Java 代码也可以转换为有效的Groovy 代码,Groovy 和Java 语言的主要区别是:完成同样的任务所需的Groovy 代码比Java 代码更少。其特点为:
- 功能强大,例如提供了动态类型转换、闭包和元编程(metaprogramming)支持
- 支持函数式编程,不需要main 函数
- 默认导入常用的包
- 类不支持default 作用域,且默认作用域为public。
- Groovy 中基本类型也是对象,可以直接调用对象的方法。
- 支持DSL(Domain Specific Languages 领域特定语言)和其它简洁的语法,让代码变得易于阅读和维护。
- Groovy 是基于Java 语言的,所以完全兼容Java 语法,所以对于java 程序员学习成本较低。
详细了解请参考:http://www.groovy-lang.org/documentation.html
2.2、Groovy 安装[非必须]
下载地址: https://groovy.apache.org/download.html
解压配置环境变量:
2.3、创建Groovy 项目
2.4、Groovy 基本语法
类型转换:当需要时,类型之间会自动发生类型转换: 字符串(String)、基本类型(如int) 和类型的包装类(如Integer)类说明:如果在一个groovy 文件中没有任何类定义,它将被当做script 来处理,也就意味着这个文件将被透明的转换为一个Script 类型的类,这个自动转换得到的类将使用原始的groovy 文件名作为类的名字。groovy 文件的内容被打包进
run 方法,另外在新产生的类中被加入一个main 方法以进行外部执行该脚本。
2.4.1、案例1:基本注意点
提示:方法调用时,在不含有歧义的地方可以省略方法调用时的括号。这类似于使用${变量名}时,括号在不引起歧义的地
方可以省略是一样的:如
def num1=1;
def num2= 2;
println "$num1 + $num2 = ${num1+num2}"
2.4.2、案例2:引号说明
def num1=1;
def num2=2;
def str1="1d"; //双引号
def str2='dsd'; //单引号
//双引号运算能力,单引号用于常量字符串,三引号相当于模板字符串,可以支持换行
println "$num1 + $num2 = ${num1 + num2}"
//基本数据类型也可以作为对象使用,可以调用对象的方法
println(num1.getClass().toString())
println(str1.getClass().toString())
println(str2.getClass().toString())
2.4.3、案例3:三个语句结构
Groovy 支持顺序结构从上向下依次解析、分支结构(if…else、if…else if …else…、switch…case、for、while、do…while)
具体参考官网:http://www.groovy-lang.org/semantics.html#_conditional_structures
2.4.4、案例4:类型及权限修饰符
Groovy 中的类型有:
1.原生数据类型及包装类
2.类、内部类、抽象类、接口
3.注解
4.Trait: 可以看成是带有方法实现的接口
权限修饰符: public、protected、private
拓展:Groovy 类与Java 类之间的主要区别是:
1.没有可见性修饰符的类或方法自动是公共的(可以使用一个特殊的注释来实现包的私有可见性)。
2.没有可见性修饰符的字段将自动转换为属性,不需要显式的getter 和setter 方法。
3.如果属性声明为final,则不会生成setter。
4.一个源文件可能包含一个或多个类(但是如果一个文件不包含类定义的代码,则将其视为脚本)。脚本只是具有一些特殊
约定的类,它们的名称与源文件相同(所以不要在脚本中包含与脚本源文件名相同的类定义)。
提示: 有关Groovy 中各种各样的数据类型和权限修饰符及Goovy 与Java 区别请参考:
http://www.groovy-lang.org/objectorientation.html#_modifiers_on_a_property
2.4.5、案例5:集合操作
Groovy 支持List、Map 集合操作,并且拓展了Java 中的API,具体参考如下方法:
List:
add():添加某个元素
plus():添加某个list 集合
remove():删除指定下标的元素
removeElement():删除某个指定的元素
removeAll(): 移除某个集合中的元素
pop():弹出list 集合中最后一个元素
putAt():修改指定下标的元素
each():遍历
size(): 获取list 列表中元素的个数
contains(): 判断列表中是否包含指定的值,则返回true
Map:
put():向map 中添加元素
remove():根据某个键做移除,或者移除某个键值对
+、-:支持map 集合的加减操作
each():遍历map 集合
请参考官网:http://www.groovy-lang.org/syntax.html#_number_type_suffixes
提示:可以把不同的基本类型添加到同一集合中
2.4.6、案例6:类导入
Groovy 遵循Java 允许import 语句解析类引用的概念。
import groovy.xml.MarkupBuilder
def xml = new MarkupBuilder()
assert xml != null
Groovy 语言默认提供的导入
import java.lang.*
import java.util.*
import java.io.*
import java.net.*
import groovy.lang.*
import groovy.util.*
import java.math.BigInteger
import java.math.BigDecimal
这样做是因为这些包中的类最常用。通过导入这些样板代码减少了。
参考官网地址:http://www.groovy-lang.org/structure.html#_imports
2.4.7、案例7:异常处理
Groovy 中的异常处理和java 中的异常处理是一样的。
def z
try {def i = 7, j = 0try {def k = i / jassert false} finally {z = 'reached here'}
} catch ( e ) {assert e in ArithmeticExceptionassert z == 'reached here'
}
参考官网地址: http://www.groovy-lang.org/semantics.html#_try_catch_finally
2.4.8、案例8:闭包
闭包:Groovy 中的闭包是一个开放的、匿名的代码块,它可以接受参数、也可以有返回值。闭包可以引用其周围作用域中声明的变量。
语法:{ [closureParameters -> ] statements }
其中[ closureParameters-> ]是一个可选的逗号分隔的参数列表,参数后面是Groovy 语句。参数类似于方法参数列表,这些参数可以是类型化的,也可以是非类型化的。当指定参数列表时,需要使用-> 字符,用于将参数与闭包体分离。
参考:http://www.groovy-lang.org/closures.html
//闭包体完成变量自增操作
{ item++ }
//闭包使用空参数列表明确规定这是无参的
{ -> item++ }
//闭包中有一个默认的参数[it],写不写无所谓
{ println it }
{ it -> println it }
//如果不想使用默认的闭包参数it,那需要显示自定义参数的名称
{ name -> println name }
//闭包也可以接受多个参数
{ String x, int y ->
println "hey ${x} the value is ${y}"
}
//闭包参数也可是一个对象
{ reader ->
def line = reader.readLine()
闭包调用方式: 闭包是groovy.lang.Closure
的实例。它可以像任何其他变量一样分配给一个变量或字段。
闭包对象(参数)
闭包对象.call(参数)
def isOdd = { int i -> i%2 != 0 }
assert isOdd(3) == true
assert isOdd.call(2) == false
def isEven = { it%2 == 0 }
assert isEven(3) == false
assert isEven.call(2) == true
特殊说明: 可以把闭包当作一个对象,作为参数传递给方法使用
//无参闭包
def run(Closure closure){
println("run start....")
closure()
println("run end....")
}
run {
println "running......"
}
//有参闭包
def caculate(Closure closure){
def num1=1;
def num2=3;
println("caculate start....")
closure(num1,num2)
println("caculate end....")
}
caculate {x,y -> println "计算结果为:$x+$y=${x+y}"} //在build.gradle文件中我们见到的很多都是闭包格式的。
2.5、在idea 中创建普通java 工程
具体整合:
第一步:创建由Gradle 管理的项目在这里插入图片描述
第二步:修改当前项目使用本地安装的gradle:可以加快下载项目依赖jar 包的速度【配置了私服地址】。
特别提示1:使得在Terminal 中执行以gradlew 开头命令和操作图形化的IDEA 使用Gradle 版本不一定是同一个版本哦。
1.Terminal中以gradlew开头指令用的是Wrapper规定的gradle版本,wrapper中规定版本默认和idea插件中规定的版本一致。
2.而图形化的IDEA使用Gradle是本地安装的哦。
特别提示2:目前只能是在创建项目时重新设置本地gradle,创建新项目需要重新去改。
特别提示3 :当我们在gradle.build 文件添加依赖之后, 这些依赖会在下载到GRADLE
USER_HOME/caches/modules-2/files-2.1 目录下面,所以这里的GRADLE_USER
HOME 相当于Gradle 的本地仓库,当然也可以如下方式找到jar 包位置。
2.6、在idea 中创建web 工程
在idea 新版本的创建项目中,无法自己选择创建项目是普通java 工程还是web 工程了【IDEA 旧版本是可以的】,所以我们如果想创建web 工程,只需要自己在src/main/目录下添加webapp/WEB-INF/web.xml 及页面即可。
接下来在我们对gradle 的其它知识点讲解之前我们先提一下在gradle 文件中需要用到的Groovy 语法。
2.7、项目部署
当我们将一个java 项目打成war 包之后,就需要部署到服务器运行,这里有两种方式:
- 我们将项目打成war 包,部署到本地tomcat 运行:
- 使用Gretty 插件中内置服务器方式部署项目:
2.7.1、Gretty 部署项目
Gretty 是一个功能丰富的gradle 插件,用于在嵌入的servlet 容器上运行web 应用程序,让项目开发和部署更加简单。目前Gretty 插件已经作为gradle 的核心库使用了,Gretty 其核心功能为:
1.底层支持jetty,tomcat 等Servlet 容器
2.支持项目热部署、HTTPS、调试
Gretty 官网地址:http://akhikhl.github.io/gretty-doc/index.html
2.7.2、具体使用
第一步:引入Gretty 插件
plugins {id ‘war’id 'org.gretty' version '2.2.0'
}
第二步:指定maven 仓库
repositories {//指定jcenter仓库,一定要放在前面jcenter()mavenCentral()
}
第三步:针对Gretty 插件的设置
gretty {httpPort = 8888contextPath = "/web"debugPort = 5005 // defaultdebugSuspend = true // defaulthttpsEnabled = truemanagedClassReload=true //修改了类之后重新加载//servletContainer = 'tomcat8' //如果不指定默认的servlet容器,支持tomcat7/8,默认是使用的是Jetty服务器httpsPort = 4431
}
第四步:执行Gretty 插件
gradle appRun
如果大家想进一步了解的属性配置, 比如Gretty 热部署等设置, 欢迎参考其官方文档
http://akhikhl.github.io/gretty-doc/Gretty-configuration.html
2.8、Gradle 对测试支持
测试任务自动检测并执行测试源集中的所有单元测试。测试执行完成后会生成一个报告。支持JUnit 和TestNG 测试。
2.8.1、默认测试目录及标准输出
2.8.2、Junit 使用
Gradle 对于Junit4.x 支持
dependencies {testImplementation group: 'junit' ,name: 'junit', version: '4.12'
}
test {useJUnit()
}
Gradle 对于Junit5.x 版本支持
dependencies {testImplementation 'org.junit.jupiter:junit-jupiter-api:5.8.1'testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.8.1'
}
test {useJUnitPlatform()
}
注意:无论是Junt4.x 版本还是Junit5.x 版本,我们只需在build.gradle 目录下执行gradle test 指令,gradle 就会帮我们执
行所有的加了@Test 注解的测试,并生成测试报告。
2.8.3、包含和排除特定测试
test {enabled trueuseJUnit()include 'com/**'exclude 'com/abc/**'
}
gradle 在junit 中的批量测试,可以设置包含或者排除某些特定测试。
3、Gradle 进阶说明
为了让大家快速的入门gradle,本章将从整体构建脚本的角度介绍:
- 什么是setting 文件,它有什么作用;
- 说明什么是build 文件,它又有什么作用
- 我们可以创建多少个build
- project 和task,他们有什么作用;又是什么关系,如何配置
- 项目的生命周期
- 项目发布
- 使用Gradle 创建SpringBoot 项目等
3.1、项目的生命周期
Gradle 项目的生命周期分为三大阶段: Initialization -> Configuration -> Execution. 每个阶段都有自己的职责,具体如下图所示:
Initialization 阶段主要目的是初始化构建, 它又分为两个子过程,一个是执行Init Script,另一个是执行Setting Script。init.gradle 文件会在每个项目build 之前被调用,用于做一些初始化的操作,它主要有如下作用:
配置内部的仓库信息(如公司的maven 仓库信息);
配置一些全局属性;
配置用户名及密码信息(如公司仓库的用户名和密码信息)。
Setting Script 则更重要, 它初始化了一次构建所参与的所有模块。
Configuration 阶段:这个阶段开始加载项目中所有模块的Build Script。所谓"加载" 就是执行build.gradle 中的语句,根据脚本代码创建对应的task, 最终根据所有task 生成由Task 组成的有向无环图(Directed Acyclic Graphs),如下:
从而构成如下有向无环树:
Execution 阶段:这个阶段会根据上个阶段构建好的有向无环图,按着顺序执行Task【Action 动作】。
3.2、settings 文件
首先对settings 文件的几点说明:
- 作用:主要是在项目初始化阶段确定一下引入哪些工程需要加入到项目构建中,为构建项目工程树做准备。
- 工程树:gradle 中有工程树的概念,类似于maven 中的project 与module。
- 内容:里面主要定义了当前gradle 项目及子project 的项目名称
- 位置:必须放在根工程目录下。
- 名字:为settings.gradle 文件,不能发生变化
- 对应实例:与org.gradle.api.initialization.Settings 实例是一一对应的关系。每个项目只有一个settings 文件。
- 关注:作为开发者我们只需要关注该文件中的include 方法即可。使用相对路径【: 】引入子工程。
- 一个子工程只有在setting 文件中配置了才会被gradle 识别,这样在构建的时候才会被包含进去。案例如下所示:
//根工程项目名
rootProject.name = 'root'
//包含的子工程名称
include 'subject01'
include 'subject02'
include 'subject03'
//包含的子工程下的子工程名称
include 'subject01:subproject011'
include 'subject01:subproject012'
项目名称中":" 代表项目的分隔符, 类似路径中的"/“. 如果以”:" 开头则表示相对于root project 。然后Gradle 会为每个带有build.gradle 脚本文件的工程构建一个与之对应的Project 对象。
3.3、Task
项目实质上是Task 对象的集合。一个Task 表示一个逻辑上较为独立的执行过程,比如编译Java 源代码,拷贝文件,打包Jar 文件,甚至可以是执行一个系统命令。另外,一个Task 可以读取和设置Project 的Property 以完成特定的操作。
3.3.1、任务入门
可参考官方文档:https://docs.gradle.org/current/userguide/tutorial_using_tasks.html
让我们来先看一个例子:
task A {println "root taskA"doFirst(){println "root taskA doFirst"}doLast(){println "root taskA doLast"}
}
在文件所在的目录执行命令: gradle A。
提示1 :task 的配置段是在配置阶段完成
提示2 :task 的doFirst、doLast 方法是执行阶段完成,并且doFirst 在doLast 执行之前执行。
提示3:区分任务的配置段和任务的行为,任务的配置段在配置阶段执行,任务的行为在执行阶段执行
3.3.2、任务的行为
案例如下:doFirst、doLast 两个方法可以在任务内部定义,也可以在任务外部定义
def map=new HashMap<String,Object>();
//action属性可以设置为闭包,设置task自身的行为
map.put("action",{println "taskD.."})
task(map,"a"){description 'taskA description....'group "atguigu"
//在task内部定义doFirst、doLast行为doFirst {def name = 'doFirst..'println name}doLast {def name = 'doLast..'println name}
}
//在task外部定义doFirst、doLast行为
a.doFirst {println it.description
}
a.doLast {println it.group
}
测试:gradle a , 输出如下所示:
底层原理分析:无论是定义任务自身的action,还是添加的doLast、doFirst 方法,其实底层都被放入到一个Action 的List中了,最初这个action List 是空的,当我们设置了action【任务自身的行为】,它先将action 添加到列表中,此时列表中只有一个action,后续执行doFirst 的时候doFirst 在action 前面添加,执行doLast 的时候doLast 在action 后面添加。doFirst永远添加在actions List 的第一位,保证添加的Action 在现有的action List 元素的最前面;doLast 永远都是在action List末尾添加,保证其添加的Action 在现有的action List 元素的最后面。一个往前面添加,一个往后面添加,最后这个actionList 就按顺序形成了doFirst、doSelf、doLast 三部分的Actions,就达到doFirst、doSelf、doLast 三部分的Actions 顺序执
行的目的。
提示1:其中<<代表doLast,在gradle5.x 版本之后就废弃,不能使用了,如下所示:
如下所示:
task hello << {println 'Hello world!'
}
3.3.3、任务的依赖方式
Task 之间的依赖关系可以在以下几部分设置:
1.参数依赖
2.内部依赖
3.外部依赖
方式一:参数方式依赖
task A {doLast {println "TaskA.."}
}
task 'B'{doLast {println "TaskB.."}
}
//参数方式依赖: dependsOn后面用冒号
task 'C'(dependsOn: ['A','B']){doLast {println "TaskC.."}
}
方式二:内部依赖
//参数方式依赖
task 'C' {//内部依赖:dependsOn后面用= 号dependsOn= [A,B]doLast {println "TaskC.."}
}
测试: gradle C
方式三:外部依赖
//外部依赖:可变参数,引号可加可不加
C.dependsOn(B,'A')
当然:task 也支持跨项目依赖
在subproject01 工程的build.gradle 文件中定义:
task A {doLast {println "TaskA.."}
}
在subproject02 工程的build.gradle 文件中定义:
task B{dependsOn(":subproject01:A") //依赖根工程下的subject01中的任务A :跨项目依赖。doLast {println "TaskB.."}
}
测试:gradle B ,控制台显示如下
拓展1:当一个Task 依赖多个Task 的时候,被依赖的Task 之间如果没有依赖关系,那么它们的执行顺序是随机的,并无影响。
拓展2:重复依赖的任务只会执行一次,比如:
A -> B、C B -> C 任务A 依赖任务B 和任务C、任务B 依赖C 任务。执行任务A 的时候,显然任务C 被重复依赖了,C
只会执行一次。
3.3.4、任务执行
任务执行语法:gradle [taskName…] [–option-name…]。
分类 | 解释 |
---|---|
常见的任务(*) | gradle build: 构建项目:编译、测试、打包等操作gradle run :运行一个服务,需要application 插件支持,并且指定了主启动类才能运行gradle clean: 请求当前项目的build 目录gradle init : 初始化gradle 项目使用gradle wrapper:生成wrapper 文件夹的。gradle wrapper 升级wrapper 版本号:gradle wrapper --gradle-version=4.4gradle wrapper --gradle-version 5.2.1 --distribution-typeall :关联源码用 |
项目报告相关任务 | gradle projects : 列出所选项目及子项目列表,以层次结构的形式显示gradle tasks: 列出所选项目【当前project,不包含父、子】的已分配给任务组的那些任务。gradle tasks --all :列出所选项目的所有任务。gradle tasks --group=“build setup”:列出所选项目中指定分组中的任务。gradle help --task someTask :显示某个任务的详细信息gradle dependencies :查看整个项目的依赖信息,以依赖树的方式显示gradle properties 列出所选项目的属性列表 |
调试相关选项 | -h,–help: 查看帮助信息-v, --version:打印Gradle、Groovy、Ant、JVM 和操作系统版本信息。-S, --full-stacktrace:打印出所有异常的完整(非常详细)堆栈跟踪信息。-s,–stacktrace: 打印出用户异常的堆栈跟踪(例如编译错误)。-Dorg.gradle.daemon.debug=true: 调试Gradle 守护进程。-Dorg.gradle.debug=true:调试Gradle 客户端(非daemon)进程。-Dorg.gradle.debug.port=(port number):指定启用调试时要侦听的端口号。默认值为5005。 |
性能选项:【备注:在gradle.properties 中指定这些选项中的许多选项,因此不需要命令行标志】 | –build-cache, --no-build-cache: 尝试重用先前版本的输出。默认关闭(off)。–max-workers: 设置Gradle 可以使用的woker 数。默认值是处理器数。-parallel, --no-parallel: 并行执行项目。有关此选项的限制,请参阅并行项目执行。默认设置为关闭(off) |
守护进程选项 | –daemon, --no-daemon: 使用Gradle 守护进程运行构建。默认是on–foreground:在前台进程中启动Gradle 守护进程。-Dorg.gradle.daemon.idletimeout=(number of milliseconds):Gradle Daemon 将在这个空闲时间的毫秒数之后停止自己。默认值为10800000(3 小时)。 |
日志选项 | -Dorg.gradle.logging.level=(quiet,warn,lifecycle,info,debug):通过Gradle 属性设置日志记录级别。-q, --quiet: 只能记录错误信息-w, --warn: 设置日志级别为warn-i, --info: 将日志级别设置为info -d, --debug:登录调试模式(包括正常的堆栈跟踪) |
其它(*) | -x:-x 等价于: --exclude-task : 常见gradle -x test clean build–rerun-tasks: 强制执行任务,忽略up-to-date ,常见gradle build --rerun-tasks–continue: 忽略前面失败的任务,继续执行,而不是在遇到第一个失败时立即停止执行。每个遇到的故障都将在构建结束时报告,常见:gradle build --continue。gradle init --type pom :将maven 项目转换为gradle 项目(根目录执行)gradle [taskName] :执行自定义任务 |
… |
更详细请参考官方文档:
https://docs.gradle.org/current/userguide/command_line_interface.html#sec:command_line_executing_tasks
拓展:gradle 任务名是缩写: 任务名支持驼峰式命名风格的任务名缩写,如:connectTask 简写为:cT,执行任务gradle cT。
拓展1:前面提到的Gradle 指令本质:一个个的task[任务], Gradle 中所有操作都是基于任务完成的。
拓展2:gradle 默认各指令之间相互的依赖关系:
相关解释:
3.3.5、任务定义方式
任务定义方式,总体分为两大类:一种是通过Project 中的task()方法,另一种是通过tasks 对象的create 或者register 方法。
task('A',{//任务名称,闭包都作为参数println "taskA..."
})
task('B'){//闭包作为最后一个参数可以直接从括号中拿出来println "taskB..."
}
task C{//groovy语法支持省略方法括号:上面三种本质是一种println "taskC..."
}
def map=new HashMap<String,Object>();
map.put("action",{println "taskD.."}) //action属性可以设置为闭包
task(map,"D");
tasks.create('E'){//使用tasks的create方法println "taskE.."
}
tasks.register('f'){ //注:register执行的是延迟创建。也即只有当task被需要使用的时候才会被创建。println "taskF...."
}
当然:我们也可以在定义任务的同时指定任务的属性,具体属性有:
在定义任务时也可以给任务分配属性:定义任务的时候可以直接指定任务属性,也可以给已有的任务动态分配属性:
//①.F是任务名,前面通过具名参数给map的属性赋值,以参数方式指定任务的属性信息
task(group: "atguigu",description: "this is task B","F")
//②.H是任务名,定义任务的同时,在内部直接指定属性信息
task("H") {group("atguigu")description("this is the task H")
}
//③.Y是任务名,给已有的任务在外部直接指定属性信息
task "y"{}
y.group="atguigu"
clean.group("atguigu") //案例:给已有的clean任务重新指定组信息
3.3.6、任务类型
前面我们定义的task 都是DefaultTask 类型的,如果要完成某些具体的操作完全需要我们自己去编写gradle 脚本,势必有些麻烦,那有没有一些现成的任务类型可以使用呢?有的,Gradle 官网给出了一些现成的任务类型帮助我们快速完成想要的任务,我们只需要在创建任务的时候,指定当前任务的类型即可,然后即可使用这种类型中的属性和API 方法了。
提示1:如果想看更详细的gradle 自带Task 类型,请参考官方文档: https://docs.gradle.org/current/dsl/index.html
提示2: 官方文档在给出这些任务类型的时候,同时给出了案例代码,可以点进去上述官网地址中的某个类型中观看
具体使用例如:
tasks.register('myClean', Delete) {delete buildDir
}
在命令行执行gradle myClean 发现就可以将当前project 的build 目录删除
当然除了gradle 自带的task 类型,我们也可以自定义task 类型,如下所示:
拓展4:自定义Task 类型
def myTask=task MyDefinitionTask (type: CustomTask)
myTask.doFirst(){println "task 执行之前执行的doFirst方法"
}
myTask.doLast(){println "task 执行之后执行的doLast方法"
}
class CustomTask extends DefaultTask {
//@TaskAction表示Task本身要执行的方法@TaskActiondef doSelf(){println "Task 自身在执行的in doSelf"}
}
测试:gradle MyDefinitionTask
控制台输出:
3.3.7、任务的执行顺序
在Gradle 中,有三种方式可以指定Task 执行顺序:
- dependsOn 强依赖方式
- 通过Task 输入输出
- 通过API 指定执行顺序
详细请参考官网:https://docs.gradle.org/current/dsl/org.gradle.api.Task.html
3.3.8、动态分配任务
gradle 的强大功能不仅仅用于定义任务的功能。例如,可以使用它在循环中注册同一类型的多个任务
4.times { counter ->tasks.register("task$counter") {doLast {println "I'm task number $counter"}}
}
一旦注册了任务,就可以通过API 访问它们。例如,您可以使用它在运行时动态地向任务添加依赖项。Ant 不允许这样的事情发生。
4.times { counter ->tasks.register("task$counter") {doLast {println "I'm task number $counter"}}
}
tasks.named('task0') { dependsOn('task2', 'task3') }
构建4 个任务,但是任务0 必须依赖于任务2 和3,那么代表任务2 和3 需要在任务0 之前优先加载。具体测试如下:
3.3.9、任务的关闭与开启
每个任务都有一个enabled 默认为的标志true。将其设置为false 阻止执行任何任务动作。禁用的任务将标记为“跳过”。
task disableMe {doLast {println 'This task is Executing...'}enabled(true)//直接设置任务开启,默认值为true
}
//disableMe.enabled = false //设置关闭任务
3.3.10、任务的超时
每个任务都有一个timeout 可用于限制其执行时间的属性。当任务达到超时时,其任务执行线程将被中断。该任务将被标记为失败。终结器任务仍将运行。如果–continue 使用,其他任务可以在此之后继续运行。不响应中断的任务无法超时。Gradle 的所有内置任务均会及时响应超时
task a() {doLast {Thread.sleep(1000)println "当前任务a执行了"}timeout = Duration.ofMillis(500)
}
task b() {doLast {println "当前任务b执行了"}
}
在控制台使用: gradle a b 测试会发现执行a 的时候,由于a 执行超时,抛出异常,所以没有继续往下执行【b 也没执行】。然后在控制台使用: gradle a b –continue,测试会发现a 虽然执行失败,但是b 还是执行了。
3.3.11、任务的查找
常用的任务查找方法有:
task atguigu {doLast {println "让天下没有难学的技术:尚硅谷"}
}
//根据任务名查找
tasks.findByName("atguigu").doFirst({println "尚硅谷校区1:北京...."})
tasks.getByName("atguigu").doFirst({println "尚硅谷校区2:深圳...."})
//根据任务路径查找【相对路径】
tasks.findByPath(":atguigu").doFirst({println "尚硅谷校区3:上海...."})
tasks.getByPath(":atguigu").doFirst({println "尚硅谷校区4:武汉...."})
执行task: gradle atguigu,输出结果如下所示:
尚硅谷校区4:武汉....
尚硅谷校区3:上海....
尚硅谷校区2:深圳....
尚硅谷校区1:北京....
让天下没有难学的技术:尚硅谷
3.3.12、任务的规则
当我们执行、依赖一个不存在的任务时,Gradle 会执行失败,报错误信息。那我们能否对其进行改进,当执行一个不存在的任务时,不是报错而是打印提示信息呢?
task hello {doLast {println 'hello 尚硅谷的粉丝们'}
}
tasks.addRule("对该规则的一个描述,便于调试、查看等"){String taskName -> task(taskName) {doLast {println "该${taskName}任务不存在,请查证后再执行"}}
}
测试: 使用gradle abc hello 进行测试,此时当abc 任务不存在时,也不会报异常【不中断执行】而是提示自定义的规则信息,继续执行hello 任务。此外,它还可以根据不同的规则动态创建需要的任务等情况。
3.3.13、任务的onlyIf 断言
断言就是一个条件表达式。Task 有一个onlyIf 方法。它接受一个闭包作为参数,如果该闭包返回true 则该任务执行,否则跳过。这有很多用途,比如控制程序哪些情况下打什么包,什么时候执行单元测试,什么情况下执行单元测试的时候不执行网络测试等。具体案例如下所示:
task hello {doLast {println 'hello 尚硅谷的粉丝们'}
}
hello.onlyIf { !project.hasProperty('fensi') }
测试:通过-P 为Project 添加fensi 属性
gradle hello -Pfensi
3.3.14、默认任务
Gradle 允许您定义一个或多个在没有指定其他任务时执行的默认任务。
代码如下所示:
defaultTasks 'myClean', 'myRun'
tasks.register('myClean'){doLast {println 'Default Cleaning!'}
}
tasks.register('myRun') {doLast {println 'Default Running!'}
}
tasks.register('other') {doLast {println "I'm not a default task!"}
}
测试及结果如下:
gradle -q
Default Cleaning!
Default Running!
3.4、Gradle 中的文件操作
几种常见的文件操作方式:
- 本地文件
- 文件集合
- 文件树
- 文件拷贝
- 归档文件
各种文件操作类型的详细介绍如下所示:
3.4.1、本地文件
使用Project.file(java.lang.Object)方法,通过指定文件的相对路径或绝对路径来对文件的操作,其中相对路径为相对当前project[根project 或者子project]的目录。其实使用Project.file(java.lang.Object)方法创建的File 对象就是Java 中的File对象,我们可以使用它就像在Java 中使用一样。示例代码如下:
//使用相对路径
File configFile = file('src/conf.xml')
configFile.createNewFile();
// 使用绝对路径
configFile = file('D:\\conf.xml')
println(configFile.createNewFile())
// 使用一个文件对象
configFile = new File('src/config.xml')
println(configFile.exists())
3.4.2、文件集合
文件集合就是一组文件的列表, 在Gradle 中, 文件集合用FileCollection 接口表示。我们可以使用Project.files(java.lang.Object[])方法来获得一个文件集合对象,如下代码创建一个FileCollection 实例:
def collection = files('src/test1.txt',new File('src/test2.txt'),['src/test3.txt', 'src/test4.txt'])
collection.forEach(){File it ->it.createNewFile() //创建该文件println it.name //输出文件名
}
Set set1 = collection.files // 把文件集合转换为java中的Set类型
Set set2 = collection as Set
List list = collection as List// 把文件集合转换为java中的List类型
for (item in list) {println item.name
}
def union = collection + files('src/test5.txt') // 添加或者删除一个集合
def minus = collection - files('src/test3.txt')
union.forEach(){File it ->println it.name
}
对于文件集合我们可以遍历它;也可以把它转换成java 类型;同时还能使用+来添加一个集合,或使用-来删除集合。
3.4.3、文件树
文件树是有层级结构的文件集合,一个文件树它可以代表一个目录结构或一ZIP 压缩包中的内容结构。文件树是从文件集合继承过来的,所以文件树具有文件集合所有的功能。我们可以使用Project.fileTree(java.util.Map)方法来创建文件树对象,还可以使用过虑条件来包含或排除相关文件。示例代码如下:
tree = fileTree('src/main').include('**/*.java')// 第一种方式:使用路径创建文件树对象,同时指定包含的文件
//第二种方式:通过闭包创建文件树:
tree = fileTree('src/main') {include '**/*.java'
}
tree = fileTree(dir: 'src/main', include: '**/*.java') //第三种方式:通过路径和闭包创建文件树:具名参数给map传值
tree = fileTree(dir: 'src/main', includes: ['**/*.java', '**/*.xml', '**/*.txt'], exclude: '**/*test*/**')
tree.each {File file -> // 遍历文件树的所有文件println fileprintln file.name
}
3.4.4、文件拷贝
我们可以使用Copy 任务来拷贝文件,通过它可以过虑指定拷贝内容,还能对文件进行重命名操作等。Copy 任务必须指定一组需要拷贝的文件和拷贝到的目录,这里使用CopySpec.from(java.lang.Object[])方法指定原文件;使用CopySpec.into(java.lang.Object)方法指定目标目录。示例代码如下
task copyTask(type: Copy) {from 'src/main/resources'into 'build/config'
}
from()方法接受的参数和文件集合时files()一样。当参数为一个目录时,该目录下所有的文件都会被拷贝到指定目录下(目录自身不会被拷贝);当参数为一个文件时,该文件会被拷贝到指定目录;如果参数指定的文件不存在,就会被忽略;当参数为一个Zip 压缩文件,该压缩文件的内容会被拷贝到指定目录。into()方法接受的参数与本地文件时file()一样。示例代码如下
task copyTask(type: Copy) {// 拷贝src/main/webapp目录下所有的文件from 'src/main/webapp'// 拷贝单独的一个文件from 'src/staging/index.html'// 从Zip压缩文件中拷贝内容from zipTree('src/main/assets.zip')// 拷贝到的目标目录into 'build/explodedWar'
}
在拷贝文件的时候还可以添加过虑条件来指定包含或排除的文件,示例如下:
task copyTaskWithPatterns(type: Copy) {from 'src/main/webapp'into 'build/explodedWar'include '**/*.html'include '**/*.jsp'exclude { details -> details.file.name.endsWith('.html') }
}
在拷贝文件的时候还可以对文件进行重命名操作,示例如下:
task rename(type: Copy) {from 'src/main/webapp'into 'build/explodedWar'// 使用一个闭包方式重命名文件rename { String fileName ->fileName.replace('-staging-', '')}
}
在上面的例子中我们都是使用Copy 任务来完成拷贝功能的,那么有没有另外一种方式呢?答案是肯定的,那就是Project.copy(org.gradle.api.Action)方法。下面示例展示了copy()方法的使用方式:
task copyMethod {doLast {copy {from 'src/main/webapp'into 'build/explodedWar'include '**/*.html'include '**/*.jsp'}}
}
或者使用project 对象的copy 方法:
copy {//相对路径或者绝对路径from file('src/main/resources/ddd.txt') //file也可以换成new File()into this.buildDir.absolutePath
}
执行gradle build 指令即可。去build 目录的本地磁盘查看,就能看到。
3.4.5、归档文件
通常一个项目会有很多的Jar 包,我们希望把项目打包成一个WAR,ZIP 或TAR 包进行发布,这时我们就可以使用Zip,Tar,Jar,War 和Ear 任务来实现,不过它们的用法都一样,所以在这里我只介绍Zip 任务的示例。首先,创建一个Zip 压缩文件,并指定压缩文件名称,如下代码所示:
apply plugin: 'java'
version=1.0
task myZip(type: Zip) {from 'src/main‘into ‘build’ //保存到build目录中baseName = 'myGame'
}
println myZip.archiveName
执行命令gradle -q myZip,输出结果为:
> gradle -q myZip
myGame-1.0.zip
最后,我们可以使Project.zipTree(java.lang.Object)Project.tarTree(java.lang.Object)方法来创建访问Zip 压缩包的文件树对象,示例代码如下:
// 使用zipTree
FileTree zip = zipTree('someFile.zip')
// 使用tarTree
FileTree tar = tarTree('someFile.tar')
在这里,我们介绍了Gradle 对本地文件、文件集合、文件树、文件拷贝和归档文件的操作方式。更详细的请参考官方文档:https://docs.gradle.org/current/userguide/working_with_files.html
3.5、Dependencies
3.5.1、依赖的方式
Gradle 中的依赖分别为直接依赖,项目依赖,本地jar 依赖。
案例如下:
dependencies {//①.依赖当前项目下的某个模块[子工程]implementation project(':subject01')//②.直接依赖本地的某个jar文件implementation files('libs/foo.jar', 'libs/bar.jar')//②.配置某文件夹作为依赖项implementation fileTree(dir: 'libs', include: ['*.jar'])//③.直接依赖implementation 'org.apache.logging.log4j:log4j:2.17.2'
}
直接依赖:在项目中直接导入的依赖,就是直接依赖上
implementation 'org.apache.logging.log4j:log4j:2.17.2'
上面是简写法,完整版写法如下:
implementation group: 'org.apache.logging.log4j', name: 'log4j', version: '2.17.2'
group/name/version 共同定位一个远程仓库,version 最好写一个固定的版本号,以防构建出问题,implementation 类似maven 中的依赖的scope,对比maven 中的依赖:
<dependencies><dependency><groupId>log4j</groupId><artifactId>log4j</artifactId><version>1.2.12</version><scope>compile</scope></dependency>
</dependencies>
log4j log4j 1.2.12 compile
implementation project(':subject01')
这种依赖方式是直接依赖本工程中的libary module,这个libary module 需要在setting.gradle 中配置。
本地jar 依赖:本地jar 文件依赖,一般包含以下两种方式
//直接依赖某文件
implementation files('libs/foo.jar', 'libs/bar.jar')
//配置某文件夹作为依赖项
implementation fileTree(dir: 'libs', include: ['*.jar'])
3.5.2、依赖的下载
当执行build 命令时,gradle 就会去配置的依赖仓库中下载对应的Jar,并应用到项目中。
3.5.3、依赖的类型
类似于Maven 的scope 标签,gradle 也提供了依赖的类型,具体如下所示:
官方文档参考:
https://docs.gradle.org/current/userguide/java_library_plugin.html#java_library_plugin: 各个依赖范围的关系和说明
https://docs.gradle.org/current/userguide/upgrading_version_6.html#sec:configuration_removal : 依赖范围升级和移除
https://docs.gradle.org/current/userguide/java_library_plugin.html#java_library_plugin:API 和implemention 区别
https://docs.gradle.org/current/userguide/java_plugin.html#java_plugin: 执行java 命令时都使用了哪些依赖范围的依赖。
提示1:java 插件提供的功能,java-library 插件都提供。
3.5.4、api 与implementation 区别
如下所示:
**编译时:**如果libC 的内容发生变化,由于使用的是api 依赖,依赖会传递,所以libC、libA、projectX 都要发生变化,都需要重新编译,速度慢,
**运行时:**libC、libA、projectX 中的class 都要被加载。
**编译时:**如果libD 的内容发生变化,由于使用的是implemetation 依赖,依赖不会传递,只有libD、libB 要变化并重新编译,速度快,运行时:libC、libA、projectX 中的class 都要被加载。
拓展3:api 和implementation 案例分析
api 的适用场景是多module 依赖,moduleA 工程依赖了module B,同时module B 又需要依赖了module C,modelA 工程也需要去依赖module C,这个时候避免重复依赖module,可以使用module B api 依赖的方式去依赖module C,modelA 工程只需要依赖moduleB 即可。
总之,除非涉及到多模块依赖,为了避免重复依赖,咱们会使用api,其它情况我们优先选择implementation,拥有大量的api 依赖项会显著增加构建时间。
3.5.5、依赖冲突及解决方案
依赖冲突是指"在编译过程中, 如果存在某个依赖的多个版本, 构建系统应该选择哪个进行构建的问题",如下所示:
A、B、C 都是本地子项目module,log4j 是远程依赖。
编译时: B 用1.4.2 版本的log4j,C 用2.2.4 版本的log4j,B 和C 之间没有冲突
打包时: 只能有一个版本的代码最终打包进最终的A对应的jar |war包,对于Gradle 来说这里就有冲突了
案例演示:我们在build.gradle 引入依赖库
dependencies {testImplementation 'org.junit.jupiter:junit-jupiter-api:5.8.1'testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.8.1'implementation 'org.hibernate:hibernate-core:3.6.3.Final'
}
修改build.gradle
dependencies {testImplementation 'org.junit.jupiter:junit-jupiter-api:5.8.1'testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.8.1'implementation 'org.hibernate:hibernate-core:3.6.3.Final'implementation 'org.slf4j:slf4j-api:1.4.0'
}
如上所示:默认下,Gradle 会使用最新版本的jar 包【考虑到新版本的jar 包一般都是向下兼容的】,实际开发中,还是建议使用官方自带的这种解决方案。当然除此之外,Gradle 也为我们提供了一系列的解决依赖冲突的方法: exclude移除一个依赖,不允许依赖传递,强制使用某个版本。
Exclude 排除某个依赖
dependencies {testImplementation 'org.junit.jupiter:junit-jupiter-api:5.8.1'testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.8.1'implementation('org.hibernate:hibernate-core:3.6.3.Final'){//排除某一个库(slf4j)依赖:如下三种写法都行exclude group: 'org.slf4j'exclude module: 'slf4j-api'exclude group: 'org.slf4j',module: 'slf4j-api'}//排除之后,使用手动的引入即可。implementation 'org.slf4j:slf4j-api:1.4.0'
}
不允许依赖传递
dependencies {testImplementation 'org.junit.jupiter:junit-jupiter-api:5.8.1'testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.8.1'implementation('org.hibernate:hibernate-core:3.6.3.Final'){//不允许依赖传递,一般不用transitive(false)}//排除之后,使用手动的引入即可implementation 'org.slf4j:slf4j-api:1.4.0'
}
在添加依赖项时,如果设置transitive 为false,表示关闭依赖传递。即内部的所有依赖将不会添加到编译和运行时的类路径。
强制使用某个版本
dependencies {testImplementation 'org.junit.jupiter:junit-jupiter-api:5.8.1'testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.8.1'implementation('org.hibernate:hibernate-core:3.6.3.Final')//强制使用某个版本!!【官方建议使用这种方式】implementation('org.slf4j:slf4j-api:1.4.0!!')//这种效果和上面那种一样,强制指定某个版本implementation('org.slf4j:slf4j-api:1.4.0'){version{strictly("1.4.0")}}
}
拓展:我们可以先查看当前项目中到底有哪些依赖冲突:
//下面我们配置,当Gradle 构建遇到依赖冲突时,就立即构建失败
configurations.all() {Configuration configuration ->//当遇到版本冲突时直接构建失败configuration.resolutionStrategy.failOnVersionConflict()
}
3.6、Gradle 插件
3.6.1、使用插件的原因
简单的说,通过应用插件我们可以:
.促进代码重用、减少功能类似代码编写、提升工作效率
2.促进项目更高程度的模块化、自动化、便捷化
3.可插拔式的的扩展项目的功能
3.6.2、插件的作用
在项目构建过程中做很多事情,把插件应用到项目中,通常可以完成:
- 可以添加任务【task】到项目中,从而帮助完成测试、编译、打包等。
- 可以添加依赖配置到项目中。
- 可以向项目中拓展新的扩展属性、方法等。
- 可以对项目进行一些约定,如应用Java 插件后,约定src/main/java 目录是我们的源代码存在位置,编译时编译这个
目录下的Java 源代码文件。
3.6.3、插件的分类和使用
第一种:脚本插件
脚本插件的本质就是一个脚本文件,使用脚本插件时通过apply from:将脚本加载进来就可以了,后面的脚本文件可以是本地的也可以是网络上的脚本文件,下面定义一段脚本,我们在build.gradle 文件中使用它,具体如下:
//version.gradle文件
ext {company= "尚硅谷"cfgs = [compileSdkVersion : JavaVersion.VERSION_1_8]spring = [version : '5.0.0']
}
下面将将在构建文件中使用这个脚本文件,具体如下:
//build.gradle文件
//map作为参数
apply from: 'version.gradle'
task taskVersion{doLast{println "公司名称为:${company},JDK版本是${cfgs.compileSdkVersion},版本号是${spring.version}"}
}
上述代码的执行结果如下:
PS D:\repos\idearepos\root> gradle -q taskVersion
版本是2.0,版本号是1
意义:脚本文件模块化的基础,可按功能把我们的脚本进行拆分一个个公用、职责分明的文件,然后在主脚本文件引用,
比如:将很多共有的库版本号一起管理、应用构建版本一起管理等。
第二种:对象插件之内部插件[核心插件]
二进制插件[对象插件]就是实现了org.gradle.api.Plugin 接口的插件,每个Java Gradle 插件都有一个plugin id。
可通过如下方式使用一个Java 插件:
apply plugin : 'java' //map具名参数方式
或者:
//也可以使用闭包作为project.apply方法的一个参数
apply{plugin 'java'
}
通过上述代码就将Java 插件应用到我们的项目中了,对于Gradle 自带的核心插件都有唯一的plugin id,其中java 是Java 插件的plugin id,这个plugin id 必须是唯一的,可使用应用包名来保证plugin id 的唯一性。这里的java 对应的具体类型是org.gradle.api.plugins.JavaPlugin,所以可以使用如下方式使用Java 插件:
//使用方式1:Map具名参数,全类名
apply plugin:org.gradle.api.plugins.JavaPlugin
//org.gradle.api.plugins默认导入:使用方式2
apply plugin:JavaPlugin
apply plugin: 'java' //核心插件,无需事先引入,使用方式3:插件的id
Gradle 中提供的二进制插件【核心插件】,可参考: https://docs.gradle.org/current/userguide/plugin_reference.html
第二种:对象插件之第三方插件
如果是使用第三方发布的二进制插件,一般需要配置对应的仓库和类路径,
//使用传统的应用方式
buildscript {ext {springBootVersion = "2.3.3.RELEASE"}repositories {mavenLocal()maven { url 'http://maven.aliyun.com/nexus/content/groups/public' }jcenter()}// 此处先引入插件dependencies {classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")}
}
//再应用插件
apply plugin: 'org.springframework.boot' //社区插件,需要事先引入,不必写版本号
但是如果是第三方插件已经被托管在https://plugins.gradle.org/ 网站上,就可以不用在buildscript 里配置classpath依赖了,直接使用新出的plugins DSL 的方式引用,案例如下:
使用plugins DSL 方式
plugins {id 'org.springframework.boot' version '2.4.1'
}
注意:
- 如果使用老式插件方式buildscript{}要放在build.gradle 文件的最前面,而新式plugins{}没有该限制。
- 托管在网站gradle 插件官网的第三方插件有两种使用方式,一是传统的buildscript 方式,一种是plugins DSL 方式。
第二种:对象插件之用户自定义插件
interface GreetingPluginExtension {Property<String> getMessage()Property<String> getGreeter()
}class GreetingPlugin implements Plugin<Project> {void apply(Project project) {def extension = project.extensions.create('greeting', GreetingPluginExtension)project.task('hello') {doLast {println "${extension.message.get()} from ${extension.greeter.get()}"}}}
}apply plugin: GreetingPlugin
// Configure the extension using a DSL block
greeting {message = 'Hi'greeter = 'Gradle'
}
参考地址:https://docs.gradle.org/current/userguide/custom_plugins.html
我们直接执行hello 任务./gradle hello 即可,这种方式实现的插件我们一般不使用,因为这种方式局限性太强,只能本Project,而其他的Project 不能使用。
3.6.4、buildSrc 项目
buildSrc 是Gradle 默认的插件目录,编译Gradle 的时候会自动识别这个目录,将其中的代码编译为插件。
-
首先先建立一个名为buildSrc 的java Module,将buildSrc 从included modules
移除,重新构建,然后只保留build.gradle和src/main目录,其他全部删掉,注意名字一定是buildSrc,不然会找不到插件。 -
然后修改Gradle 中的内容
apply plugin: 'groovy' //必须
apply plugin: 'maven-publish'
dependencies {implementation gradleApi() //必须implementation localGroovy() //必须
}
repositories {google()jcenter()mavenCentral() //必须
}
//把项目入口设置为src/main/groovy
sourceSets {main {groovy {srcDir 'src/main/groovy'}}
}
3.创建入口目录,在src/main 下创建代码入口目录,如下:
4.然后实现插件代码Text.groovy,注意文件后缀为groovy,文件要引入package com.atguigu
package com.atguigu
import org.gradle.api.Plugin
import org.gradle.api.Project
class Text implements Plugin<Project>{@Overridevoid apply(Project project) {project.task("atguigu"){doLast{println("自定义atguigu插件")}}}
}
5.接下来在main 目录下创建resources 目录,在resources 目录下创建META-INF 目录,在META-INF 目录下创建gradle-plugins 目录,在gradle-plugins 目录下创建properties 文件
6.properties 文件可以自己命名,但是要以.properties 结尾,比如com.atguigu.plugin.properties,其com.atguigu.plugin 就是定义的包名路径.
7.最后需要在properties 文件中指明我们实现插件的全类名implementation-class=com.atguigu.Text
到目前为止我们的插件项目已经写完了,在module 引入我们写的插件apply plugin:‘com.atguigu.plugin’,然后执行插件的
Task,./gradle atguigu
输出:
这种形式的写法,在我们整个工程的module 都可以使用,但也只是限制在本工程,其他工程不能使用。
改进:
第二种写插件的方式他只能在本工程中使用,而其他的项目工程不能使用,有时候我们需要一个插件在多个工程中使用,
这时候我们就需要把插件上传maven 中。
第一步: 首先将上述buildSrc 目录复制一份,修改文件夹名,然后在settings.gradle 文件中使用include 引入
第二步:修改build.gradle 文件,发布到maven 仓库中
apply plugin: 'groovy' //必须
apply plugin: 'maven-publish'
dependencies {implementation gradleApi() //必须implementation localGroovy() //必须
}
repositories {google()jcenter()mavenCentral() //必须
}
sourceSets { //把项目入口设置为src/main/groovymain {groovy {srcDir 'src/main/groovy'}}
}
publishing {publications {myLibrary(MavenPublication) {groupId = 'com.atguigu.plugin' //指定GAV坐标信息artifactId = 'library'version = '1.1'from components.java//发布jar包//from components.web///引入war插件,发布war包}}
repositories {maven { url "$rootDir/lib/release" }//发布项目到私服中// maven {// name = 'myRepo' //name属性可选,表示仓库名称,url必填// //发布地址:可以是本地仓库或者maven私服// //url = layout.buildDirectory.dir("repo")// //url='http://my.org/repo'// // change URLs to point to your repos, e.g. http://my.org/repo// //认证信息:用户名和密码// credentials {// username = 'joe'// password = 'secret'// }// }}
}
第三步:执行publish 指令,发布到根project 或者maven 私服仓库。
第四步:使用插件,在项目级build.gradle 文件中将插件添加到classpath:
buildscript {repositories {maven { url "$rootDir/lib/release" }}dependencies {classpath "com.atguigu.plugin:library:1.1"}
}apply plugin: 'java'
//是在atguiguplugin 中定义的插件ID
apply plugin: 'com.atguigu.plugin'
第五步:执行gradle build 指令就会在控制台看到自定义插件的输出,说明自定义插件就已经生效了。
最后,至于如何写一个插件,能帮助项目更加自动化或者便捷化,是值得大家未来需要长期思考、关注、努力的点。
3.6.5、插件的关注点
第一点: 插件的引用
apply plugin: ‘插件名’
第二点:主要的功能[任务]
当我们在工程中引入插件后,插件会自动的为我们的工程添加一些额外的任务来完成相应的功能。以Java 插件为例,当
我们加入java 插件之后,就加入了如下功能:
具体大家可通过gradle tasks 查看加入某个插件前后的区别。
说明:Gradle 中的任务依赖关系是很重要的,它们之间的依赖关系就形成了构建的基本流程。
第三点:工程目录结构
一些插件对工程目结构有约定,所以我们一般遵循它的约定结构来创建工程,这也是Gradle 的“约定优于配置”原则。
例如java 插件规定的项目源集目录结构如下所示:
如果要使用某个插件就应该按照它约定的目录结构设置,这样能大大提高我们的效率,当然各目录结构也可以自己定义。
第四点:依赖管理
比如前面我们提到的依赖的类型[依赖管理]部分,不同的插件提供了不同的依赖管理。
第五点:常用的属性
例如:Java 插件会为工程添加一些常用的属性,我们可以直接在编译脚本中直接使用。
当然,这里还有一些其它属性
3.6.6、Java 插件分析
参考官网:https://docs.gradle.org/current/userguide/plugin_reference.html,以Java 插件为例,讲解需要关注的几点:
第一点:我们要关注插件使用
plugins {id 'java'
}
第二点:我们要关注插件的功能
我们可通过官方文档介绍了解某个插件功能或者百度、再或者大家可以通过gradle tasks 查看加入java 插件前后的区别。
第三点:项目布局
一般加入一个插件之后,插件也会提供相应的目录结构,例如:java 插件的目录结构
当然这个默认的目录结构也是可以改动的例如:
sourceSets {main {java {srcDirs = ['src/java']}resources {srcDirs = ['src/resources']}}
}
也可设置源集的属性等信息。
第四点:依赖管理:以java 插件为例,提供了很多依赖管理项
源集依赖关系配置
第五点:额外的属性和方法:
可参考官方文档: sourceCompatibility(JavaVersion.VERSION_1_8)
3.7、build.gradle 文件
- build.gradle 是一个gradle 的构建脚本文件,支持java、groovy 等语言。
- 每个project 都会有一个build.gradle 文件,该文件是项目构建的入口,可配置版本、插件、依赖库等信息。
- 每个build 文件都有一个对应的Project 实例,对build.gradle 文件配置,本质就是设置Project 实例的属性和方法。
- 由于每个project 都会有一个build 文件,那么Root Project 也不列外.Root Project 可以获取到所有Child Project,所以在Root Project 的build 文件中我们可以对Child Project 统一配置,比如应用的插件、依赖的maven 中心仓库等。
- build 文件中常见的属性和方法如下所示:
3.7.1、常见属性代码
代码参考:
//指定使用什么版本的JDK语法编译源代码,跟编译环境有关,在有java插件时才能用
sourceCompatibility = 1.8
//指定生成特定于某个JDK版本的class文件:跟运行环境有关,在有java插件时才能用
targetCompatibility = 1.8
//业务编码字符集,注意这是指定源码解码的字符集[编译器]
compileJava.options.encoding "UTF-8"
//测试编码字符集,注意这是指定源码解码的字符集[编译器]
compileTestJava.options.encoding "UTF-8"
//编译JAVA文件时采用UTF-8:注意这是指定源码编码的字符集【源文件】
tasks.withType(JavaCompile) {options.encoding = "UTF-8"
}
//编译JAVA文件时采用UTF-8:注意这是指定文档编码的字符集【源文件】
tasks.withType(Javadoc) {options.encoding = "UTF-8"
}
提示1:group+name+version 类似于maven 的group+artifactId+version
提示2:encoding 解决业务代码与测试代码中文乱码问题
3.7.2、Repositories
repositories {//gradle中会按着仓库配置的顺序,从上往下依次去对应的仓库中找所需要的jar包://如果找到,则停止向下搜索,如果找不到,继续在下面的仓库中查找//指定去本地某个磁盘目录中查找:使用本地file文件协议:一般不用这种方式maven { url 'file:///D:/repos/mavenrepos3.5.4'}maven { url "$rootDir/lib/release" }//指定去maven的本地仓库查找mavenLocal()//指定去maven的私服或者第三方镜像仓库查找maven { name "Alibaba" ; url "https://maven.aliyun.com/repository/public" }maven { name "Bstek" ; url "https://nexus.bsdn.org/content/groups/public/" }//指定去maven的远程仓库查找:即https://repo.maven.apache.org/maven2/mavenCentral()//去google仓库查找google()
}
因为Gradle 没有自己的远程仓库,而是使用Maven、jcenter、jvy、google 这些远程仓库。
3.7.3、Subprojects 与Allprojects
allprojects 是对所有project(包括Root Project+ child Project[当前工程和所有子工程])的进行统一配置,而subprojects是对所有Child Project 的进行统一配置。
测试如下:
allprojects {tasks.create('hello') {doLast {task ->println "project name is $task.project.name"}}
}
subprojects {hello.doLast{task->println "here is subprojects $task.project.name"}
}
通常在subprojects 和allprojects 中:
allprojects(){ //本质Project中的allprojects方法,传递一个闭包作为参数。apply plugin: 'java'ext {junitVersion = '4.10'..}task allTask{...}repositories {...}dependencies {...}
}
subprojects(){…//同上面allprojects中的方法。
}
拓展1: 如果是直接在根project 配置repositories 和dependencies 则只针对根工程有效。
拓展:我们也可以在对单个Project 进行单独配置:
project('subject01') {task subject01 {doLast {println 'for subject01'}}
}
执行gradle build 指令即可查看测试效果。
3.7.4、ext 用户自定义属性
Project 和Task 都允许用户添加额外的自定义属性,要添加额外的属性,通过应用所属对象的ext 属性即可实现。添加之后可以通过ext 属性对自定义属性读取和设置,如果要同时添加多个自定义属性,可以通过ext 代码块:
//自定义一个Project的属性
ext.age = 18
//通过代码块同时自定义多个属性
ext {phone = 19292883833address="北京尚硅谷"
}
task extCustomProperty {//在task中自定义属性ext {desc = "奥利给"}doLast {println "年龄是:${age}"println "电话是:${phone}"println "地址是:${address}"println "尚硅谷:${desc}"}
}
测试:通过gradle extCustomProperty
输出结果为:
年龄是:18
电话是:19292883833
地址是:北京尚硅谷
尚硅谷:奥利给
拓展1: ext 配置的是用户自定义属性,而gradle.properties 中一般定义系统属性、环境变量、项目属性、JVM 相关配置信息。例如
gradle.properties 文件案例:加快构建速度的,gradle.properties 文件中的属性会自动在项目运行时加载。
## 设置此参数主要是编译下载包会占用大量的内存,可能会内存溢出
org.gradle.jvmargs=-Xms4096m -Xmx8192m
## 开启gradle缓存
org.gradle.caching=true
#开启并行编译
org.gradle.parallel=true
#启用新的孵化模式
org.gradle.configureondemand=true
#开启守护进程
org.gradle.daemon=true
详细请参考:https://docs.gradle.org/current/userguide/build_environment.html#sec:gradle_configuration_properties
3.7.5、Buildscript
buildscript 里是gradle 脚本执行所需依赖,分别是对应的maven 库和插件。
案例如下:
import org.apache.commons.codec.binary.Base64
buildscript {repositories {mavenCentral()}dependencies {classpath group: 'commons-codec', name: 'commons-codec', version: '1.2'}
}
tasks.register('encode') {doLast {def byte[] encodedString = new Base64().encode('hello world\n'.getBytes())println new String(encodedString)}
}
需要注意的是:
- buildscript{}必须在build.gradle 文件的最前端。
- 对于多项目构建,项目的buildscript ()方法声明的依赖关系可用于其所有子项目的构建脚本。
- 构建脚本依
案例如下所示:
//老式apply插件的引用方式,使用apply+buildscript
buildscript {ext {springBootVersion = "2.3.3.RELEASE"}repositories {mavenLocal()maven { url 'http://maven.aliyun.com/nexus/content/groups/public' }jcenter()}//此处引入插件dependencies {classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")}
}
apply plugin: 'java' //核心插件,无需事先引入
apply plugin: 'org.springframework.boot' //社区插件,需要事先引入,才能应用,不必写版本号
3.8、publishing 项目发布
接下来,将咱们写好的模块发布发布到公司的私服以供别人使用,如下所示:
3.8.1、引入maven 发布的插件
plugins {id 'java-library' //如果发布war包,需要war插件,java-library支持带源码、文档发布id 'maven-publish'
}
3.8.2、设置发布代码
//带源码和javadoc的发布:需要'java-library'插件支持:它是java的升级版,java插件的功能java-library都有
//javadoc.options.encoding="UTF-8"
//java {
// withJavadocJar()
// withSourcesJar()
//}
publishing {publications {myLibrary(MavenPublication) {groupId = 'org.gradle.sample' //指定GAV坐标信息artifactId = 'library'version = '1.1'from components.java//发布jar包//from components.web///引入war插件,发布war包}}repositories {//本地仓库位于USER_HOME/.m2/repositorymavenLocal()//发布项目到私服中maven {name = 'myRepo' //name属性可选,表示仓库名称,url必填//发布地址:可以是本地仓库或者maven私服//url = layout.buildDirectory.dir("repo")// change URLs to point to your repos, e.g. http://my.org/repodef releasesRepoUrl = layout.buildDirectory.dir('repos/releases')def snapshotsRepoUrl = layout.buildDirectory.dir('repos/snapshots')url = version.endsWith('SNAPSHOT') ? snapshotsRepoUrl : releasesRepoUrl//认证信息:用户名和密码// credentials {// username = 'joe'// password = 'secret'// }}}
}
3.8.3、执行发布指令
执行发布命令,将项目发布到本地仓库或者远程仓库。常见的发布指令有:
generatePomFileForPubNamePublication: 生成pom 文件
publishPubNamePublicationToRepoNameRepository:发布项目到指定仓库,如果没有仓库名,默认为maven
publishPubNamePublicationToMavenLocal: 将PubName 发布复制到本地Maven 仓库中包括POM 文件和其他元数据。
publish: 发布到repositories 中指定的仓库(为比如Maven 私服)
publishToMavenLocal: 执行所有发布任务中的操作发布到本地maven 仓库【默认在用户家目录下的.m2/repository】。
3.9、生命周期中Hook
Gradle 在生命周期各个阶段都提供了用于回调的钩子函数:
Gradle 初始化阶段:
- 在settings.gradle 执行完后,会回调Gradle 对象的settingsEvaluated 方法
- 在构建所有工程build.gradle 对应的Project 对象后,也既初始化阶段完毕,会回调Gradle对象的projectsLoaded 方法
Gradle 配置阶段:
-
Gradle 会循环执行每个工程的build.gradle 脚本文件
-
在执行当前工程build.gradle 前,会回调Gradle 对象的beforeProject 方法和当前Project对象的beforeEvaluate 方法,虽然beforeEvalute 属于project 的生命周期, 但是此时build script 尚未被加载, 所以beforeEvaluate 的设置依然要在init script 或setting script 中进行,不要在build script 中使用project.beforeEvaluate 方法。
-
在执行当前工程build.gradle 后,会回调Gradle 对象的afterProject 方法和当前Project
对象的afterEvaluate 方法 -
在所有工程的build.gradle 执行完毕后,会回调Gradle 对象的projectsEvaluated 方法
-
在构建Task 依赖有向无环图后,也就是配置阶段完毕,会回调TaskExecutionGraph 对象的whenReady 方法
Gradle 执行阶段:
-
Gradle 会循环执行Task 及其依赖的Task
-
在当前Task 执行之前,会回调TaskExecutionGraph 对象的beforeTask 方法
-
在当前Task 执行之后,会回调TaskExecutionGraph 对象的afterTask 方法
当所有的Task 执行完毕后,会回调Gradle 对象的buildFinish 方法。
提示:Gradle 执行脚本文件的时候会生成对应的实例,主要有如下几种对象:
1、Gradle 对象:在项目初始化时构建,全局单例存在,只有这一个对象
2、Project 对象:每一个build.gradle文件都会转换成一个Project 对象,类似于maven中的pom.xml文件
3、Settings 对象:settings.gradle 会转变成一个settings 对象,和整个项目是一对一的关系,一般只用到include方法
4.、Task对象: 从前面的有向无环图中,我们也可以看出,gradle最终是基于Task的,一个项目可以有一个或者多个Task
钩子函数代码演示:项目目录结构如下:
在root project 的settings.gradle 文件中添加:
gradle.settingsEvaluated { //1.settingsEvaluated钩子函数,在初始化阶段完成println "settingsEvaluated"
}
gradle.projectsLoaded { //2.projectsLoaded钩子函数,在初始化阶段完成println "projectsLoaded"
}
//声明一个变量:表示当前项目名,在每次执行某个项目的beforeEvaluate方法时先给projectName变量赋值
//这样方便在:gradle.beforeProject和afterProject两个钩子函数使用。
def projectName=""
gradle.addProjectEvaluationListener( new ProjectEvaluationListener(){//3.执行各个project的beforeEvaluate:在配置阶段完成@Overridevoid beforeEvaluate(Project project) {projectName=project.nameprintln "${project.name} Project beforeEvaluate"}//5.执行各个project的afterEvaluate:在配置阶段完成@Overridevoid afterEvaluate(Project project, ProjectState projectState) {println "${project.name} Project afterEvaluate"}
});gradle.beforeProject {//4.执行各个project的beforeProject:在配置阶段完成
println "${projectName} beforeProject..."
}
gradle.afterProject {//6.执行各个project的afterProject:在配置阶段完成
println "${projectName} afterProject..."
}
//7.所有工程的build.gradle 执行完毕后,回调Gradle 对象的projectsEvaluated 方法:在配置阶段完成
def rootProjectName=rootProject.getName()
gradle.projectsEvaluated {println "${rootProjectName} projectsEvaluated..."
}
//8.配置阶段完毕后,回调TaskExecutionGraph 对象的whenReady 方法:在配置阶段完成
gradle.taskGraph.whenReady {println "${rootProjectName} taskGraph whenReady..."
}
//9.在当前Task执行之前,会回调TaskExecutionGraph 对象的beforeTask方法:在执行阶段完成
gradle.taskGraph.beforeTask {task ->println "this is the task ${task.name} of the project ${task.getProject().name} beforeTask.."
}
//10.在当前Task执行之后,会回调TaskExecutionGraph 对象的afterTask方法:在执行阶段完成
gradle.taskGraph.afterTask {task ->println "this is the task ${task.name} of the project ${task.getProject().name} afterTask.."
}
//11.当所有的Task 执行完毕后,会回调Gradle 对象的buildFinish 方法:在执行阶段完成
gradle.buildFinished {println "${rootProjectName} buildFinished..."
}
在root 的build.gradle 文件中添加:
task A {println "root taskA"doFirst(){println "root taskA doFirst"}doLast(){println "root taskA doLast"}
}
在subject01 的build.gradle 文件中添加:
task B {println "SubProject01 taskB"doFirst(){println "SubProject01 taskB doFirst"}doLast(){println "SubProject01 taskB doLast"}
}
在subject02 的build.gradle 文件中添加:
//task C在上面
task C{//依赖task DdependsOn 'D'println "SubProject02 taskC"doFirst(){println "SubProject02 taskC doFirst"}doLast(){println "SubProject02 taskC doLast"}
}
//task D在下面
task D {println "SubProject02 taskD"doFirst(){println "SubProject02 taskD doFirst"}doLast(){println "SubProject02 taskD doLast"}
}
测试:在root 工程的根目录执行:gradle C .就能看到gradle 生命周期的三个阶段,及每个阶段执行的钩子函数、还有在执行阶段有依赖关系的任务的执行顺序问题。
拓展1:在settings.gradle 中添加监听器,查看task 有向无环图:
gradle.taskGraph.addTaskExecutionGraphListener(new TaskExecutionGraphListener(){@Override //生成有向无环图void graphPopulated(TaskExecutionGraph taskExecutionGraph) {taskExecutionGraph.allTasks.forEach(releaseTask->{//核心逻辑:通过taskExecutionGraph获得所有的taskprintln "尚硅谷:" + releaseTask.getProject().name + ":" + releaseTask.name})}
})
测试:在root 工程根目录下执行:gradle C。查看测试结果:
拓展2: 计算Gradle 构建过程中各个阶段的耗时:需要注意,这里只是计算了初始化阶段的settings 文件,并没有计算init.gradle 初始化的时间。
def projectName=rootProject.getName() //定义项目名
long beginOfSetting = System.currentTimeMillis() //初始化阶段开始时间
def beginOfConfig //配置阶段开始时间
def configHasBegin = false //配置阶段是否开始了,只执行一次
def beginOfProjectConfig = new HashMap() //存放每个build.gradle 执行之前的时间
def beginOfTaskExecute //执行阶段开始时间
gradle.projectsLoaded { //初始化阶段执行完毕println "${projectName}工程初始化总耗时${System.currentTimeMillis() - beginOfSetting} ms"
}
//build.gradle 执行前
gradle.beforeProject {Project project ->if(!configHasBegin){configHasBegin = truebeginOfConfig = System.currentTimeMillis()}beginOfProjectConfig.put(project,System.currentTimeMillis())
}
//build.gradle 执行后
gradle.afterProject {Project project ->def begin = beginOfProjectConfig.get(project)if(project.name == projectName) {println "根工程${projectName} 配置阶段耗时:${System.currentTimeMillis() - begin} ms"}else{println "子工程${project.name} 配置阶段耗时:${System.currentTimeMillis() - begin} ms"}
}
gradle.taskGraph.whenReady {//配置阶段完毕println "整个${projectName}项目在配置阶段总耗时:${System.currentTimeMillis() - beginOfConfig} ms"beginOfTaskExecute = System.currentTimeMillis()
}
//build.gradle 执行后
gradle.afterProject {Project project ->def begin = beginOfProjectConfig.get(project)if(project.name == projectName) {println "根工程${projectName} 配置阶段耗时:${System.currentTimeMillis() - begin} ms"}else{println "子工程${project.name} 配置阶段耗时:${System.currentTimeMillis() - begin} ms"}
}
gradle.taskGraph.whenReady {//配置阶段完毕println "整个${projectName}项目在配置阶段总耗时:${System.currentTimeMillis() - beginOfConfig} ms"beginOfTaskExecute = System.currentTimeMillis()
}
3.10、创建Springboot 项目
Spring Boot Gradle 插件在Gradle 提供Spring Boot 支持。它允许您打包可执行jar 或war 归档文件,运行Spring
Boot 应用程序,并使用Spring-Boot-dependencies 提供的依赖管理。相关文档请参考:
https://docs.spring.io/spring-boot/gradle-plugin/running.html#running-your-application
3.10.1、引入springboot 插件
该插件发布在Gradle 的插件门户网站上,可以使用插件块来应用:
plugins {id 'org.springframework.boot' version '2.3.7.RELEASE' //维护springboot版本号,不单独使用,和下面两个插件一起用id 'io.spring.dependency-management' version '1.0.10.RELEASE'//进行依赖管理,在引入其它boot依赖时省略版本号、解决jar包冲突问题id 'java'
}
3.10.2、引入所需要的依赖
dependencies {implementation 'org.springframework.boot:spring-boot-starter'implementation 'org.springframework.boot:spring-boot-starter-web' //省略版本,原生bom支持,插件management提供testImplementation('org.springframework.boot:spring-boot-starter-test') {exclude group: 'org.junit.vintage', module: 'junit-vintage-engine'}
}
test {useJUnitPlatform()
}
3.10.3、执行gradle bootRun 指令
要想运行当前Springboot 项目,直接执行gradle bootRun 指令或者idea 右侧按钮即可。
当然如果想让当前项目打成可执行jar 包,只需执行: gradle bootJar 指令即可。
Cloud 项目创建也可以借助于脚手架创建,与Boot 项目类似。
3.10.4、拓展spring-boot-gradle-plugin 插件
buildscript {repositories {maven { url 'https://maven.aliyun.com/repository/public' }}dependencies {classpath 'org.springframework.boot:spring-boot-gradle-plugin:2.4.1'}
}
apply plugin: 'org.springframework.boot'
apply plugin: 'io.spring.dependency-management'
3.11、基于ssm 多模块项目案例
3.11.1、多项目模块划分
meinian-mobile-web: 美年旅游项目的用户系统
meinian-web: 美年旅游项目的管理员系统
meinian-service: 美年旅游项目的业务逻辑层
meinian-dao : 美年旅游项目的持久化层
meinian-bean : 美年旅游项目的Model 封装
3.11.2、项目搭建前配置分析
3.11.3、代码演示
代码和配置文件同单体ssm 一样。只不过做了拆分。
3.11.4、settings.gradle 文件中
rootProject.name = 'meinian-parent'
include 'meinian-bean'
include 'meinian-dao'
include 'meinian-service'
include 'meinian-web'
include 'meinian-mobile-web'
3.11.5、在根工程build.gradle 文件中抽取子模块的公共配置
group 'com.atguigu'
version '1.0-SNAPSHOT'
subprojects {//添加插件apply plugin: 'java'//基本JDK配置sourceCompatibility = 1.8targetCompatibility = 1.8compileJava.options.encoding "UTF-8"compileTestJava.options.encoding "UTF-8"tasks.withType(JavaCompile) {options.encoding = "UTF-8"}group 'com.atguigu'version '1.0-SNAPSHOT'repositories {mavenLocal()maven {url "https://maven.aliyun.com/repository/public"}maven {url "https://maven.aliyun.com/repository/central"}maven {url "https://maven.aliyun.com/repository/google"}maven {url "https://maven.aliyun.com/repository/spring"}mavenCentral()}//依赖的配置:设置通用的依赖dependencies {testImplementation 'org.junit.jupiter:junit-jupiter-api'testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine'implementation 'log4j:log4j:1.2.17'}test {useJUnitPlatform()}
}
3.11.6、在根工程的build.gradle 文件中配置各个模块的依赖信息
project("meinian-bean"){dependencies {compileOnly 'org.projectlombok:lombok:1.18.24'}
}
project("meinian-dao"){apply plugin: 'java-library'//支持apidependencies {api project(':meinian-bean')implementation 'org.mybatis:mybatis-spring:1.2.3'implementation 'com.alibaba:druid:1.0.15'implementation 'org.mybatis:mybatis:3.3.0'implementation 'mysql:mysql-connector-java:5.1.36'}
}
project("meinian-service"){apply plugin: 'java-library'//支持apidependencies {api project(':meinian-dao')implementation 'org.springframework:spring-web:4.1.7.RELEASE'implementation 'org.springframework:spring-test:4.0.5.RELEASE'implementation 'org.springframework:spring-jdbc:4.1.7.RELEASE'implementation 'org.aspectj:aspectjweaver:1.8.6'}
}project("meinian-web"){apply plugin: 'war'dependencies {implementation project(':meinian-service')implementation 'org.springframework:spring-webmvc:4.1.7.RELEASE'implementation "com.fasterxml.jackson.core:jackson-databind:2.2.3"implementation "com.fasterxml.jackson.core:jackson-annotations:2.2.3"implementation "com.fasterxml.jackson.core:jackson-core:2.2.3"compileOnly 'javax.servlet:servlet-api:2.5'implementation 'jstl:jstl:1.2'}
}
取之后,各子模块的build.gradle 文件就不用配置了。
3.12、微服务实战
3.12.1、创建数据库及表
创建对应的数据库:CREATE DATABASE micro_user
project("meinian-bean"){
dependencies {
compileOnly 'org.projectlombok:lombok:1.18.24'
}
}
project("meinian-dao"){
apply plugin: 'java-library'//支持api
dependencies {
api project(':meinian-bean')
implementation 'org.mybatis:mybatis-spring:1.2.3'
implementation 'com.alibaba:druid:1.0.15'
implementation 'org.mybatis:mybatis:3.3.0'
implementation 'mysql:mysql-connector-java:5.1.36'
}
}
project("meinian-service"){
apply plugin: 'java-library'//支持api
dependencies {
api project(':meinian-dao')
implementation 'org.springframework:spring-web:4.1.7.RELEASE'
implementation 'org.springframework:spring-test:4.0.5.RELEASE'
implementation 'org.springframework:spring-jdbc:4.1.7.RELEASE'
implementation 'org.aspectj:aspectjweaver:1.8.6'
}
}
project("meinian-web"){apply plugin: 'war'dependencies {implementation project(':meinian-service')implementation 'org.springframework:spring-webmvc:4.1.7.RELEASE'implementation "com.fasterxml.jackson.core:jackson-databind:2.2.3"implementation "com.fasterxml.jackson.core:jackson-annotations:2.2.3"implementation "com.fasterxml.jackson.core:jackson-core:2.2.3"compileOnly 'javax.servlet:servlet-api:2.5'implementation 'jstl:jstl:1.2'}
}
抽取之后,各子模块的build.gradle 文件就不用配置了。
3.12、微服务实战
3.12.1、创建数据库及表`
创建对应的数据库:CREATE DATABASE micro_user
CREATE TABLE USER(id INT UNSIGNED PRIMARY KEY AUTO_INCREMENT,username VARCHAR(30) NOT NULL COMMENT '用户名',email VARCHAR(30) NOT NULL COMMENT '邮箱',gender TINYINT DEFAULT 0 COMMENT '性别'
)
创建对应的数据库:CREATE DATABASE micro_order
USE micro_order;
CREATE TABLE `orderinfo` (
`oid` INT(10) UNSIGNED NOT NULL AUTO_INCREMENT,
`uid` INT(11) DEFAULT NULL COMMENT '用户id',
`product_name` VARCHAR(30) NOT NULL COMMENT '省份',
PRIMARY KEY (`oid`)
) ENGINE=INNODB AUTO_INCREMENT=5 DEFAULT CHARSET=utf8
3.12.2、搭建项目架构
microservice-parent: 统一管理所有模块的jar 包版本信息
microservice-bean: 统一管理所有模块的用到的pojo 类
microservice-common:统一管理所有模块的用到的工具类、枚举类、异常处理、日志文件、统一返回结果信息
microservice-service: 统一封装所有的微服务
microservice-gateway: 封装网关信息
3.12.3、具体演示
创建项目结构,记得将gradle 改成本地自己安装的gradle。