文章目錄

簡介

相信大部分的開發者都用過註解，尤其是對使用過Spring的開發者來說，註解是現代Spring中不可獲取的一部分。Spring從最開始的xml配置到後面的註解配置，不論是從編程習慣還是項目的構建，都對我們程序員產生了非常重要的影響。

除了使用Spring自帶的註解之外，我們還可以自定義註解。然後通過AOP來對註解進行攔截從而處理相應的業務邏輯。

除了Spring之外，其實JDK本身自帶註解，本文將會深入探討註解的起源和兩種不同的使用方式。

更多精彩內容且看：

更多內容請訪問www.flydean.com

註解的起源和marker interfaces

先看一個最簡單的註解：

@CustUserAnnotation
public class CustUser {
}

上面我們將CustUser標記爲一個自定義的註解@CustUserAnnotation。

註解其實是在JDK 5中引入的。那麼在JDK 5之前，註解是用什麼方式來表示的呢？答案就是marker interfaces。

marker interfaces中文翻譯叫做標記接口，標記接口就是說這個接口使用來做標記用的，內部並沒有提供任何方法或者字段。

在java中有很多標記接口，最常見的就是Cloneable，Serializable，還有java.util包中的EventListener和RandomAccess。

以Cloneable爲例：

/*
 * @since   1.0
 */
public interface Cloneable {
}

該接口從java1.0就開始有了。實現該接口的類才能夠調用Object中的clone方法。

我們在代碼中如何判斷類是否實現了Cloneable接口呢？

public Object clone() throws CloneNotSupportedException {
        if (this instanceof Cloneable) {
            return super.clone();
        } else {
            throw new CloneNotSupportedException();
        }
    }

很簡單，通過instanceof來判斷是否是Cloneable即可。

marker interfaces好用是好用，但是有一些缺點，比如沒有額外的元數據信息，功能太過單一，並且會和正常的interface混淆。實現起來也比一般的interface複雜。

正式由於這些原因，在JDK5中，引入了註解Annotation。

註解的定義

註解是由@interface來定義的。創建一個annotation需要指定其target和retention，並可以自定義參數。

我們舉個例子：

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface CustUserAnnotation {
    int value();
    String name();
    String[] addresses();
}

上面是我自定義的一個註解。

Retention

Retention表示註解將會在什麼階段可見。它有三個可選值：

SOURCE 表示只在源代碼可見，編譯的時候就會被丟棄。

CLASS 表示在class可見，也就是說編譯的時候可見，但是運行時候不可見。

RUNTIME 表示運行時候可見。什麼時候才需要運行時可見呢？那就是使用到反射的時候。我們會在後面的例子中具體的描述這種情況。

Retention本身也是一個註解：

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Retention {
    /**
     * Returns the retention policy.
     * @return the retention policy
     */
    RetentionPolicy value();
}

Target

Target表示這個註解將會用到什麼地方。它有12個值。

TYPE 表示用在Class，interface，enum或者record上。

FIELD 表示用在class的字段上。

METHOD 表示用在方法上。

PARAMETER 表示用在方法上面。

CONSTRUCTOR 用在構造函數上。

LOCAL_VARIABLE 用在本地變量上。

ANNOTATION_TYPE 用在註解上。

PACKAGE 用在package上。

TYPE_PARAMETER 用在類型參數上。

TYPE_USE 用在任何TYPE使用上。

TYPE_PARAMETER和TYPE_USE有什麼區別呢？

TYPE_USE用在任何類型的使用上面，比如申明，泛型，轉換：

@Encrypted String data
List<@NonNull String> strings
MyGraph = (@Immutable Graph) tmpGraph;

而TYPE_PARAMETER用在類型參數上：

class MyClass<T> {...}

MODULE 用在module上。

RECORD_COMPONENT 預覽功能，和records相關。

Target和Retention一樣也是一個註解。

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Target {
    /**
     * Returns an array of the kinds of elements an annotation type
     * can be applied to.
     * @return an array of the kinds of elements an annotation type
     * can be applied to
     */
    ElementType[] value();
}

自定義參數

註解也可以自定參數，參數可以是下的類型：

基礎類型：int，long,double等
String
Class
枚舉類型
其他的註解類型
上面5中的數組

上面我們的自定義類型定義了三個參數：

    int value();
    String name();
    String[] addresses();

我們看下怎麼使用：

@CustUserAnnotation(value = 100, name="jack ma",addresses = {"人民路","江西路"})
public class CustUser {
}

在使用中，我們需要傳入自定義的參數，當然你也可以使用default在註解中提供默認值，這樣就不需要從外部傳入。

在運行時使用註解

在運行時，我們可以使用反射的API來獲得註解，並獲取註解中的自定義變量，從而進行相應的業務邏輯處理。

