basic-android-annotations

[codingWang]

Annotation -注解

1.注解可用于修饰：

• 类
• 方法
• 参数
• 变量
• 构造器

2.注解的处理

• 编译器：注解处理器
• 运行期：反射

3.Java中的注解

• @Documented:注解是否包含在JavaDoc中
• @Retention:什么时候使用该注解
  • RetentionPolicy.SOURCE 不出现在class文件
  • RetentionPolicy.CLASS 出现在class
  • RetentionPolicy.RUNTIME 运行时可获取
• @Target:注解用于什么地方
  • CONSTRUCTOR:构造器
  • FIELD:属性
  • LOCAL_VARIABLE:局部变量
  • METHOD:方法
  • PACKAGE:包
  • PARAMETER:参数
  • TYPE:类、接口、枚举
• @Inherited:是否允许子类继承该注解
• @Override:当前方法的定义将覆盖超类中的方法
• @Deprecated:标记已经废弃的代码
• @SuppressWarnings:关闭编译器警告信息
• @Repeatable:表示当前注解对于同一对象可以重复使用

4.Android中的注解

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

• @IntDef / @StringDef :将参数设置为待枚举的集合
• @IntRange / @FloatRange :限定区间范围
• @Nullable / @NonNull :注解元素可以为Null/注解元素不能为Null
• @RequiresPermission :声明权限
• @ColorInt :标记参数为颜色值类型
• @CheckResult :检查函数返回值是否被使用

  Resource Annotations：

  @AnimatorRes   @AnimRes   @ArrayRes   @AttrRes   @BoolRes
  @ColorRes  @DimenRes  @DrawableRes  @FractionRes  @IdRes
  @IntegerRes  @InterpolatorRes  @LayoutRes  @MenuRes @PluralsRes
  @RawRes   @StringRes   @StyleableRes   @StyleRes   @XmlRes

Thread Annotations

 @UiThread //标注方法在UI线程执行
 @MainThread //主线程对象
 @WorkerThread //后台工作线程
 @BinderThread //
 @AnyThread

• @CallSuper :重写的方法必须调用父类的super方法
• @Keep : 不混淆

参考1 参考2 参考3