【JAVA】java注解的自定義和使用

java注解概念

　　Java提供了一種原程序中的元素關聯任何信息和任何數據的途徑和方法

java注解介紹

　　常用注解

　　@Override：表示方法是重寫的方法

　　@Deprecated：過時的方法

　　@SuppressWarnings：抑制警告

　　注解分類

　　按照運行機制分

　　1、源碼注解：注解只在源碼中存在，編譯成.class文件就不存在了

　　2、編譯時注解：注解在源碼和.class文件中都存在，如@Override

　　3、運行時注解：在運行階段起作用，甚至會影響運行邏輯，如@Autowired

　　按照來源分

　　1、JDK自帶注解

　　2、第三方注解

　　3、自定義注解

自定義注解和使用

　　1、使用@interface關鍵定義注解（Description.java），如下：

package com.hd;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Inherited;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * 注解的注解：元注解
 * 
 * 注解作用域
    ElementType.TYPE：允許被修飾的注解作用在類、接口和枚舉上
    ElementType.FIELD：允許作用在屬性字段上
    ElementType.METHOD：允許作用在方法上
    ElementType.PARAMETER：允許作用在方法參數上
    ElementType.CONSTRUCTOR：允許作用在構造器上
    ElementType.LOCAL_VARIABLE：允許作用在本地局部變量上
    ElementType.ANNOTATION_TYPE：允許作用在注解上
    ElementType.PACKAGE：允許作用在包上
    
    注解的生命周期
    RetentionPolicy.SOURCE：當前注解編譯期可見，不會寫入 class 文件
    RetentionPolicy.CLASS：類加載階段丟棄，會寫入 class 文件
    RetentionPolicy.RUNTIME：永久保存，可以反射獲取
 *
 */
// 注解的作用域
@Target({ElementType.METHOD, ElementType.TYPE})
// 注解的生命周期
@Retention(RetentionPolicy.RUNTIME)
// 允許子類繼承
@Inherited
// 生成javadoc的時候生成注解的信息
@Documented
// @interface：使用@interface關鍵定義注解
public @interface Description {
    
    // 注解的成員
    // 成員類型所限的，合法的類型包括原始數據類型及String、Class、Annotation、Enumeration
    String desc();
    
    String author();
    
    // 成員以無參無異常方式生命，可以用default為成員指定一個默認值
    int age() default 18;
    
    // 如果注解成員只有一個時，成員名必須取名未value(),在使用時可以忽略成員名和賦值號(=)
    // 注解可以沒有成員，沒有成員的注解成為標識注解
}

　　2、在普通類上使用注解，使用方法

　　　　注解使用： @<注解名>(<成員名1>=<成員值1>, <成員名2>=<成員值2>, ...)

　　　　如下：

 package com.hd;

 /**
  * 注解使用：
  * @<注解名>(<成員名1>=<成員值1>, <成員名2>=<成員值2>, ...)
  * @author H__D
  * @date 2019-07-09 22:49:32
  *
  */
@Description(desc="I am class annotation", author="hd")
public class TestDescription {

    @Description(desc="I am method annotation", author="hd")
    public String test(){
        
        return "red";
    }
    

}

　　3、解析注解，通過反射獲取類，函數或成員上的運行時注解信息，從而實現動態控制程序運行的邏輯

package com.hd;

import java.lang.annotation.Annotation;
import java.lang.reflect.Method;

/**
 * 解析注解
 * 通過反射獲取類，函數或成員上的運行時注解信息，從而實現動態控制程序運行的邏輯
 * 
 * 對於一個類或者接口來說，Class 類中提供了以下一些方法用於反射注解。
    getAnnotation：返回指定的注解
    isAnnotationPresent：判定當前元素是否被指定注解修飾
    getAnnotations：返回所有的注解
    getDeclaredAnnotation：返回本元素的指定注解
    getDeclaredAnnotations：返回本元素的所有注解，不包含父類繼承而來的
 * 
 * @author H__D
 * @date 2019-07-09 22:52:42
 *
 */
public class ParseDecription {
    
    public static void main(String[] args) {
        // TODO Auto-generated method stub
        // 1、使用類加載器加載類
        try {
            Class c = Class.forName("com.hd.TestDescription");
            System.out.println(c);
            
            // 2、找到類上面的注解
            boolean isExist = c.isAnnotationPresent(Description.class);
            
            if(isExist) {
                // 3、拿到注解實例
                Description d = (Description) c.getAnnotation(Description.class);
                System.out.println("========parse class annotation=========");
                System.out.println("desc = " + d.desc());
                System.out.println("author = " + d.author());
                System.out.println("age = " + d.age());
            }
            
            // 4、找到方法上的注解
            Method[] ms = c.getMethods();
            for (Method m : ms) {
                boolean isMExist = m.isAnnotationPresent(Description.class);
                if(isMExist) {
                    Description d = m.getAnnotation(Description.class);
                    System.out.println("========parse method annotation=========");
                    System.out.println("desc = " + d.desc());
                    System.out.println("author = " + d.author());
                    System.out.println("age = " + d.age());
                }
            }
            
            // 另外一種解析方法
            for (Method m : ms) {
                Annotation[] annotations = m.getAnnotations();
                for (Annotation annotation : annotations) {
                    if(annotation instanceof Description) {
                        System.out.println("========parse method annotation other way=========");
                        Description d = (Description) annotation;
                        System.out.println("desc = " + d.desc());
                        System.out.println("author = " + d.author());
                        System.out.println("age = " + d.age());
                    }
                }
            }
            
        } catch (ClassNotFoundException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }
}

　　4、運行結果如下：