JavaSE自学笔记专题_Real（注解Annotation）

JavaSE自学笔记专题_Real（注解Annotation）

一、注解基本概念

1、注解，又叫做注释，英文单词Annotation
2、注解Annotation是一种引用数据类型，编译之后也是生成xxx.class文件
3、注解的定义：

	[修饰符列表] @interface 注解类型名{
	注解里面的内容
}

4、怎样使用？
（1）注解的语法格式：
@注解类型名
（2）注解用在什么地方：
类上面、方法上面、属性上面、变量上面等… …
注解还能修饰注解，甚至是修饰自己。

二、JDK内置了那些注解？

1、Deprecated：用@Deprecated注释的程序元素，不鼓励程序员使用这样的元素，通常是因为他很危险或存在更好的选择。
2、Override：表示一个方法声明打算重写超类的另一个方法声明。
（1）@Override这个注释只能注解方法；
（2）@Override这个注解是给编译器参考的，何运行阶段没有关系；
（3）凡是java中的方法带有这个注解的，编译器将会进行编译检查，如果这个方法不是重写父类的方法，编译器会报错。
3、SuppressWarnings：指示应该在注释元素（以及包含在该元素种的所有程序元素）种取消显示指定的编译器警告

三、元注解

1、什么是元注解？
用来标注注解类型的注解，称为元注解

//这是Override注解的定义
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}

2、常见的元注解：
(1)Target
这是一个元注解，用来标注注解类型的注解
这个Target注解用来标注被标注的注解可以出现在哪些位置上
@Target(ElementType.METHOD)：表示被标注的注解只能出现在方法的上面
(2)Retention
这是一个元注解，用来标注注解类型的注解
这个注解用来标注被标注的注解最终保存在哪里。
@Retention(RetentionPolicy.SOURCE)：表示该注解只能保留在Java源文件中
@Retention(RetentionPolicy.CLASS)：表示该注解被保存在class文件中
@Retention(RetentionPolicy.SOURCE)：表示该注解被保存在class文件中，并且可以在反射机制中被读取到

四、自定义注解的自定义属性

1、自定义注解的属性值

public @interface MyAnnotation {
    /**
     * 我们通常在注解当中可以定义属性，以下这个是MyAnnotation的name属性
     * 看着像一个方法，但是称之为属性name
     */
    String name();

    /**
     * 颜色属性
     */
    String color();

    /**
     * 年龄属性
     */
    int age() default 25 //属性指定默认值
}

2、注解的使用

public class AnnotationTest {
    /**
     * r如果一个注解中有属性值，必须给属性赋值，除非该属性有默认值
     */

    @MyAnnotation(name="Lucy", color="red")
    public void fun(){

    }
}

3、value属性
若属性是value得话，可以在使用注解的时候不用写value的单词，直接写属性值即可

public @interface MyAnnotation1 {
    String value();
}

以下两种写法都对：

    @MyAnnotation1(value="Mary")
    public void fun2(){

    }
    @MyAnnotation1("Mary")
    public void fun3(){

    }

4、value属性值的注意：
如果自定义注解中只有一个属性，且属性名为value，那么在使用注解的时候可以直接省略value不写，直接写属性值；
但是如果自定义注解中的属性有两个或两个以上，其中一个属性名为value，则该value就不能省略，所以省略value的写法条件比较苛刻。

5、属性是一个数组：

public enum ElementType {
    /** Class, interface (including annotation type), or enum declaration */
    TYPE,

    /** Field declaration (includes enum constants) */
    FIELD,

    /** Method declaration */
    METHOD,

    /** Formal parameter declaration */
    PARAMETER,

    /** Constructor declaration */
    CONSTRUCTOR,

    /** Local variable declaration */
    LOCAL_VARIABLE,

    /** Annotation type declaration */
    ANNOTATION_TYPE,

    /** Package declaration */
    PACKAGE,

    /**
     * Type parameter declaration
     *
     * @since 1.8
     */
    TYPE_PARAMETER,

    /**
     * Use of a type
     *
     * @since 1.8
     */
    TYPE_USE,

    /**
     * Module declaration.
     *
     * @since 9
     */
    MODULE
}
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Target {
    ElementType[] value();
}
@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, MODULE, PARAMETER, TYPE})
public @interface Deprecated {
    String since() default "";
    boolean forRemoval() default false;
}

五、通过反射获得注解以及注解的属性

**注意！！！**通过反射机制获得注解对象的前提是，修饰注解的@Retention注解的属性值RetentionPolicy必须是RUNTIME

    /**
     * 通过反射获得注解以及注解的属性
     * @throws ClassNotFoundException
     */
    @Test
    public void Test01() throws ClassNotFoundException {
        //通过在射获取AnnotationTest类
        Class c = Class.forName("com.AnnotationStudy.AnnotationTest");
        if(c.isAnnotationPresent(MyAnnotation.class) == true){
			MyAnnotation annotation = (MyAnnotation)c.getAnnotation(MyAnnotation.class);
			System.out.println("得到的注解为："+annotation);
			//获得注解对象之后，获取对象的属性值
			String name = annotation.name()
			System.out.println(name);
			
		}
        //判断类上面是否右@Myannotation
        System.out.println(c.isAnnotationPresent(MyAnnotation.class));
    }

六、注解存在的意义与目的是什么，有什么用？

注解是一种注释，有了注解之后，需要按照一定的规则进行代码的编写，没有注解，我们可以根据自己的需要编写代码，但是加上注解之后，我们需要按照一定的规则进行代码的编写，一定程度上，注解是为了让开发更加的规范，让开发出来的程序更加有章可循。（个人拙见）