Java使用lombok消除冗余代碼的方法步驟
一、項目背景
在寫Java程序的時候經常會遇到如下情形:
新建了一個Class類,然后在其中設置了幾個字段,最后還需要花費很多時間來建立getter和setter方法。
lombok項目的產生就是為了省去我們手動創建getter和setter方法的麻煩,它能夠在我們編譯源碼的時候自動幫我們生成getter和setter方法。即它最終能夠達到的效果是:在源碼中沒有getter和setter方法,但是在編譯生成的字節碼文件中有getter和setter方法。
比如源碼文件:
import java.io.Serializable; import lombok.Data; @Data public class BasicClusterInfo implements Serializable { private static final long serialVersionUID = 3478135817352393604L; private String hbaseKey; private intreceiverCount; }
以下是編譯上述源碼文件得到的字節碼文件,對其反編譯得到的結果
public class BasicClusterInfo extends java.lang.Object implements java.io.Serializable{ public BasicClusterInfo(); public java.lang.String getHbaseKey(); public int getReceiverCount(); public void setHbaseKey(java.lang.String); public void setReceiverCount(int); public boolean equals(java.lang.Object); public boolean canEqual(java.lang.Object); public int hashCode(); public java.lang.String toString(); }
二、eclipse安裝lombok
為IDE安裝lombok插件非常簡單,以eclipse環境為例,其安裝過程分為以下幾個步驟:
1)下載lombok.jar包 lombok的官網地址:https://projectlombok.org/ lombok的下載地址:https://projectlombok.org/download.html lombok項目的Github地址:https://github.com/rzwitserloot/lombok
2)運行lombok.jar 在windows命令行中輸入以下命令:
java -jar D:softwarelombok.jar
其中D:softwarelombok.jar這是windows下lombok.jar所在的位置, 數秒后將彈出以下對話框,以指定eclipse的安裝路徑。
3)確認完eclipse的安裝路徑后,點擊install/update按鈕,即可完成安裝。
4)安裝完成之后,請確認eclipse安裝路徑下是否多了一個lombok.jar包,并且其配置文件eclipse.ini中是否 添加了如下內容:
-javaagent:lombok.jar -Xbootclasspath/a:lombok.jar
那么恭喜你已經安裝成功,否則將缺少的部分添加到相應的位置即可 。
5)重啟eclipse。
三、項目中使用lombok
在項目中使用lombok的方法很簡單,分為四個步驟: 1)在需要自動生成getter和setter方法的類上,加上@Data注解。 2)在編譯類路徑中加入lombok.jar包,若是maven工程,引入相關依賴即可。
<dependencies> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>1.16.18</version> </dependency></dependencies>
3)使用支持lombok的編譯工具編譯源代碼(關于支持lombok的編譯工具,見“五、支持lombok的編譯工具”)。 4)編譯得到的字節碼文件中自動生成了getter和setter方法。
四、原理分析
接下來對lombok的工作原理進行分析,以Oracle的javac編譯工具為例。
自從Java 6起,javac就支持“JSR 269 Pluggable Annotation Processing API”規范,只要程序實現了該API,就能在javac運行的時候得到調用。
舉例來說,現在有一個實現了'JSR 269 API'的程序A,那么使用javac編譯源碼的時候具體流程如下: 1)javac對源代碼進行分析,生成一棵抽象語法樹(AST)。 2)運行過程中調用實現了'JSR 269 API'的A程序。 3)此時A程序就可以完成它自己的邏輯,包括修改第一步驟得到的抽象語法樹(AST)。 4)javac使用修改后的抽象語法樹(AST)生成字節碼文件。
詳細的流程圖如下:
五、支持lombok的編譯工具
1)由“四、原理分析”可知,Oracle javac直接支持lombok。 2)常用的項目管理工具Maven所使用的java編譯工具來源于配置的第三方工具,如果我們配置這個第三方工具為Oracle javac的話,那么Maven也就直接支持lombok了。 3)Intellij Idea配置的編譯工具為Oracle javac的話,也就直接支持lombok了。 4)Eclipse中使用的不是Oracle javac這個編譯工具,而是自己實現的Eclipse Compiler for Java (ECJ).要想使ECJ支持lombok,得進行設置,具體是在Eclipse程序目錄中的eclipse.ini文件中添加如下兩行設置:
-javaagent:[lombok.jar所在路徑]-Xbootclasspath/a:[lombok.jar所在路徑]
六、常用lombok注解
lombok 提供的注解不多,可以參考官方視頻的講解和官方文檔。 Lombok 注解在線幫助文檔:http://projectlombok.org/features/index 下面是幾個比較常用的 lombok 注解: @Data :注解在類上;提供類所有屬性的 getting 和 setting 方法,此外還提供了equals、canEqual、hashCode、toString 方法@Setter:注解在屬性上;為屬性提供 setting 方法@Getter:注解在屬性上;為屬性提供 getting 方法@Log4j :注解在類上;為類提供一個 屬性名為log 的 log4j 日志對象@NoArgsConstructor:注解在類上;為類提供一個無參的構造方法@AllArgsConstructor:注解在類上;為類提供一個全參的構造方法
七、其他問題
現在使用Intellij Idea作為Java項目的IDE,配置Oracle javac作為編譯工具。
現在有一個A類,其中有一些字段,沒有創建它們的setter和getter方法,使用了lombok的@Data注解,另外有一個B類,它調用了A類實例的相應字段的setter和getter方法。
編譯A類和B類所在的項目,并不會報錯,因為最終生成的A類字節碼文件中存在相應字段的setter和getter方法。但是,IDE發現B類源代碼中所使用的A類實例的setter和getter方法在A類源代碼中找不到定義,IDE會認為這是錯誤。
要解決以上這個不是真正錯誤的錯誤,可以下載安裝Intellij Idea中的'Lombok plugin'。
八、lombok的罪惡
使用lombok雖然能夠省去手動創建setter和getter方法的麻煩,但是卻大大降低了源代碼文件的可讀性和完整性,降低了閱讀源代碼的舒適度。
參考文獻:
[1] http://stackoverflow.com/questions/6107197/how-does-lombok-work [2] https://projectlombok.org/download.html [3] http://stackoverflow.com/questions/3061654/what-is-the-difference-between-javac-and-the-eclipse-compiler [4] http://www.ibm.com/developerworks/library/j-lombok/ [5] http://notatube.blogspot.com/2010/12/project-lombok-creating-custom.html
到此這篇關于Java使用lombok消除冗余代碼的方法步驟的文章就介紹到這了,更多相關Java lombok消除冗余代碼內容請搜索好吧啦網以前的文章或繼續瀏覽下面的相關文章希望大家以后多多支持好吧啦網!
相關文章:
1. IntelliJ IDEA創建web項目的方法2. CentOS郵件服務器搭建系列—— POP / IMAP 服務器的構建( Dovecot )3. ASP中實現字符部位類似.NET里String對象的PadLeft和PadRight函數4. django創建css文件夾的具體方法5. 存儲于xml中需要的HTML轉義代碼6. Android打包上傳AAR文件到Maven倉庫的示例7. .NET SkiaSharp 生成二維碼驗證碼及指定區域截取方法實現8. MyBatis JdbcType 與Oracle、MySql數據類型對應關系說明9. phpstudy apache開啟ssi使用詳解10. jsp網頁實現貪吃蛇小游戲
