Java注解詳細(xì)介紹
Java注解介紹
基于注解(Annotation-based)的Java開發(fā)無疑是最新的開發(fā)趨勢.[譯者注: 這是05年的文章,在2014年,毫無疑問,多人合作的開發(fā),使用注解變成很好的合作方式,相互之間的影響和耦合可以很低].
基于注解的開發(fā)將Java開發(fā)人員從繁瑣笨重的配置文件中解脫出來. Java 5.0中首次引入了注解,注解是這個JDK版本的特性之一,將程序員書寫Java示例API文件的工作轉(zhuǎn)交給了編譯器. 當(dāng)不再維護分開的源代碼和API文檔后,代碼和文檔會更容易維護. 生成的代碼示例也不太可能包含錯誤.
Java注解是JDK 5中的主要特性之一,使開發(fā)變得更簡單容易. 注解就像一種元信息(meta,可以理解為額外的信息,用來給特殊的程序看的),可以添加到代碼中,可以被用到包(package)的聲明,類型(type)聲明、構(gòu)造函數(shù)(constructors)、方法(methods)、屬性域(fields)、參數(shù)(parameters)以及變量(variables)上. 他們提供一種有效的方式來指示方法是否依賴于其他方法,是否完整,類(class)是否引用其他類,等等.
引用 甲骨文公司的官方網(wǎng)站的說明 ,"它(基于注解的開發(fā))可以讓我們在很多時候不必再去寫一份單獨的API文檔說明,只需要啟用工具來從源碼中的注解生成即可. 這形成了一種聲明式的編程風(fēng)格,程序員說,需要做什么,就讓工具根據(jù)代碼來做就好了."
簡單來說,注解是一種將meta標(biāo)記(meta-tag)與程序元素關(guān)聯(lián)的機制,允許編譯器(compiler)或JVM從有注解的元素提取程序行為,必要時生成相互依賴的代碼.
在本系列文章的第一部分,我將介紹一些基本的Java注解,他們的用處(benefits),以及一些示例用法(usages).
Java注解基礎(chǔ)知識
你需要了解兩個地方. 一是"注解"(annotation, 類似于一個 new出來的對象)本身,二是"注解的類型"(annotation type, 類似于 class定義). 注解是一個meta標(biāo)記,用在你的代碼中,其實它是有生命周期和適用范圍的. annotation type是用來定義注解的. 當(dāng)你想要創(chuàng)建自己的注解時，你就會用到它. type才是實際使用的構(gòu)造類型,注解只是那個類型的一個具體用法.
定義注解類型時需要使用一個"at"(@,國內(nèi)有人讀作圈a)標(biāo)記,緊跟著是關(guān)鍵字 interface, 再加上注解的名字(name). 另一方面,使用注解的形式,也是先寫上"at"符號(@),其次是注解類型. 這是最簡單的注解形式. 另外,你可以在使用注解時,在名字后面加上小括號,里面附上需要傳遞的參數(shù). 后面你會看到他們的示例:
定義注解類型示例: (Annotation Type,注解類型, 類似于定義一個類)
public @interface MyAnnotation {
String doSomething();
}
在普通代碼中使用注解(Annotation實例)
@MyAnnotation (doSomething="What to do")
public void mymethod() {
....
}
Java注解類型(Annotation Types)
有三種類型的注解:
標(biāo)記(Marker): 標(biāo)記類型的注解沒有元素,只有一個名字.
定義:
// 這種注解,就像一種標(biāo)簽, 沒有狀態(tài)
// 有點像沒有方法定義的接口Serializable一樣
public @interface AMarkerAnnotation {
}
使用:
@AMarkerAnnotation
public void mymethod() {
....
}
單個元素的注解: 單個元素(Single-Element)或單個值 這種類型的注解,只帶一個數(shù)據(jù). 可以在括號內(nèi)用 data=value 的方式表示,也可以只傳遞一個值(簡便的寫法).
定義:
public @interface SingleElementAnnotation
{
String doSomething();
}
使用:
@SingleElementAnnotation ("可以只傳對應(yīng)類型的值")
public void mymethod() {
....
}
Full-value或多個值的注解: Full-value類型的注解有多個數(shù)據(jù)成員. 因此,必須為每個成員使用完整的 data=value 語法格式傳遞參數(shù).
定義:
public @interface FullValueAnnotation {
String doSomething();
int count;
String date();
}
使用:
@FullValueAnnotation (doSomething="參數(shù)值", count=1,
date="09-09-2005")
public void mymethod() {
....
}
定義Java注解類型的注意事項
在定義注解類型時需要注意:
1.注解聲明應(yīng)該以一個at符號開始(@),后跟一個interface 關(guān)鍵字,以及注解的名字.
2.注解里面的方法聲明,不接受任何參數(shù)(只是看起來像是方法而已,本質(zhì)是屬性域).
3.注解里面的方法聲明不能有throws 子句.
4.注解里面的方法返回類型只能是下面這幾種:
@primitives(6種原始數(shù)據(jù)類型,int,byte等)
@String(字符串)
@Class(類, 如 String.class 這種)
@enum(枚舉)
@array of the above types(數(shù)組,數(shù)組元素只能是上面的一種類型)
Java注解類型
JDK5中有兩種類型的注解:
1.Simple annotations(簡單注解類型): 這些是 Tiger(Tiger是JDK1.5的代號?)提供的基本類型,只能用來注解普通代碼;不能用來創(chuàng)建另一個自定義注解類型.
2.Meta annotations(元注解): 專門設(shè)計用來注解其他注解類型(annotation-type)聲明的. 簡單地說,他們被稱為注解的注解(annotations-of-annotations).
相關(guān)文章
這篇文章主要為大家詳細(xì)介紹了如何利用Java編寫一個簡單的音樂播放器，文中的示例代碼講解詳細(xì)，具有一定的學(xué)習(xí)價值，感興趣的小伙伴可以了解一下2023-07-07
本文主要介紹了springboot冪等切片的實現(xiàn)，文中通過示例代碼介紹的非常詳細(xì)，具有一定的參考價值，感興趣的小伙伴們可以參考一下2022-03-03
這篇文章主要介紹了UrlRewrite 重寫url詳解及實例的相關(guān)資料,重寫能美化，提高安全，有利于搜索引擎的收入等，需要的朋友可以參考下2016-12-12
這篇文章主要介紹了十個常見的Java異常出現(xiàn)原因，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-03-03
SpringBoot整合Kotlin構(gòu)建Web服務(wù)的方法示例
這篇文章主要介紹了SpringBoot整合Kotlin構(gòu)建Web服務(wù)的方法示例，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2019-02-02
Java多線程之 FutureTask:帶有返回值的函數(shù)定義和調(diào)用方式
這篇文章主要介紹了Java多線程之 FutureTask:帶有返回值的函數(shù)定義和調(diào)用方式，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2021-07-07
這篇文章主要介紹了Java中使用BigDecimal進行浮點數(shù)運算,需要的朋友可以參考下2014-07-07
springboot多個service互相調(diào)用的事務(wù)處理方式
這篇文章主要介紹了springboot多個service互相調(diào)用的事務(wù)處理方式，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2022-02-02
spring帶bean和config如何通過main啟動測試
這篇文章主要介紹了spring帶bean和config，通過main啟動測試,本文通過實例代碼給大家介紹的非常詳細(xì)，對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友可以參考下2023-07-07
這篇文章主要為大家詳細(xì)介紹了Java實現(xiàn)五子棋AI算法，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價值，感興趣的小伙伴們可以參考一下2018-03-03