Android注解使用之使用Support Annotations注解优化代码
2016-07-18 08:51
447 查看
前言:
前面学习总结了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。
![](http://images2015.cnblogs.com/blog/950883/201607/950883-20160717075412795-1453355887.png)
@NonNull注解可以用来标识参数不能为null。
![](http://images2015.cnblogs.com/blog/950883/201607/950883-20160717074535311-658355272.png)
2.)Resource Type 注解
资源在Android中作为整型值来传递。这意味着希望获取一个drawable作为参数的代码很容易被传递了一个string类型的资源,因为他们资源id都是整型的,编译器很难区分。Resource Type注解在这种条件下可以提供类型检查,例如:
如果类型指定错误,编译不会通过。
![](http://images2015.cnblogs.com/blog/950883/201607/950883-20160717095410248-1560097621.png)
常见的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注解,表示你期望的是一个代表颜色的整数值,如果使用不对同样也是编译不通过
![](http://images2015.cnblogs.com/blog/950883/201607/950883-20160717084117686-1895460030.png)
3.)Threading 注解
比如我们在项目中处理比较耗时的操作,需要制定在工作子线程中执行,可以使用Threading 注解,如果没有在制定的线程中执行也是编译不过的
![](http://images2015.cnblogs.com/blog/950883/201607/950883-20160717082551670-407314090.png)
几种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{}
需要在调用时只能传入指定类型,如果传入类型不对,编译不通过
![](http://images2015.cnblogs.com/blog/950883/201607/950883-20160717093523654-1222968746.png)
5.)Value Constraints注解:@Size, @IntRange, @FloatRange
在实际开发过程中,我们有时可能需要设置一个取值范围,这时我们可以使用取值范围注解来约束。
比如我们设置一个百分比,取值范围为0-100,
![](http://images2015.cnblogs.com/blog/950883/201607/950883-20160717084930170-234580957.png)
对于数据、集合以及字符串,你可以用@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)
用了这个后,当重写的方法没有调用父方法时,工具就会给予标记提示
![](http://images2015.cnblogs.com/blog/950883/201607/950883-20160717091320248-921952184.png)
8.)Return Values注解: @CheckResult
如果你的方法返回一个值,你期望调用者用这个值做些事情,那么你可以使用@CheckResult注解标注这个方法。
这个在具体使用中用的比较少,除非特殊情况,比如在项目中对一个数据进行处理,这个处理比较耗时,我们希望调用该函数的调用者在不需要处理结果的时候,提示没有使用,酌情删除调用。
![](http://images2015.cnblogs.com/blog/950883/201607/950883-20160717094140342-741590737.png)
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。接下来准备在项目中大量推广使用。相关文章推荐
- Android通知栏
- Android调试命令小结
- IntentService的使用
- [android-x86-6.0-rc1] after start netd - netstat
- android中使用底部菜单栏造成Viewpager+fragment中ListView数据被隐藏一条的解决
- android学习之蓝牙
- Android数据存储总结
- android五大布局之-RelativeLayout
- Windows 系统下进行 Android 集成开发环境搭建
- Android 中的数据存储----SharePreferences 存储
- Android 中的数据存储----文件存储
- Android线程相关编程
- Android动画之---属性动画
- 学了很久的android,你可能还是没有理解清楚的Context
- 自定义Activity标题栏
- Android权威编程指南学习笔记1
- Android 热补丁的一些总结
- Android JNI初步☞Java方法和native方法关联
- 设置Activity全屏显示
- android实现消息推送的解决方案