注解的作用及使用

一、注解的作用

      注解是我们开发中经常遇到的，如setContentView需要传的layout类型的资源参数，而我们传入string类型的资源参数，因为资源参数都是int类型，所以不会报错，只有在编译的时候才会报错，为了避免这个问题，在传参数的时候就知道传入错误，就需要使用注解

    

Nullness注解

               @Nullable作用于函数参数或者返回值，标记参数或者返回值可以为空

               @NonNull作用于函数参数或者返回值，标记参数或者返回值不可以为空

使用如下：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.fragment_transition_scene_before);
    
    helloword(null);
}

    private void helloword(@NonNull String s){
        
    }

当传入null的时候就studio中就会有提示，这样就可以在不运行的时候就知道传错了参数

 资源类型注解

         传入的资源都是int类型，很容易传错，所以需要添加资源注解，注解列表如下：

               @AnimatorRes : 标记整型值是android.R.animator类型

               @AnimRes : 标记整型值是android.R.anim类型

               @AnyRes : 标记整型值类型是任何一种资源类型，如果确切知道表示的是哪一种具体资源的话，建议显示指定

               @ArryRes : 标记整数型值是android.R.array类型

               @AttrArs : 标记整形值是adnroid.R.attr类型

               @BoolRes : 标记整型值是布尔类型

               @ColorRes : 标记整型值是android.R.color类型

               @DrawableRes : 标记整型值是android.R.drawable类型

               @FractionRes : 标记整型值是fraction类型，这个比较少见，这种类型的资源常见于Animation Xml中，比如50%p,表示占parent的50%

               @IdRes : 标记整型值是android.R.id类型

               @IntegerRes : 标记整型值是android.R.integer类型

               @InterpolatorRes : 标记整型值是android.R.interpolator类型

               @LayoutRes : 标记整型值是android.R.layout类型

               @MenuRes : 标记整型值是android.R.menu类型

               @PluralRes : 标记整型值是android.R.plurals类型，表示复数字符串类型

               @RawRes  : 标记整型值是android.R.raw类型

               @StringRes : 标记整型值是android.R.string类型

               @StyleableRes : 标记整型值是android.R.styleable类型

               @StyleRes : 标记整型值是android.R.style类型

               @TransitionRes : 标记整型值是transtion类型

               @XmlRes : 标记整型值是android.R.xml类型

线程注解

               @UiThead : 标记运行在UI线程，一个UI线程是Activtiy运行所在的主窗口，对于一个应用而言，可能存在多个UI线程，每个UI线程对应不同的主窗口

               @MainThread : 标记运行在主线程，一个应用只有一个主线程，主线程也是@UiThread线程，通常情况下，我们使用@MianThread来注解生命周期相关的函数，使用@UiThread来注解视图相关函数，一般情况下，@MainThread和@UiThread是可以互换的

               @WorkerThread : 标记运行在后台的线程

               @BinderThread ： 标记运行在Binder线程

实列子可以参看AsyncTask源码

值范围注解

               当函数参数的取值在一定范围的内时，可以使用值范围注解来防止调用者传入错误的参数，这种类型主要有三种：

          1、@Size：对于类似数组、集合和字符串之类的参数，可以使用@Size注解来表示这些参数的大小,用法如下：

              

               @Size(min= 1) ： 可以表示集合不为空

               @Size(max=23) : 可以表示字符串最大字符个数是23

               @Size(2) : 可以表示数组元素的个数是2个

               @Size(multiple=2) : 可以表示数组大小是2的倍数

          2、@IntRange：参数类型是int或long，用法如下：

               public void setAlpha(@IntRange(from=0,to=255) int alpha){...}

          3、@FloatRange : 参数类型是float或者double，用法如下：

               public void setAlpha(@FloatRange(from=0.0 , to-1.0) float alpha){...}

权限注解

               为了编译时及时发现缺失的权限，我们可以是用@RequiresPermission注解

          

          1、如果函数调用需要声明一个权限，实现如下：

               @RequiresPermission(Manifest.permission.SET_WALLPAPER)

               public abstract void setWallpaper(Bitmap bitmap) throws IOException;

          2、如果函数需要声明集合中至少一个权限，实现如下：

                @RequiresPermission(anyof = {

                          Manifest.permission.SET_WALLPAPER，

                         Manifest.permission.ACCESS_FINE_LOCATION })

                public abstract void setWallpaper(Bitmap bitmap) throws IOException;

          3、同时声明多个权限，实现如下:

                @RequiresPermission(allof = {

                      Manifest.permission.SET_WALLPAPER，

                     Manifest.permission.ACCESS_FINE_LOCATION })

                 public abstract void setWallpaper(Bitmap bitmap) throws IOException;

         4、对于Intent调用所需权限，可以在Intent的ACTION字符串定义处添加注解，实现如下：

                @RequiresPermission(andorid.Mainfest.permission.BUUETOOTH)

                  public static final String ssss = "ppppppppppppppppp"

         5、对于ContentProvider相关所需的权限，可能同时需要读和写这两个操作，对应不同的权限声明如下：

               @RequiresPermission.Read(@RequiresPermission(READ_HISTORY_BOOKMARKS))

                @RequiresPermission.Write(@RequiresPermission(WRITE_HISTORY_BOOKMARKS))

                  public static final Uri ssss = Uri.parse("content://....")

重写函数注解

          如果重写父类的某个函数，同时重写的函数需要调用被重写的函数，否者出现逻辑错误，那么就可以使用@CallSuper注解来提示开发者,实现如下:

          @CallSuper

          protected void onCreate(@Nullable Bundle savedInstanceState);

@Keep注解

          混淆代码时可以在代码中标记不混淆的方法

          @Keep

           public void String sssss(){...}

以上是一些简单的注解列表，希望对你有所帮助！