CustUser custUser= new CustUser();
        Annotation[] annotations= custUser.getClass().getAnnotations();
        Stream.of(annotations).filter(annotation -> annotation instanceof CustUserAnnotation)
                .forEach(annotation -> log.info(((CustUserAnnotation) annotation).name()));

還是剛纔的例子，我們通過getAnnotations方法獲取到註解的值。

在運行時是用註解當然是個不錯的主意，但是反射用的太多的話其實會影響程序的性能。

那麼我們可以不可以將運行時的註解提前到編譯時呢？答案是肯定的。

在編譯時使用註解

要想在編譯時使用註解，就要介紹今天我們的最後一部分內容annotation processors。

自定義processors需要實現javax.annotation.processing.Processor接口。

接下來我們自定義一個Processor：

@SupportedAnnotationTypes("com.flydean.*")
@SupportedSourceVersion(SourceVersion.RELEASE_14)
public class MyProcessor extends AbstractProcessor {
    @Override
    public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
        System.out.println("process annotation!");
        annotations.forEach(annotation -> {
            Set<? extends Element> elements = roundEnv.getElementsAnnotatedWith(annotation);
            elements.stream()
                    .filter(TypeElement.class::isInstance)
                    .map(TypeElement.class::cast)
                    .map(TypeElement::getQualifiedName)
                    .map(name -> "Class " + name + " is annotated with " + annotation.getQualifiedName())
                    .forEach(System.out::println);
        });
        return true;
    }
}

SupportedAnnotationTypes表示支持的註解類型。

SupportedSourceVersion表示支持的源代碼版本。

最後我們在process方法中，獲取了註解類的一些信息。

有了processor我們怎麼在maven環境中使用呢？

最簡單的辦法就是在maven的maven-compiler-plugin插件中添加annotationProcessors，如下所示：

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <source>14</source>
                    <target>14</target>
                    <annotationProcessors>
                       <annotationProcessor>com.flydean.MyProcessor</annotationProcessor>
                    </annotationProcessors>
                </configuration>
            </plugin>
        </plugins>
    </build>

如果不添加，默認情況下編譯器會從classpath中去尋找META-INF/services/javax.annotation.processing.Processor文件，這個文件裏面列出了對外提供的註解處理器。編譯器會加載這些註解處理器去處理當前項目的註解。

lombok應該大家都用過吧，它實際上爲我們提供了兩個註解處理器：

很不幸的是，因爲我在CustUser中使用了lombok中的log，如果像上面一樣顯示指定annotationProcessor則會將覆蓋默認的查找路徑，最後會導致lombok失效。

那應該怎麼處理才能兼容lombok和自定義的processor呢？

我們可以把自定義processor單獨成一個模塊，也做成lombok這樣的形式：

這個processor的模塊編譯參數需要加上一個proc none的參數：

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.8.1</version>
                <configuration>
                    <source>14</source>
                    <target>14</target>
                    <proc>none</proc>
                </configuration>
            </plugin>
        </plugins>
    </build>

proc是設置是否需要在本項目中啓用processor。對於processor項目來說，它本身還沒有編譯，如果啓用就會出現找不到類的錯誤。所以這裏我們需要將proc設置爲none。

最後我們的annotation-usage項目可以不需要annotationProcessors的配置就可以自動從classpath中讀取到自定義的processor了。

總結

本文介紹了marker interface,annotation和annotation processor，並詳細講解了如何在maven程序中使用他們。

本文的例子https://github.com/ddean2009/
learn-java-base-9-to-20

本文作者：flydean程序那些事

本文鏈接：http://www.flydean.com/marker-interface-annotation-processor/

本文來源：flydean的博客

歡迎關注我的公衆號:程序那些事，更多精彩等着您！

標記接口,註解和註解處理器的前世今生

文章目錄

簡介

註解的起源和marker interfaces

註解的定義

Retention

Target

自定義參數

在運行時使用註解

在編譯時使用註解

總結

致遠OA及相關OA系統集成與二次開發

EXCEL公式使用總結

System.Object未被引用的程序集中定義

Java 信號量（semaphore）搭配CountDownLatch 實現多線程處理循環內邏輯並限制創建線程數

[轉帖]linux命令top內存顯示M兆或者G

【面試準備】項目經驗——接口自動化項目

flutter系列之:創建一個內嵌的navigation 簡介搭建主Navigator 構建子路由總結

還不知道如何在java中終止一個線程?快來,一文給你揭祕簡介 Thread.stop被禁用之謎怎麼才能安全？捕獲異常之後的處理總結

flutter系列之:在flutter中自定義themes 簡介 MaterialApp中的themes 自定義themes的使用總結

flutter系列之:Navigator的高級用法簡介 named routes 給named route傳參數從Screen返回值向Screen傳值總結

flutter系列之:在flutter中使用導航Navigator 簡介 flutter中的Navigator Navigator的使用總結

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結