컴파일 과정과 Lombok 의 동작 원리

컴파일 과정에서 Lombok 동작 Flow

전체적인 흐름은 위와 같고, Lombok 은 컴파일 단계에서 Annotation Processing 에서 수행된다.

Lombok 동작 원리

1. javac 가 소스 파일을 파싱하여 AST(Abstract Syntax Tree, 추상 구문 트리) 를 만든다.

• 소스 파일 읽기
  • javac (자바 컴파일러)는 먼저 입력된 자바 소스 파일(.java 확장자를 가진 일반 텍스트 파일)을 읽는다.
• 파싱(Parsing)
  • 소스 파일을 읽은 후 javac 는 이를 구문 분석(parser) 를 통해 AST 로 변환한다.

       ASSIGN
      /      \
   VAR a      ADD
            /    \
         VAR b   CONST 5

2. Lombok 의 Annotation Processor 가 AST 를 수정하고 새로운 노드(소스 코드)를 추가한다.

• Annotation Processing
  • javac는 소스 코드를 컴파일하는 과정에서 어노테이션을 처리하기 위해서 Annotaion Processing 단계를 거친다. Lombok 은 이 과정에서 동작한다.
• Lombok 의 Annotation Processor
  • Lombok 은 자체적으로 제공하는 Annotation Processor 를 통해 AST 를 수정하고,
• Lombok 의 Annotation handler
  • Annotation handler 로 어노테이션에 따라 필요한 코드를 추가하고, 이로 인해 AST 가 다시 수정된다.
• AST 수정
  • Lombok 은 AST 에서 특정 위치를 찾아 노드를 추가하거나 기존 노드를 수정한다.
  • 예를 들어, @Getter 가 필드 private int age; 에 붙어 있으면, Lombok 은 해당 클래스의 AST 에 public int getAge() { return this.age; } 라는 메서드 노드를 삽입한다.

3. javac 는 Lombok 에 의해 수정된 AST 를 기반으로 Byte Code 를 생성한다.

Lombok 의 Annotation Processing 이 완료된 직후의 시점.

• Byte Code 생성
  • 수정된 AST 를 기반으로 javac 는 바이트 코드를 생성하고 .class 파일로 저장한다.
  • Lombok 에 의해 추가된 코드도 이 과정에서 바이트 코드로 변환된다

4. 컴파일 과정에서의 Annotation Processing 및 Syntax Tree 접근

• Annotation Processing 시작
  • 컴파일 과정에서 Enter 및 MemberEnter 단계가 완료된 후, Annotation Processing 이 시작되어 Lombok 이 AST 를 수정한다.
• Syntax Tree 접근
  • com.sun.source.tree.* 패키지를 통해 생성된 Syntax Tree 에 접근할 수 있다.
• Data Model
  • com.sun.tools.javac.code.* 패키지 내 클래스들은 자바 코드의 의미론적 정보를 제공하며, 이는 Enter, MemberEnter, Annotation Visitor 단계에서 생성된다.
• 컴파일러 재시작
• Annotation Processing 중에 새로운 파일이 생성될 경우, 컴파일이 재시작 될 수 있다.

컴파일 과정의 주요 단계

1. 준비 및 초기화

• 준비 프로세스
  • 컴파일러의 초기화 단계에서 플러그인 주석 프로세서가 초기화된다.

2. 구문 분석 (Parsing)

• Parse 단계
  • 자바 소스 파일을 읽고 구문 분석하여 토큰 시퀀스 결과를 추상 구문 트리(AST) 노드에 매핑한다.
  • Lexical Analysis: 문자 스트림을 토큰(심볼)으로 변환한다.
  • Parsing: 토큰 순서에 따라 추상 구문 트리를 구성하고, 이를 기반으로 후속 작업을 위한 구문 트리를 구축한다.

3. Enter 단계

• EnterTrees
  • 심볼 테이블을 채우는 과정으로, 클래스와 인터페이스의 기본 구조를 파악하고 심볼 테이블을 구축한다.
  • 첫 번째 단계: 모든 클래스를 해당 범위에 등록한다.
  • 두 번째 단계: 각 클래스 심볼의 MemberEnter 객체를 사용하여 클래스, 슈퍼 클래스, 인터페이스의 매개변수를 결정한다.

