第11章 注解

Annotation其實(shí)就是代碼里的特殊標(biāo)記松捉,可以在編譯,類加載缘滥,運(yùn)行的時(shí)候被讀取轰胁,并執(zhí)行相應(yīng)的處理。在不改變?cè)羞壿嫷那闆r下朝扼,在源文件嵌入一些補(bǔ)充信息。一條重要原則:僅僅使用注解來標(biāo)識(shí)程序元素霎肯,對(duì)程序不會(huì)造成任何影響擎颖,要讓注解起作用榛斯,必須為這些注解提供注解處理工具。

一搂捧、基本Annotation

  • @Override 只能修飾方法驮俗,強(qiáng)制子類必須覆蓋父類的方法
  • @Deprecated 表示某個(gè)程序元素(類、方法允跑、接口等)已經(jīng)過時(shí)王凑,若其他程序使用該元素,將會(huì)給出警告
  • @SuppressWarnings 被修飾的程序元素取消顯示指定的警告聋丝,會(huì)同時(shí)作用于該程序元素下的所有的子元素

二索烹、自定義Annotation

1、定義Annotation

定義新的Annotation弱睦,使用@interface關(guān)鍵字百姓,與定義一個(gè)接口非常相似。所有的注解都繼承了Annotation接口况木。

public @interface Testable{
    
}

使用Annotation的語法垒拢,非常類似于public,final等修飾符(一般單獨(dú)放一行)火惊,通常用于修飾程序中的類 求类、接口、變量屹耐、方法等

public class MyClass {
    @Testable
    public void info() {

    }
}

Annotation中還可以帶成員變量仑嗅,用無參數(shù)的方法來聲明。方法名定義了成員變量的名字张症,返回值定義了成員變量的類型仓技。語法與定義接口的語法非常相似。若沒有定義默認(rèn)值俗他,則必須賦值脖捻。

public @interface Testable {
    String name();
    int age() default 19;//已經(jīng)設(shè)置默認(rèn)值,使用時(shí)可以不賦值
}
//使用
public class MyClass {
    @Testable(name="xiangyaohui")
    public void info() {

    }
}

標(biāo)記Annotation:沒有成員變量兆衅,僅使用自身的存在與否地沮,來為我們提供信息。
元數(shù)據(jù)Annotation:包含成員變量的Annotation羡亩,因?yàn)樗麄兛梢越邮芨嗟脑獢?shù)據(jù)摩疑。

2、提取Annotation信息

AnnotatedElement接口中的三個(gè)方法

- <T extends Annotation> T getAnnotation(Class<T> aClass) //返回該類程序元素上畏铆,指定類型的注解雷袋,若該類型的注解不存在,返回null
- Annotation[] getAnnotations()   //返回程序元素存在的所有注解
- boolean isAnnotationPresent(Class<? extends Annotation> aClass)   //判定該程序元素上是否包含指定類型的注解

AnnotatedElement接口的實(shí)現(xiàn)類:
Class
Contrustor
Field
Method
Package

2.1辞居、例子一

僅僅是一個(gè)標(biāo)記Annotation楷怒,沒有成員變量

public @interface Testable {
}

public class MyClass {
    @Testable
    public void m1() {

    }
    public void m2() {

    }
}

public class TestProcessor {
    public static void process(String clazz) throws ClassNotFoundException {
        for (Method m : Class.forName(clazz).getMethods()) {
            //如果包含Testable標(biāo)記注解
            if (m.isAnnotationPresent(Testable.class)) {
                try {
                    //調(diào)用m方法
                    m.invoke(null);
                }catch (Exception e){
                    e.printStackTrace();
                }
            }
        }
    }
}

其實(shí)注解很簡單蛋勺,就是為源碼添加一些特殊的標(biāo)記,這些標(biāo)記可以通過反射獲取鸠删,獲取到之后做出相應(yīng)的處理抱完。

2.2、例子二

