Open AIDoc

한국어

简体中文
繁體中文
日本語

한국어

简体中文
繁體中文
日本語

Appearance

All-open 컴파일러 플러그인 ​

코틀린의 클래스와 멤버는 기본적으로 final입니다. 이는 클래스가 open이어야 하는 Spring AOP와 같은 프레임워크나 라이브러리를 사용할 때 불편함을 초래합니다. all-open 컴파일러 플러그인은 코틀린을 이러한 프레임워크의 요구 사항에 맞게 조정하며, 특정 어노테이션이 지정된 클래스와 그 멤버를 명시적인 open 키워드 없이도 open 상태로 만들어 줍니다.

예를 들어 Spring을 사용하는 경우, 모든 클래스를 open으로 만들 필요는 없으며 @Configuration이나 @Service와 같은 특정 어노테이션이 지정된 클래스만 필요합니다. all-open 플러그인을 사용하면 이러한 어노테이션을 지정할 수 있습니다.

코틀린은 Gradle과 Maven 모두에 대해 완전한 IDE 통합과 함께 all-open 플러그인 지원을 제공합니다.

Spring의 경우, kotlin-spring 컴파일러 플러그인을 사용할 수 있습니다.

Gradle ​

build.gradle(.kts) 파일에 플러그인을 추가합니다:

kotlin
plugins {
    kotlin("plugin.allopen") version "2.3.0"
}
groovy
plugins {
    id "org.jetbrains.kotlin.plugin.allopen" version "2.3.0"
}

그 다음 클래스를 open으로 만들 어노테이션 목록을 지정합니다:

kotlin
allOpen {
    annotation("com.my.Annotation")
    // annotations("com.another.Annotation", "com.third.Annotation")
}
groovy
allOpen {
    annotation("com.my.Annotation")
    // annotations("com.another.Annotation", "com.third.Annotation")
}

클래스(또는 상위 클래스 중 어느 하나라도)에 com.my.Annotation이 지정되어 있으면, 해당 클래스 자체와 모든 멤버가 open이 됩니다.

또한 메타 어노테이션에서도 작동합니다:

kotlin
@com.my.Annotation
annotation class MyFrameworkAnnotation

@MyFrameworkAnnotation
class MyClass // all-open이 됩니다

MyFrameworkAnnotation은 all-open 메타 어노테이션인 com.my.Annotation으로 어노테이션되어 있으므로, 이 또한 all-open 어노테이션이 됩니다.

Maven ​

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

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

    <configuration>
        <compilerPlugins>
            <!-- 또는 Spring 지원을 위해 "spring" 사용 -->
            <plugin>all-open</plugin>
        </compilerPlugins>

        <pluginOptions>
            <!-- 각 어노테이션은 별도의 라인에 배치됩니다 -->
            <option>all-open:annotation=com.my.Annotation</option>
            <option>all-open:annotation=com.their.AnotherAnnotation</option>
        </pluginOptions>
    </configuration>

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

all-open 어노테이션이 작동하는 방식에 대한 자세한 정보는 Gradle 섹션을 참조하십시오.

Spring 지원 ​

Spring을 사용하는 경우 Spring 어노테이션을 수동으로 지정하는 대신 kotlin-spring 컴파일러 플러그인을 활성화할 수 있습니다. kotlin-spring은 all-open 위에 구축된 래퍼(wrapper)이며, 정확히 동일하게 작동합니다.

build.gradle(.kts) 파일에 spring 플러그인을 추가합니다:

kotlin
plugins {
    id("org.jetbrains.kotlin.plugin.spring") version "2.3.0"
}
groovy
plugins {
    id "org.jetbrains.kotlin.plugin.spring" version "2.3.0"
}

Maven에서 spring 플러그인은 kotlin-maven-allopen 플러그인 의존성을 통해 제공되므로, pom.xml 파일에서 다음과 같이 활성화할 수 있습니다:

xml
<compilerPlugins>
    <plugin>spring</plugin>
</compilerPlugins>

<dependencies>
    <dependency>
        <groupId>org.jetbrains.kotlin</groupId>
        <artifactId>kotlin-maven-allopen</artifactId>
        <version>${kotlin.version}</version>
    </dependency>
</dependencies>

이 플러그인은 다음 어노테이션들을 지정합니다:

메타 어노테이션 지원 덕분에 @Configuration, @Controller, @RestController, @Service 또는 @Repository가 지정된 클래스들은 이러한 어노테이션들이 @Component로 메타 어노테이션되어 있기 때문에 자동으로 open됩니다.

물론 동일한 프로젝트에서 kotlin-allopen과 kotlin-spring을 모두 사용할 수 있습니다.

start.spring.io 서비스를 통해 프로젝트 템플릿을 생성하면 kotlin-spring 플러그인이 기본적으로 활성화됩니다.

명령줄 컴파일러 ​

All-open 컴파일러 플러그인 JAR은 코틀린 컴파일러의 바이너리 배포판에 포함되어 있습니다. kotlinc 옵션인 -Xplugin을 사용하여 JAR 파일 경로를 제공함으로써 플러그인을 연결할 수 있습니다:

bash
-Xplugin=$KOTLIN_HOME/lib/allopen-compiler-plugin.jar

annotation 플러그인 옵션을 사용하여 all-open 어노테이션을 직접 지정하거나, _프리셋(preset)_을 활성화할 수 있습니다:

bash
# 플러그인 옵션 형식: "-P plugin:<plugin id>:<key>=<value>". 
# 옵션은 반복해서 사용할 수 있습니다.

-P plugin:org.jetbrains.kotlin.allopen:annotation=com.my.Annotation
-P plugin:org.jetbrains.kotlin.allopen:preset=spring

all-open 플러그인에서 사용 가능한 프리셋은 spring, micronaut, quarkus입니다.

Copyright © 2026 Open AIDoc.