Java 注解

注解

　　1、注解，或者叫做注释类型，英文单词是：Annotation
　　　　疑问：注解到底是干啥的？？？？？？？？？

　　2、注解Annotation是一种引用数据类型。编译之后也是生成xxx.class文件。

　　3、怎么自定义注解呢？语法格式？

　　　　[修饰符列表] @interface 注解类型名{

　　　　}

/*
自定义注解：MyAnnotation
 */
public @interface MyAnnotation {
    // ??????
}

　　4、注解怎么使用，用在什么地方？

　　　　第一：注解使用时的语法格式是：
　　　　@注解类型名

　　　　第二：注解可以出现在类上、属性上、方法上、变量上等....
　　　　　　注解还可以出现在注解类型上。

　　5、JDK内置了哪些注解呢？

　　　　java.lang包下的注释类型：

　　　　掌握：
　　　　Deprecated 用 @Deprecated 注释的程序元素，
　　　　不鼓励程序员使用这样的元素，通常是因为它很危险或存在更好的选择。

　　　　掌握：
　　　　Override 表示一个方法声明打算重写超类中的另一个方法声明。

// @Override这个注解只能注解方法。
// @Override这个注解是给编译器参考的，和运行阶段没有关系。
// 凡是java中的方法带有这个注解的，编译器都会进行编译检查，如果这个方法不是重写父类的方法，编译器报错。

　　　　不用掌握：
　　　　SuppressWarnings 指示应该在注释元素（以及包含在该注释元素中的
　　　　所有程序元素）中取消显示指定的编译器警告。

　　6、元注解
　　　　什么是元注解？
　　　　用来标注“注解类型”的“注解”，称为元注解。

　　　　常见的元注解有哪些？
　　　　　　Target
　　　　　　Retention

　　　　　　关于Target注解：
　　　　　　　　这是一个元注解，用来标注“注解类型”的“注解”
　　　　　　　　这个Target注解用来标注“被标注的注解”可以出现在哪些位置上。

　　　　　　　　@Target(ElementType.METHOD)：表示“被标注的注解”只能出现在方法上。
　　　　　　　　@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, MODULE, PARAMETER, TYPE})
　　　　　　　　表示该注解可以出现在：
　　　　　　　　构造方法上
　　　　　　　　字段上
　　　　　　　　局部变量上
　　　　　　　　方法上
　　　　　　　　....
　　　　　　　　类上...

　　　　　　关于Retention注解：
　　　　　　　　这是一个元注解，用来标注“注解类型”的“注解”
　　　　　　　　这个Retention注解用来标注“被标注的注解”最终保存在哪里。

　　　　　　　　@Retention(RetentionPolicy.SOURCE)：表示该注解只被保留在java源文件中。
　　　　　　　　@Retention(RetentionPolicy.CLASS)：表示该注解被保存在class文件中。
　　　　　　　　@Retention(RetentionPolicy.RUNTIME)：表示该注解被保存在class文件中，并且可以被反射机制所读取。

　　　　　　

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}

 

　　7、Retention的源代码

　　　　//元注解
　　　　public @interface Retention {
　　　　//属性
　　　　RetentionPolicy value();
　　　　}

　　　　RetentionPolicy的源代码：
　　　　public enum RetentionPolicy {
　　　　　　SOURCE,
　　　　　　CLASS,
　　　　　　RUNTIME
　　　　}

　　　　//@Retention(value=RetentionPolicy.RUNTIME)
　　　　@Retention(RetentionPolicy.RUNTIME)
　　　　public @interface MyAnnotation{}

 

　　8、Target的源代码
　　9、注解在开发中有什么用呢？

　　需求：
　　　　假设有这样一个注解，叫做：@Id
　　　　这个注解只能出现在类上面，当这个类上有这个注解的时候，
　　　　要求这个类中必须有一个int类型的id属性。如果没有这个属性
　　　　就报异常。如果有这个属性则正常执行！

自定义注解

　　1、在注解当中可以定义属性

　　　    如果一个注解的属性的名字是value，并且只有一个属性的话，在使用的时候，该属性名可以省略。

　　　　属性的类型可以是：

　　　　　　byte short int long float double boolean char String Class 枚举类型
　　　　　　以及以上每一种的数组形式。

package com.bjpowernode.java.annotation2;

public @interface MyAnnotation {

    /**
     * 我们通常在注解当中可以定义属性，以下这个是MyAnnotation的name属性。
     * 看着像1个方法，但实际上我们称之为属性name。
     * @return
     */
    String name();

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

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

}


package com.bjpowernode.java.annotation2;

public class MyAnnotationTest {

    // 报错的原因：如果一个注解当中有属性，那么必须给属性赋值。（除非该属性使用default指定了默认值。）
    /*@MyAnnotation
    public void doSome(){

    }*/

    //@MyAnnotation(属性名=属性值,属性名=属性值,属性名=属性值)
    //指定name属性的值就好了。
    @MyAnnotation(name = "zhangsan", color = "红色")
    public void doSome(){

    }

} 

 

　　

/*
如果一个注解的属性的名字是value，并且只有一个属性的话，在使用的时候，该属性名可以省略。
 */
public class MyAnnotationTest {

    // 报错原因：没有指定属性的值。
    /*@MyAnnotation
    public void doSome(){

    }*/

    @MyAnnotation(value = "hehe")
    public void doSome(){

    }

    @MyAnnotation("haha")
    public void doOther(){

    }
}

public @interface MyAnnotation {

    /*
    指定一个value属性。
     */
    String value();

    //String email();
}

　　2、注解作用