Groovy 是一种基于 JVM 的动态语言,他的语法和 Java 相似,最终也是要编译 .class 在JVM上运行。
Groovy 完全兼容 Java 并且在此基础上添加了很多动态类型和灵活的特性,比如支持闭包,支持DSL,是一门非常灵活的动态脚本语言。
这篇文章是为了能看懂在 Gradle脚本中的代码,知道怎么写。所以不会深入Groovy。
每个 build 脚本配置文件都是一个 Groovy脚本文件。在里面可以写任何符合 Groovy 语法的代码。
例如定义类,方法,变量等。又因为Groovy 是完全兼容Java的,故也可以写任何Java代码,是完全兼容的。
DSL(Domain Specific Language) 中文意思是 领域特定语言,专门关注某一领域,在于专而不是全。所以才是领域特定的。
Gradle 的脚本就是基于 Groovy 的DSL,专门解决自动化构建的DSL。
我们只需要按照相应的语法,配置相应的 Gradle 脚本就可以达到自动化构建的目的,这也是 DSL 的初衷。
//这里是注释
def name = "佛系编码"
/* 这里是多行注释
啦啦啦啦 */
/**
* 这里是 doc 注释
* 啦啦啦啦
*/
Java中的基本数据类型,对象它都支持;另外还有
闭包
加强的 List,Map的集合
加强的File,Stream等IO类型
类型可以显式声明,也可以用 def 来声明,用 def 声明的类型Groovy将会进行类型推断。
基本数据类型都是和Java 中的一致,就不拿出来说了。下面说一下,对象,字符串,闭包等;
另外:Groovy 中的分号是可以省略的;
使用单引号和双引号都可以定义一个字符串常量。
差别是 单引号只是单纯的字符串,不能使用表达式,运算,求值,正则等。
task character(){
doLast{
def name = '张三'
def address ="北京市"
def age = 19
println "单引号双引号都是字符串 name is ${name}; age is $age ; address is ${address}"
println '单引号里无法运算表达式例如 name is ${name}'
}
}
执行 character
gradle character
得到结果如下
单引号双引号都是字符串 name is 张三; age is 19 ; address is 北京市
单引号里无法运算表达式例如 name is ${name}
双引号的字符串可以直接进行表达式计算,规则是一个美元符号紧跟一个花括号: ${expression} ,如果只有一个变量可以省略花括号。例如上面的 $age
集合默认是 java.util.ArrayList 类型的
def nums = [1,2,4,5,6]
println "nums is ${nums.getClass().getName()} size = ${nums.size()}"
输出结果为
nums is java.util.ArrayList size = 5
也可以显式指定集合类型 使用 as 关键字;
def nums1 = [0,"23",4,5,62,false] as LinkedList
println "nums1 is ${nums1.getClass().getName()};size = ${nums1.size()}"
输出为
nums1 is java.util.LinkedList;size = 6
或者在前面显式指定类型
LinkedList otherLinked = [3, 4, 5]
元素的访问是通过下标访问的
println "第三个元素是 ${nums1[2]},倒数第一个是 ${nums1[-1]};第一个和倒数第一个:${nums1[0,-1]}"
println "第二个到第四个:${nums1[1..3]}"
输出为:
第三个元素是 4,倒数第一个是 false;第一个和倒数第一个:[0, false]
第二个到第四个:[23, 4, 5]
使用 each 方法遍历集合 参数默认是 it
//遍历
nums1.each {
print "$it, "
}
输出为:
0, 23, 4, 5, 62, false,
带有下标的遍历:使用 eachWithIndex 方法
numList.eachWithIndex { int value ,int index->
println "list[$index] = $value"
}
数组的定义要明确的指定数组类型
String [] strings = ["I","'","m","is","a","dog","."]
println "\n 数组 :${strings.getClass().getName()}"
strings.each{
print "$it "
}
def multi = [5,7,5,8,54,87] as int[]
println "\n使用 as 显式指定类型: ${multi.getClass().getName()}"
multi.each{
print "$it "
}
输出是
数组 :[Ljava.lang.String;
I ' m is a dog .
使用 as 显式指定类型: [I
5 7 5 8 54 87
使用 List.add() 添加元素
numList.add(-11)
使用 可以使用 << 操作符添加一个
numList << 13
numList[0] = 0
不用担心下标越界;Groovy就自动增加到所需的下标,中间的会设置为 null
def numList = [0,1,2,3,4,5] as LinkedList
numList.each{
print "$it "
}
println "\n 在 10位置添加一个 11"
numList[10] =11
println "添加后的:"
numList.each{
print "$it "
}
输出为:
> Task :collect1
0 1 2 3 4 5
在 10位置添加一个 11
添加后的:
0 1 2 3 4 5 null null null null 11
BUILD SUCCESSFUL in 0s
使用 List.remove() 移除元素 参数可以是 下标,可以是值
numList.remove 0
numList.remove((Object)10)
使用 List.removeLast() 移除最后一个元素
numList.removeLast()
使用 List.find() 查找第一个符合条件的元素
print "\n list.find() 查找第一个符合条件的元素 numList.find { it%2==0}"
print numList.find { it%2==0}
使用 List.findAll() 查找所有符合条件的元素
print "\n list.findAll() 查找所有符合条件的元素 numList.findAll {it % 2 ==0 }"
print numList.findAll { it % 2 ==0}
使用 List.any() 查找元素,只要有一个元素符合就返回 true
print "\n list.any() 只要有一个元素符合条件就返回 true numList.any { it % 2 ==1} "
print numList.any { it % 2 ==1}
使用 List.every() 查找元素,必须所有元素都符合条件才会返回 true
print "\n list.every() 必须所有元素都符合条件才会返回 true numList.every {it % 2 == 0} "
print numList.every { it % 2 == 0}
统计符合条件的元素个数:使用 List.count()
print numList.count { it % 2 ==0 }
统计最大值:List.max(),最小值:List.min()
print "\n 最大值是 ${numList.max()} ,最小值是 ${numList.min()}, 最小的绝对值是 "
print numList.min { Math.abs it}
Map 的定义是键值对的方式,使用逗号隔开
def colors = [red:'#FF0000',green:'#00FF00',blue:'#0000FF']
访问 Map 中的元素有三种方式:
例如:
task map{
doLast{
def colors = [red:'#FF0000',green:'#00FF00',blue:'#0000FF']
println " map calss is ${colors.getClass().getName()}"
println "通过 map.key 的方式访问 colors.red = ${colors.red}"
println "通过 map[key] 的方式访问 colors['red'] = ${colors['red']}"
println "通过 map.get(key) 的方式访问 colors.get(red) = ${colors.get('red')}"
}
}
输出为 :
> Task :map
map calss is java.util.LinkedHashMap
通过 map.key 的方式访问 colors.red = #FF0000
通过 map[key] 的方式访问 colors['red'] = #FF0000
通过 map.get(key) 的方式访问 colors.get(red) = #FF0000
BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed
//添加元素
colors['pink'] = '#FF00FF'
colors.yellow = '#FFFF00'
//修改元素
colors.red = 'red'
colors['blue'] = 'blue'
println "修改后的元素是 colors.red = ${colors.red},colors.blue = ${colors.blue}"
//删除元素
colors.remove('red')
和上面的一样 使用 each 方法
//遍历
colors.each{
println "${it.key} :${it.value}"
}
查找的方法 和 上面的都一样,只是 参数换成了 Map.Entry 或者 key,value ;
这里只用 find 做一个示例:
find 方法
def green = colors.find { key ,value ->
if(key.equals('green')) {
return colors[key]
}
return null
}
println "查找结果是 ${green}"
def blue = colors.find { Map.Entry entry ->
if(entry.key.equals('blue')){
return entry.value
}
return null
}
println "查找的结果是 ${blue}"
方法也是使用 def 定义的
/*
* 返回大的那个
*/
def max(int a ,int b){
if(a>b){
return a
}else{
return b
}
}
Groovy 会把执行过程中的最后一句代码作为返回值
/*
* 返回大的那个
*/
def max(int a ,int b){
if(a>b){
a
}else{
b
}
}
在调用方法时括号是可以省略的;使用 空格间隔开参数即可
def printMaximum(int a,int b){
if(a>b){
println "The maximum value of $a and $b is $a"
}else{
println "The maximum value of $a and $b is $b"
}
}
task method {
doLast{
println "max is ${max(0,1)}"
printMaximum 10,20
}
}
输出是
> Task :method
max is 1
The maximum value of 10 and 20 is 20
BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed
代码块就是一段被花括号包围的代码,其实就是闭包;
例如 each 方法
最原始的应该是这样的
colors.each({println it})
格式化后
colors.each({
println it
})
Groovy 规定最后一个参数是闭包,可以将闭包放在方法外面
colors.each(){
println it
}
调用时方法的括号是可以省略的 就成了这样
colors.each {
println it
}
闭包是 Groovy 的一个重要特性,可以说是 DSL 的基础。
闭包其实就是一段匿名代码块。
闭包在 Groovy 中是 groovy.lang.Closure 类的实例,这使得闭包可以赋值给变量或字段。
定义一个闭包
def hello = { println "Hello 佛系编码" }
调用这个闭包
hello.call()
另一种调用方式 直接在后面跟上 ()
hello()
下面模拟一个 each 的执行,定一个方法迭代集合中的元素
/*
* closure 就是 闭包参数
*/
def customEach(closure){
//迭代元素
for(int i in 1..10){
//在闭包后跟上 () 就是调用了 括号里的参数就是闭包要接收的参数
closure(i)
}
}
调用这个方法,传入一个闭包打印元素; 如果闭包只有一个参数,那么默认就是 it
// 如果只有一个参数 默认就是 it
customEach {
println it
}
如果闭包要接收多个参数,那就必须把参数显式的列出来,使用 -> 将参数和主体分开
再次模拟一个 map 的 迭代:
def eachMap(closure){
def map1 = [name:'佛系编码',age:666]
map1.each {
closure(it.key,it.value)
}
}
·····
//如果有多个参数,就必须要把参数列出来,使用 -> 将 参数和主体分开
eachMap { key,value ->
println "$key:$value"
}
Groovy 闭包的强大之处在于它支持闭包方法的委托。
Groovy 的闭包有三个重要属性
如果将闭包定义在一个类中,默认三个属性都是相等的;
举个例子: 在 Person 类中 定义了 一个 act 闭包
class Person{
private String name
public int getAge(){
12
}
Closure act ={
println "thisObject:${thisObject.getClass()}"
println "owner:${owner.getClass()}"
println "delegate:${delegate.getClass()}"
}
}
调用这个闭包,将会有下面的输出
> Task :test
thisObject:class Person
owner:class Person
delegate:class Person
BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed
如果将 闭包定义在一个 闭包里,那么 thisOjbect 就和 其他两个不一样,因为 thisObject 是表示的定义闭包所在的类,而 owner 表示 类或闭包
这次在 一个闭包里再定一个闭包看一下
class Person{
private String name
public int getAge(){
12
}
Closure act ={
println "thisObject:$thisObject"
println "owner:$owner"
println "delegate:$delegate"
}
Closure eat = {
def test = {
println "thisObject:${thisObject.getClass()}"
println "owner:${owner.getClass()}"
println "delegate:${delegate.getClass()}"
}
test()
}
}
执行这个 eat 闭包,将会得到以下结果
> Task :test
thisObject:class Person
owner:class Person$_closure2
delegate:class Person$_closure2
BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed
可以看到 thisObject 和 owner 已经不一样了,因为 thisObject 表示的是 所在的类,而 owner 表示的定义所在的类或闭包(最近原则)
三个属性已经很明白了吧,
无论什么时候在闭包中访问某属性或调用某方法时,若没有明确的设置对象,那么就会调用一个委托策略。通过这个委托策略来决定如果访问属性或调用方法。
有以下几个策略,可以通过 闭包的属性更改:resolveStrategy
下面通过一个嵌套类演示一下 策略更改的实际应用。
定义两个类 Person 和 内部类 Foot ,并且两者都有 name 属性。Person 多一个 age 属性。
class Person{
private String name
public int getAge(){
12
}
class Foot {
String name
Closure walk = { it ->
println "name is $name,age is $age ,delegate is ${delegate.getClass()}"
//设置 delegate 属性
delegate = it;
resolveStrategy = Closure.DELEGATE_FIRST
println "修改策略为 Closure.DELEGATE_FIRST delegate 优先"
println "name is $name, age is $age ,delegate is ${delegate.getClass()}"
}
}
void walk(){
Foot foot = new Foot(name:'脚');
foot.walk(this)
}
}
调用 Person 的 walk 方法
Person person = new Person()
person.name ="佛系编码"
person.walk()
将会得到下面的输出
> Task :test
name is 脚,age is 12 ,delegate is class Person$Foot
修改策略为 Closure.DELEGATE_FIRST delegate 优先
name is 佛系编码, age is 12 ,delegate is class Person
BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed
我来解释一下这个输出
第一个name 是 脚 ;这是因为默认策略是 Closure.OWNER_FIRST 是在 owner 寻找属性的;owner 当然是 Foot了。
第二个 name 是 佛系编码;这是因为 策略改为了 Clousre.DELEGATE_FIRST 是优先在 delegate 上寻找的,而又把 delegate 属性修改为了传进去的 Person 实例,他的值在上面已经明确声明为了 佛系编码 。
而 age 只有在 Person 中声明了 getAge() 方法,明确返回了 12.所以即使更改了策略,换了delegate 的值,仍然是 12.
注:三个属性中 只有 delegate 属性可以修改。
在 Gradle 中,我们一般会指定 delegate 为当前的 it,这样在闭包中就可以对 it 进行配置
定义一个 User 类
class User{
String name
int age
def dumpUser(){
println "name is $name,age is $age ."
}
}
在构建配置脚本中定义一个方法,传入一个闭包参数用来配置 User 类
将闭包委托策略更改,并设置 delegate 属性
def user(Closure<User> closure){
User user = new User()
closure.delegate = user
closure.resolveStrategy = Closure.DELEGATE_FIRST
closure(user)
}
在使用的时候就是这样的了,Gradle 中就有很多这种的 DSL 配置,例如我们创建的 task
task configClosure(){
doLast{
user {
name = '佛系编码'
age = 0
dumpUser()
}
}
}
输出为
> Task :configClosure
name is 佛系编码,age is 0 .
BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed
这里只介绍和 Java 中不同的地方.
先看段代码:
task obj{
doLast{
Person p = new Person()
println "没赋值前的 :${p.name}"
p.name = '佛系编码'
println "赋值后的 :${p.name}"
println "age is ${p.age}"
}
}
class Person{
private String name
public int getAge(){
12
}
}
执行 obj 任务的输出
Task :obj
没赋值前的 :null
赋值后的 :佛系编码
age is 12
BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed
在 Person 类中并没有定义 name 属性的 get/set 方法;却可以设置和修改它的值;
这是因为 Groovy 帮我们搞定了 get/set 方法。
age 属性也没有在 Person 类中定义,只是定义了一个 getAge() 方法却可以使用 age 属性。
但是,因为没有定义 set 方法,所以 age 属性只能访问。
这里只列出来和 Java 不同且常用的运算符
对象非空时使用对象本身,对象为空时使用给定值;常用于给定某个可空变量的默认值。
task operator {
doLast{
Person person = new Person();
//person.name 为 null 所以会使用 佛系编码
def name = person.name ? person.name:'佛系编码'
// getAge 返回 12 不为空 所以使用本身
def age = person.age ?:10
println "name is $name , age is $age"
}
}
输出
> Task :operator
name is 佛系编码 , age is 12
BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed
当调用一个对象上的属性或方法时,如果对象是空的,就会抛出空异常,这个使用 ?. 运算符,当对象为空时,表达式的值也是空,就不会抛出异常。
task operator {
doLast{
User user
println "user.name is ${user?.name}"
}
}
输出是
> Task :operator
user.name is null
BUILD SUCCESSFUL in 0s
1 actionable task: 1 executed
断言是用于验证假设条件是否为真,在Groovy的断言中,如果假设的条件不为真,那么就会抛出java.lang.AssertionError异常。
Groovy断言和Java断言完全不同。Groovy断言是一项语言功能,一直处于开启状态,和JVM的断言功能-ea完全无关。所以它是我们进行单元测试的首选方式。
例如
assert 1==2 :"1不等于2"
会抛出以下异常
FAILURE: Build failed with an exception.
······
* What went wrong:
Execution failed for task ':operator'.
> 1不等于2. Expression: (1 == 2)
当然不给出消息也是可以的
assert 1==2
那么异常就是这样的。
Execution failed for task ':operator'.
> assert 1==2
|
false
在使用断言时最好是给出一条消息,此消息可以帮助其他人理解和维护你的代码,理清你的意图。
对于闭包的参数,只能在 API 查询了,没有什么好的办法。
这里把 Groovy 文档地址列出来,方便大家查询相关 API
要使用 gradle 或者 ./gradle 或者 gradlew 命令,必须是要安装Gradle 并设置过环境变量的,当然在Gradle所在的目录也是可以的。
build.gradle 是Gradle 的默认构建脚本文件,在执行 Gradle 命令的时候会默认找在当前目录下的 build.gradle 文件。
也可以通过 -b 参数指定加载执行的文件。
例如 要执行 groovu-basic.build 里的 operator 任务
gradle -b groovy-basic.gradle operator
如果要执行上面的测试代码,步骤是
task test{
doLast{
//这里是代码
}
}
gradle test
附上我的 Gradle 版本
原文:https://www.cnblogs.com/skymxc/p/groovy-basic.html