No-arg 编译器插件
对带有指定注解的类, no-arg 编译器插件会为它生成一个额外的无参数构造器.
生成的构造器是合成的(Synthetic), 因此不能在 Java 或 Kotlin 代码中直接调用, 但可以使用反射调用.
这个功能使得 Java Persistence API (JPA) 可以创建类的实例, 即使从 Kotlin 或 Java 的观点看, 它并没有无参数的构造器 (参见 下文 关于 kotlin-jpa
插件的介绍).
在你的 Kotlin 文件中
添加新的注解, 用来标注那些需要无参数构造器的代码:
package com.my
annotation class Annotation
Gradle
添加插件, 并指定需要为类生成无参数构造器的注解.
plugins {
kotlin("plugin.noarg") version "2.0.21"
}
plugins {
id "org.jetbrains.kotlin.plugin.noarg" version "2.0.21"
}
然后指定 no-arg 注解:
noArg {
annotation("com.my.Annotation")
}
如果你希望插件在合成的(Synthetic)构造器中执行初始化逻辑, 请打开 invokeInitializers
选项. 这个选项默认关闭.
noArg {
invokeInitializers = true
}
Maven
<plugin>
<artifactId>kotlin-maven-plugin</artifactId>
<groupId>org.jetbrains.kotlin</groupId>
<version>${kotlin.version}</version>
<configuration>
<compilerPlugins>
<!-- 对 JPA 的情况请使用 "jpa" 插件 -->
<plugin>no-arg</plugin>
</compilerPlugins>
<pluginOptions>
<option>no-arg:annotation=com.my.Annotation</option>
<!-- 在合成的(Synthetic)构造器中调用实例的初始化代码 -->
<!-- <option>no-arg:invokeInitializers=true</option> -->
</pluginOptions>
</configuration>
<dependencies>
<dependency>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-maven-noarg</artifactId>
<version>${kotlin.version}</version>
</dependency>
</dependencies>
</plugin>
JPA 支持
和 kotlin-spring
插件封装了 all-open
一样, kotlin-jpa
也是 no-arg
的上层封装. 这个插件自动指定 no-arg 注解为 @Entity
, @Embeddable
, 和 @MappedSuperclass
.
在 Gradle 中添加这个插件的方法如下:
plugins {
kotlin("plugin.jpa") version "2.0.21"
}
plugins {
id "org.jetbrains.kotlin.plugin.jpa" version "2.0.21"
}
在 Maven 中, 启用 jpa
插件:
<compilerPlugins>
<plugin>jpa</plugin>
</compilerPlugins>
命令行编译器
将插件的 JAR 文件添加到编译器的插件 classpath, 并指定需要处理的注解, 或使用预设定(preset):
-Xplugin=$KOTLIN_HOME/lib/noarg-compiler-plugin.jar
-P plugin:org.jetbrains.kotlin.noarg:annotation=com.my.Annotation
-P plugin:org.jetbrains.kotlin.noarg:preset=jpa
最终更新: 2024/11/17