Java自定义注解

注解说明

Java注解又称Java标注，是Java语言5.0版本开始支持加入源代码的特殊语法元数据。为我们在代码中添加信息提供了一种形式化的方法，使我们可以在稍后某个时刻非常方便的使用这些数据。
Java语言中的类、方法、变量、参数和包等都可以被标注。和Javadoc不同，Java标注可以通过反射获取注解内容。在编译器生成类文件时，注解可以被嵌入到字节码中。Java虚拟机可以保留注解内容，在运行时可以获取到注解内容。

Java中的注解

java.lang中定义了3个作用在代码上的注解

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

java.lang.annotation中定义的4个元注解（作用在其他注解上的注解）

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

Java 7 中又额外加入了3个注解

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

n(表示数列的长度，即n个数)，接下来一行n个无序的数

元注解

@Retention——指定标记注释的存储方式即注解在什么范围有效

RetentionPolicy.SOURCE:在源文件中有效（即源文件保留）
RetentionPolicy.CLASS:在class文件中有效（即class保留）
RetentionPolicy.RUNTIME:在运行时有效（即运行时保留）

@Target——限制注解应用的Java元素类型

ElementType.ANNOTATION_TYPE 可以应用于注释类型。
ElementType.CONSTRUCTOR 可以应用于构造函数。
ElementType.FIELD 可以应用于字段或属性。
ElementType.LOCAL_VARIABLE 可以应用于局部变量。
ElementType.METHOD 可以应用于方法级注释。
ElementType.PACKAGE 可以应用于包声明。
ElementType.PARAMETER 可以应用于方法的参数。
ElementType.TYPE 可以应用于类的任何元素。

@Documented——注解应使用Javadoc工具记录这些元素。(默认注释不包含在javadoc中)

@Inherited——表明注释类型可以从超类继承，及注解可以被子类继承

自定义注解

Java中自定义注解和创建一个接口相似，自定义注解的格式是以@interface为标志的。

自定义一个注解，给作用在属性上给String属性赋值

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Inherited
public @interface setValue {
    String value() default "defaulf value";
}

新建一个User对象并使用在name属性上使用注解

@Data
public class User {
    @setValue(value = "antsit")
    private String name;
    private Integer age;
    @setValue
    private String deault;
}

在测试代码中使用Java反射实现注解业务

public class Test {
    public static void main(String[] args) throws IllegalAccessException {
        User user=new User();
        Class clazz=user.getClass();
        Field[] fields=clazz.getDeclaredFields();
        for(Field field:fields){
            if(field.isAnnotationPresent(setValue.class)){
                setValue setValue=field.getAnnotation(setValue.class);
                String nameValue=setValue.value();
                field.setAccessible(true);//取消属性的访问权限控制，即使private属性也可以进行访问
                field.set(user,nameValue);
            }
        }
        System.out.println(user.toString());
    }
}

目录CONTENT