百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术教程 > 正文

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

csdh11 2025-03-11 14:51 4 浏览

前言:

前面学习总结了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的参数、成员变量、或者方法,检查对应的资源类型。

  • AnimatorResanimator资源类型
  • AnimResanim资源类型
  • AnyRes:任意资源类型
  • ArrayResarray资源类型
  • AttrResattr资源类型
  • BoolResboolean资源类型
  • ColorRescolor资源类型
  • DimenResdimen资源类型。
  • DrawableResdrawable资源类型。
  • FractionResfraction资源类型
  • IdResid资源类型
  • IntegerResinteger资源类型
  • InterpolatorResinterpolator资源类型
  • LayoutReslayout资源类型
  • MenuResmenu资源类型
  • PluralsResplurals资源类型
  • RawResraw资源类型
  • StringResstring资源类型
  • StyleableResstyleable资源类型
  • StyleResstyle资源类型
  • TransitionRestransition资源类型
  • XmlResxml资源类型

以上基本上包括了所有的资源类型,但是有时需要通过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。接下来准备在项目中大量推广使用。

相关推荐

如何在HeidiSQL工具中查看SQL的执行时间

在HeidiSQL工具中,可以通过两种方式查看SQL语句的执行时间:1.SQL日志(SQLLog)窗口HeidiSQL的SQL日志窗口会记录所有执行的SQL语句及其执行时间。specifical...

SQL学习:实例讲解SQL必会的12个高频语句

在数据库查询中,总结了12个高频常用SQL语句,供大家参考学习:1、复制表结构,不包括数据(用于建立同一个表结构)...

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

前言:前面学习总结了Java注解的使用,博客地址详见Java学习之注解Annotation实现原理,从本质上了解到什么注解,以及注解怎么使用?不要看见使用注解就想到反射会影响性能之类,今天我们就来学习...

Android多任务并行下载、断点续传

多任务并行下载,断点续传,要做起来其实还是很麻烦的,所以推荐一个开源库,这个开源库叫Aria,刚好是我前一久搞断点续传时发现的,仔细了解后发现,真香!!!它简单易用,是个稳当高效的下载框架,不仅可以...

微信8.0.19安卓内测版怎么升级 微信8.0.19内测版下载与更新一览

昨天夜间,安卓版微信8.0.19再次迎来了更新!距离正式版间发布隔了一周,经过短暂体验同样带来不少新功能。在此前已经上线了iOS版微信中的语音消息断续播放和批量删除好友功能,也在本次微信8.0.19内...

android使用greendao来保存数据

有时我们的数据属于保存到数据库,对于Android应用和IOS应用,我们一般都会使用SQLite这个嵌入式的数据库作为我们保存数据的工具。由于我们直接操作数据库比较麻烦,而且管理起来也非常的麻烦,所以...

AndroidStudio_安卓原生开发_FileProvider使用

在制作apk在线升级的功能的时候,需要首先去,请求后台接口,去获取是否有需要更新的版本,有的话需要先去下载对应版本的文件,保存在手机上,然后再去,获取这个版本文件,获取的时候,需要用到文件共享.这个时...

详解安卓的FileProvider是如何提升文件共享安全的

自Android7.0开始,Android框架开启了严格模式(StrictMode),禁止应用将file:///开头的Uri共享给其他的应用读写文件,否则会收到...

咋回事?第一代摩托Moto X 还没吃上安卓5.0

IT之家讯2月11日消息,想必第一代MotoX用户感觉自己身处“噩梦”中。摩托罗拉家所有手机,甚至是档次比较低的MotoG和MotoE都已经吃上或正准备开吃Android5.0。那么为何第一...

推理帝的胜利:Android L 官方正式版代号叫柠檬蛋白派?

按照Android版本命名法则,在Android4.4被命名为KitKat之后,接下来的Android版本命名应该与L有关,所以在AndroidL测试版被公布之后,我们几乎...

「图」iOS端Outlook正测试共享邮箱功能 Android端随后开放

iOS端Outlook正在测试共享邮箱(SharedMailboxes)功能。微软iOS平台产品线的负责人MichaelPalermiti今天宣布已启动测试工作,该功能允许多个用户从公共邮箱(例如...

用上它,你就能体验到 MIUI 12 最令人惊艳的功能

MIUI12前天发布会上推出的全局自由小窗功能,完善程度着实令人惊喜。厂商为提升用户体验各显其能,作为用户当然举双手欢迎。但一想到我卑微的原生安卓用户身份,以及目前Android8.0才是安...

安卓微信8.0内测下载地址分享:安卓机升级微信8.0动态表情试用

安卓微信8.0内测哪里下载?相信很多用户在寻找微信8.0的安卓内测包,现在小编给大家带来了微信8.0安卓内测邀请链接,感兴趣的小伙伴赶紧试试吧!安卓微信8.0内测版本:点击进入链接在浏览器打开后,复制...

您所请求的网址(URL)无法获取

发生了下列的错误:Unabletoforwardthisrequestatthistime.目前无法将您的请求进行转送操作Thisrequestcouldnotbefor...

深入浅出SlidingMenu

如果想直接查看源码的话可以从我的Github上下载查看:https://github.com/zhanghuijun0/demo-for-android/tree/master/SlidingMenu...