1. 日常遇到的冗余的接口方法实现
日常开发中,经常会要实现接口,但是很多场景中,只需要用到其中一两个方法,例如 ActivityLifecycleCallbacks
,它有很多个接口需要实现,但是很多时候我们只需要用到其中的一两个
val myActivityLifecycleCallbacks = object : Application.ActivityLifecycleCallbacks {/*** 例如我们只需要监听 Activity 的创建和销毁,那么 onActivityStarted, onActivityResumed, onActivityPaused* onActivityStopped,onActivityStopped,onActivitySaveInstanceState 这 6 个方法是完全没必要实现的,* 即使是空实现*/override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) {TODO("Not yet implemented")}override fun onActivityStarted(activity: Activity) {TODO("Not yet implemented")}override fun onActivityResumed(activity: Activity) {TODO("Not yet implemented")}override fun onActivityPaused(activity: Activity) {TODO("Not yet implemented")}override fun onActivityStopped(activity: Activity) {TODO("Not yet implemented")}override fun onActivitySaveInstanceState(activity: Activity, outState: Bundle) {TODO("Not yet implemented")}override fun onActivityDestroyed(activity: Activity) {TODO("Not yet implemented")}}
如果有多个不同业务需要实现这个接口,就这样很容易产生代码冗余。有没有一种优雅的方式,只需要实现自己需要的方法而不再需要去关注其他方法?有的,那就是利用 Java 的动态代理和 kotlin 的委托模式
2. 利用 Java 的动态代理和 Kotlin 的委托模式
首先需要实现一个通用的动态代理,新建一个 Kotlin 文件 DelegateObject.kt
,这里通过 inline
和 reified
关键字,获取到泛型的 class 信息
import java.lang.reflect.InvocationHandler
import java.lang.reflect.Proxyinline fun <reified T> noOpDelegate() : T {val javaClass = T::class.javareturn Proxy.newProxyInstance(javaClass.classLoader, arrayOf(javaClass), no_op_invocationHandler) as T
}val no_op_invocationHandler = InvocationHandler { _, _, _ -> }
这样就可以获取到任意一个接口的一个对象,只是没有具体的实现。接着再利用 Kotlin 的 by
关键字实现对象委托
val myActivityLifecycleCallbacks = object : Application.ActivityLifecycleCallbacks by noOpDelegate() {}
由于 Kotlin 委托模式的原理,实际上在编译期间也是会生成 ActivityLifecycleCallbacks
的所有方法,先来看看转译后的实现
private final Application.ActivityLifecycleCallbacks myActivityLifecycleCallbacks = (Application.ActivityLifecycleCallbacks)(new Application.ActivityLifecycleCallbacks() {// $FF: synthetic fieldprivate final Application.ActivityLifecycleCallbacks $$delegate_0;{int $i$f$noOpDelegate = false;Class javaClass$iv = Application.ActivityLifecycleCallbacks.class;Object var10001 = Proxy.newProxyInstance(javaClass$iv.getClassLoader(), new Class[]{javaClass$iv}, DelegateObjectKt.getNo_op_invocationHandler());if (var10001 == null) {throw new NullPointerException("null cannot be cast to non-null type android.app.Application.ActivityLifecycleCallbacks");} else {this.$$delegate_0 = (Application.ActivityLifecycleCallbacks)var10001;}}public void onActivityCreated(@NonNull @NotNull Activity activity, @Nullable @org.jetbrains.annotations.Nullable Bundle savedInstanceState) {Intrinsics.checkNotNullParameter(activity, "activity");this.$$delegate_0.onActivityCreated(activity, savedInstanceState);}public void onActivityDestroyed(@NonNull @NotNull Activity activity) {Intrinsics.checkNotNullParameter(activity, "activity");this.$$delegate_0.onActivityDestroyed(activity);}public void onActivityPaused(@NonNull @NotNull Activity activity) {Intrinsics.checkNotNullParameter(activity, "activity");this.$$delegate_0.onActivityPaused(activity);}public void onActivityResumed(@NonNull @NotNull Activity activity) {Intrinsics.checkNotNullParameter(activity, "activity");this.$$delegate_0.onActivityResumed(activity);}public void onActivitySaveInstanceState(@NonNull @NotNull Activity activity, @NonNull @NotNull Bundle outState) {Intrinsics.checkNotNullParameter(activity, "activity");Intrinsics.checkNotNullParameter(outState, "outState");this.$$delegate_0.onActivitySaveInstanceState(activity, outState);}public void onActivityStarted(@NonNull @NotNull Activity activity) {Intrinsics.checkNotNullParameter(activity, "activity");this.$$delegate_0.onActivityStarted(activity);}public void onActivityStopped(@NonNull @NotNull Activity activity) {Intrinsics.checkNotNullParameter(activity, "activity");this.$$delegate_0.onActivityStopped(activity);}});
现在已经将 ActivityLifecycleCallbacks 的匿名内部类对象委托给了 noOpDelegate
生成的代理对象。这样需要用到具体哪个方法时,只需要再次重写即可,例如文章最开始的例子可以变为
val myActivityLifecycleCallbacks = object : Application.ActivityLifecycleCallbacks by noOpDelegate() {override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) {TODO("Not yet implemented")}override fun onActivityDestroyed(activity: Activity) {TODO("Not yet implemented")}}
经过精简的代码可以使代码更加简洁,可以更好的聚焦业务实现
3. 注意接口方法存在返回值问题
如果实现的接口中的方法带有返回值,务必要重写该方法,不然会报 IllegalArgumentException 异常。 这也算是这种优雅方式中一个缺点。来看个例子,首先定义一个接口
interface TestNoDelegateInterface {fun testFun1()fun testFun2(): Int
}
该接口定义了两个方法,其中一个方法有 int 类型的返回值,使用 noOpDelegate
实现该接口
val testNoDelegateInterface = object : TestNoDelegateInterface by noOpDelegate() {
}
当 testNoDelegateInterface
去调用 testFun2()
方法
testNoDelegateInterface.testFun2()
控制台将打印报错信息
AndroidRuntime: FATAL EXCEPTION: main
AndroidRuntime: Process: com.example.mydemoapplication, PID: 25135
AndroidRuntime: java.lang.IllegalArgumentException: result has type int, got kotlin.Unit
AndroidRuntime: at $Proxy2.testFun2(Unknown Source)
而当 testNoDelegateInterface
去调用 testFun1()
方法时则没有这个问题
原因是在使用动态代理反射实现 TestNoDelegateInterface
接口的代理对象时,传入的 InvocationHandler
实际是个空对象,当通过 Kotlin 委托生成的接口方法需要一个返回值,而代理对象在实际执行方法时由于没有具体实现,导致两个方法的返回类型不一致,最终报错。先看下 testNoDelegateInterface
转译成的 java 代码
final <undefinedtype> testNoDelegateInterface = new TestNoDelegateInterface() {// 委托模式将 testNoDelegateInterface 的能力委托给了由动态代理创建的 $$delegate_0 对象private final TestNoDelegateInterface $$delegate_0;{int $i$f$noOpDelegate = false;Class javaClass$iv = TestNoDelegateInterface.class;Object var10001 = Proxy.newProxyInstance(javaClass$iv.getClassLoader(), new Class[]{javaClass$iv}, DelegateObjectKt.getNo_op_invocationHandler());if (var10001 == null) {throw new NullPointerException("null cannot be cast to non-null type com.example.mydemoapplication.TestNoDelegateInterface");} else {this.$$delegate_0 = (TestNoDelegateInterface)var10001;}}public void testFun1() {this.$$delegate_0.testFun1();}public int testFun2() {/*** 动态代理的对象的方法调用最终都会执行到 InvocationHandler#invoke(java.lang.Object, java.lang.reflect.Method, java.lang.Object[]) * 的方法实现,因为通用动态代理传入的 no_op_invocationHandler 是个空实现,所以这里调用并不会返回一个期望的返回值*/return this.$$delegate_0.testFun2();}};
综上,需要实现带返回值的接口,这样就不会报错了
val testNoDelegateInterface = object : TestNoDelegateInterface by noOpDelegate() {// 重写带返回的方法,具体返回的值按照业务需求实现override fun testFun2(): Int {return Int.MIN_VALUE}}