Android注解使用之使用Support Annotations注解优化代码

前言：

前面学习总结了Java注解的使用，博客地址详见Java学习之注解Annotation实现原理，从本质上了解到什么注解，以及注解怎么使用？不要看见使用注解就想到反射会影响性能之类，今天我们就来学习一下Android Support Annotations注解来优化我们的代码，增加可读性的同时，也让让更多的错误消灭在萌芽之中。

Support Annotations简介：

Android support library从19.1版本开始引入了一个新的注解库，它包含很多有用的元注解，你能用它们修饰你的代码，帮助你发现bug。Support library自己本身也用到了这些注解，所以作为support library的用户，Android Studio已经基于这些注解校验了你的代码并且标注其中潜在的问题。

Support Annotations如何引入：

注解默认是没有包含的；它被包装成一个独立的库，如果使用了appcompat库，那么Support Annotations就会自动引入进来，因为appcompat使用了Support Annotations，如果没有则需要在build.gradle中添加如下配置：

dependencies {
    compile 'com.android.support:support-annotations:23.4.0'
}

Support Annotations分类：

1.）Nullness注解

@Nullable注解可以用来标识特定的参数或者返回值可以为null。

@NonNull注解可以用来标识参数不能为null。

2.）Resource Type 注解

资源在Android中作为整型值来传递。这意味着希望获取一个drawable作为参数的代码很容易被传递了一个string类型的资源，因为他们资源id都是整型的，编译器很难区分。Resource Type注解在这种条件下可以提供类型检查，例如：

如果类型指定错误，编译不会通过。

常见的Resource Type注解,使用方式都是指定一个integer的参数、成员变量、或者方法，检查对应的资源类型。

• AnimatorRes：animator资源类型
• AnimRes：anim资源类型
• AnyRes：任意资源类型
• ArrayRes：array资源类型
• AttrRes：attr资源类型
• BoolRes：boolean资源类型
• ColorRes：color资源类型
• DimenRes：dimen资源类型。
• DrawableRes：drawable资源类型。
• FractionRes：fraction资源类型
• IdRes：id资源类型
• IntegerRes：integer资源类型
• InterpolatorRes：interpolator资源类型
• LayoutRes：layout资源类型
• MenuRes：menu资源类型
• PluralsRes：plurals资源类型
• RawRes：raw资源类型
• StringRes：string资源类型
• StyleableRes：styleable资源类型
• StyleRes：style资源类型
• TransitionRes：transition资源类型
• XmlRes：xml资源类型

以上基本上包括了所有的资源类型，但是有时需要通过RGB颜色整型来设置颜色值，在这种情况下，你可以使用@ColorInt注解，表示你期望的是一个代表颜色的整数值，如果使用不对同样也是编译不通过

3.）Threading 注解

比如我们在项目中处理比较耗时的操作，需要制定在工作子线程中执行，可以使用Threading 注解，如果没有在制定的线程中执行也是编译不过的

几种Threading注解

• @UiThread UI线程
• @MainThread 主线程
• @WorkerThread 子线程
• @BinderThread 绑定线程

4.）Typedef 注解：IntDef/StringDef

整型除了可以作为资源的引用之外，也可以用作“枚举”类型使用。

@IntDef和”typedef”作用非常类似，你可以创建另外一个注解，然后用@IntDef指定一个你期望的整型常量值列表，最后你就可以用这个定义好的注解修饰你的API了。

例如：需要自定义网络类型

    private final static int GET=0;
    private final static int POST=1;
    private final static int DELETE=2;
    private final static int PUT=3;
    @IntDef({GET, POST, DELETE,PUT})
    @Retention(RetentionPolicy.SOURCE)
    public @interface ReqType{}

需要在调用时只能传入指定类型，如果传入类型不对，编译不通过

5.）Value Constraints注解：@Size, @IntRange, @FloatRange

在实际开发过程中，我们有时可能需要设置一个取值范围，这时我们可以使用取值范围注解来约束。

比如我们设置一个百分比，取值范围为0-100，

对于数据、集合以及字符串，你可以用@Size注解参数来限定集合的大小(当参数是字符串的时候，可以限定字符串的长度)。