4. MemberEnter 단계

• 클래스 멤버 스캔
  • 각 클래스의 멤버들(필드, 메서드, 생성자 등)을 스캔하고, 이들에 대한 심볼 정보를 심볼 테이블에 등록한다.
  • 타입 체킹 및 상수 폴딩
  • 멤버들의 타입을 검증하고, 상수 값을 계산하여 최적화한다.

5. Annotation Visitor 및 Annotation Processing

• Annotate 단계
  • 어노테이션을 스캔하고, 어노테이션 프로세서를 호출하여 어노테이션이 지시하는 작업을 처리한다.
  • Annotation Processor: 어노테이션 프로세서가 동작하며, AST 를 수정하거나 새로운 코드를 삽입한다.

6. 의미 분석 (Semantic Analysis)

• Attribute 단계
  • 의미 분석을 통해 변수 선언, 타입 일치 여부 등을 확인하며, 상수 접기 작업이 이루어진다.
• Flow 단계
  • 데이터 및 제어 흐름 분석을 통해 프로그램의 논리를 검증한다.
  • 변수 사용 전 할당 여부, 메서드 경로에서의 반환 값 존재 여부, 예외 처리의 적절성 등을 확인한다.

7. Desugar

• Desugar 단계
  • 구문적 설탕(syntactic sugar)을 제거하고, 내부 클래스, 클래스 리터럴, 단언, foreach 루프 등을 처리하여 AST 를 재작성한다.

8. Generate

• Generate 단계
  • 바이트코드를 생성하고, 인스턴스 생성자 메서드(<init>)와 클래스 생성자 메서드(<clinit>)를 추가한다.
  • 문자열 추가 작업을 StringBuffer 나 StringBuilder 로 변환한다.

9. 바이트 코드 생성 및 출력

• 바이트 코드 생성 (Class Generation 단계)
  • javac 는 수정된 AST 를 바탕으로 .class 파일에 들어갈 바이트 코드를 생성한다.
• 출력 (Output)
  • 생성된 바이트 코드를 .class 파일로 저장하며, 이 .class 파일은 최종적으로 JVM 에 의해 실행된다.

Lombok 은 컴파일 과정의 Annotation Processing 단계에서 동작하여, 소스 코드에 대한 AST 를 수정하거나 필요한 코드를 자동 생성합니다. 이 수정된 AST 를 바탕으로 최종 바이트 코드가 생성되고, .class 파일로 출력됩니다.
위의 과정을 JavaCompiler 코드를 보면 아래와 같다. (코드보러가기)

