Android 中注解的使用

转载请标明出处： http://blog.csdn.net/airsaid/article/details/78017487
本文出自：周游的博客

前言

Android Support Library 从 19.1 版本开始引入了一个新的注解库，其中包含了很多的元注解，使用它们修饰我们的代码， 可以让我们提高程序的开发效率，让我们更早的发现问题。以及对代码施以规范，让代码更加有可读性。这篇文章就来简单了解下这些注解，以及其使用。如有错误和遗漏，欢迎留言和补充～

注：现在我们新建项目直接就依赖了 support.appcompat 包，其中已经依赖了 annotations 包。如果你的项目中写如下注解报错，可以添加注解包：

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

@IntDef & @StringDef

替代 Java 中枚举的注解，以 @IntDef 为例，定义和使用如下：

@IntDef({RED, BLUE, YELLOW})
@Retention(RetentionPolicy.SOURCE)
public @interface LightColors{
   };

public static final int RED = 1;
public static final int BLUE = 2;
public static final int YELLOW = 3;

public void setColor(@LightColors int color){
}

• @interface：声明新的枚举注解类型。
• @Retention(RetentionPolicy.SOURCE)：告知编译器不将枚举的注解数据存储在 .class 文件中。

如果允许常量与标志（例如：|、& 和 ^ 等等）相结合，则我们可以使用 flag 属性，如：

@IntDef(flag = true, value = {RED, BLUE, YELLOW})

使用：

setColor(RED | BLUE);

@Nullable & @NonNull

• @Nullable：注解的元素可以为 null。
• @NonNull：注解的元素不可以为 null。

上面的注解可以修饰如下元素：
1，方法参数。如：

@Nullable
private String data;

2，方法的返回值。 如：

@Nullable
public String getData(){
    return data;
}

3，成员属性。如：

public void setData(@Nullable String data){
}

当用空的参数传给被 @NonNull 修饰的方法参数的方法时，会给出如下警告提示（编译不会报错）：