No-arg 编译器插件

最终更新: 2025/02/06

对带有指定注解的类, 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.1.0"
}

然后指定 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.1.0"
}

在 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