public @interface ClickListenerFor {
    //用于保存監(jiān)聽器實(shí)現(xiàn)類
    String listener();
}
public class ClickListenerProcessor {
    public static void process(Object obj) {
        try {
            Class clazz = obj.getClass();
            for (Field field : clazz.getFields()) {
                field.setAccessible(true);
                ClickListenerFor c = field.getAnnotation(ClickListenerFor.class);
                if (c !=null){
                    //獲取元數(shù)據(jù)
                    Class listenerClazz = Class.forName(c.listener());
                    //
                    View.OnClickListener click = (View.OnClickListener) listenerClazz.newInstance();
                    //獲取field 實(shí)際對(duì)應(yīng)的對(duì)象
                    Button button = (Button) field.get(obj);
                    //添加事件
                    button.setOnClickListener(click);
                }
            }
        } catch (Exception ex) {
            ex.printStackTrace();
        }
    }
}
public class MainActivity extends Activity {
    @ClickListenerFor(listener = "OkClickListener")
    private Button okButton;
    @ClickListenerFor(listener = "CancelClickListener")
    private Button cancelButton;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Button button1 = findViewById(R.id.button1);
        Button button2 = findViewById(R.id.button2);
        ClickListenerProcessor.process(this);
    }

    class OkClickListener implements View.OnClickListener {
        @Override
        public void onClick(View view) {
            //點(diǎn)擊了確定按鈕
        }
    }

    class CancelClickListener implements View.OnClickListener {
        @Override
        public void onClick(View view) {
            //點(diǎn)擊了取消按鈕
        }
    }
}

三刃泡、元注解

@Retention

@Test

@Documented

@Inherited

四巧娱、使用APT來處理Annotation

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市烘贴,隨后出現(xiàn)的幾起案子禁添,更是在濱河造成了極大的恐慌,老刑警劉巖庙楚,帶你破解...
    沈念sama閱讀 206,013評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件上荡,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡馒闷,警方通過查閱死者的電腦和手機(jī)酪捡,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,205評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來纳账,“玉大人逛薇,你說我怎么就攤上這事∈璩妫” “怎么了永罚?”我有些...
    開封第一講書人閱讀 152,370評(píng)論 0 342
  • 文/不壞的土叔 我叫張陵,是天一觀的道長卧秘。 經(jīng)常有香客問我呢袱,道長,這世上最難降的妖魔是什么翅敌? 我笑而不...
    開封第一講書人閱讀 55,168評(píng)論 1 278
  • 正文 為了忘掉前任羞福,我火速辦了婚禮,結(jié)果婚禮上蚯涮,老公的妹妹穿的比我還像新娘治专。我一直安慰自己,他們只是感情好遭顶,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,153評(píng)論 5 371
  • 文/花漫 我一把揭開白布张峰。 她就那樣靜靜地躺著,像睡著了一般棒旗。 火紅的嫁衣襯著肌膚如雪喘批。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 48,954評(píng)論 1 283
  • 那天,我揣著相機(jī)與錄音谤祖,去河邊找鬼婿滓。 笑死老速,一個(gè)胖子當(dāng)著我的面吹牛粥喜,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播橘券,決...
    沈念sama閱讀 38,271評(píng)論 3 399
  • 文/蒼蘭香墨 我猛地睜開眼额湘,長吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來了旁舰?” 一聲冷哼從身側(cè)響起锋华,我...
    開封第一講書人閱讀 36,916評(píng)論 0 259
  • 序言:老撾萬榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎箭窜,沒想到半個(gè)月后毯焕,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,382評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡磺樱,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,877評(píng)論 2 323
  • 正文 我和宋清朗相戀三年纳猫,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片竹捉。...
    茶點(diǎn)故事閱讀 37,989評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡芜辕,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出块差,到底是詐尸還是另有隱情侵续,我是刑警寧澤,帶...
    沈念sama閱讀 33,624評(píng)論 4 322
  • 正文 年R本政府宣布憨闰,位于F島的核電站状蜗,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏鹉动。R本人自食惡果不足惜轧坎,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,209評(píng)論 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望训裆。 院中可真熱鬧眶根,春花似錦、人聲如沸边琉。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,199評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽变姨。三九已至族扰,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背渔呵。 一陣腳步聲響...
    開封第一講書人閱讀 31,418評(píng)論 1 260
  • 我被黑心中介騙來泰國打工怒竿, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人扩氢。 一個(gè)月前我還...
    沈念sama閱讀 45,401評(píng)論 2 352
  • 正文 我出身青樓耕驰,卻偏偏與公主長得像,于是被迫代替她去往敵國和親录豺。 傳聞我的和親對(duì)象是個(gè)殘疾皇子朦肘,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,700評(píng)論 2 345

推薦閱讀更多精彩內(nèi)容