Java中註解與原理分析詳解

一、註解基礎

註解即標註與解析,在Java的代碼工程中,註解的使用幾乎是無處不在,甚至多到被忽視;

無論是在JDK源碼或者框架組件,都在使用註解能力完成各種識別和解析動作;在對系統功能封裝時,也會依賴註解能力簡化各種邏輯的重復實現;

基礎接口

在Annotation的源碼註釋中有說明:所有的註解類型都需要繼承該公共接口,本質上看註解是接口,但是代碼並沒有顯式聲明繼承關系,可以直接查看字節碼文件;

//1、聲明註解
public @interface SystemLog {}

//2、查看指令
javap -v SystemLog.class

//3、打印結果
Compiled from "SystemLog.java"
public interface com.base.test.SystemLog extends java.lang.annotation.Annotation

元註解

聲明註解時使用,用來定義註解的作用目標,保留策略等;

@Documented
@Inherited
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface SystemLog { String model () default "" ; }
  • Documented:是否被javadoc或類似工具記錄在文檔中;
  • Inherited:標識註解是否可以被子類繼承;
  • Target:作用目標,在ElementType枚舉中可以看到取值包括類、方法、屬性等;
  • Retention:保留策略,比如編譯階段是否丟棄,運行時保留;

此處聲明一個SystemLog註解,作用范圍是在方法上,並且在運行時保留,該註解通常用在服務運行時,結合AOP切面編程實現方法的日志采集;

二、註解原理

先來看一個簡單的註解使用案例,再細致的分析其中原理,案例並不復雜,就是常見的標註與解析兩個關鍵動作;

public class LogInfo {
    @SystemLog(model = "日志模塊")
    public static void main(String[] args) {
        // 生成代理文件
        System.getProperties().put("sun.misc.ProxyGenerator.saveGeneratedFiles", "true");
        // 反射機制
        Method[] methods = LogInfo.class.getMethods();
        for (Method method:methods){
            SystemLog systemLog = method.getAnnotation(SystemLog.class) ;
            if (systemLog != null){
                // 動態代理:com.sun.proxy.$Proxy2
                System.out.println(systemLog.getClass().getName());
                System.out.println(systemLog.model());
            }
        }
    }
}

這裡涉及到兩個核心概念:反射機制、動態代理;反射機制可以在程序運行時獲取類的完整結構信息,代理模式給目標對象提供一個代理對象,由代理對象持有目標對象的引用;

案例中通過反射機制,在程序運行時進行註解的獲取和解析,值得關註的是systemLog對象的類名,輸出的是代理類信息;

案例執行完畢後,會在代碼工程的目錄下生成代理類,可以查看$Proxy2文件;

public final class $Proxy2 extends Proxy implements SystemLog {
    public final String model() throws  {
        try {
            return (String)super.h.invoke(this, m3, (Object[])null);
        } catch (RuntimeException | Error var2) {
            throw var2;
        } catch (Throwable var3) {
            throw new UndeclaredThrowableException(var3);
        }
    }
}

在對SystemLog解析的過程中,實際上是在使用註解的代理類,$Proxy2繼承瞭Proxy類並實現瞭SystemLog接口,並且重寫瞭相關方法;有關反射和代理的邏輯,在之前的內容中有詳說,此處不贅述;

值得一看是代理類中invoke方法調用,具體的處理邏輯在AnnotationInvocationHandler類的invoke方法中,會對註解原生方法和自定義方法做判斷,並對原生方法提供實現;

三、常用註解

1、JDK註解

在JDK中有多個註解是經常使用的,例如Override、Deprecated、SuppressWarnings等;

  • Override:判斷方法是否為重寫方法;
  • Deprecated:標記過時的API,繼續使用會警告;
  • FunctionalInterface:檢驗是否為函數式接口;
  • SuppressWarnings:代碼的警告會靜默處理;

這裡註意FunctionalInterface註解,從1.8開始引入,檢驗是否為函數式接口,即接口隻能有一個抽象方法,否則編譯報錯;

2、Lombok註解

在具體的看Lombok組件之前,需要先瞭解一個概念:代碼編譯;在open-jdk的描述文檔中大致分為三個核心階段;

第一步:讀取命令行上指定的所有源文件,解析為語法樹,進行符號表填充;

第二步:調用註解處理器,如果處理器生成任何新的源文件或類文件,編譯會重新啟動;

第三步:分析器創建的語法樹被分析並轉換為類文件;