举几个例子

• 集合不能为空: @Size(min=1)
• 字符串最大只能有23个字符: @Size(max=23)
• 数组只能有2个元素: @Size(2)
• 数组的大小必须是2的倍数 (例如图形API中获取位置的x/y坐标数组: @Size(multiple=2)

6.）Permissions 注解: @RequiresPermission

有时我们的方法调用需要调用者拥有指定的权限，这时我们可以使用@RequiresPermission注解，

@RequiresPermission(Manifest.permission.SET_WALLPAPER)
public abstract void setWallpaper(Bitmap bitmap) throws IOException;

除了上面的单一使用方式，官方同时也给出了如下几种使用场景

（1）如果你至少需要权限集合中的一个，你可以使用anyOf属性

@RequiresPermission(anyOf = {
    Manifest.permission.ACCESS_COARSE_LOCATION,
    Manifest.permission.ACCESS_FINE_LOCATION})
public abstract Location getLastKnownLocation(String provider);

（2）如果你同时需要多个权限，你可以用allOf属性

@RequiresPermission(allOf = {
    Manifest.permission.READ_HISTORY_BOOKMARKS, 
    Manifest.permission.WRITE_HISTORY_BOOKMARKS})
public static final void updateVisitedHistory(ContentResolver cr, String url, boolean real) ;

（3）对于intents的权限，可以直接在定义的intent常量字符串字段上标注权限需求(他们通常都已经被@SdkConstant注解标注过了)

@RequiresPermission(android.Manifest.permission.BLUETOOTH)
public static final String ACTION_REQUEST_DISCOVERABLE =
 "android.bluetooth.adapter.action.REQUEST_DISCOVERABLE";

（4）对于content providers的权限，你可能需要单独的标注读和写的权限访问，所以可以用@Read或者@Write标注每一个权限需求

@RequiresPermission.Read(@RequiresPermission(READ_HISTORY_BOOKMARKS))
@RequiresPermission.Write(@RequiresPermission(WRITE_HISTORY_BOOKMARKS))
public static final Uri BOOKMARKS_URI = Uri.parse("content://browser/bookmarks");

7.）Overriding Methods 注解: @CallSuper

如果你的API允许使用者重写你的方法，但是呢，你又需要你自己的方法(父方法)在重写的时候也被调用，这时候你可以使用@CallSuper标注

例如：Activity的onCreate函数

@CallSuper
protected void onCreate(@Nullable Bundle savedInstanceState) 

用了这个后，当重写的方法没有调用父方法时，工具就会给予标记提示

8.）Return Values注解: @CheckResult

如果你的方法返回一个值，你期望调用者用这个值做些事情，那么你可以使用@CheckResult注解标注这个方法。

这个在具体使用中用的比较少，除非特殊情况，比如在项目中对一个数据进行处理，这个处理比较耗时，我们希望调用该函数的调用者在不需要处理结果的时候，提示没有使用，酌情删除调用。

9.）其他注解

Keep：指出一个方法在被混淆的时候应该被保留。

VisibleForTesting：可注解一个类，方法，或变量，表示有更宽松的可见性，这样它能够有更宽泛的可见性，使代码可以被测试。

10.）IntelliJ注解

IntelliJ，Android Studio就是基于它开发的，IntelliJ有一套它自己的注解；IntDef分析其实重用的是MagicConstant分析的代码，IntelliJ null分析其实用的是一组配置好的null注解。如果你执行Analyze > Infer Nullity…，它会试图找出所有的null约束并添加他们。这个检查有时会插入IntelliJ注解。你可以通过搜索,替换为Android注解库的注解，或者你也可以直接用IntelliJ注解。在build.gradle里或者通过Project Structure对话框的Dependencies面板都可以添加如下依赖：

dependencies {
    compile 'com.intellij:annotations:12.0'
}

小结：

经过查阅资料，系统了学习了Support Annotations注解，学以致用，通过这个Support Annotations可以提高代码可读性，同时可以在类加载时就可以检查一些错误，同时不会对性能有任何影响，因为Support Annotations中的注解的生命周期全部是RetentionPolicy.CLASS。接下来准备在项目中大量推广使用。