相信大家在項目中都使用過Lombok,因爲能夠簡化我們許多的代碼,但是該有的功能一點也不少。
那麼lombok到底是個什麼呢,lombok是一個可以通過簡單的註解的形式來幫助我們簡化消除一些必須有但顯得很臃腫的 Java 代碼的工具,簡單來說,比如我們新建了一個類,然後在其中寫了幾個字段,然後通常情況下我們需要手動去建立getter和setter方法啊,構造函數啊之類的,lombok的作用就是爲了省去我們手動創建這些代碼的麻煩,它能夠在我們編譯源碼的時候自動幫我們生成這些方法。
那麼Lombok到底是如何做到這些的呢?其實底層就是用到了編譯時註解的功能。
Lombok如何使用
Lombok是一個開源項目,代碼是在lombok中,如果是gradle項目的話直接在項目中引用如下即可。
compile ("org.projectlombok:lombok:1.16.6")
功能
那麼Lombok是做什麼呢?其實很簡單,一個最簡單的例子就是能夠通過添加註解自動生成一些方法,使我們代碼更加簡潔易懂。例如下面一個類。
1 @Data
2 public class TestLombok {
3 private String name;
4 private Integer age;
5
6 public static void main(String[] args) {
7 TestLombok testLombok = new TestLombok();
8 testLombok.setAge(12);
9 testLombok.setName("zs");
10 }
11 }
我們使用Lombok提供的Data
註解,在沒有寫get、set
方法的時候也能夠使用其get、set
方法。我們看它編譯過後的class
文件,可以看到它給我們自動生成了get、set
方法。
1 public class TestLombok {
2 private String name;
3 private Integer age;
4
5 public static void main(String[] args) {
6 TestLombok testLombok = new TestLombok();
7 testLombok.setAge(12);
8 testLombok.setName("zs");
9 }
10
11 public TestLombok() {
12 }
13
14 public String getName() {
15 return this.name;
16 }
17
18 public Integer getAge() {
19 return this.age;
20 }
21
22 public void setName(String name) {
23 this.name = name;
24 }
25
26 public void setAge(Integer age) {
27 this.age = age;
28 }
29
30}
當然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
是如何修改已存在的類中的屬性的。
定義註解
首先當然我們需要定義自己的註解了
1 @Retention(RetentionPolicy.SOURCE)
2 @Target(ElementType.TYPE)
3 public @interface GeneratePrint {
4
5 String value();
6 }
Retention
註解上面有一個屬性value,它是RetentionPolicy
類型的枚舉類,RetentionPolicy
枚舉類中有三個值。
1 public enum RetentionPolicy {
2
3 SOURCE,
4
5 CLASS,
6
7 RUNTIME
8 }
-
SOURCE
修飾的註解:修飾的註解,表示註解的信息會被編譯器拋棄,不會留在class文件中,註解的信息只會留在源文件中 -
CLASS
修飾的註解:表示註解的信息被保留在class文件(字節碼文件)中當程序編譯時,但不會被虛擬機讀取在運行的時候 -
RUNTIME
修飾的註解:表示註解的信息被保留在class文件(字節碼文件)中當程序編譯時,會被虛擬機保留在運行時。所以它能夠通過反射調用,所以正常運行時註解都是使用的這個參數
Target
註解上面也有個屬性value,它是ElementType
類型的枚舉。是用來修飾此註解作用在哪的。
1 public enum ElementType {
2 TYPE,
3
4 FIELD,
5
6 METHOD,
7
8 PARAMETER,
9
10 CONSTRUCTOR,
11
12 LOCAL_VARIABLE,
13
14 ANNOTATION_TYPE,
15
16 PACKAGE,
17
18 TYPE_PARAMETER,
19
20 TYPE_USE
21 }
定義註解處理器
我們要定義註解處理器的話,那麼就需要繼承AbstractProcessor
類。繼承完以後基本的框架類型如下
1 @SupportedSourceVersion(SourceVersion.RELEASE_8)
2 @SupportedAnnotationTypes("aboutjava.annotion.MyGetter")
3 public class MyGetterProcessor extends AbstractProcessor {
4 @Override
5 public synchronized void init(ProcessingEnvironment processingEnv) {
6 super.init(processingEnv);
7 }
8
9 @Override
10 public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
11 return true;
12 }
13 }
我們可以看到在子類中上面有兩個註解,註解描述如下
-
@SupportedSourceVersion
:表示所支持的Java版本 -
@SupportedAnnotationTypes
:表示該處理器要處理的註解
繼承了父類的兩個方法,方法描述如下
-
init方法:主要是獲得編譯時期的一些環境信息
-
process方法:在編譯時,編譯器執行的方法。也就是我們寫具體邏輯的地方
我們是演示一下如何通過繼承AbstractProcessor
類來實現在編譯時生成類,所以我們在process
方法中書寫我們生成類的代碼。如下所示。
1 @Override
2 public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
3 StringBuilder builder = new StringBuilder()
4 .append("package aboutjava.annotion;\n\n")
5 .append("public class GeneratedClass {\n\n")
6 .append("\tpublic String getMessage() {\n")
7 .append("\t\treturn \"");
8
9 for (Element element : roundEnv.getElementsAnnotatedWith(MyGetter.class)) {
10 String objectType = element.getSimpleName().toString();
11
12 builder.append(objectType).append(" says hello!\\n");
13 }
14 builder.append("\";\n")
15 .append("\t}\n")
16 .append("}\n");
17 try {
18 JavaFileObject source = processingEnv.getFiler().createSourceFile("aboutjava.annotion.GeneratedClass");
19 Writer writer = source.openWriter();
20 writer.write(builder.toString());
21 writer.flush();
22 writer.close();
23 } catch (IOException e) {
24
25
26 }
27 return true;
28 }
定義使用註解的類(測試類)
上面的兩個類就是基本的工具類了,一個是定義了註解,一個是定義了註解處理器,接下來我們來定義一個測試類(TestAno.java)。我們在類上面加上我們自定的註解類。
1 @MyGetter
2 public class TestAno {
3
4 public static void main(String[] args) {
5 System.out.printf("1");
6 }
7 }
這樣我們在編譯期就能生成文件了,接下來演示一下在編譯時生成文件,此時不要着急直接進行javac編譯,MyGetter
類是註解類沒錯,而MyGetterProcessor
是註解類的處理器,那麼我們在編譯TestAno
Java文件的時候就會觸發處理器。因此這兩個類是無法一起編譯的。
先給大家看一下我的目錄結構
aboutjava2
-- annotion3
-- MyGetter.java4
-- MyGetterProcessor.java5
-- TestAno.java
所以我們先將註解類和註解處理器類進行編譯
javac aboutjava/annotion/MyGett*
接下來進行編譯我們的測試類,此時在編譯時需要加上processor
參數,用來指定相關的註解處理類。
javac -processor aboutjava.annotion.MyGetterProcessor aboutjava/annotion/TestAno.java
大家可以看到動態圖中,自動生成了Java文件。
獲取更多精彩內容,請關注我的個人微信公衆號【程序員Style】,瞭解更多知識。關注回覆“666”即可獲取學習資料。