Lombok常常用，可是你知道它的原理是什麼嗎？

相信你們在項目中都使用過Lombok，由於可以簡化咱們許多的代碼，可是該有的功能一點也很多。那麼lombok究竟是個什麼呢，lombok是一個能夠經過簡單的註解的形式來幫助咱們簡化消除一些必須有但顯得很臃腫的 Java 代碼的工具，簡單來講，好比咱們新建了一個類，而後在其中寫了幾個字段，而後一般狀況下咱們須要手動去創建getter和setter方法啊，構造函數啊之類的，lombok的做用就是爲了省去咱們手動建立這些代碼的麻煩，它可以在咱們編譯源碼的時候自動幫咱們生成這些方法。

那麼Lombok究竟是如何作到這些的呢？其實底層就是用到了編譯時註解的功能。

Lombok如何使用

Lombok是一個開源項目，代碼是在lombok中，若是是gradle項目的話直接在項目中引用以下便可。

compile ("org.projectlombok:lombok:1.16.6")

功能

那麼Lombok是作什麼呢？其實很簡單，一個最簡單的例子就是可以經過添加註解自動生成一些方法，使咱們代碼更加簡潔易懂。例以下面一個類。

@Data
public class TestLombok {
    private String name;
    private Integer age;

    public static void main(String[] args) {
        TestLombok testLombok = new TestLombok();
        testLombok.setAge(12);
        testLombok.setName("zs");
    }
}

咱們使用Lombok提供的Data註解，在沒有寫get、set方法的時候也可以使用其get、set方法。咱們看它編譯事後的class文件，能夠看到它給咱們自動生成了get、set方法。

public class TestLombok {
    private String name;
    private Integer age;

    public static void main(String[] args) {
        TestLombok testLombok = new TestLombok();
        testLombok.setAge(12);
        testLombok.setName("zs");
    }

    public TestLombok() {
    }

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

    public Integer getAge() {
        return this.age;
    }

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

    public void setAge(Integer age) {
        this.age = age;
    }

}

固然Lombok的功能不止如此，還有不少其餘的註解幫助咱們簡便開發，網上有許多的關於Lombok的使用方法，這裏就再也不囉嗦了。正常狀況下咱們在項目中自定義註解，或者使用Spring框架中@Controller、@Service等等這類註解都是運行時註解，運行時註解大部分都是經過反射來實現的。而Lombok是使用編譯時註解實現的。那麼編譯時註解是什麼呢？

編譯時註解

> 註解（也被成爲元數據）爲咱們在代碼中添加信息提供了一種形式化的方法，使咱們能夠在稍後某個時刻很是方便地使用這些數據。 ——————摘自《Thinking in Java》

Java中的註解分爲運行時註解和編譯時註解，運行時註解就是咱們常用的在程序運行時經過反射獲得咱們註解的信息，而後再作一些操做。而編譯時註解是什麼呢？就是在程序在編譯期間經過註解處理器進行處理。

• 編譯期：Java語言的編譯期是一段不肯定的操做過程，由於它多是將*.java文件轉化成*.class文件的過程；也多是指將字節碼轉變成機器碼的過程；還多是直接將*.java編譯成本地機器代碼的過程
• 運行期：從JVM加載字節碼文件到內存中，到最後使用完畢之後卸載的過程都屬於運行期的範疇。

註解處理工具apt

> 註解處理工具apt(Annotation Processing Tool)，這是Sun爲了幫助註解的處理過程而提供的工具，apt被設計爲操做Java源文件，而不是編譯後的類。

它是javac的一個工具，中文意思爲編譯時註解處理器。APT能夠用來在編譯時掃描和處理註解。經過APT能夠獲取到註解和被註解對象的相關信息，在拿到這些信息後咱們能夠根據需求來自動的生成一些代碼，省去了手動編寫。注意，獲取註解及生成代碼都是在代碼編譯時候完成的，相比反射在運行時處理註解大大提升了程序性能。APT的核心是AbstractProcessor類。

正常狀況下使用APT工具只是可以生成一些文件(不只僅是咱們想象的class文件，還包括xml文件等等之類的)，並不能修改原有的文件信息。

可是此時估計會有疑問，那麼Lombok不就是在咱們原有的文件中新增了一些信息嗎？我在後面會有詳細的解釋，這裏簡單介紹一下，其實Lombok是修改了Java中的**抽象語法樹AST**才作到了修改其原有類的信息。

接下來咱們演示一下如何用APT工具生成一個class文件，而後咱們再說Lombok是如何修改已存在的類中的屬性的。

定義註解

首先固然咱們須要定義本身的註解了

@Retention(RetentionPolicy.SOURCE) // 註解只在源碼中保留
@Target(ElementType.TYPE) // 用於修飾類
public @interface GeneratePrint {

    String value();
}

Retention 註解上面有一個屬性value，它是RetentionPolicy類型的枚舉類，RetentionPolicy枚舉類中有三個值。

public enum RetentionPolicy {

    SOURCE,

    CLASS,

    RUNTIME
}

