淺談Android中@IntDef注解的使用

上回書(shū)說(shuō)到Android中推薦使用@IntDef代替枚舉類(lèi)型。 那么今天的主題就是來(lái)淺淺的了解一下@IntDef注解的使用怔鳖。

在build.gradle 文件中添加依賴(lài)
implementation 'com.android.support:support-annotations:26.1.0'

定義自己的@IntDef注解類(lèi)型

@IntDef ({
        LEFT_UP, LEFT_DOWN,
        RIGHT_UP, RIGHT_DOWN,
        UP, DOWN
})
@Retention(RetentionPolicy.CLASS)
public @interface RenderPosition {
    int LEFT_UP = 0;
    int LEFT_DOWN = 1;
    int RIGHT_UP = 2;
    int RIGHT_DOWN = 3;
    int UP = 4;
    int DOWN = 5;
}

@IntDef限定了 RenderPosition類(lèi)型的值范圍。
@Retention(RetentionPolicy.CLASS) 為元注解乒验,什么是元注解呢俄认?
元注解就是用來(lái)注解注解類(lèi)型的注解:)
理解了這句話,就理解了注解類(lèi)型蒙揣,哈哈靶溜。

JDK中提供了如下幾種常用的元注解

  • @Documented
    表示含有該注解類(lèi)型的元素(帶有注釋的)會(huì)通過(guò)javadoc或類(lèi)似工具進(jìn)行文檔化
  • @Inherited
    表示注解類(lèi)型能被自動(dòng)繼承
  • @Retention
    表示注解類(lèi)型的存活時(shí)長(zhǎng)
  • @Target
    表示注解類(lèi)型所適用的程序元素的種類(lèi)
  • @Repeatable
    使被修飾的注解可以重復(fù)的注解某一個(gè)程序元素

如果你對(duì)注解類(lèi)型還不了解或者對(duì)這些元注解的用法不了解的話,可以參考這篇秒懂:
秒懂JAVA注解類(lèi)型

在定義了自己的IntDef注解類(lèi)型后懒震,你就可以用它來(lái)修飾方法參數(shù)罩息、方法返回值
就像下面這樣:

        @RenderPosition
        private int calculateRenderPosition(Rect faceRect) {
            ....
            return RenderPosition.UP;
        }

也可以作為switch-case的變量類(lèi)型,像這樣:

        private Rect calculateBackgroundRect(Rect faceRect) {
            @RenderPosition int renderPostion = calculateRenderPosition(faceRect);
            Rect backgroundRect = new Rect();
            switch (renderPostion) {
                case RenderPosition.UP:
                    ...
                    break;
                case RenderPosition.DOWN:
                    ...
                    break;
                case RenderPosition.LEFT_UP:
                    ...
                    break;
                case RenderPosition.RIGHT_UP:
                    ...
                    break;
                case RenderPosition.LEFT_DOWN:
                    ...
                    break;
                case RenderPosition.RIGHT_DOWN:
                    ...
                    break;
            }
            return backgroundRect;
        }

同理个扰,我們也可以使用@StringDef

這樣就完成了瓷炮,既不用枚舉,也實(shí)現(xiàn)了編譯期的類(lèi)型檢查递宅,同時(shí)還避免了只定義靜態(tài)常量帶來(lái)的語(yǔ)義模糊的問(wèn)題娘香。

是不是很棒?

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末办龄,一起剝皮案震驚了整個(gè)濱河市烘绽,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌俐填,老刑警劉巖安接,帶你破解...
    沈念sama閱讀 219,039評(píng)論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異玷禽,居然都是意外死亡赫段,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,426評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門(mén)矢赁,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)糯笙,“玉大人,你說(shuō)我怎么就攤上這事撩银「椋” “怎么了?”我有些...
    開(kāi)封第一講書(shū)人閱讀 165,417評(píng)論 0 356
  • 文/不壞的土叔 我叫張陵额获,是天一觀的道長(zhǎng)够庙。 經(jīng)常有香客問(wèn)我,道長(zhǎng)抄邀,這世上最難降的妖魔是什么耘眨? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 58,868評(píng)論 1 295
  • 正文 為了忘掉前任,我火速辦了婚禮境肾,結(jié)果婚禮上剔难,老公的妹妹穿的比我還像新娘胆屿。我一直安慰自己,他們只是感情好偶宫,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,892評(píng)論 6 392
  • 文/花漫 我一把揭開(kāi)白布非迹。 她就那樣靜靜地躺著,像睡著了一般纯趋。 火紅的嫁衣襯著肌膚如雪憎兽。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 51,692評(píng)論 1 305
  • 那天吵冒,我揣著相機(jī)與錄音纯命,去河邊找鬼。 笑死桦锄,一個(gè)胖子當(dāng)著我的面吹牛扎附,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播结耀,決...
    沈念sama閱讀 40,416評(píng)論 3 419
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼留夜,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了图甜?” 一聲冷哼從身側(cè)響起碍粥,我...
    開(kāi)封第一講書(shū)人閱讀 39,326評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎黑毅,沒(méi)想到半個(gè)月后嚼摩,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,782評(píng)論 1 316
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡矿瘦,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,957評(píng)論 3 337
  • 正文 我和宋清朗相戀三年枕面,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片缚去。...
    茶點(diǎn)故事閱讀 40,102評(píng)論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡潮秘,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出易结,到底是詐尸還是另有隱情枕荞,我是刑警寧澤,帶...
    沈念sama閱讀 35,790評(píng)論 5 346
  • 正文 年R本政府宣布搞动,位于F島的核電站躏精,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏鹦肿。R本人自食惡果不足惜矗烛,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,442評(píng)論 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望箩溃。 院中可真熱鬧瞭吃,春花似錦碌识、人聲如沸。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 31,996評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)开泽。三九已至牡拇,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間穆律,已是汗流浹背惠呼。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 33,113評(píng)論 1 272
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留峦耘,地道東北人剔蹋。 一個(gè)月前我還...
    沈念sama閱讀 48,332評(píng)論 3 373
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像辅髓,于是被迫代替她去往敵國(guó)和親泣崩。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,044評(píng)論 2 355