导读大纲
-
- [1.1 为第三方的类添加方法: 扩展函数](#1.1 为第三方的类添加方法: 扩展函数)
1.1 为第三方的类添加方法: 扩展函数
-
Kotlin 的主题之一 是与现有代码的平滑集成
- 即使是纯 Kotlin 项目 ,也是构建在 Java 库之上 的
- 如 JDK、Android 框架和其他第三方框架
- 而当你将 Kotlin 集成到 Java 项目 中时
- 你还要处理尚未或不会转换为 Kotlin 的现有代码
- 如果能在使用这些 API 时使用 Kotlin 的所有优点
- 而无需重写它们, 岂不美哉?
- 即使是纯 Kotlin 项目 ,也是构建在 Java 库之上 的
-
从概念上 讲,扩展函数很简单
- 扩展函数的本质 是: 一个可以作为类的成员被调用 ,但定义在类之外的函数
- <1> 为了演示扩展函数,添加一个计算字符串最后一个字符的方法
- 暂时忽略处理空字符串的边缘情况
kotlin
package strings
fun String.lastChar(): Char = this.get(this.length - 1) // <1>
-
只需在添加的函数名称前 加上要扩展的类或接口的名称即可
- 这个类名被称为接收器类型 ; 而调用扩展函数的值被称为接收器对象
- 在扩展函数声明中,接收器类型是定义扩展的类型
- 可以用它来指定函数要扩展的目标类型
- 接收器对象是该目标类型的实例 ,可以用它来访问所扩展类型的属性和方法
- 这里String就是要扩展的目标类型 ,this就是String类型的实例对象
- 简单理解就是:lastChar() 方法是 String 类型的成员
- 这个类名被称为接收器类型 ; 而调用扩展函数的值被称为接收器对象
-
可以使用与普通类成员相同的语法调用该函数
- <1> 这里String是接收器类型, "Kotlin"是接收器对象
kotlin
fun String.lastChar() = this.get(this.length -1) // <1>
fun main() {
println("Kotlin".lastChar()) // <1>
}
-
从某种意义上 说,你为 String 类添加自己的方法
- 尽管 String 类并不是您代码的一部分 ,甚至可能没有该类的源代码
- 但您仍然可以在项目中用您需要的方法来扩展它
- 只要编译成 Java 类 , 就可以在该类中添加自己的扩展方法
- 尽管 String 类并不是您代码的一部分 ,甚至可能没有该类的源代码
-
在扩展函数的主体 中, 与在成员方法中使用 this 的方式相同
- <1> 与在Java的普通成员方法 中一样
- 访问对象的属性和方法 可以省略"this"关键字
- <2> 这里可以简化 lastChar() 扩展函数的实现, 省略其中的
this
- this.get(this.length -1) ==> get(length - 1)
- <1> 与在Java的普通成员方法 中一样
kotlin
/* Java */
public class Example {
private final String name;
public Example(String name) {
this.name = name;
}
public void sayHello() {
System.out.println("Hello " + name); // <1>
}
}
=======================================================
package strings
fun String.lastChar(): Char = get(length - 1) // <2>
-
在扩展函数(就像在类中定义方法 )中,可以直接访问被扩展类的方法和属性
- 但是要注意,扩展函数只是扩展功能 ,而不允许你破坏封装
- 与类中定义的方法不同 ,扩展函数不能访问私有或受保护的成员
- 但是要注意,扩展函数只是扩展功能 ,而不允许你破坏封装
-
在扩展函数的主体 中,你可以调用接收器的任何方法(methods)
- 这里的方法指的是,既可以调用类中原有的成员函数 ,也可以调用扩展函数
- 在调用方法时,扩展函数与成员函数是没有区别 的
- 而且通常情况下,特定方法是成员函数还是扩展函数 并不重要
- 扩展函数强大之处 就在于可以利用它来扩展源代码中的类
- 即使你都没有这个类的源代码
- <1> 比如在你的代码中调用 lastChar()方法
- 根本不需要关注该方法 是String类自带的还是第三方库扩展的
- 对于调用者来说,这种调用是无感的
kotlin
fun main() {
println("Kotlin".lastChar()) // <1>
}