如何让因类型擦除不同名的Java方法在Kotlin中使用同一名称？

在Kotlin中我们可以用@JvmName注解让Java以不同名称引用Kotlin声明，比如处理泛型类型擦除导致的方法冲突：

@JvmName("doFooWithStrings")
fun doFoo(list: List<String>) {
    ...
}

@JvmName("doFooWithInts")
fun doFoo(list: List<Int>) {
   ...
}

现在需要实现相反的需求：有两个因Java类型擦除无法同名的方法，希望在Kotlin中用同一个名称调用：

Java代码：

public class Foo {
    public void doFooWithStrings(List<String> list) { ... }

    public void doFooWithInts(List<Integer> list) { ... }
}

期望的Kotlin调用方式：

// 调用doFooWithStrings
doFoo(listOf("1", "2", "3")) 
// 调用doFooWithInts
doFoo(listOf(1, 2, 3)) 

是否存在类似@KotlinName的注解指定Kotlin中的名称？理想情况是原Java方法名在Kotlin中不可访问，或至少给出警告避免使用。

解决方案：扩展函数 + 废弃标记 #

Kotlin没有官方的@KotlinName注解直接为Java方法重命名，但可以通过扩展函数实现统一调用名称，同时用@Deprecated注解限制原方法的使用：

1. 定义同名扩展函数 #

为Foo类创建两个重载的扩展函数doFoo，分别对应原Java方法的参数类型，内部转发调用：

// 处理String列表的扩展函数
fun Foo.doFoo(list: List<String>) {
    this.doFooWithStrings(list)
}

// 处理Int列表的扩展函数
fun Foo.doFoo(list: List<Int>) {
    this.doFooWithInts(list)
}

2. 标记原方法为废弃（可选） #

如果希望引导开发者使用新的doFoo方法，可以为原Java方法的Kotlin映射添加废弃注解，甚至隐藏原方法：

// 警告开发者使用替代方法
@Deprecated(
    message = "请使用doFoo替代",
    replaceWith = ReplaceWith("doFoo(list)"),
    level = DeprecationLevel.WARNING
)
fun Foo.doFooWithStrings(list: List<String>) = this.doFooWithStrings(list)

@Deprecated(
    message = "请使用doFoo替代",
    replaceWith = ReplaceWith("doFoo(list)"),
    level = DeprecationLevel.WARNING
)
fun Foo.doFooWithInts(list: List<Int>) = this.doFooWithInts(list)

如果需要彻底隐藏原方法，将level改为DeprecationLevel.HIDDEN，这样原方法名在Kotlin的代码补全和编译中都会被隐藏，只能使用doFoo。

原理说明 #

• Kotlin支持基于泛型实参的重载（不会像Java那样因类型擦除丢失信息），所以两个同名扩展函数可以共存并被正确解析。
• 扩展函数属于Kotlin层的封装，不需要修改原Java代码，对Java调用方无影响。
• @Deprecated注解可以灵活控制原方法的可见性，从警告到完全隐藏。

内容的提问来源于stack exchange，提问作者Sweeper