Java中的注解及自定義注解你用的怎么樣，能不能像我這樣應用自如？

Java注解提供了關于代碼的一些資訊，但并不直接作用于它所注解的代碼內容，在這個教程當中，我們將學習Java的注解，如何定制注解，注解的使用以及如何通過反射決議注解，

Java1.5引入了注解，當前許多java框架中大量使用注解，如Hibernate、Jersey、Spring，注解作為程式的元資料嵌入到程式當中，注解可以被一些決議工具或者是編譯工具進行決議，我們也可以宣告注解在編譯程序或執行時產生作用，

在使用注解之前，程式源資料只是通過java注釋和javadoc，但是注解提供的功能要遠遠超過這些，注解不僅包含了元資料，它還可以作用于程式運行程序中、注解解釋器可以通過注解決定程式的執行順序，例如，在Jersey webservice 我們為方法添加URI字串的形式的PATH注解，那么在程式運行程序中jerser解釋程式將決定該方法去呼叫所給的URI，

創建Java自定義注解

創建自定義注解和創建一個介面相似，但是注解的interface關鍵字需要以@符號開頭，我們可以為注解宣告方法，我們先來看看注解的例子，然后我們將討論他的一些特性，

package com.journaldev.annotations;

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;

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

• 注解方法不能帶有引數；
• 注解方法回傳值型別限定為：基本型別、String、Enums、Annotation或者是這些型別的陣列；
• 注解方法可以有默認值；
• 注解本身能夠包含元注解，元注解被用來注解其它注解，

這里有四種型別的元注解：

1. @Documented —— 指明擁有這個注解的元素可以被javadoc此類的工具檔案化，這種型別應該用于注解那些影響客戶使用帶注釋的元素宣告的型別，如果一種宣告使用Documented進行注解，這種型別的注解被作為被標注的程式成員的公共API，

2. @Target——指明該型別的注解可以注解的程式元素的范圍，該元注解的取值可以為TYPE,METHOD,CONSTRUCTOR,FIELD等，如果Target元注解沒有出現，那么定義的注解可以應用于程式的任何元素，

3. @Inherited——指明該注解型別被自動繼承，如果用戶在當前類中查詢這個元注解型別并且當前類的宣告中不包含這個元注解型別，那么也將自動查詢當前類的父類是否存在Inherited元注解，這個動作將被重復執行知道這個標注型別被找到，或者是查詢到頂層的父類，

4. @Retention——指明了該Annotation被保留的時間長短，RetentionPolicy取值為SOURCE,CLASS,RUNTIME，

Java內建注解

Java提供了三種內建注解，

1. @Override——當我們想要復寫父類中的方法時，我們需要使用該注解去告知編譯器我們想要復寫這個方法，這樣一來當父類中的方法移除或者發生更改時編譯器將提示錯誤資訊，

2. @Deprecated——當我們希望編譯器知道某一方法不建議使用時，我們應該使用這個注解，Java在javadoc 中推薦使用該注解，我們應該提供為什么該方法不推薦使用以及替代的方法，

3. @SuppressWarnings——這個僅僅是告訴編譯器忽略特定的警告資訊，例如在泛型中使用原生資料型別，它的保留策略是SOURCE（譯者注：在源檔案中有效）并且被編譯器丟棄，

我們來看一個java內建注解的例子參照上邊提到的自定義注解，

package com.journaldev.annotations;

import java.io.FileNotFoundException;
import java.util.ArrayList;
import java.util.List;

public class AnnotationExample {

public static void main(String[] args) {
}

@Override
@MethodInfo(author = 'Pankaj', comments = 'Main method', date = 'Nov 17 2012', revision = 1)
public String toString() {
    return 'Overriden toString method';
}

@Deprecated
@MethodInfo(comments = 'deprecated method', date = 'Nov 17 2012')
public static void oldMethod() {
    System.out.println('old method, don't use it.');
}

@SuppressWarnings({ 'unchecked', 'deprecation' })
@MethodInfo(author = 'Pankaj', comments = 'Main method', date = 'Nov 17 2012', revision = 10)
public static void genericsTest() throws FileNotFoundException {
    List l = new ArrayList();
    l.add('abc');
    oldMethod();
}

}

相信這個例子可以不言自明并能展示在不同場景下的應用，

Java注解決議

我們將使用反射技術來決議java類的注解，那么注解的RetentionPolicy應該設定為RUNTIME否則java類的注解資訊在執行程序中將不可用那么我們也不能從中得到任何和注解有關的資料，

package com.journaldev.annotations;

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

public class AnnotationParsing {

public static void main(String[] args) {
    try {
    for (Method method : AnnotationParsing.class
        .getClassLoader()
        .loadClass(('com.journaldev.annotations.AnnotationExample'))
        .getMethods()) {
        // checks if MethodInfo annotation is present for the method
        if (method.isAnnotationPresent(com.journaldev.annotations.MethodInfo.class)) {
            try {
        // iterates all the annotations available in the method
                for (Annotation anno : method.getDeclaredAnnotations()) {
                    System.out.println('Annotation in Method ''+ method + '' : ' + anno);
                    }
                MethodInfo methodAnno = method.getAnnotation(MethodInfo.class);
                if (methodAnno.revision() == 1) {
                    System.out.println('Method with revision no 1 = '+ method);
                    }

            } catch (Throwable ex) {
                    ex.printStackTrace();
                    }
        }
    }
    } catch (SecurityException | ClassNotFoundException e) {
            e.printStackTrace();
         }
    }

}

運行上面程式將輸出：

Annotation in Method 'public java.lang.String com.journaldev.annotations.AnnotationExample.toString()' : @com.journaldev.annotations.MethodInfo(author=Pankaj, revision=1, comments=Main method, date=Nov 17 2012)
Method with revision no 1 = public java.lang.String com.journaldev.annotations.AnnotationExample.toString()
Annotation in Method 'public static void com.journaldev.annotations.AnnotationExample.oldMethod()' : @java.lang.Deprecated()
Annotation in Method 'public static void com.journaldev.annotations.AnnotationExample.oldMethod()' : @com.journaldev.annotations.MethodInfo(author=Pankaj, revision=1, comments=deprecated method, date=Nov 17 2012)
Method with revision no 1 = public static void com.journaldev.annotations.AnnotationExample.oldMethod()
Annotation in Method 'public static void com.journaldev.annotations.AnnotationExample.genericsTest() throws java.io.FileNotFoundException' : @com.journaldev.annotations.MethodInfo(author=Pankaj, revision=10, comments=Main method, date=Nov 17 2012)

這就是該教程的全部內容，希望你可以從中學到些東西，

最后

私信回復 資料 領取一線大廠Java面試題總結+阿里巴巴泰山手冊+各知識點學習思維導+一份300頁pdf檔案的Java核心知識點總結！

這些資料的內容都是面試時面試官必問的知識點，篇章包括了很多知識點，其中包括了有基礎知識、Java集合、JVM、多執行緒并發、spring原理、微服務、Netty 與RPC 、Kafka、日記、設計模式、Java演算法、資料庫、Zookeeper、分布式快取、資料結構等等，

標籤：Java

上一篇：后端程式員必備的 Linux 基礎知識+常見命令（近萬字總結）

下一篇：Spring Boot 2.x基礎教程：使用集中式快取Redis