java注解

注解

1、 注解，或者叫做注释，英文单词是: Annotation
2、注解Annotation是一 种引用数据类型。编译之后也是生成xxx.class文件。
3、怎么自定义注解呢?语法格式?
[修饰符列表] @interface 注解类型名{
}
4、注解怎么使用，用在什么地方?
第一:注解使用时的语法格式是:
@注解类型名
第二:注解可以出现在类上、属性上、方法.上、变量上等…
注解还可以出现在注解类型上。

//@Ovenride这个注解只能注解方法。
//@Override这个注解是給编译器参考的,和运行阶段没有关系。
//凡是java中的方法带有这个注解的,编译器都会进行编译检查，如果这个方法不是重写父类的方法，编译器报错。
5、 元注解
什么是元注解?
用来标注"注解类型"的注解”，称为元注解。
常见的元注解有哪些?
Target
Retention

关于Target注解:
这是一一个元注解，用来标注"注解类型”“的"注解”
这个Target注解用来标注"被标注的注解"可以出现在哪些位置.上[
@Target (ElementType.METHOD):表示”\被标注的注解"只能出现在方法上。
@Target (value= {CONSTRUCTOR，FIELD， LOCAL_VARIABLE, METHODPACKAGE, MODULE, PARAMETER, TYPE})
表示该注解可以出现在:
构造方法上
字段上
局部变量上
方法上
类上…

关于Retention注解:
这是一一个元注解，用来标注"注解类型”的"注解”
这个Retention注解用来标注被标注的注解"最终保存在哪里。
@Retention (RetentionPolicy . SOURCE):表示该注解只被保留在java源文件中。
@Retention (Re tentionPolicy. CLASS):表示该在解被保存在class文件中。
@Retention (RetentionPolicy . RUNTIME):表示该注解被保存在class文件中，并且可以被反射机制读取

// Deprecated这个注解标注的元素已过时。
//这个注解主要是向其它程序员传达一个信息，告知已过时,有更好的解决方案存在。
@Deprecated
注解当中的属性可以是哪种类型?
属性的类型可以是:
byte short int long float double boolean char String Class 枚举类型
以及以上每一种的数组形式。

6、Retention的源代码
//元注解

public @ interface Retention {
//属性
Re tentionPolicy value () ;
}
RetentionPolicy的源代码:
public enum RetentionPolicy {
SOURCE ,
CLASS ,
RUNTIME
}

反射注解

//只允许该注解可以标注类、方法
@Target({ElementType.TYPE,ElementType.METHOD})
//希望这个注解可以被反射
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotion {
    String name() default "上海浦东区";

}

@MyAnnotion(name = "北京四合院")
public class MyAnnotionTest {

}

public class 反射注解 {
    public static void main(String[] args) throws ClassNotFoundException {
        //获取这个类
        Class c=Class.forName("注解.反射注解.MyAnnotionTest");
        //判断这个类上面是否有@MyAnnotion
        System.out.println(c.isAnnotationPresent(MyAnnotion.class));//true

        if(c.isAnnotationPresent(MyAnnotion.class)){
            //获取该注解的对象
            MyAnnotion myAnnotion= (MyAnnotion) c.getAnnotation(MyAnnotion.class);
            //获取注解类对象的属性怎么办？和调用接口没区别
            String value=myAnnotion.name();
            System.out.println(value);

        }
        //判断String类型中是否有MyAnnotion类型的注解
        Class stringClass=Class.forName("java.lang.String");
        System.out.println(stringClass.isAnnotationPresent(MyAnnotion.class));
    }
}

7、 注解在开发中有什么用呢?
需求:
假没有这样一一个注解，叫做: @Id
这个注解只能出现在类上面，当这个类上有这个注解的时候，
要求这个类中必须有一个int类型的id属性。如果没有这个属性
就报异常。如果有这个属性则正常执行!

//表示这个注解只能出现在类上面
@Target(ElementType.TYPE)
//表示这个注解可以被反射机制所读取到
@Retention(RetentionPolicy.RUNTIME)
public @interface MustHasIdPropertyAnnotation {

}
// 这个注解@Id用来标注类，被标注的类中必须有一个int类型的id属性,没有就报异常。|

@MustHasIdPropertyAnnotation
public class User {
    private int id;
    private String name;
    private String password;
}

//异常类
public class HasNotIdPropertyException extends RuntimeException {

    public HasNotIdPropertyException() {
        super();
    }
    public HasNotIdPropertyException(String s){
        super(s);
    }
}

public class 注解在开发中的作用 {
    public static void main(String[] args) throws ClassNotFoundException {
        Class userClass=Class.forName("注解.注解在开发中的作用.User");
        boolean flag=false;
        //判断一个类是否有ID注解
        if(userClass.isAnnotationPresent(MustHasIdPropertyAnnotation.class)){
            //当一个类上面有@MustHas IdPropertyAnnotation注解的时候,要求类中必须存在int类型的id属性
            //如果没有int类型的id属性则报异常。

            //获取类的属性
            Field[] field=userClass.getDeclaredFields();

            for (Field s:field) {
                if("id".equals(s.getName())&&"int".equals(s.getType().getSimpleName())){
                    flag=true;//表示合法
                    System.out.println("程序合法");
                    break;
                }

            }
        }
        if (!flag){
            throw new HasNotIdPropertyException("被MustHasIdPropertyAnnotation注解的类必须要有一个int类型的id");
        }
    }
}

运行结果:

注释id后