文章目录
I . 内联扩展函数 apply
II . Kotlin 调用 Java API
III . apply 内联扩展函数示例 ( 调用 Java API 处理图像 )
I . 内联扩展函数 apply
1 . apply 函数原型 : 泛型 T 类型对象 , 调用 apply 方法 , 后面定义了一个闭包代码块 ; 调用 apply 方法的对象类型是泛型 , 说明任何对象都可以调用该方法 ;
/**
* Calls the specified function [block] with `this` value as its receiver and returns `this` value.
*
* For detailed usage information see the documentation for [scope functions]
* (https://kotlinlang.org/docs/reference/scope-functions.html#apply).
*/
@kotlin.internal.InlineOnly
public inline fun <T> T.apply(block: T.() -> Unit): T {
contract {
callsInPlace(block, InvocationKind.EXACTLY_ONCE)
}
block()
return this
}
2 . apply 函数作用 : 扩展了调用 apply 函数的泛型类型 T 的对象的操作方法 , 等同于为泛型 T 对象定义了一个新的方法 ;
3 . apply 函数调用对象 : 所有的对象都可以调用 apply 函数 ,
4 . 闭包代码块 说明 :
① 主要功能 : apply 函数可以指定要执行的代码块 , 再代码块中可以使用 this 访问其调用对象 , 执行完毕后 , 会自动返回该对象 ;
② 调用 T 对象本身 : 使用 this 可以访问该对象 , 不是 it ;
③ 特点 : 在 apply 后的闭包内 , 可以调用该 T 对象的所有成员方法 和 成员变量 ;
④ 返回值 : appay 方法返回泛型类型 T 对象本身 , 即在闭包内执行的针对 T 对象的内容是保存下来的
II . Kotlin 调用 Java API
Kotlin 与 Java 代码是完全兼容的 , 因为其都是基于 Java 虚拟机的语言 ;
Kotlin 中可以调用 Java 语言的类和方法 ;
Java 语言中也可以调用 Kotlin 的类和方法 ;
因此 Kotlin 中是可以调用 Java 的 API 函数库的 , 这极大的拓展了 Kotlin 的功能 ;
III . apply 内联扩展函数示例 ( 调用 Java API 处理图像 )
package pic
import java.awt.image.BufferedImage
import java.io.File
import javax.imageio.ImageIO
/*
Kotlin 图像处理
涉及到调用 Java API 中的方法
*/
fun main() {
/*
Kotlin 中可以使用 Java 的所有 API , 这里使用 Java 的图像操作 API 进行图像处理
作用 : BufferedImage 作用是在内存中生成图片 , 下面代码的含义是 :
在内存中传入一个宽高为 100 像素, 像素格式为 TYPE_INT_RGB 的图像
构造方法 : BufferedImage 初始化传入的三个参数分别是 图像的 宽 和 高 , 图像的像素格式 RGB
*/
var image = BufferedImage(100 , 100, BufferedImage.TYPE_INT_RGB)
/*
使用高阶函数 ( 参数和返回值为函数的函数 )
Calls the specified function [block] with `this` value as its receiver and returns `this` value.
For detailed usage information see the documentation for [scope functions]
(https://kotlinlang.org/docs/reference/scope-functions.html#apply).
@kotlin.internal.InlineOnly
public inline fun <T> T.apply(block: T.() -> Unit): T {
contract {
callsInPlace(block, InvocationKind.EXACTLY_ONCE)
}
block()
return this
}
apply 函数作用 :
作用 : 扩展了调用 apply 函数的泛型类型 T 的对象的操作方法 , 等同于为泛型 T 对象定义了一个新的方法
特点 : 在 apply 后的闭包内 , 可以调用该 T 对象的所有成员方法 和 成员变量
返回值 : appay 方法返回泛型类型 T 对象本身 , 即在闭包内执行的针对 T 对象的内容是保存下来的
调用 T 对象本身 : 使用 this 可以访问该对象 , 不是 it
apply 接收一个函数类型参数 block: T.() -> Unit
函数类型变量名 : block 是函数类型实例名称
T.() -> Unit : 函数类型
T 表示 image 本身
T.() 表示 image 本身的成员方法 , 其返回值是 Unit 空类型
*/
image.apply {
// i 在 0 到 99 的闭区间
for(i in 0 .. 99){
// j 在 0 到 99 的闭区间
for (j in 0 .. 99){
setRGB(i, j, 0xFFFFFF)
}
}
}
/*
设置图像中某像素点的颜色值
参数 int x : 像素点的 x 坐标
参数 int y : 像素点的 y 坐标
参数 int rgb : 像素点的颜色值
下面的代码含义是将图像 四个角 和 中心 的像素设置成 红色
*/
image.setRGB(0, 0, 0xFF0000)
image.setRGB(0, 99, 0xFF0000)
image.setRGB(50, 50, 0xFF0000)
image.setRGB(99, 0, 0xFF0000)
image.setRGB(99, 99, 0xFF0000)
/*
将内存中的图像写出到本地
三个参数分别是 : 图像数据 , 图像格式 , 图像输出的 File 对象
*/
ImageIO.write(image, "bmp", File("image.bmp"))
}
生成的图像展示 :
