Java注解之Retention、Documented、Inherited介紹
Retention注解
Retention(保留)注解說明,這種類型的注解會被保留到那個階段. 有三個值:
1.RetentionPolicy.SOURCE —— 這種類型的Annotations只在源代碼級別保留,編譯時就會被忽略
2.RetentionPolicy.CLASS —— 這種類型的Annotations編譯時被保留,在class文件中存在,但JVM將會忽略
3.RetentionPolicy.RUNTIME —— 這種類型的Annotations將被JVM保留,所以他們能在運行時被JVM或其他使用反射機制的代碼所讀取和使用.
示例5演示了 RetentionPolicy.RUNTIME 的聲明:
Java注解的示例1:
@Retention(RetentionPolicy.RUNTIME)
public @interface Test_Retention {
String doTestRetention();
}
在這個示例中, @Retention(RetentionPolicy.RUNTIME)注解表明 Test_Retention注解將會由虛擬機保留,以便它可以在運行時通過反射讀取.
Documented 注解
Documented 注解表明這個注解應(yīng)該被 javadoc工具記錄. 默認情況下,javadoc是不包括注解的. 但如果聲明注解時指定了 @Documented,則它會被 javadoc 之類的工具處理, 所以注解類型信息也會被包括在生成的文檔中. 示例6進一步演示了使用 @Documented:
Java注解的示例2:
@Documented
public @interface Test_Documented {
String doTestDocument();
}
接下來,像下面這樣修改TestAnnotations類:
public class TestAnnotations {
public static void main(String arg[]) {
new TestAnnotations().doSomeTestRetention();
new TestAnnotations().doSomeTestDocumented();
}
@Test_Retention (doTestRetention="保留注解信息測試")
public void doSomeTestRetention() {
System.out.printf("測試注解類型 'Retention'");
}
@Test_Documented(doTestDocument="Hello document")
public void doSomeTestDocumented() {
System.out.printf("測試注解類型 'Documented'");
}
}
現(xiàn)在,如果你使用 javadoc命令生成 TestAnnotations.html文件,你將看到類似于圖1的結(jié)果.
從截圖可以看到,文檔中沒有 doSomeTestRetention() 方法的 annotation-type信息()方法. 但是, doSomeTestDocumented() 方法的文檔提供了注解的描述信息. 這是因為 @Documented標簽被加到了Test_Documented注解上. 之前的注解Test_Retention并沒有指定 @Documented 標記(tag).
Inherited 注解(這段可能有問題...)
這是一個稍微復(fù)雜的注解類型. 它指明被注解的類會自動繼承. 更具體地說,如果定義注解時使用了 @Inherited 標記,然后用定義的注解來標注另一個父類, 父類又有一個子類(subclass),則父類的所有屬性將被繼承到它的子類中. 在示例7中,你會看到使用 @Inherited 標簽的好處.
Java注解的示例3
首先,定義你的注解:
@Inherited
public @interface MyParentObject {
boolean isInherited() default true;
String doSomething() default "Do what?";
}
接下來,使用注解標注了一個類:
@MyParentObject
public Class MyChildObject {
}
正如你看到的,你不需要在實現(xiàn)類中定義接口方法. 因為使用 @Inherited標記，這些都自動繼承了. 如果你使用一種古老的方式定義實現(xiàn)類,會是什么樣子呢? 看看下面這張 古老的實現(xiàn)方式吧:
public class MyChildObject implements MyParentObject {
public boolean isInherited() {
return false;
}
public String doSomething() {
return "";
}
public boolean equals(Object obj) {
return false;
}
public int hashCode() {
return 0;
}
public String toString() {
return "";
}
public Class annotationType() {
return null;
}
}
看到的區(qū)別嗎? 可以看到,你必須實現(xiàn)父接口的所有方法. 除了isInherited()和從myParentObject doSomething()方法外,你還需要實現(xiàn) java.lang.Object的 equals(),toString()和hasCode()方法. 還有 java.lang.annotation.Annotation 類的 annotationType()方法. 不管你是不是想要實現(xiàn)這些方法,你必須在繼承的對象中包含這些.
結(jié)論
本文向你展示了如何通過使用JDK5的注解功能使開發(fā)更容易. 注解不直接影響程序的語義. 開發(fā)和部署工具可以以某種方式閱讀這些注解并處理它們,使用包含注解的程序可以替代額外的Java源文件、XML文檔或其他古老的構(gòu)件. 使用注解可以使用更少的代碼完成同樣的事情,并且有更好的編譯時錯誤檢測機制. 注解的目的是花更少的時間在那些死硬無用的細節(jié)中,更多地關(guān)注業(yè)務(wù)邏輯規(guī)則. 本文是Java注解系列的第一部分. 在第二部分中,你將了解如何使用注解來開發(fā)一個簡單的Web應(yīng)用程序. 最后,在第三部分中,你會看到一個包括多個數(shù)據(jù)庫表的復(fù)雜示例.
相關(guān)文章
在Java開發(fā)中,我們經(jīng)常會遇到需要從JSON數(shù)據(jù)中提取特定字段值的情況,這篇文章主要給大家介紹了關(guān)于JSON字符串中獲取一個指定字段的值四種方式,文中通過代碼介紹的非常詳細,需要的朋友可以參考下2024-09-09
這篇文章主要介紹了Java之SSM中bean相關(guān)知識匯總案例講解,本篇文章通過簡要的案例,講解了該項技術(shù)的了解與使用,以下就是詳細內(nèi)容,需要的朋友可以參考下2021-07-07
IntelliJ IDEA 2019.2 x64的安裝、應(yīng)用與簡單配置(圖文)
這篇文章主要介紹了IntelliJ IDEA 2019.2 x64的安裝、應(yīng)用與簡單配置,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2019-10-10
java http連接池的實現(xiàn)方式(帶有失敗重試等高級功能)
這篇文章主要介紹了java http連接池的實現(xiàn)方式(帶有失敗重試等高級功能),具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-04-04
解析Java的Spring框架的BeanPostProcessor發(fā)布處理器
這篇文章主要介紹了Java的Spring框架的BeanPostProcessor發(fā)布處理器,Spring是Java的SSH三大web開發(fā)框架之一,需要的朋友可以參考下2015-12-12
對主表（采購申請表）和明細表（申請物資表）同時進行插入操作insert，怎么實現(xiàn)呢，下面給大家分享mybatis主表與明細表一對多的同時插入操作方法，感興趣的朋友一起看看吧2023-02-02
這篇文章主要介紹了Java?獲取Word中所有插入和刪除修訂，在?Word?文檔中啟用跟蹤更改功能后，會記錄文檔中的所有編輯行為，例如插入、刪除、替換和格式更改。對插入或刪除的內(nèi)容，本文介紹獲取方法,需要的朋友可以參考下2022-04-04
本文主要介紹了Java調(diào)用GPU算力的實現(xiàn)示例,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧2025-03-03
SpringSecurity數(shù)據(jù)庫進行認證和授權(quán)的使用
本文主要介紹了用戶的賬號、密碼以及角色信息在數(shù)據(jù)庫中的認證和授權(quán)，文中通過示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2021-08-08
在學習Java的過程中，想必大家都一定學習過異常這個篇章，異常的基本特性和使用這里就不再多講了。本文就來和大家講講如何自定義異常2022-08-08