Java注解的使用

概念：java提供了一种原程序中的元素关联任何信息和任何元数据的途径和方法。

Java中的常见注解

JDK自带注解：

@Override//覆盖父类的方法        

@Deprecated//表示方法过时了

@SuppressWarnings("deprecation")//忽略deprecation警告

常见第三方注解：

Spring : @Autowired        @Service          @Repository

Mybatis :@InsertProvider       @UpdateProvider             @Options

注解的分类

按照运行机制分：

1.源码注解：注解只在源码中存在，编译成.class文件就不存在了

2.编译时注解：注解在源码和.class文件中都存在（jdk自带注解）

3.运行时注解：在运行阶段还起作用，甚至会影响运行逻辑的注解

按照来源分：

1.来自JDK的注解

2.来自第三方的注解

3.我们自己定义的注解

元注解：注解的注解

@Target({ElementType.METHOD,ElementType.TYPE})/**注解的作用域
//CONSTRUCTOR(构造方法声明)、FIELD（字段声明）、LOCAL_VARIABLE（局部变量声明）
//METHOD（方法声明）、PACKAGE（包声明）、TYPE（类、接口）
*/
@Retention(RetentionPolicy.RUNTIME) /**
//声明周期RUNTIME（运行时存在，可以通过反射读取）、
//CLASS（编译时会纪录到class中，运行时忽略）、
//SOURCE（只在源码显示，编译时会丢弃）*/
@Inherited/**允许子类继承注解，对接口无效，对类有效；只继承类的注解，类下的方法的注解无法继承*/
@Documented/**生成javadoc时包含注解*/
public @interface Description{//使用@interface关键字定义注解
    /**
     * 成员以无参无异常方式声明
     * 成员类型是受限的，合法的类型包括原始类型及String,Class,Annotation,Enumeration
     * 可以用default为成员指定一个默认的值
     * 如果注解只有一个成员，则成员名必须取名为value(),在使用时可以忽略成员名和赋值号(=)
     * 注解类可以没有成员，没有成员的注解称为标识注解
     */
//    String desc();
//    String author();
//    int age() default 18;
    String value();
}

public interface Person {
    public String name();
    @Deprecated
    //表示方法过时了
    public int age();
}

@Description("i am class")
public class Child implements Person {
    @Override
    @Description("i am method")
    public String name() {    
        return null;
    }
    @Override
    public int age() {
            return 0;
    }
}

public class Test {
    
    @SuppressWarnings({ "rawtypes", "unchecked" })
    public static void main(String[] args) {
        try {
            //1.使用类加载器加载类
            Class c = Class.forName("com.wzyy.zujie.Child");
            //2.找到类上面的注解,判断这个类com.wzyy.zujie.Child上是否存在Description.class这个注解
            boolean isExist = c.isAnnotationPresent(Description.class);
            if(isExist){
                //3.拿到注解实例
                Description d = (Description) c.getAnnotation(Description.class);
                System.out.println(d.value());//i am class
            }
            //4.找到方法上的注解
            Method[] ms = c.getMethods();
            for(Method m:ms){
                //第一种解析方法，判断这个方法上是否存在Description注解
//                boolean isMExist = m.isAnnotationPresent(Description.class);
//                if(isMExist){
                    //存在就得到这个方法上的Description注解
//                    Description d = m.getAnnotation(Description.class);
//                    System.out.println(d.value());//i am method    
//                }
                //第二种解析方法,得到这个方法上所有的注解，判断是否是Description
                Annotation[] as =m.getAnnotations();
                for(Annotation a:as){
                    if(a instanceof Description){
                        Description d = (Description) a;
                        System.out.println(d.value());//i am method
                    }
                    
                }
            }
            
        } catch (ClassNotFoundException e) {
            e.printStackTrace();
        }
        
    }
//    /**使用注解的语法：@<注解名>(<成员名1>=<成员值1>，<成员名2>=<成员值2>....)*/
//    @Description(desc="aaa",author="bb",age=22)
//    public String eyeColor(){    
//        return "red";
//    }
}