Java Android 注解

一 注解说明

注解(Annotation)，也叫元数据。从 JDK 1.5 开始，java 开始支持注解。它是JDK1.5及以后版本引入的一个特性，与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面，用来对这些元素进行说明，注释。文档 JSR-269 将它规范化，在 JDK 1.6 写入编译器 javac 中。

二 注解分类

【内置注解】

1. 作用在代码的注解

@Override - 检查该方法是否是重载方法。如果发现其父类，或者是引用的接口中并没有该方法时，会报编译错误。
@Deprecated - 标记过时方法。如果使用该方法，会报编译警告。
@SuppressWarnings - 指示编译器去忽略注解中声明的警告。

2. 作用在其他注解的注解(或者说 元注解)

@Retention - 标识这个注解怎么保存，是只在代码中，还是编入class文件中，或者是在运行时可以通过反射访问。
@Documented - 标记这些注解是否包含在用户文档中。
@Target - 标记这个注解应该是哪种 Java 成员。
@Inherited - 标记这个注解是继承于哪个注解类(默认 注解并没有继承于任何子类)

3. 从 Java 7 开始，额外添加了 3 个注解

@SafeVarargs - Java 7 开始支持，忽略任何使用参数为泛型变量的方法或构造函数调用产生的警告。
@FunctionalInterface - Java 8 开始支持，标识一个匿名函数或函数式接口。
@Repeatable - Java 8 开始支持，标识某注解可以在同一个声明上使用多次。

【自定义注解】

三 注解作用域

1. 通过元注解@Retention标识注解生命周期：

源码时注解（RetentionPolicy.SOURCE） //源代码注解 仅在源码有效
编译时注解（RetentionPolicy.CLASS）  //编译是注解 class文件有效
运行时注解（RetentionPolicy.RUNTIME）  //运行时注解 运行时有效 可以反射访问

2. 通过元注解@Target 标识注解作用范围：

PACKAGE:用于包
TYPE:用于类、接口(包括注解类型) 或enum声明
FIELD:用于属性
CONSTRUCTOR:用于构造器
METHOD:用于方法
PARAMETER:用于参数
LOCAL_VARIABLE:用于局部变量
ANNOTATION_TYPE：用于注解类型

四 自定义注解

上面主要描述了关于注解的一些说明，接下来通过一个示例尝试自定义一个注解：
1.自定义注解格式

public @interface 注解名 { 定义体 }

2.注解参数数据类型

• 所有基本数据类型（int,float,boolean,byte,double,char,long,short)
• String类型
• Class类型
• enum类型
• Annotation类型
• 以及以上所有类型的数组

3.android应用示例

//注解类
@Retention(RetentionPolicy.RUNTIME) //运行时注解
@Target(ElementType.FIELD) //作用于属性
public @interface BindView {
    @IdRes
    int value() default -1;
}

//注解解析类
public class Bind {
    public static void inject(Activity activity) {
        Class<?> target = activity.getClass();
        Field[] fields = target.getDeclaredFields();
        try {
            for (Field field : fields) {
                if (field.isAnnotationPresent(BindView.class)) {
                    BindView bind = field.getAnnotation(BindView.class);
                    if (bind.value() != -1) {
                        field.setAccessible(true); //field设置
                        field.set(activity, activity.getWindow().getDecorView().findViewById(bind.value()));
                    }
                }
            }
        } catch (IllegalAccessException e) {
            e.printStackTrace();
        }
    }
}

//测试Activity 布局就一个TextView就不给出了（默认android:text = "cs"）
public class BindActivity extends AppCompatActivity {

    @BindView(R.id.test)
    TextView test;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_bind);
        test.setText("测试");
    }
}

4.示例运行效果

运行效果图.png