Lombok Annotation Processor 의존성을 추가한 이유
레벨 3 해커톤 중 에러를 마주쳤습니다.
잘만 동작하던 코드였는데, 갑자기 컴파일에 실패했습니다. @Getter를 사용한 코드들에서 메서드를 찾을 수 없다는 에러였는데요.
해당 에러를 해결하기 위해서는 Lombok Annotation Processor에 대한 의존성을 추가했습니다.
이 의존성은 무엇이고 왜 추가해야 하는지 알아봅시다!
Lombok Annotation Processor에 대해 알기 전에 Annotation Processor에 대해 알아보아야 할 것 같은데요.
Annotation Processor는 Java 소스 코드나 컴파일된 클래스에서 말 그대로, 애노테이션을 처리하는 도구입니다.
컴파일러는 소스 코드에서 애노테이션을 발견하면 해당 애노테이션을 처리할 Annotation Processor를 찾아 활성화합니다.
자바에서는 Java 6부터 도입된 Annotation Processing API를 통해 Annotation Processor를 제공합니다.
Processor 인터페이스를 보면, 애노테이션 프로세서를 위한 인터페이스로 컴파일 시 애노테이션을 처리하는 역할을 합니다.
Processor는 어노테이션을 여러 라운드에 걸쳐 다음과 같이 처리합니다.
- 각 라운드에서 애노테이션 프로세서가 실행되고, 그 과정에서 새로운 소스 파일을 생성할 수 있습니다.
- 새로운 소스 파일이 생성되면 다음 라운드가 시작됩니다.
- 더 이상 새로운 소스 파일이 생성되지 않으면 처리가 종료됩니다.
- 자바 Annotation Processing API 사용방법
내가 직접 생성한 Annotation을 다른 방식으로 처리하고 싶다라면 AbstractProcessor 클래스를 상속하여 Annotation Processor를 직접 구현하면 됩니다.
다시 롬복으로 돌아와서, Lombok은 다들 아시다 싶이 반복적인 보일러 플레이트 코드 (ex. getter)를 Annotation 형태로 사용할 수 있게 해주는 라이브러리인데요.
앞의 내용을 토대로 Lombok Annotation Processor가 무엇인지 유추할 수 있습니다. 바로 Lombok 어노테이션에 대한 Annotation Processor 라는 것인데요.
Annotation Processor를 주입해줘야 하는만큼 Lombok의 Annotation Processor은 보통의 자바 Annotation Processor과 조금 다르게 동작합니다.
그래서 의존성을 굳이 추가해주어야 하는 것이죠!
그러면 추가한 Lombok의 Annotation Processor이 무슨 일을 해주는지 알기 전에 여기서 알아야 할 하나의 개념이 또 있습니다 !
바로 Abstract syntax tree인데요.
Syntax tree는 Parse Tree라고도 불리는데요.
Parse Tree 즉, 구문 분석 트리는 프로그래밍 언어나 자연어의 문장 구조를 나타내는 트리 구조입니다. 주로 컴파일러 설계와 자연어 처리에서 사용되며 소스 코드의 모든 구문적 세부 사항을 포함합니다.
AST는 즉, abstract syntax tree란 위의 syntax tree를 추상화한 트리입니다.
AST는 Parse Tree보다 추상화된 형태로, 불필요한 구문적 세부사항을 제거합니다.
때문에 코드의 구조를 더 명확하게 표현하며, 코드 분석과 변환에 용이합니다.
다시 돌아와서, Lombok Annotation Processor는 AST를 조작하는 방식으로 작동합니다.
전체 과정을 살펴보면 다음과 같습니다.
- Lombok Processor는 AST를 순회하며 롬복 애노테이션(@Getter, @Setter 등)을 찾습니다.
- 각 애노테이션에 대응하는 핸들러를 호출합니다. 각 핸들러는 AST를 분석하고 필요한 코드를 생성합니다.
- 예를 들어, @Getter 애노테이션을 만나면 GetterHandler가 getter 메서드에 해당하는 AST 노드를 생성합니다.
- 생성된 AST 노드를 기존 AST에 주입합니다.
- 이때 롬복은 자바 컴파일러의 내부 API를 사용하여 AST를 직접 수정합니다.
- 수정된 AST 컴파일
- 롬복에 의해 수정된 AST를 기반으로 자바 컴파일러가 바이트코드를 생성합니다.
- 컴파일된 클래스 파일에는 롬복이 생성한 메서드가 포함됩니다. 원본 소스 코드는 변경되지 않지만, 컴파일된 결과물에는 추가된 코드가 반영됩니다.
이렇게 롬복이 어떻게 동작하는지 알아보았습니다.
정리하면, Lombok 어노테이션을 사용할 때, 해당 어노테이션 처리를 해주는 Lombok Annotation Processor가 필요하고 그 Processor는 AST를 조작하여 컴파일 전에 개발자가 작성하지 않는 코드를 추가시켜준다라고 아시면 좋을 것 같습니다 !