Android 随笔——Android必须知道的注解Annotations

转载请标明地址 QuincySx： www.jianshu.com/p/95b8ae422…

先讲一下这是什么这个算是一种注解辅助的库，在我们合作开发的时候进行一定的约束，我这样说大家可能不太理解，大家继续往下看自行理解一下这个库就在我们的 v7 包里面，基本每个项目都会引入，可能只是大家没用到而已如图

今天我要写的就是把这类里面我自己比较常用的一些注解给大家分享一下

@NonNull

首先看一下 @NonNull 注解他的意思是参数不能为空的意思


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

        hello("sss"); //正常调用没有问题

        hello(null); //当这样写的写的时候编译器报了个警告
}

//一个普通的方法
public void hello(@NonNull String s) {

}

警告不能为空

@UiThread

这个注解的意思是该方法在主线程下运行

 @UiThread
    public void hello1() {

    }

资源文件类的注解

然后下面这些一块说 @AnimatorRes @ColorRes @DimenRes @DrawableRes @LayoutRes 等等像这样以 Res 结尾的注解表示这些参数只能是资源文件下面用 @ColorRes 举个例子

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

        setColor(12);  //报错 Expected resource of type color
        
        setColor(R.color.colorPrimary);  //不报错没有问题
    }

    //只允许设置资源里面的颜色
    public void setColor(@ColorRes int color) {

    }

其他的与上面用法基本相同，因为参数都是 Int 类型的,传的时候可能会有些困扰，这个库就可以解决这些问题

@IntDef

光有 Android 自带的 Int 类型过滤，这个注解可以进行自定义示例：

public final static int LOADING = 10;
public final static int SUCCESS = 11;

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

        setStatus(LOADING);  //没有问题
        
        // 以下这两种方式都会显示错误
        setStatus(10); 
        setStatus(1); 
}

@IntDef({LOADING , SUCCESS })
public @interface TestStatus{
}

//只允许设置资源里面的颜色
public void setStatus(@TestStatus int status) {

}

其他补充

下面再说一点题外话对于Android的颜色我也是看到 @ColorRes @ColorInt 这两个注解，才研究了一下，之前对于设置背景的 Color 参数都是 Int 类型，为什么有的需要 getResources() 去取，有的则不需要，下面看源码

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

        setColorInt(Color.BLUE);  //直接传 Java 里面的颜色

        setColorInt(Color.parseColor("#cccccc"));  //把 HTML 样式的颜色转换过来使用

        setColorInt(0XFFCCCCCC);  // 这种方式要简单说一下了 前两位 0X 是固定的,小写也没有关系,然后是后面两位 FF 这是表示颜色透明度，后面 6 位代表颜色值，他与上面的写法效果是一样的

        setColor(R.color.colorPrimary);  //使用资源文件里面的颜色
}

public void setColor(@ColorRes int color) {
        //用资源文件里面的颜色需要对颜色进行转换一下，在对控件进行使用
        mTextView.setBackgroundColor(getResources().getColor(color));
}

public void setColorInt(@ColorInt int color) {
        //对颜色的值可以直接进行使用
        mTextView.setBackgroundColor(color);
}

总结

很简单的知识点，但是使用频率还是很高的本人技术水平有限，如有错误还请指出