Java注解介紹

基于注解(Annotation-based)的Java開(kāi)發(fā)無(wú)疑是最新的開(kāi)發(fā)趨勢(shì).[譯者注: 這是05年的文章,在2014年,毫無(wú)疑問(wèn),多人合作的開(kāi)發(fā),使用注解變成很好的合作方式,相互之間的影響和耦合可以很低].

基于注解的開(kāi)發(fā)將Java開(kāi)發(fā)人員從繁瑣笨重的配置文件中解脫出來(lái). Java 5.0中首次引入了注解,注解是這個(gè)JDK版本的特性之一,將程序員書(shū)寫(xiě)Java示例API文件的工作轉(zhuǎn)交給了編譯器. 當(dāng)不再維護(hù)分開(kāi)的源代碼和API文檔后,代碼和文檔會(huì)更容易維護(hù). 生成的代碼示例也不太可能包含錯(cuò)誤.

Java注解是JDK 5中的主要特性之一,使開(kāi)發(fā)變得更簡(jiǎn)單容易. 注解就像一種元信息(meta,可以理解為額外的信息,用來(lái)給特殊的程序看的),可以添加到代碼中,可以被用到包(package)的聲明,類(lèi)型(type)聲明、構(gòu)造函數(shù)(constructors)、方法(methods)、屬性域(fields)、參數(shù)(parameters)以及變量(variables)上. 他們提供一種有效的方式來(lái)指示方法是否依賴(lài)于其他方法,是否完整,類(lèi)(class)是否引用其他類(lèi),等等.

引用 甲骨文公司的官方網(wǎng)站的說(shuō)明 ,"它(基于注解的開(kāi)發(fā))可以讓我們?cè)诤芏鄷r(shí)候不必再去寫(xiě)一份單獨(dú)的API文檔說(shuō)明,只需要啟用工具來(lái)從源碼中的注解生成即可. 這形成了一種聲明式的編程風(fēng)格,程序員說(shuō),需要做什么,就讓工具根據(jù)代碼來(lái)做就好了."

簡(jiǎn)單來(lái)說(shuō),注解是一種將meta標(biāo)記(meta-tag)與程序元素關(guān)聯(lián)的機(jī)制,允許編譯器(compiler)或JVM從有注解的元素提取程序行為,必要時(shí)生成相互依賴(lài)的代碼.

在本系列文章的第一部分,我將介紹一些基本的Java注解,他們的用處(benefits),以及一些示例用法(usages).

Java注解基礎(chǔ)知識(shí)

你需要了解兩個(gè)地方. 一是"注解"(annotation, 類(lèi)似于一個(gè) new出來(lái)的對(duì)象)本身,二是"注解的類(lèi)型"(annotation type, 類(lèi)似于 class定義). 注解是一個(gè)meta標(biāo)記,用在你的代碼中,其實(shí)它是有生命周期和適用范圍的. annotation type是用來(lái)定義注解的. 當(dāng)你想要?jiǎng)?chuàng)建自己的注解時(shí)，你就會(huì)用到它. type才是實(shí)際使用的構(gòu)造類(lèi)型,注解只是那個(gè)類(lèi)型的一個(gè)具體用法.

定義注解類(lèi)型時(shí)需要使用一個(gè)"at"(@,國(guó)內(nèi)有人讀作圈a)標(biāo)記,緊跟著是關(guān)鍵字 interface, 再加上注解的名字(name). 另一方面,使用注解的形式,也是先寫(xiě)上"at"符號(hào)(@),其次是注解類(lèi)型. 這是最簡(jiǎn)單的注解形式. 另外,你可以在使用注解時(shí),在名字后面加上小括號(hào),里面附上需要傳遞的參數(shù). 后面你會(huì)看到他們的示例:

定義注解類(lèi)型示例: (Annotation Type,注解類(lèi)型, 類(lèi)似于定義一個(gè)類(lèi))

在普通代碼中使用注解(Annotation實(shí)例)

Java注解類(lèi)型(Annotation Types)

有三種類(lèi)型的注解:

標(biāo)記(Marker): 標(biāo)記類(lèi)型的注解沒(méi)有元素,只有一個(gè)名字.

定義:

使用:

單個(gè)元素的注解: 單個(gè)元素(Single-Element)或單個(gè)值 這種類(lèi)型的注解,只帶一個(gè)數(shù)據(jù). 可以在括號(hào)內(nèi)用 data=value 的方式表示,也可以只傳遞一個(gè)值(簡(jiǎn)便的寫(xiě)法).

定義:

使用:

Full-value或多個(gè)值的注解: Full-value類(lèi)型的注解有多個(gè)數(shù)據(jù)成員. 因此,必須為每個(gè)成員使用完整的 data=value 語(yǔ)法格式傳遞參數(shù).

定義:

使用:

定義Java注解類(lèi)型的注意事項(xiàng)

在定義注解類(lèi)型時(shí)需要注意:

1.注解聲明應(yīng)該以一個(gè)at符號(hào)開(kāi)始(@),后跟一個(gè)interface 關(guān)鍵字,以及注解的名字.
2.注解里面的方法聲明,不接受任何參數(shù)(只是看起來(lái)像是方法而已,本質(zhì)是屬性域).
3.注解里面的方法聲明不能有throws 子句.
4.注解里面的方法返回類(lèi)型只能是下面這幾種:
@primitives(6種原始數(shù)據(jù)類(lèi)型,int,byte等)
@String(字符串)
@Class(類(lèi), 如 String.class 這種)
@enum(枚舉)
@array of the above types(數(shù)組,數(shù)組元素只能是上面的一種類(lèi)型)

Java注解類(lèi)型

JDK5中有兩種類(lèi)型的注解:

1.Simple annotations(簡(jiǎn)單注解類(lèi)型): 這些是 Tiger(Tiger是JDK1.5的代號(hào)?)提供的基本類(lèi)型,只能用來(lái)注解普通代碼;不能用來(lái)創(chuàng)建另一個(gè)自定義注解類(lèi)型.

2.Meta annotations(元注解): 專(zhuān)門(mén)設(shè)計(jì)用來(lái)注解其他注解類(lèi)型(annotation-type)聲明的. 簡(jiǎn)單地說(shuō),他們被稱(chēng)為注解的注解(annotations-of-annotations).