• SOURCE 修飾的註解：修飾的註解,表示註解的信息會被編譯器拋棄，不會留在class文件中，註解的信息只會留在源文件中
• CLASS 修飾的註解：表示註解的信息被保留在class文件(字節碼文件)中當程序編譯時，但不會被虛擬機讀取在運行的時候
• RUNTIME 修飾的註解：表示註解的信息被保留在class文件(字節碼文件)中當程序編譯時，會被虛擬機保留在運行時。因此它可以經過反射調用，因此正常運行時註解都是使用的這個參數

Target 註解上面也有個屬性value，它是ElementType類型的枚舉。是用來修飾此註解做用在哪的。

public enum ElementType {
    TYPE,

    FIELD,

    METHOD,

    PARAMETER,

    CONSTRUCTOR,

    LOCAL_VARIABLE,

    ANNOTATION_TYPE,

    PACKAGE,

    TYPE_PARAMETER,

    TYPE_USE
}

定義註解處理器

咱們要定義註解處理器的話，那麼就須要繼承AbstractProcessor 類。繼承完之後基本的框架類型以下

@SupportedSourceVersion(SourceVersion.RELEASE_8)
@SupportedAnnotationTypes("aboutjava.annotion.MyGetter")
public class MyGetterProcessor extends AbstractProcessor {
    @Override
    public synchronized void init(ProcessingEnvironment processingEnv) {
	super.init(processingEnv);
    }

    @Override
    public boolean process(Set<!--? extends TypeElement--> annotations, RoundEnvironment roundEnv) {
        return true;
    }
}

咱們能夠看到在子類中上面有兩個註解，註解描述以下

• @SupportedSourceVersion ：表示所支持的Java版本
• @SupportedAnnotationTypes ：表示該處理器要處理的註解

繼承了父類的兩個方法，方法描述以下

• init方法：主要是得到編譯時期的一些環境信息
• process方法：在編譯時，編譯器執行的方法。也就是咱們寫具體邏輯的地方

咱們是演示一下如何經過繼承AbstractProcessor 類來實如今編譯時生成類，因此咱們在process方法中書寫咱們生成類的代碼。以下所示。

@Override
public boolean process(Set<!--? extends TypeElement--> annotations, RoundEnvironment roundEnv) {
    StringBuilder builder = new StringBuilder()
            .append("package aboutjava.annotion;\n\n")
            .append("public class GeneratedClass {\n\n") // open class
            .append("\tpublic String getMessage() {\n") // open method
            .append("\t\treturn \"");
    // for each javax.lang.model.element.Element annotated with the CustomAnnotation
    for (Element element : roundEnv.getElementsAnnotatedWith(MyGetter.class)) {
        String objectType = element.getSimpleName().toString();
        // this is appending to the return statement
        builder.append(objectType).append(" says hello!\\n");
    }
    builder.append("\";\n") // end return
            .append("\t}\n") // close method
            .append("}\n"); // close class
    try { // write the file
        JavaFileObject source = processingEnv.getFiler().createSourceFile("aboutjava.annotion.GeneratedClass");
        Writer writer = source.openWriter();
        writer.write(builder.toString());
        writer.flush();
        writer.close();
    } catch (IOException e) {
        // Note: calling e.printStackTrace() will print IO errors
        // that occur from the file already existing after its first run, this is normal
    }
    return true;
}

定義使用註解的類(測試類)

上面的兩個類就是基本的工具類了，一個是定義了註解，一個是定義了註解處理器，接下來咱們來定義一個測試類(TestAno.java)。咱們在類上面加上咱們自定的註解類。

@MyGetter
public class TestAno {

    public static void main(String[] args) {
        System.out.printf("1");
    }
}

這樣咱們在編譯期就能生成文件了，接下來演示一下在編譯時生成文件，此時不要着急直接進行javac編譯，MyGetter類是註解類沒錯，而MyGetterProcessor是註解類的處理器，那麼咱們在編譯TestAno Java文件的時候就會觸發處理器。所以這兩個類是沒法一塊兒編譯的。

先給你們看一下個人目錄結構

aboutjava
	-- annotion
		-- MyGetter.java
		-- MyGetterProcessor.java
		-- TestAno.java

因此咱們先將註解類和註解處理器類進行編譯

javac aboutjava/annotion/MyGett*

接下來進行編譯咱們的測試類，此時在編譯時須要加上processor參數，用來指定相關的註解處理類。

javac -processor aboutjava.annotion.MyGetterProcessor aboutjava/annotion/TestAno.java

你們能夠看到動態圖中，自動生成了Java文件。

代碼地址

總結

本篇文章還會有第二篇進行講解Lombok的原理，如何修改原有類的內容。本篇做爲前置知識，簡單的介紹了註解處理器是什麼，如何利用註解處理器作一些咱們在編譯期纔可以作的事情。但願你們可以本身在本機上試驗一下，若是本篇有任何問題歡迎指出。

參考

• 萬能的APT！編譯時註解的妙用
• Compile time processing using annotation processor
• Java Annotation Processing and Creating a Builder
• Lombok原理分析與功能實現
• java註解處理器——在編譯期修改語法樹
• AOP 最後一塊拼圖 | AST 抽象語法樹 —— 最輕量級的AOP方法
• Java Annotation Processing and Creating a Builder
• Java抽象語法樹AST淺析與使用