java核心-注解

注解：

1.注解的概念：说明程序的，给计算机看

注解：也叫元数据，一种代码级别的说明，他是jdk1.5版本之后引入的一个特性他，与类，接口，枚举是一个层次，他可以声明在包，类，字段，方法，局部变量，方法参数等，对元素进行说明，注释

注释：用文字描述程序，给程序员看的

/**/

//

注解作用分类：

1.编写文档，通过java代码里标识的注解生成文档【生成doc文档】

2.代码分析：通过代码里标识的注解对代码进行分【使用反射】

3.编译检查：通过代码里标识的注解让编译器能够实现基本的编译检查 override

2.jdk中预定义的注解

@Override检查被该注解的方式是否继承自父类【接口】

@SuppressWarnings(“all”) //压制警告，去除idea中黄色标识

@Deprecated表示过时，不推荐使用

@SuppressWarnings(“all”) //压制警告，去除idea中黄色标识

3.自定义注解
格式：

public class AnnotationTest {
    // @Override注解使用
    @Override
    public String toString() {
        return "AnnotationTest{}";
    }
    @Deprecated
    public void show1(){
        // 版本1，已经过时，可用版本二替换
    }
    public void show2(){
        // 最新的方法
    }
    public void test(){
        show1();  //用@Deprecated表示过时，不推荐使用
        show2();
        // 例如：
        int year = new Date().getYear();
    }
}

3.自定义注解
格式：

// 元注解
public @interface 注解名称{
 //属性列表
}

自定义注解反编译后的内容

pubilc interface MyAnno extends java.lang.annotation.Annotation{

}

注解的本质上就是一个借口，继承Annotation父接口

public @interface MyAnno {
    // 可以定义接口定义的抽象方法和成员变量
    String USER_NAME = "tom";
    public String show();
}

属性：在接口中定义的抽象方法

返回结果必须是如下类型：

1.基本数据类型

2.String类型

3.枚举类型

4.注解

5.以上类型的数组

属性赋值注意点：

1.如果定义的属性时，使用default作为默认值，可以不用赋值

public @interface MyAnno {
    public String name();
    public int age();
}

使用
   @MyAnno(name = "zhangsan",age = 18)
    public void test1(){
    }

实例;
public @interface MyAnno {
    public String name();
    public int age() default 18;
}
@MyAnno(name = "zhangsan")
    public void test1(){
    }

2.如果只有一个属性需要赋值，而且该属性的名称是value，那么在赋值时，value可以省略

public @interface MyAnno {
    public String value();
}
使用
@MyAnno("12")
    public void test1(){
    }

3.数组赋值的时候，值使用{}大括号包裹，如果数组中只有一个值，那么{}可以省略

// PersonEnum类的定义
public enum PersonEnum {
    P1,P2
}
//注解
public @interface MyAnno {
    public String name();
    public int age() default 18;
    public PersonEnum personEunm() default PersonEnum.P1;
    public String[] citys() default "chengdu";
}
使用
@MyAnno(name = "zhangsan",age = 18,personEunm = PersonEnum.P1,citys = "beijing")
    public void test1(){
    }

4.元注解

jdk中提供的四个元注解

1.@Target:描述当前注解能够作用的位置

ElementType.TYPE 可以作用在类上

ElementType.METHOD可以作用在方法上

ElementType.FILED 可以作用在成员变量上

public @interface MyParam {
}
使用
@MyParam
public class MyParamTest {
    @MyParam
    public String name;
    @MyParam
    public void test(){};
}
@Target({ElementType.TYPE,ElementType.METHOD,ElementType.FIELD})
public @interface MyParam {
}
使用
@MyParam
public class MyParamTest {
    @MyParam
    public String name;
    @MyParam
    public void test(){};
}

2.@Retention:描述注解被保留到的阶段

SOURCE<CLASS<RUNTIME

SOURCE:表示当前注释只在代码阶段有效

CLASS:表示该注解会被保留到字节码阶段

RUNTIME:表示该注释会被保留到运行阶段JVM

一般使用RetentionPolicy.RUNTIME

3.@Documented:描述注解是否被抽取到javaDoc.API中

4.@inherited:描述注解是否可被子类继承

5.自定义注解的案例

自定义注解：

/**

 * 自定义注解调用哪个类的哪个方法
 * */
   @Documented
   @Target({ElementType.TYPE,ElementType.METHOD})
   @Retention(RetentionPolicy.RUNTIME)
   public @interface InvoAnno {
    public String className();
    public String methodName();
   }
   调用的方法

package annoTest;

public class Student1 {
    public void show(){
        System.out.println("show1......");
    }
}

使用：

@InvoAnno(className = "annoTest.Student1",methodName = "show")
public class InvoAnnoTest {
public static void main(String[] args) throws Exception {
    // 通过反射方式获取接口的属性
    Class<InvoAnnoTest> clazz = InvoAnnoTest.class;
    InvoAnno anno = clazz.getAnnotation(InvoAnno.class);
    String className = anno.className();
    String methodName = anno.methodName();

    System.out.println(className);
    System.out.println(methodName);
    /* 这里为什么能直接获取到是因为
     * clazz.getAnnotation(InvoAnno.class);执行时候，生成了如下方法
     * public class MyInvoAnno extends InvoAnno{
     *     String className{
     *     return "Student1";
     * }
     * String methodName{
     *     return "show";
     * }
     * }
     * */
    // 通过反射获取对应实例,执行接口方法
    Class<?> aClass = Class.forName(className);
    Method method = aClass.getMethod(methodName);
    Object o = aClass.newInstance();
    method.invoke(o);
}
}

运行结果如下：

annoTest.Student1
show
show1......

通过注解加反射，实现了根据执行类执行指定方法（aop结合注解实现鉴权）