更多細節說明可以參考openjdk文檔中Compiler模塊的內容,下面再回到Lombok組件上;

Lombok組件在代碼工程中的使用非常頻繁,通過註解的方式極大的簡化Java中Bean對象的編寫,提高瞭效率並且讓源碼顯得簡潔;

這裡用一段簡單的代碼演示其效果,在IdKey的類中通過三個常用的Lombok註解,替代瞭類中很多基礎方法的顯式生成,查看編譯後的文件實際是存在相關方法的;

@Data
@AllArgsConstructor
@NoArgsConstructor
public class IdKey {
    private Integer id ;
    private String key ;

    public static void main(String[] args) {
        IdKey idKey01 = new IdKey(1,"cicada") ;
        System.out.println(idKey01);
        idKey01.setId(2);
        idKey01.setKey("smile");
        System.out.println(idKey01);
    }
}

這裡需要瞭解JDK中註解處理器的相關源碼,AbstractProcessor作為超類,編譯器在編譯時會去檢查該類的子類,子類中最核心的是process方法;

//1、Lombok處理器
@SupportedAnnotationTypes("*")
public class LombokProcessor extends AbstractProcessor {
    private JavacTransformer transformer;
    @Override
    public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
         transformer.transform(prio, javacProcessingEnv.getContext(), cusForThisRound, cleanup);
    }
}

//2、AST抽象樹
public class JavacTransformer {
    public void transform(long priority, Context context, List<JCTree.JCCompilationUnit> compilationUnits,
                          CleanupRegistry cleanup) {
        JavacAST ast = new JavacAST(messager, context, unit, cleanup);
        ast.traverse(new AnnotationVisitor(priority));
        handlers.callASTVisitors(ast, priority);
    }
}

// 3、註解處理抽象類
public abstract class JavacAnnotationHandler<T extends Annotation> {
    public abstract void handle(AnnotationValues<T> annotation, JCAnnotation ast, JavacNode annotationNode);
}

//4、Getter註解處理
public class HandleGetter extends JavacAnnotationHandler<Getter> {
    @Override 
    public void handle(AnnotationValues<Getter> annotation, JCTree.JCAnnotation ast, JavacNode annotationNode) {
        JavacNode node = annotationNode.up();
        List<JCTree.JCAnnotation> onMethod = unboxAndRemoveAnnotationParameter(ast, "onMethod", "@Getter(onMethod", annotationNode);
        switch (node.getKind()) {
            case FIELD:
                createGetterForFields(level, fields, annotationNode, true, lazy, onMethod);
                break;
        }
    }
}

IdKey類從簡潔的源碼編譯為復雜的字節碼文件,通過註解對結構處理時關聯一個核心概念,叫AST抽象樹,會涉及到很多語法、詞法的解析邏輯;

四、自定義註解

在系統開發中通過自定義註解可以處理各種麻煩的重復邏輯,其最明顯的好處就是可以大量的消除冗餘的代碼塊;

1、同步控制

代碼中可能存在很多方法是限制重復請求的,加鎖處理是很常用的手段,此時完全可以通過註解結合AOP切面編程簡化代碼的復雜程度;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface SyncLock {
    String lockKey();           // 鎖的Key
    int time () default 3000 ;  // 有效時間
    int retryNum () default 3 ; // 重試次數
}

通過註解標記在方法上,可以極大簡化同步鎖的編碼步驟,隻是在讀取KEY的時候需要設計好解析規則,結合反射原理進行獲取即可;

基於相同的原理,也適應與日志采集、系統告警等功能,在之前的內容中都有詳細的總結;

2、類型引擎

在數據處理的邏輯中,經常有這樣一種場景,同一份數據要動態推送到多種數據源中存儲,比如常見的MySQL表和ES索引雙寫模式,這就需要對實體對象做不同的解析邏輯;

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
public @interface BizType {
    EsIndexEnum esIndexEnum () ;        // ES索引解析適配
    MySqlTableEnum mySqlTableEnum () ;  // MySQL表解析適配
    ExcelEnum excelEnum () ;            // Excel解析適配
}

首先聲明一個類型解析的註解,可以標記在實體對象的字段屬性上,然後根據各種數據源的類型枚舉,去適配不同解析工廠的執行邏輯,比如常用數據類型、格式、或者完全自定義。

到此這篇關於Java中註解與原理分析詳解的文章就介紹到這瞭,更多相關Java註解內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!

推薦閱讀: