JAVA && Spring && SpringBoot2.x — 學(xué)習(xí)目錄

注解可以代替配置文件的功能。

1. 元注解

元注解的作用就是注解其他注解，一般我們使用自定義注解時(shí)，就需要用元注解來(lái)標(biāo)注我們自己的注解，一共有以下四個(gè)元注解。

1.1 @Target注解

說(shuō)明Annotation被修飾的范圍，可被用于packages、type(類，接口，枚舉，Annotation類型)、類型成員（方法，構(gòu)造方法，成員變量，枚舉值）、方法參數(shù)和本地變量（如循環(huán)變量，catch參數(shù)）。

一句話總結(jié)：定義了注解的作用范圍。
使用方法：@Target(ElementType.TYPE)

1.2 @Retention

[瑞ten神]定義了該注解被保留的時(shí)間長(zhǎng)短，有些只在源碼中保留，有些需要編譯成的class中保留，有些需要在程序運(yùn)行時(shí)候保留。

一句話總結(jié)：定義注解的聲明周期。
使用方法：@Retention(RetentionPolicy.RUNTIME)

1.3 Documented

標(biāo)記注解，該元注解沒(méi)有屬性。表明這個(gè)注解應(yīng)該被javadoc工具記錄。即若使用javadoc之類的工具處理，該注解信息會(huì)被生成到文檔中。

1.4 Inherited

[in 和 瑞 ti 得]標(biāo)記注解，被他標(biāo)記的類型是可繼承的，比如一個(gè)class被@Inherited標(biāo)記，那么一個(gè)子類繼承該class后，則這個(gè)注解將被用于該class的子類。

@MyAnno
public interface Eat {
}

class Parent implements Eat {

}

class Child implements Eat {

}

@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@RequestMapping
@interface MyAnno {


}

class Test {

    public static void main(String[] args) {
        MyAnno eatAnnotation = Eat.class.getAnnotation(MyAnno.class);
        MyAnno parentAnnotation = Parent.class.getAnnotation(MyAnno.class);
        MyAnno childAnnotation = Child.class.getAnnotation(MyAnno.class);
        System.out.println(eatAnnotation);  //@com.galax.common.anno.customAnno.MyAnno()
        System.out.println(parentAnnotation); //null
        System.out.println(childAnnotation); //null
    }
}

我們的注解標(biāo)注了@Inherited表示該注解可以被繼承，但是parentAnnotation和childAnnotation依舊是null。需要注意：@Inherited繼承只能發(fā)生在類上，而不發(fā)生在接口上（也就是說(shuō)標(biāo)注在接口上依舊不能被繼承。）

2. 自定義注解

1. 自定義注解的格式

public @interface 注解名 {定義體}

使用@interface定義的一個(gè)注解，自動(dòng)繼承了java.lang.annotation.Annotation接口，其中的每一個(gè)方法實(shí)際上是聲明了一個(gè)配置參數(shù)。方法的名稱就是參數(shù)的名稱，返回值就是參數(shù)的類型（返回值類型只能是：基本類型、Class、String、enum類型、Annotation類型，以及上述參數(shù)的數(shù)組類型）。可以使用default來(lái)聲明參數(shù)的默認(rèn)值。

2. 需要注意的點(diǎn)：

1. 只能用public或默認(rèn)(default)這兩個(gè)訪問(wèn)權(quán)修飾。
2. 如果只有一個(gè)參數(shù)成員,最好把參數(shù)名稱設(shè)為"value"。
3. 參數(shù)的返回值，只能是基本類型，String類型，Class類型，枚舉類型，注解類型以及他們的數(shù)組類型。

3. 注解的默認(rèn)值

注解元素必須有確定的值，要么是給定的默認(rèn)值，要是使用的時(shí)候賦予值。需要注意的是：若需要表達(dá)一個(gè)元素不存在值，所以使用空字符串或者負(fù)數(shù)表示某個(gè)元素不存在，在定義注解時(shí)，這已經(jīng)成為一個(gè)約定用法。

3. 如何獲取自定義注解信息

Java自定義注解是通過(guò)運(yùn)行時(shí)靠反射獲取注解

AnnotatedElement對(duì)象.png

Class上實(shí)現(xiàn)AnnotatedElement接口.png

Java的注解解析類主要是AnnotatedElement接口的實(shí)現(xiàn)類，我們可以通過(guò)反射獲取一個(gè)類的AnnotatedElement對(duì)象后，就可以通過(guò)下面表格的幾個(gè)方法，訪問(wèn)Annotation信息。

1. 自定義注解：定義

@Documented
@Target(ElementType.METHOD)
@Inherited
@Retention(RetentionPolicy.RUNTIME)
public @interface MethodInfo {
    String author() default "xioapang";
    String date();
    int revision() default 1;
    String comments();
}

2. 自定義注解：使用

public class AnnotationExample {
    @MethodInfo(author = "XXX", comments = "toString method", date = "Nov 17 2019", revision = 2)
    public String toString() {
        return "Overriden toString method";
    }
}

3. 自定義注解：解析

@Slf4j
public class AnnotationParsing {
    public static void main(String[] args) {
        try {
            //加載某個(gè)類上的所有方法
            for (Method method : AnnotationParsing.class.getClassLoader().loadClass("com.galax.common.anno.customAnno.AnnotationExample").getMethods()) {
                //判斷方法是否存在MethodInfo.class注解
                if (method.isAnnotationPresent(MethodInfo.class)) {
                    //獲取非繼承關(guān)系的所有注解
                    for (Annotation anno : method.getDeclaredAnnotations()) {
                        log.info("注解信息：{} ", anno);
                    }
                    //獲取元素上該注解的詳細(xì)信息
                    MethodInfo methodAnnotation = method.getAnnotation(MethodInfo.class);
                    log.info("版本號(hào)：{}", methodAnnotation.revision());
                    log.info("作者：{}", methodAnnotation.author());
                    log.info("時(shí)間：{}", methodAnnotation.date());
                    log.info("描述：{}", methodAnnotation.comments());
                }
            }
        } catch (ClassNotFoundException e) {
            e.printStackTrace();
        }

    }
}

文章參考

深入理解Java自定義注解(一):入門

深入理解Java自定義注解(二)-使用自定義注解

Java反射獲取類和對(duì)象信息全解析