深入浅出Android Support Annotation

导读：如果你之前遇到过在方法参数前面有@NonNull 的情况却不知道它是干什么的，这

篇文章将解答你的疑问。*

原文如下：

在 Android Support Library19.1 版本中，Android 工具小组引入了几个很酷的注解类

型，供开发者在工程中使用。Support Library 自身也使用这些注解，这是一个好兆头。

就让我们好好研究下。*通过 gradle 可以很容易的把这些注解添加到我们的工程中：

compile 'com.android.support:support-annotations:20.0.0'

有三种类型的注解可供我们使用：



IntDef 和 StringDef 注解；



我们将通过代码例子来讲解每一种类型的作用以及在工程中如何使用它们。

Nullness 注解

使用@NonNull 注解修饰的参数不能为 null。在下面的代码例子中，我们有一个取值为

null 的 name 变量，它被作为参数传递给 sayHello 函数，而该函数要求这个参数是非

null 的 String 类型：

public class MainActivity extends ActionBarActivity {

sayHello(name);

}

void sayHello(@NonNull String s) {

Toast.makeText(this, "Hello " + s, Toast.LENGTH_LONG).show();

}

}

public class MainActivity extends ActionBarActivity {

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

User user = new User("Our Lord Duarte");

Toast.makeText(this, "Hello " + getName(user),

}

}



因为 getName 函数的返回值使用@Nullable 修饰，所以调用：

Toast.makeText(this, "Hello " + getName(user),

Toast.LENGTH_LONG).show();

没有检查 getName 的返回值是否为空，将可能导致 crash。

资源类型注解

是否曾经传递了错误的资源整型值给函数，还能够愉快的得到本来想要的整型值吗？资源

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

sayHello(R.style.AppTheme);

}

void sayHello(@StringRes int id) {

Toast.makeText(this, "Hello " + getString(id),

Toast.LENGTH_LONG).show();