超级苦工
阅读 28
[Kotlin Tutorials 11] Kotlin和Java的双向互操作

Kotlin和Java的双向互操作

Kotlin和Java是有互操作性的(Interoperability). Kotlin和Java代码可以互相调用.

为什么在一个项目里这两种语言会同时存在呢?

  • 改造Java项目迁移到Kotlin时, 渐进改动就会有两种语言同时存在, 相互调用的情况.
  • 即便你选择了一种语言, 很可能也需要用到库是用另一种语言写的. 比如新写一个Kotlin项目, 但是用到的库仍然是Java的.

Kotlin调用Java

空安全

因为Java中的所有引用都是可能为null的. Java声明的类型在Kotlin中被称为platform types.

从Java中传过来的引用, 可以赋值给Kotlin的非空类型, 不会有编译错误, 但是如果引用值为空, 会在运行时抛出异常.

举例, 在kotlin中调用Java的方法, 返回一个String:

val stringOne = JavaUtils.getStringOne()
println(stringOne)
println(stringOne.length)

如果Java方法返回null怎么办?
运行这段程序时先打出null, 再抛出NullPointerException.

如果程序是这样写的:

val stringOne: String = JavaUtils.getStringOne()
println(stringOne)
println(stringOne.length)

说明Kotlin假设Java传回来的是一个非空值. 这段代码编译时不会报错, 但是运行时第一行就抛出IllegalStateException.

如果这样写:

val stringOne: String? = JavaUtils.getStringOne()
println(stringOne)
println(stringOne?.length)

终于利用上了Kotlin的空安全检查, 所有用到这个变量的地方都要加上?, 如果不做检查编译时就会提示错误.
但是这样防御难免导致代码太啰嗦了, 可能到处都是?.

好的实践是Java中的Public APIs(Non-primitive parameters, Field type, Return)都应该加上注解.

如果Java的类型上有关于null的注解, 就会直接表示为Kotlin中为不为null或者可为null的对应类型.

注解可以来自于各种包中, 比如JetBrains提供的: @Nullable@NotNull.

比如:

@NotNull
public static String getStringOne() {
    return "hello";
}

这样Kotlin代码就知道传过来的肯定是个非空值, 可以放心使用.

如果是@Nullable, 编译器就会提示使用前做检查.

转义在Kotlin中作为关键字的Java标识符

Kotlin中的关键字, 比如:

fun, in, is, object, typealias, typeof, val, var, when

