Skip to content

No-arg 컴파일러 플러그인 ​

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

생성된 생성자에는 HIDDEN 레벨의 @Deprecated 어노테이션이 적용되므로, Java에서는 호출할 수 있지만 Kotlin에서는 호출할 수 없습니다. 프레임워크는 리플렉션을 통해 이 생성자를 호출할 수 있습니다.

예를 들어 이를 통해 Java Persistence API(JPA)와 같은 프레임워크가 인자 없는 생성자를 선언하지 않은 Kotlin 클래스를 인스턴스화할 수 있습니다.

Kotlin에서 JPA 엔티티를 다룰 때는 kotlin-jpa 컴파일러 플러그인을 사용할 수 있습니다. 이 플러그인은 @Entity, @Embeddable, @MappedSuperclass와 같은 JPA 어노테이션을 자동으로 지정합니다.

어노테이션 선언 ​

no-arg 플러그인은 설정에 등록된 어노테이션이 지정된 클래스만 처리합니다. 따라서 플러그인을 활성화하기 전에 인자 없는 생성자가 필요한 클래스를 표시할 어노테이션을 선언하세요. 예를 들어 다음과 같이 NoArgAnnotation을 선언할 수 있습니다:

kotlin
package com.example

annotation class NoArgAnnotation

플러그인 적용 ​

Gradle ​

build.gradle(.kts) 파일의 plugins {} 블록에 no-arg 플러그인을 추가합니다:

kotlin
plugins {
    kotlin("jvm") version "2.4.21"  // 사용할 Kotlin 버전
    kotlin("plugin.noarg") version "2.4.21" // Kotlin no-arg 플러그인
}
groovy
plugins {
    id "org.jetbrains.kotlin.jvm" version "2.4.21"
    id "org.jetbrains.kotlin.plugin.noarg" version "2.4.21"
}

그런 다음 앞서 선언한 어노테이션(예: com.example.NoArgAnnotation)을 지정하여 해당 어노테이션이 붙은 클래스에 인자 없는 생성자를 생성하도록 설정합니다:

groovy
noArg {
    annotation("com.example.NoArgAnnotation")
}

생성된 생성자에서 클래스 초기화 로직을 실행하도록 하려면 invokeInitializers 옵션을 활성화하세요. 이 옵션은 기본적으로 비활성화되어 있습니다:

groovy
noArg {
    invokeInitializers = true
}

Maven ​

pom.xml 파일에 플러그인을 추가합니다:

xml
<properties>
    <kotlin.version>2.4.21</kotlin.version>
</properties>

<plugin>
    <artifactId>kotlin-maven-plugin</artifactId>
    <groupId>org.jetbrains.kotlin</groupId>
    <version>${kotlin.version}</version>

    <configuration>
        <compilerPlugins>
            <plugin>no-arg</plugin>
        </compilerPlugins>

        <pluginOptions>
            <option>no-arg:annotation=com.example.NoArgAnnotation</option>
            <!-- 생성된 생성자에서 인스턴스 초기화 블록 호출 -->
            <!-- <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>

no-arg 플러그인 사용 ​

플러그인이 적용되면 등록된 어노테이션이 지정된 클래스는 컴파일 시점에 인자 없는 생성자를 갖게 됩니다. 생성자를 직접 선언할 필요가 없습니다:

kotlin
package com.example

// no-arg 플러그인이 이 클래스에 대한 인자 없는 생성자를 생성합니다
@NoArgAnnotation
class MyEntity(val id: Int)

다음 단계 ​