摘要：注解的定義注解通過關(guān)鍵字進(jìn)行定義它的形式跟接口很類似，不過前面多了一個(gè)符號上面的代碼就創(chuàng)建了一個(gè)名字為的注解你可以簡單理解為創(chuàng)建了一張名字為的標(biāo)簽注解的應(yīng)用上面創(chuàng)建了一個(gè)注解那么注解的的使用方法是什么呢創(chuàng)建一個(gè)類然后在類定義的地方加上就可以

java jdk: 10.0.2

注解通過 @interface 關(guān)鍵字進(jìn)行定義.

public @interface TestAnnotation {
}

它的形式跟接口很類似，不過前面多了一個(gè) @ 符號. 上面的代碼就創(chuàng)建了一個(gè)名字為 TestAnnotaion 的注解.

你可以簡單理解為創(chuàng)建了一張名字為 TestAnnotation 的標(biāo)簽.

上面創(chuàng)建了一個(gè)注解, 那么注解的的使用方法是什么呢.

@TestAnnotation
public class Test {
}

創(chuàng)建一個(gè)類 Test, 然后在類定義的地方加上 @TestAnnotation 就可以用 TestAnnotation 注解這個(gè)類了.

你可以簡單理解為將 TestAnnotation 這張標(biāo)簽貼到 Test 這個(gè)類上面.

不過, 要想注解能夠正常工作, 還需要介紹一下一個(gè)新的概念那就是元注解.

元注解是什么意思呢？

元注解是可以注解到注解上的注解, 或者說元注解是一種基本注解, 但是它能夠應(yīng)用到其它的注解上面.

如果難于理解的話, 你可以這樣理解. 元注解也是一張標(biāo)簽, 但是它是一張?zhí)厥獾臉?biāo)簽, 它的作用和目的就是給其他普通的標(biāo)簽進(jìn)行解釋說明的.

元標(biāo)簽有 @Retention、 @Documented、@Target、 @Inherited、 @Repeatable 5 種.

Retention 的英文意為保留期的意思. 當(dāng) @Retention 應(yīng)用到一個(gè)注解上的時(shí)候, 它解釋說明了這個(gè)注解的的存活時(shí)間.

它的取值如下：

RetentionPolicy.SOURCE 注解只在源碼階段保留, 在編譯器進(jìn)行編譯時(shí)它將被丟棄忽視.

RetentionPolicy.CLASS 注解只被保留到編譯進(jìn)行的時(shí)候, 它并不會被加載到 JVM 中.

RetentionPolicy.RUNTIME 注解可以保留到程序運(yùn)行的時(shí)候, 它會被加載進(jìn)入到 JVM 中, 所以在程序運(yùn)行時(shí)可以獲取到它們.

我們可以這樣的方式來加深理解, @Retention 去給一張標(biāo)簽解釋的時(shí)候, 它指定了這張標(biāo)簽張貼的時(shí)間.

@Retention 相當(dāng)于給一張標(biāo)簽上面蓋了一張時(shí)間戳, 時(shí)間戳指明了標(biāo)簽張貼的時(shí)間周期.

@Retention(RetentionPolicy.RUNTIME)
public @interface TestAnnotation {
}

上面的代碼中, 我們指定 TestAnnotation 可以在程序運(yùn)行周期被獲取到, 因此它的生命周期非常的長.

顧名思義, 這個(gè)元注解肯定是和文檔有關(guān). 它的作用是能夠?qū)⒆⒔庵械脑匕?Javadoc 中去.

Target 是目標(biāo)的意思, @Target 指定了注解運(yùn)用的地方.

你可以這樣理解, 當(dāng)一個(gè)注解被 @Target 注解時(shí), 這個(gè)注解就被限定了運(yùn)用的場景.

ElementType.ANNOTATION_TYPE 可以給一個(gè)注解進(jìn)行注解

ElementType.CONSTRUCTOR 可以給構(gòu)造方法進(jìn)行注解

ElementType.FIELD 可以給屬性(字段)進(jìn)行注解

ElementType.LOCAL_VARIABLE 可以給局部變量進(jìn)行注解

ElementType.METHOD 可以給方法進(jìn)行注解

ElementType.PACKAGE 可以給一個(gè)包進(jìn)行注解

ElementType.PARAMETER 可以給一個(gè)方法內(nèi)的參數(shù)進(jìn)行注解

ElementType.TYPE 可以給一個(gè)類型進(jìn)行注解, 比如類、接口、枚舉

Inherited 是繼承的意思, 但是它并不是說注解本身可以繼承, 而是說如果一個(gè)超類被 @Inherited 注解過的注解進(jìn)行注解的話, 那么如果它的子類沒有被任何注解應(yīng)用的話, 那么這個(gè)子類就繼承了超類的注解.
說的比較抽象. 代碼來解釋.

@Inherited
@Retention(RetentionPolicy.RUNTIME)
@interface Test {}


@Test
public class A {}


