安卓注解详解：Nullness、资源类型、权限与更多-优快云博客

本文链接：https://blog.youkuaiyun.com/u010331406/article/details/49128715

本文介绍了安卓注解的使用，包括Nullness注解如@NonNull和@Nullable，资源类型注解如@ColorRes，权限注解，CallSuper注解以及枚举注解。通过示例展示了这些注解如何影响编译器警告和提高代码质量，鼓励开发者在项目中应用注解以提升团队协作效率。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

博客：安卓之家
微博：追风917
优快云：蒋朋的家
简书：追风917
博客园：追风917

Annotation

Annotation就是注解了，JDK1.5新增加功能，该功能可用于类，构造方法，成员变量，方法，参数等的声明中，比如常见的@Override，butterknife库里的@Bind, 该功能并不影响程序的运行，但是会对编译器警告等辅助工具产生影响。

关于java注解的详细介绍，包括概念，作用，分类，解析及几个常用的安卓库的原理解析等请来这里查看：Java Annotation 及几个常用开源项目注解原理简析

Android Annotation

Android Annotation是以Support Library的形式给我们提供的，从安卓19.1开始出现，该包在sdk目录\Sdk\extras\android\m2repository\com\android\support\support-annotations下：

android annotation

api版本23下，android studio里是直接可以使用的，不用添加依赖库，以前的api可能需要，请酌情增删。api23暂时有39个注解，可以这里查看：

buildtool23

安卓注解有8种类型，分别是Nullness注解、资源类型注解、线程注解、变量限制注解、权限注解、结果检查注解、CallSuper注解、枚举注解(IntDef和StringDef)。

下面简单摘录几个，以飨读者：

Nullness注解

包括@NoNull和@Nullable，这里以@NoNull为例说明：

先看下@NoNull的源码：

    @Retention(CLASS)
    @Target({METHOD, PARAMETER, FIELD})
    public @interface NonNull {
    }

这里我们知道，@NoNull编译到类文件里，应用于方法，参数和成员变量，下面我们先来一发：

public class MainActivity extends Activity {
    @NonNull private String str;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        str = null;
    }
}

我们给成员变量str加上了@NoNull注解，也就是str不能为null，而后面我们把str初始化为null，此时as编译器这样提示我们：

nonull

也就是str不能为空，这就像是一种约定，很像c语言里的断言assert。这样有什么好处呢？这样可以避免后面的频繁判断str是否为空的操作，如果和别的项目配合呢，可能会出现某些bug，而使用注解可以很好的用于团队合作，项目维护起来也方便。

资源类型注解

此类注解以Res结尾，比如@BoolRes, @IdRes, @IntegerRes, @StringRes, @ColorRes等，这里以@ColorRes为例说明

先看下@ColorRes的源码：

    @Documented
    @Retention(CLASS)
    @Target({METHOD, PARAMETER, FIELD, LOCAL_VARIABLE})
    public @interface ColorRes {
    }

这里我们知道，@ColorRes在编译时生效，使用于方法，参数和成员变量和局部变量，下面我们再来一发：

public class MainActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        getCurColor(R.id.ic_launcher);
    }

    void getCurColor(@ColorRes int color) {
        Toast.makeText(this, "Color: " + getString(color), Toast.LENGTH_LONG).show();
    }
}

我们给getColor函数的参数color加上了@ColorRes注解，即该参数是一个颜色资源，而上面我们上面传递的是id资源，此时as编译器这样提示我们：

color

我们这样调用就ok的

    getCurColor(R.color.material_blue_grey_900);

：看到了吧，好玩吗？
：嗯，as很好很强大，，，
：好的，我们继续。

权限注解

直接上代码了，源码自己查阅咯

    @RequiresPermission(Manifest.permission.SET_WALLPAPER)
    public abstract void setWallpaper(Bitmap bitmap) throws IOException;

此例说明setWallpaper方法有设置壁纸的权限。

CallSuper Annotations

直接来了哈，我们看Activity.java源码里的onCreate方法

    @CallSuper
    protected void onCreate(Bundle savedInstanceState) {
    }

@CallSuper说明所有重写onCreate()方法的方法都要有super.onCreate();

枚举注解

有时候，基于性能的考虑，需要用整型常量代替枚举类型，此时枚举注解可以轻松搞掂，这就是大名鼎鼎的@IntDef and @StringDef，我们看看@IntDef源码

    @Retention(Source)
    @Target({ANNOTATION_TYPE})
    public @interface IntRef {
        long[] value() default {};
        boolean flag() default false;
    }

可见该注解表示不编译annotation到类文件中，用于注解类型，再来一发？好的，我们看看ActionBar源码吧：

import android.support.annotation.IntDef;
...
public abstract class ActionBar {
    ...
    //Define the list of accepted constants
    @IntDef({NAVIGATION_MODE_STANDARD, NAVIGATION_MODE_LIST, NAVIGATION_MODE_TABS})

    //Tell the compiler not to store annotation data in the .class file
    @Retention(RetentionPolicy.SOURCE)

    //Declare the NavigationMode annotation
    public @interface NavigationMode {}

    //Declare the constants
    public static final int NAVIGATION_MODE_STANDARD = 0;
    public static final int NAVIGATION_MODE_LIST = 1;
    public static final int NAVIGATION_MODE_TABS = 2;

    //Decorate the target methods with the annotation
    @NavigationMode
    public abstract int getNavigationMode();

    //Attach the annotation
    public abstract void setNavigationMode(@NavigationMode int mode);