SAM-with-receiver 编译器插件
sam-with-receiver 编译器插件将带有注解的 Java“单一抽象方法”(SAM)接口方法的第一个形参转变为 Kotlin 中的接收者。这种转换仅在 SAM 接口作为 Kotlin lambda 表达式传递时生效,且同时适用于 SAM 适配器和 SAM 构造函数(详情请参阅 SAM 转换文档)。
以下是一个示例:
java
public @interface SamWithReceiver {}
@SamWithReceiver
public interface TaskRunner {
void run(Task task);
}kotlin
fun test(context: TaskContext) {
val runner = TaskRunner {
// 这里的 'this' 是一个 'Task' 实例
println("$name is started")
context.executeTask(this)
println("$name is finished")
}
}Gradle
其用法与 all-open 和 no-arg 相同,区别在于 sam-with-receiver 没有任何内置预设,你需要自行指定需要特殊处理的注解列表。
kotlin
plugins {
kotlin("plugin.sam.with.receiver") version "2.4.21"
}groovy
plugins {
id "org.jetbrains.kotlin.plugin.sam.with.receiver" version "2.4.21"
}然后指定 SAM-with-receiver 注解列表:
groovy
samWithReceiver {
annotation("com.my.SamWithReceiver")
}Maven
xml
<plugin>
<artifactId>kotlin-maven-plugin</artifactId>
<groupId>org.jetbrains.kotlin</groupId>
<version>${kotlin.version}</version>
<configuration>
<compilerPlugins>
<plugin>sam-with-receiver</plugin>
</compilerPlugins>
<pluginOptions>
<option>
sam-with-receiver:annotation=com.my.SamWithReceiver
</option>
</pluginOptions>
</configuration>
<dependencies>
<dependency>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-maven-sam-with-receiver</artifactId>
<version>${kotlin.version}</version>
</dependency>
</dependencies>
</plugin>命令行编译器
将插件 JAR 文件添加到编译器插件类路径中,并指定 sam-with-receiver 注解列表:
bash
-Xplugin=$KOTLIN_HOME/lib/sam-with-receiver-compiler-plugin.jar
-P plugin:org.jetbrains.kotlin.samWithReceiver:annotation=com.my.SamWithReceiver