No-arg 컴파일러 플러그인

No-arg 컴파일러 플러그인

no-arg 컴파일러 플러그인은 특정 애너테이션이 붙은 클래스에 대해 인자 없는 생성자(zero-argument constructor)를 추가로 생성해 줘요. 클래스 자체는 건드리지 않고, 빌드 과정에서 합성 생성자만 보태는 방식이에요.

출처: No-arg compiler plugin

본문

이렇게 생성된 생성자는 **합성(synthetic)**이라서 Java나 Kotlin에서 직접 호출할 수는 없어요. 다만 **리플렉션(reflection)**으로는 호출할 수 있어요.

그 덕분에 Java Persistence API(JPA) 같은 쪽에서, Kotlin이나 Java 관점에서는 인자 없는 생성자가 없음에도 클래스를 인스턴스화할 수 있게 돼요. (아래의 kotlin-jpa 플러그인 설명을 참고하세요.)

Kotlin 파일에서

인자 없는 생성자가 필요한 코드를 표시할 새 애너테이션을 추가해요.

Gradle

Gradle의 plugins DSL로 플러그인을 추가해요.

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

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

그런 다음, 애너테이션이 붙은 클래스에 대해 no-arg 생성자를 생성하게 만들 no-arg 애너테이션 목록을 지정해요.

noArg {
    annotation("com.my.Annotation")
}

합성 생성자에서 초기화 로직을 실행하게 하려면 invokeInitializers 옵션을 켜요. 기본적으로는 꺼져 있어요.

Maven

Maven에서는 유사하게 설정해요. (이어지는 JPA 지원에서 예시를 확인할 수 있어요.)

JPA 지원

kotlin-spring 플러그인이 all-open 위에 감싸져 있듯이, kotlin-jpa는 no-arg 위에 감싸져 있어요. 이 플러그인은 @Entity, @Embeddable, @MappedSuperclass no-arg 애너테이션을 자동으로 지정해 줘요.

플러그인을 Gradle plugins DSL로 추가해요.

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

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

Maven에서는 jpa 플러그인을 활성화해요.

커맨드라인 컴파일러

플러그인 JAR 파일을 컴파일러 플러그인 클래스패스에 추가하고 애너테이션이나 프리셋을 지정해요.

더 알아보기

  • all-open 컴파일러 플러그인
  • Kotlin Gradle 플러그인의 컴파일러 플러그인 사용법