No-arg 컴파일러 플러그인

no-arg 컴파일러 플러그인은 특정 어노테이션이 있는 클래스에 대해 인자 없는 생성자(zero-argument constructor)를 추가로 생성합니다.

생성된 생성자는 합성(synthetic)이므로 Java나 Kotlin에서 직접 호출할 수는 없지만, 리플렉션(reflection)을 사용하여 호출할 수 있습니다.

이를 통해 Java Persistence API (JPA)는 Kotlin 또는 Java 관점에서 인자 없는 생성자가 없더라도 클래스를 인스턴스화할 수 있습니다 (kotlin-jpa 플러그인에 대한 설명은 아래를 참조하세요).

Kotlin 파일에서

인자 없는 생성자가 필요한 코드를 표시하기 위해 새 어노테이션을 추가하세요.

package com.my

annotation class Annotation

Gradle

Gradle의 플러그인 DSL을 사용하여 플러그인을 추가합니다.

Kotlin

plugins {
    kotlin("plugin.noarg") version "2.1.21"
}

Groovy

plugins {
    id "org.jetbrains.kotlin.plugin.noarg" version "2.1.21"
}

그런 다음 어노테이션이 적용된 클래스에 대해 no-arg 생성자를 생성해야 하는 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 지원

all-open 위에 래핑된 kotlin-spring 플러그인과 마찬가지로, kotlin-jpa는 no-arg 위에 래핑됩니다. 이 플러그인은 @Entity, @Embeddable, 그리고 @MappedSuperclass no-arg 어노테이션을 자동으로 지정합니다.

Gradle 플러그인 DSL을 사용하여 플러그인을 추가합니다.

Kotlin

plugins {
    kotlin("plugin.jpa") version "2.1.21"
}

Groovy

plugins {
    id "org.jetbrains.kotlin.plugin.jpa" version "2.1.21"
}

Maven에서 jpa 플러그인을 활성화합니다.

<compilerPlugins>
    <plugin>jpa</plugin>
</compilerPlugins>

명령줄 컴파일러

플러그인 JAR 파일을 컴파일러 플러그인 클래스패스에 추가하고 어노테이션 또는 프리셋을 지정합니다.

-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