Annotation注解及元注解

在使用許多第三方框架的時候，查閱源碼如ButterKnife等。發現許多注解的使用，頓時覺得注解都玩不溜怎么稱霸武林。當然無論Java還是Android的SDK中都有大量注解的使用，以前總是走馬觀花，印象中知道注解代表的意思，但開口總是說不清道不明，唯有總結方得始終。

注解是附加在代碼中的一些信息，可以幫助一些代碼分析工具如Lint分析代碼，輔助開發者改善代碼，對于開發者來說有個提示、警告的作用。但注解不會改變代碼邏輯。在此總結了幾個Android開發常見的注解的解釋，以及對元注解的基本認識。

常見的幾個注解

1、@TargetApi

2、@RequiresApi

3、@suppressLint

4、@SuppressWarnings

@TargetApi(Build.VERSION_CODES.M)、@TargetApi(23)

Lint會按照API版本M以上掃描代碼，而不是project中指定的minSDKVersion，可以使得高版本Api在低版本SDK上Lint不報錯。如果只加這個注解，表明這段代碼只能在23及以上的系統上運行，如果你非要在23以下的系統上運行，那該警告的已經警告了，你只是忽略了警告，但運行時該錯還是錯。

@RequiresApi(api = Build.VERSION_CODES.M)

表示注解目標只能夠在指定的版本API及以上運行，消除高版本Api在低版本SDK上的報錯，作用上和TargetApi相同，只是在詞面上更清楚表達了這是一個建議，而不僅僅是為了消除高版本Api在低版本SDK上的報錯。從官方的表述可以看出更推薦使用RequiresApi替換TargetApi。

@SuppressLint("NewApi")

最直接暴力屏蔽指定名稱的報錯，這里的NewApi對應的具體錯誤名稱是：Calling new methods on older versions。這里的NewApi只是一個縮寫名稱。相比于@TargetApi指定了版本號，SuppressLint是一律屏蔽，所以一般不建議使用。當然還可以指定任何其他Lint定義好的錯誤名稱。在settings中查找Inspections可以找到預先定義好的所有Error、Warning。對于多個錯誤，使用逗號隔開。

在XML中類似的做法有：

tools:ignore="ScrollViewCount,UselessParent"忽略XML中的兩個警告。

@SuppressWarnings("NumericOverflow")

屏蔽NumericOverflow警告，如：int a = 1 / 0;

一般的語句注解方式suppress for statement 

    @SuppressWarnings("NumericOverflow")

     int a = 10 / 0;

注釋注解方式statement for statement with comment

     //noinspection NumericOverflow（以前總是看到這樣的注釋，但并不知道也是注解）

     int a = 10 / 0;

當然，這些注解可以使用在許多地方如：class、method、statement，分別對應由大到小不同的作用域類、方法、語句，當然作用域范圍越大，那么性能損耗自然越大。

Annotation不影響代碼邏輯

這些注解的作用只是去除Lint的錯誤警告，并不能影響任何的代碼邏輯。

所以必須在代碼中添加相應的兼容性判斷代碼，如：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {

      color = getColor(R.color.colorAccent);

}

當然，當你添加完上述兼容代碼后，警告也就消失了。

元注解（注解的注解）

常見的元注解：

1、@Documented

2、@Inherited

3、@Retention

4、@Target

分析SuppressLint的定義：

@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})

@Retention(RetentionPolicy.CLASS)

public @interface SuppressLint {

 value();

}

@Target定義作用目標

其中@Target指定了SuppressLint的作用目標，具體TYPE、FIELD等代表什么，可以在java.lang.annotation.ElementType里面找到。

例如：TYPE表示

/** Class, interface (including annotation type), or enum declaration */

即包含了類、接口（包括注解）、枚舉類型。

例如：@Override注解

@Target(ElementType.METHOD)  重寫，只能作用于方法

@Retention(RetentionPolicy.SOURCE)  只存在于編碼階段，編譯階段就失效了

public @interface Override {}

@Retention定義保留策略

1、PetentionPolicy.SOURCE 僅保留在源碼階段，編譯階段就失效

2、PetentionPolicy.CLASS默認策略，會保留到編譯出字節碼階段，運行時失效

3、PetentionPolicy.RUNTIME 保留到VM的運行時階段，可通過反射獲得

@Documented   注解將被寫入javadoc中

@Inherited   子類可以繼承父類中的該注解

@Repeatable   找不到例子，有待理解

@Native   尚處于Preview狀態，表示常量有可能被本地代碼引用