使用Android注解来改善代码

宝剑锋从磨砺出,梅花香自苦寒来。这篇文章主要讲述使用Android注解来改善代码相关的知识,希望能为你提供帮助。
昨晚看到一篇好文章。然后是英文的。所以决定翻译分享给大家。这是原文链接:http://www.michaelevans.org/blog/2015/07/14/improving-your-code-with-android-support-annotations/
假设你还没听说过android支持注解库,那么你将错过能够帮助你捕获bug的一个轻便灵活的新包。
在这个库中包括了非常多java的注解,它将帮助Android Studio为了可能出现的错误来检查你的代码,而且反馈通知给你。这个库有相当多的注解。在此我仅仅打算说明几个,可是假设你须要其余部分完整清晰的说明文档,能够在这里查看:check out the docs。


@NonNull 与 @Nullable
【使用Android注解来改善代码】@NonNull 与 @Nullable 可能是支持注解中最基础的,可是绝大多数情况下还是非常实用的。 假设參数或者方法的返回值可能是null为空的,则以凝视一个參数或者方法来表示。
眼下Android Studio 给予了一个非常好的警告提示。在我们做了一些不安全严谨的编码操作的时候。
比如这样:

使用Android注解来改善代码

文章图片

改动后是这样:
使用Android注解来改善代码

文章图片


更赞的是:我们甚至能够像样例一样更进一步的使用@CheckResult注解,来告诉我们该方法的返回值类型是我们估计要使用的,而不是错误效果的方法:
使用Android注解来改善代码

文章图片


@StringRes 与 @DrawableRes 等等
你是不是在TextView上调用setText方法。常常会出现莫名其妙的异常java android.content.res.Resources$NotFoundException: String resource ID #0x3039? 假设设置了一个整型数给setText。TextView会假定这个整型数是一个字符串的资源id,为了设置string文本将会查询这个整数。
对于整型数是无效的资源id的问题,能够通过@StringRes 注解来补救。

public void setText(@StringRes int id) { // Do something like getString(id), etc. }

假设你设置无效的字符串资源id到setText方法里。就会例如以下图显示:
使用Android注解来改善代码

文章图片

这个库还为全部的资源类型都提供了相相应的资源注解:[email  protected], @ColorRes,@InterpolatorRes, 等等。


@Keep
今天发现了一个新支持注解@Keep。依据注解文档描写叙述,这个注解还没有连接到Gradle插件中,可是当在混淆app的时候通过凝视方法和类能够被保留。
这个便捷的注解就通知混淆器保留相应的方法和类,就像这样:
public class Example { @Keep public void doSomething() { // hopefully this method does something } ... }

假设你正在用的是appcompat-v7的包,就已经包括了 support-annotations的库,那就開始愉快的使用吧!(逗比这么简单的文章还要你翻译。臭不要脸的…Orz!

以上check out the docs链接处须要FQ才干打开!












    推荐阅读