如果Java代码中用了这些关键字, 在Kotlin中调用该Java代码就要用`进行转义.

比如如果java中有一个名称为is的方法, 在kotlin中想要调用:

foo.`is`(bar)

但是, 首先需要考虑是不是名字起得不好, 如果可以改名(不是第三方代码), 优先考虑改名.

比较常见的一个使用情形是在写测试的时候, Mockito中的when就需要转义:

Mockito.`when`(xxx.foo()).thenReturn(yyy)

因为Mockito是一个Java的第三方库, 我们没法改它.

另一个解决办法是使用import alias, 给这个方法取个别名:

import org.mockito.Mockito.`when` as whenever

这样在使用的时候就可以用whenever来代替了when了.
import alias通常用来解决命名冲突的问题.

SAM Conversions

SAM: Single Abstract Method.

只要函数参数匹配, Kotlin的函数可以自动转换为Java的接口实现.

Convention: 可以做SAM转换的参数类型应该放在方法的最后, 这样看起来更舒服.

举例, 如果在Java中定义方法:

interface Operation {
    int doCalculate(int left, int right);
}

public static int calculate(Operation operation, int firstNumber, int secondNumber) {
    return operation.doCalculate(firstNumber, secondNumber);
}

在Kotlin中调用的时候用SAM转换, 用一个lambda作为接口实现:

JavaUtils.calculate({ number1, number2 -> number1 + number2 }, 2, 3)

这样虽然正确, 但是可以改进.
把Java方法定义中的参数位置交换一下, 把接口参数放在最后:

public static int calculate(int firstNumber, int secondNumber, Operation operation) {
    return operation.doCalculate(firstNumber, secondNumber);
}

在Kotlin中, 最后一个lambda参数可以提取到括号外面:

JavaUtils.calculate(2, 3) { number1, number2 -> number1 + number2 }

这样看起来更好.

注意: SAM conversion只应用于java interop.

上面的例子, 如果接口和方法是在Kotlin中定义的:

interface Operation2 {
    fun doCalculate(left: Int, right: Int): Int
}

fun calculate2(firstNumber: Int, secondNumber: Int, operation: Operation2): Int {
    return operation.doCalculate(firstNumber, secondNumber)
}

SAM conversions就不能用了, IDE会提示无法识别.
调用这个方法时, 第三个参数必须写成这种(匿名类的对象, 实现了接口):

calculate2(2, 3, object : Operation2 {
    override fun doCalculate(left: Int, right: Int): Int {
        return left + right
    }
})

这是因为在Kotlin的世界里, 函数是第一公民.

如果把前面的方法参数改为function type:

fun calculate3(firstNumber: Int, secondNumber: Int, operation: (Int, Int) -> Int): Int {
    return operation.invoke(firstNumber, secondNumber)
}

就可以像之前SAM conversions似的使用:

calculate3(2, 3) { number1, number2 -> number1 + number2 }

如果接口是在Java中定义, 但是接收参数的方法是Kotlin的方法:

fun calculate4(firstNumber: Int, secondNumber: Int, operation: JavaUtils.Operation): Int {
    return operation.doCalculate(firstNumber, secondNumber)
}

仍然是不能用SAM conversions, 因为这个方法仍然是可以接受函数类型的参数的.
在Kotlin中调用:

calculate4(2, 3, object : JavaUtils.Operation {
    override fun doCalculate(left: Int, right: Int): Int {
        return left + right
    }
})

IDE会提示你简化为:

calculate4(2, 3, JavaUtils.Operation { left, right -> left + right })

注意这里接口名称不能省略.

是不是感觉有点晕, 我把上面提到的几个调用情况写在一起:

// java function, java interface parameter
private fun trySAM1() {
    JavaUtils.calculate(2, 3) { number1, number2 -> number1 + number2 }
}

// kotlin function, kotlin interface parameter
private fun trySAM2() {
    calculate2(2, 3, object : Operation2 {
        override fun doCalculate(left: Int, right: Int): Int {
            return left + right
        }
    })
}

// kotlin function, function type parameter
private fun trySAM3() {
    calculate3(2, 3) { number1, number2 -> number1 + number2 }
}

// kotlin function, java interface parameter
private fun trySAM4() {
    calculate4(2, 3, JavaUtils.Operation { left, right -> left + right })
}

可以互相比较一下, 看看区别.

Getter和Setter

Java中的getter和setter在Kotlin中会表现为properties. 但是如果只有setter, 不会作为可见的property.

异常

Kotlin中所有的异常都是unchecked的, 所以如果调用的Java代码有受检异常, kotlin并不会强迫你处理.

其他

Java中返回void的方法在Kotlin中会变成Unit.

java.lang.Object会变成Any, Any中的很多方法都是扩展方法.

Java没有运算符重载, 但是Kotlin支持. (运算符重载容易存在过度使用的问题.)

Java调用Kotlin

属性

Kotlin的属性会被编译成Java中的一个私有字段, 加上getter和setter方法.

如果想要作为一个字段, 可以加上@JvmField注解.

包级别的方法

如果在一个文件app.kt中定义方法, 包名是org.example, 会被编译成Java的静态方法, Java类的类名是org.example.AppKt.

应用场景举例: 旧代码中有一个Java的辅助类, 包含静态方法:

public class Utils {
    public static int distanceBetween(int point1, int point2) {
        return point2 - point1;
    }
}

要把这个辅助类迁移到Kotlin代码, 可以新建一个Kotlin文件DistanceUtils.kt, 直接写包级别的方法:

fun distanceBetween(point1: Int, point2: Int): Int {
    return point2 - point1
}

在Java中调用这个方法的时候:

DistanceUtilsKt.distanceBetween(7, 9);

如果原先的Java代码中包含调用这个方法的地方太多, 又不想改所有的usage, 怎么办? ->
可以通过注解@file:JvmmName("xxx")改变类名. 这样原先Java代码中调用的地方就避免了修改.

如果有两个文件指定了相同的JvmName, 编译会报错. 可以通过加上@file:JvmMultifileClass来解决. 这样多个Kotlin文件中定义的辅助方法对于Java来说会统一到同一个类中.

实例字段

如你需要把kotlin的property作为字段暴露出来, 可以加上@JvmField注解.

适用的property: 有backing field, 没有这些修饰符: private, open, override, const, 也不是代理属性.

lateinit的属性会自动暴露为fields, 可见性和属性的setter一致.

Kotlin的data class会自动生成getter/setter. 如果加上@JvmField, 会直接暴露这些字段.

可以通过@get:JvmName("xxx")@set:JvmName("xxx")来定制getter和setter的名字.

静态字段

Kotlin在有名字的object或者companion object中声明的属性, 将会编译成静态字段.

通常这些字段是private的, 不过也可以通过以下几种方式暴露:

  • @JvmField.
  • lateinit.
  • const.

静态方法

前面提过, Kotlin包级别的方法会被编译成静态方法.

在object或companion object中声明的方法, 默认是类中的实例方法. 比如:

class StaticMethodsDemoClass {
    companion object {
        fun sayHello() {
            println("hello")
        }
    }
}

object SingletonObject {
    fun sayWorld() {
        println("world")
    }
}

在Java中调用的时候:

StaticMethodsDemoClass.Companion.sayHello();
SingletonObject.INSTANCE.sayWorld();

如果给object或companion object中的方法加上@JvmStatic, 会生成一个静态方法和一个实例方法.
调用的时候就可以省略掉中间的CompanionINSTANCE关键字, 以类名直接调用静态方法.

比如:

class StaticMethodsDemoClass {
    companion object {
        fun sayHello() {
            println("hello")
        }

        @JvmStatic
        fun sayHelloStatic() {
            println("hello")
        }
    }
}

调用的时候:

StaticMethodsDemoClass.Companion.sayHello();
//StaticMethodsDemoClass.sayHello(); // error

StaticMethodsDemoClass.Companion.sayHelloStatic(); // ok, but not necessary
StaticMethodsDemoClass.sayHelloStatic();

@JvmStatic也可以用于属性, 就会有静态版本的getter和setter方法.

其他

Kotlin方法支持默认参数, 在Java中只有全部参数的方法签名才是可见的. 如果你希望对Java暴露多个方法重载, 要给方法加上@JvmOverloads.
比如在Kotlin中写一个自定义View的构造函数:

class DialView @JvmOverloads constructor(
   context: Context,
   attrs: AttributeSet? = null,
   defStyleAttr: Int = 0
) : View(context, attrs, defStyleAttr) {
}

还可以利用
@JvmName来给方法重命名. 因为在Kotlin中是扩展方法, 在Java中只是一个静态方法, 名字可能不够直观.

Kotlin没有checked exceptions.
如果想在Java中调用一个Kotlin方法, 并包一个try-catch, 会报错说没有抛出这个异常.

可以在Kotlin方法中加上注解, 比如@Throws(IOException::class).

Feature leak prevention

Kotlin方法的参数名, 在生成代码中会作为一个字符串出现, 从而不会被混淆, 有可能会泄漏. 所以不建议放敏感信息到参数名中.

类似的还有字段名, 扩展方法名.

可以在proguard中加上

-assumenosideeffects class kotlin.jvm.internal.Intrinsics {
    public static void checkParameterIsNotNull(...);
    public static void throwUninitializedPropertyAccessException(...);
}

来移除这些代码.
但是建议在测试环境中仍然保留这些代码, 以便有错误发生的时候能够快速发现.

Tools

IDE的自动转换

Code -> Convert Java File to Kotlin File.

如果粘贴Java代码到.kt文件, IDE会自动将所粘贴代码转换为Kotlin代码.

查看编译成的Java代码

在IDE里面可以显示Kotlin Bytecode, 然后decompile, 显示java代码.

Tools -> Kotlin -> Show Kotlin Bytecode -> Decompile.

参考

关注下面的标签,发现更多相似文章
评论
相关推荐
Android 使用 HTTPS

来源: 简书 原文: Android 使用 HTTPS 如果你的项目的网络框架是okhttp,那么使用https还是挺简单的,因为okhttp默认支持HTTPS。传送门 Android 使用 HTTP...

Android 适配一篇就够 - 编译版本?support?API 兼容?图片适配?

来源: 简书 原文: Android 适配一篇就够 - 编译版本?support?API 兼容?图片适配? 本文介绍 Android 不同系统及图片资源的常见适配问题。 compileSdkVersi...

[Kotlin Tutorials 11] Kotlin和Java的双向互操作

来源: 简书 原文: [Kotlin Tutorials 11] Kotlin和Java的双向互操作 Kotlin和Java的双向互操作 Kotlin和Java是有互操作性的(Interoperabi...

Android跳转到获取应用通知权限

来源: 简书 原文: Android跳转到获取应用通知权限 1.判断是否有通知权限 官方只最低支持到API 19(4.4),低于19的只会返回true,目前暂时没有办法获取19以下的系统是否开启了某个...

Android--PathMeasure基本用法

来源: 简书 原文: Android--PathMeasure基本用法 PathMeasure是一个用来测量Path的类 构造方法 //创建一个空的PathMeasure public PathMea...

Android屏幕适配的总结

来源: 简书 原文: Android屏幕适配的总结 屏幕适配的核心:其一,就是适配的效率,即把设计图转化为App界面的过程是否高效,其二如何保证实现UI界面在不同尺寸和分辨率的手机中UI的一致性。 背...

Android热修复之-Frameworks层修复原理分析

来源: 简书 原文: Android热修复之-Frameworks层修复原理分析 说到热修复主要有两种修复方案一种是通过dex替换的方式来达到修复效果、一种是基本native层的修复。dex替换的方式...

[译文]MongoDB WiredTiger引擎调优技巧

来源: 简书 原文: [译文]MongoDB WiredTiger引擎调优技巧 MongoDB从3.0开始引入可插拔存储引擎的概念。当前,有不少存储引擎可供选择:MMAPV1、WiredTiger、M...

知道了这些 MongoDB设计技巧,提升效率50%

来源: 掘金 原文: 知道了这些 MongoDB设计技巧,提升效率50% 范式化设计还是反范式 考虑下这样的场景,我们的订单数据是这样的 商品: { "_id": productI...

Mongo实时聚合千万文档数据

来源: 掘金 原文: Mongo实时聚合千万文档数据 1.前言 大数据的聚合分析在企业中非常有用,有过大数据开发经验的人都知道ES、Mongo都提供了专门的聚合方案来解决这个问题。但是大量数据的实时聚...

历时七天,史上最强MySQL优化总结,从此优化So Easy!

来源: 掘金 原文: 历时七天,史上最强MySQL优化总结,从此优化So Easy! 一、概述 1. 为什么要优化 一个应用吞吐量瓶颈往往出现在数据库的处理速度上 随着应用程序的使用,数据库数据逐渐增...

Mysql 百问系列:B+Tree 到底是什么

来源: 掘金 原文: Mysql 百问系列:B+Tree 到底是什么 前言: 以前看过许多关于B+ Tree的文章,当时看了总觉得明白了,可是没过多久就又要忘了。直到我看了掘金小册:Mysql是怎么运...

LRU算法及其优化策略——Mysql篇

来源: 掘金 原文: LRU算法及其优化策略——Mysql篇 在上一篇文章中,介绍了LRU算法在Redis之中的应用,本篇继续给各位道友介绍在Mysql的InnobDB引擎中,是如何使用LRU算法的。...

mysql order by 优化

来源: 掘金 原文: mysql order by 优化 version : 5.7, from 8.2.1.14 ORDER BY Optimization 本节描述MySQL何时可以使用索引来满足...

MYSQL-多表查询

来源: 掘金 原文: MYSQL-多表查询 首先创建数据表tb_departments create table tb_departments (dept_id INT PRIMARY KEY, de...

MySQL索引和SQL调优

来源: 掘金 原文: MySQL索引和SQL调优 [TOC] MySQL索引和SQL调优 本文有参考网上其他相关文章,本文最后有附参考的链接 MySQL索引 MySQL支持诸多存储引擎,而各种存储引擎...

iOS 底层拾遗:AutoreleasePool

来源: 掘金 原文: iOS 底层拾遗:AutoreleasePool 前言 在阳神的 黑幕背后的Autorelease 文章中已经把 AutoreleasePool 核心逻辑讲明白了,不过多是结论性...

iOS app秒开H5优化探索

来源: 掘金 原文: iOS app秒开H5优化探索 背景 为了快递迭代、更新,公司app有一大模块功能使用H5实现,但是体验比原生差,这就衍生了如何提高H5加载速度,优化体验的问题。此文,记录一下自...

iOS常用宏 定义

来源: 简书 原文: iOS常用宏 定义 iOS开发过程中,使用的一些常用宏定义 字符串是否为空 #define kStringIsEmpty(str) ([str isKindOfClass:[NS...

比较一下iOS中的三种定时器

来源: 掘金 原文: 比较一下iOS中的三种定时器 NSTimer NSTimer是iOS开发中的最常见的定时器。 Timers work in conjunction with run loops....