public class B extends A {}

注解 Test 被 @Inherited 修飾, 之后類 A 被 Test 注解, 類 B 繼承 A, 類 B 也擁有 Test 這個(gè)注解.

Repeatable 自然是可重復(fù)的意思.

什么樣的注解會多次應(yīng)用呢? 通常是注解的值可以同時(shí)取多個(gè).

舉個(gè)例子, 一個(gè)人他既是程序員又是產(chǎn)品經(jīng)理, 同時(shí)他還是個(gè)畫家.

@interface Persons {
    Person[]  value();
}


@Repeatable(Persons.class)
@interface Person{
    String role default "";
}


@Person(role="artist")
@Person(role="coder")
@Person(role="PM")
public class SuperMan{

}

注意上面的代碼, @Repeatable 注解了 Person. 而 @Repeatable 后面括號中的類相當(dāng)于一個(gè)容器注解.

什么是容器注解呢? 就是用來存放其它注解的地方. 它本身也是一個(gè)注解.

我們再看看代碼中的相關(guān)容器注解.

@interface Persons {
    Person[]  value();
}

按照規(guī)定, 它里面必須要有一個(gè) value 的屬性, 屬性類型是一個(gè)被 @Repeatable 注解過的注解數(shù)組, 注意它是數(shù)組.

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface TestAnnotation {

    int id();

    String msg();

}

上面代碼定義了 TestAnnotation 這個(gè)注解中擁有 id 和 msg 兩個(gè)屬性. 在使用的時(shí)候, 我們應(yīng)該給它們進(jìn)行賦值.

賦值的方式是在注解的括號內(nèi)以 value=”” 形式, 多個(gè)屬性之前用 , 隔開.

@TestAnnotation(id=3,msg="hello annotation")
public class Test {

}

?? 在注解中定義屬性時(shí)它的類型必須是 8 種基本數(shù)據(jù)類型外加 類、接口、注解及它們的數(shù)組.

Map> stringClassMap = ClassUtil.getClasses("org.itzhizhe.testReflection");

stringClassMap.forEach((key, value) ->{
        ReflectionClass annotation = value.getAnnotation(ReflectionClass.class);
        if (annotation != null) {
                System.out.println("class name: " + value.getSimpleName() + ", 注解 value : " + annotation.Value());
        }
});

        Map> stringClassMap = ClassUtil.getClasses("org.itzhizhe.testReflection");

        stringClassMap.forEach((key, value) -> {

            for (Field declaredField : ClassUtil.getAnnotatedDeclaredFields(value, ReflectionField.class, false)) {
                ReflectionField annotation = declaredField.getAnnotation(ReflectionField.class);
                if (annotation != null) {

                    this.put(annotation.Value(), declaredField);

                    System.out.println("class name: " + value.getSimpleName() +
                            ", 字段名: " + declaredField.getName() +
                            ", 字段類型:" + declaredField.getType().getSimpleName() +
                            ", 注解值:" + annotation.Value()
                    );
                }

            }

        });

        Map> stringClassMap = ClassUtil.getClasses("org.itzhizhe.testReflection");

        stringClassMap.forEach((key, value) -> {

            for (Method declaredField : ClassUtil.getAnnotatedDeclaredMethods(value, ReflectionMethod.class,false)) {
                ReflectionMethod annotation = declaredField.getAnnotation(ReflectionMethod.class);
                if (annotation != null) {
                    System.out.println("class name: " + value.getSimpleName() +
                            ", 方法名: " + declaredField.getName() +
                            ", 方法返回類型:" + declaredField.getReturnType() +
                            ", 注解值:" + annotation.id()
                    );
                }

            }

        });

value.getConstructor().newInstance();

上面代碼是使用無參構(gòu)造來創(chuàng)建對象, 當(dāng)然也可以使用有參構(gòu)造來創(chuàng)建對象.

getConstructor() 參數(shù)填寫構(gòu)造參數(shù)的參數(shù)類型.

newInstance() 參數(shù)填寫傳給構(gòu)造參數(shù)的值.

可以通過 Method 的 setAccessible 方法設(shè)置為 true, 就可以調(diào)用對象的 private 方法.

declaredField.setAccessible(true);
declaredField.invoke(value);

然后可以使用 invoke 方法來進(jìn)行方法調(diào)用. 第一個(gè)參數(shù)為要調(diào)用方法的對象. 剩下的參數(shù)是方法參數(shù).

如果想實(shí)現(xiàn)像 Spring 這種框架, 實(shí)現(xiàn)上面幾步是必須.

比如依賴注入, 我們需要知道字段的類型, 然后到 IOC 容器中找到對應(yīng)的對象進(jìn)行賦值.

而方法調(diào)用你可以先將注解的方法進(jìn)行保存, 比如保存到 Map 集合中.

例如客戶端發(fā)送指定數(shù)據(jù)幀后, 然后通過 key 取出要執(zhí)行的方法后執(zhí)行就可以.