public void compile(Collection<JavaFileObject> sourceFileObjects,
                    Collection<String> classnames,
                    Iterable<? extends Processor> processors,
                    Collection<String> addModules) {

    // 1. 준비 및 초기화 단계
    if (!taskListener.isEmpty()) {
        taskListener.started(new TaskEvent(TaskEvent.Kind.COMPILATION));
    }

    if (hasBeenUsed)
        checkReusable();
    hasBeenUsed = true;

    options.put(XLINT_CUSTOM.primaryName + "-" + LintCategory.OPTIONS.option, "true");
    options.remove(XLINT_CUSTOM.primaryName + LintCategory.OPTIONS.option);

    start_msec = now();

    try {
        // 5. Annotation Visitor 및 Annotation Processing 단계
        initProcessAnnotations(processors, sourceFileObjects, classnames);

        for (String className : classnames) {
            int sep = className.indexOf('/');
            if (sep != -1) {
                modules.addExtraAddModules(className.substring(0, sep));
            }
        }

        for (String moduleName : addModules) {
            modules.addExtraAddModules(moduleName);
        }

        // 2. 구문 분석 (Parsing) 단계
        processAnnotations(
            enterTrees(
                stopIfError(
                    CompileState.ENTER,
                    // 3. Enter 단계
                    initModules(
                        stopIfError(CompileState.ENTER, parseFiles(sourceFileObjects))
                    )
                )
            ),
            classnames
        );

        // 4. MemberEnter 단계
        if (taskListener.isEmpty() && implicitSourcePolicy == ImplicitSourcePolicy.NONE) {
            todo.retainFiles(inputFiles);
        }

        if (!CompileState.ATTR.isAfter(shouldStopPolicyIfNoError)) {
            switch (compilePolicy) {
                case SIMPLE:
                    // 6. 의미 분석 + 7. Desugar + 8. Generate
                    generate(desugar(flow(attribute(todo))));
                    break;

                case BY_FILE: {
                    Queue<Queue<Env<pre>>> q = todo.groupByFile();
                    while (!q.isEmpty() && !shouldStop(CompileState.ATTR)) {
                        generate(desugar(flow(attribute(q.remove()))));
                    }
                    break;
                }

                case BY_TODO:
                    while (!todo.isEmpty()) {
                        generate(desugar(flow(attribute(todo.remove()))));
                    }
                    break;

                default:
                    Assert.error("unknown compile policy");
            }
        }

    } catch (Abort ex) {
        if (devVerbose) {
            ex.printStackTrace(System.err);
        }
    } finally {
        if (verbose) {
            elapsed_msec = elapsed(start_msec);
            log.printVerbose("total", Long.toString(elapsed_msec));
        }

        reportDeferredDiagnostics();

        if (!log.hasDiagnosticListener()) {
            printCount("error", errorCount());
            printCount("warn", warningCount());
            printSuppressedCount(errorCount(), log.nsuppressederrors, "count.error.recompile");
            printSuppressedCount(warningCount(), log.nsuppressedwarns, "count.warn.recompile");
        }

        if (!taskListener.isEmpty()) {
            taskListener.finished(new TaskEvent(TaskEvent.Kind.COMPILATION));
        }

        // 8. Generate 및 바이트 코드 생성 후 정리
        close();

        if (procEnvImpl != null) {
            procEnvImpl.close();
        }
    }

    // 9. 바이트 코드 생성 및 출력 단계는 generate 메서드에서 수행됨
}

위와 같은 과정을 거쳐서 아래의 코드를 컴파일하면,

@Data
public class User {

    private String id;

    private String name;

}

아래와 같은 결과가 나온다.

public class User {
    private String id;
    private String name;

    @Generated
    public User() {
    }

    @Generated
    public String getId() {
        return this.id;
    }

    @Generated
    public String getName() {
        return this.name;
    }

    @Generated
    public void setId(final String id) {
        this.id = id;
    }

    @Generated
    public void setName(final String name) {
        this.name = name;
    }

    @Generated
    public boolean equals(final Object o) {
        if (o == this) {
            return true;
        } else if (!(o instanceof User)) {
            return false;
        } else {
            User other = (User)o;
            if (!other.canEqual(this)) {
                return false;
            } else {
                Object this$id = this.getId();
                Object other$id = other.getId();
                if (this$id == null) {
                    if (other$id != null) {
                        return false;
                    }
                } else if (!this$id.equals(other$id)) {
                   return false;
                }

                Object this$name = this.getName();
                Object other$name = other.getName();
                if (this$name == null) {
                    if (other$name != null) {
                        return false;
                    }
                } else if (!this$name.equals(other$name)) {
                    return false;
                }

                return true;
            }
        }
    }

    @Generated
    protected boolean canEqual(final Object other) {
        return other instanceof User;
    }

    @Generated
    public int hashCode() {
        int PRIME = true;
        int result = 1;
        Object $id = this.getId();
        result = result * 59 + ($id == null ? 43 : $id.hashCode());
        Object $name = this.getName();
        result = result * 59 + ($name == null ? 43 : $name.hashCode());
        return result;
    }

    @Generated
    public String toString() {
    String var10000 = this.getId();
        return "User(id=" + var10000 + ", name=" + this.getName() + ")";
    }
}

📚 Reference

• Lombok은 어떻게 동작되나? 간단정리
• 10 minutes to teach you how to hack the Java compiler