Java注解作用介绍、原注解及其简单应用

一、注解是什么？

注解( Annotation) , 也叫元数据。-种代码级别的说明。它是JDK1.5及以后版本引入的一个特性,与类、接口、枚举是在同一个层次。它可以声明在包、类、字段、方法、局部变量、方法参数等的前面,用来对这些元素进行说明,注释。

二、作用分类

1. 编写文档:通过代码里标识的注解生成文档[生成文档doc文档]
2. 代码分析:通过代码里标识的注解对代码进行分析[使用反射]【程序员主要操作】
3. 编译检查:通过代码里标识的注解让编译器能够实现基本的编译检查[Override]

三、JDK预定义的注解

//清除IDEA警告
@SuppressWarnings("all")
//标记过时方法，比如：date.getYear()
@Deprecated
//检查被该注解标记的方法是否继承父类或接口
@Override

四、自定义注解

/**
 * 元注解
 */
@Target({ElementType.TYPE,ElementType.METHOD}) //描述当前注解能够作用的位置
@Retention(RetentionPolicy.RUNTIME) //描述注解的保留阶段
@Documented //描述注解是否被抽取到avaDoc api中
@Inherited //描述注解是否可以被子类继承
public @interface anno1 {
/*
属性:在揍口中定义的抽象方法
返回结果必须是如下类型
1.基本数据类型（不能是包装类型）
2.String类型
3.枚举类型
4.注解
5.以上类型的数组
如果注解中只存在一个属性且名称为value，则使用注解的时候可以省略value不写
*/
}
//反编译后
public interface anno1 extends java.lang.annotation.Annotation{
    //说明注解是一个接口继承了Annotation
}

五、注解案例

通过反射调用指定方法

//注解
@Target({ElementType.TYPE,ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
public @interface Anno {
    String className();
    String methodName();
}

//定义反射调用的方法
public class Student {

    public void run(){
        System.out.println("奔跑的青年...");
    }
}

//测试方法
//@Anno(className = "com.mxf.gupao.annotaion.Student",methodName = "run")
public class AnnoTest {

    @Anno(className = "com.mxf.gupao.annotaion.Student",methodName = "run")
    public static void test(){
        System.out.println("这是测试注解的方法");
    }

    public static void main(String[] args) throws Exception {
        //获取本类指定名称的注解
        Class<AnnoTest> annoTestClass = AnnoTest.class;
        //获取类上面的注解
        /*Anno annotation = annoTestClass.getAnnotation(Anno.class);
        System.out.println(annotation.className());
        System.out.println(annotation.methodName());*/
        //获取方法上的注解
        Method test = annoTestClass.getMethod("test");
        Anno annotation = test.getAnnotation(Anno.class);
        System.out.println(annotation.className());
        System.out.println(annotation.methodName());

        Class<?> aClass = Class.forName(annotation.className());
        Student s = (Student)aClass.newInstance();
        Method method = aClass.getMethod(annotation.methodName());
        method.invoke(s);
        test.invoke(null);
    }
}
/*
测试结果
com.mxf.gupao.annotaion.Student
run
奔跑的青年...
这是测试注解的方法
*/