文檔教程后端【免費(fèi)下載鏈接】CodeGuide:books: 本代碼庫(kù)是作者小傅哥多年從事一線互聯(lián)網(wǎng) Java 開(kāi)發(fā)的學(xué)習(xí)歷程技術(shù)匯總旨在為大家提供一個(gè)清晰詳細(xì)的學(xué)習(xí)教程側(cè)重點(diǎn)更傾向編寫(xiě)Java核心內(nèi)容。如果本倉(cāng)庫(kù)能為您提供幫助請(qǐng)給予支持(關(guān)注、點(diǎn)贊、分享)項(xiàng)目地址https://gitcode.com/gh_mirrors/code/CodeGuide點(diǎn)擊查看免費(fèi)下載本文是 CodeGuide 倉(cāng)庫(kù)中 ASM 文檔系列 第 4 章元數(shù)據(jù)的系統(tǒng)精讀。類(lèi)文件元數(shù)據(jù)——泛型簽名、注解、調(diào)試信息——雖不參與字節(jié)碼指令的運(yùn)行時(shí)執(zhí)行卻支撐著反射、編譯器分離編譯、調(diào)試器與注解框架等核心能力。讀完本文你將掌握用 ASM 核心 API 生成與轉(zhuǎn)換這三類(lèi)元數(shù)據(jù)的方法理解SignatureVisitor、AnnotationVisitor的訪問(wèn)者模型并能結(jié)合倉(cāng)庫(kù)中的字節(jié)碼實(shí)戰(zhàn)案例把元數(shù)據(jù)操縱能力用于 APM 監(jiān)控、框架參數(shù)化等真實(shí)場(chǎng)景。在 Java 類(lèi)文件.class中除了指令本身還存放著大量元數(shù)據(jù)類(lèi)/方法/字段的泛型信息、各種注解、以及用于調(diào)試的源碼行號(hào)與局部變量映射。ASM 為它們提供了完整的生成與轉(zhuǎn)換 API。本章對(duì)應(yīng)倉(cāng)庫(kù)文檔 4.0元數(shù)據(jù).md將逐節(jié)展開(kāi)每一節(jié)首先介紹一種元數(shù)據(jù)類(lèi)型及其類(lèi)文件存儲(chǔ)結(jié)構(gòu)然后給出相應(yīng)的 ASM 接口、組件與工具并配以說(shuō)明性示例。一、元數(shù)據(jù)概述不執(zhí)行指令卻決定框架與工具的能力邊界與字節(jié)碼指令不同元數(shù)據(jù)不是由字節(jié)代碼指令在運(yùn)行時(shí)使用而是服務(wù)于三類(lèi)消費(fèi)方反射 API當(dāng)注解或泛型信息的保留策略允許如RetentionPolicy.RUNTIME時(shí)可通過(guò)反射訪問(wèn)編譯器泛型簽名、注解可供編譯器在分離編譯separate compilation時(shí)使用調(diào)試器與異常棧行號(hào)與局部變量映射直接服務(wù)于javap、IDE 斷點(diǎn)調(diào)試和異常堆棧追蹤。因此元數(shù)據(jù)操縱是幾乎所有 Java 框架Spring、MyBatis、依賴注入、AOP與字節(jié)碼工具APM、混沌工程的底層支撐。如倉(cāng)庫(kù)實(shí)戰(zhàn)文檔 ASM字節(jié)碼編程 所述ASM 可以直接產(chǎn)生二進(jìn)制 class 文件也可以在類(lèi)被加載入 Java 虛擬機(jī)之前動(dòng)態(tài)改變類(lèi)行為元數(shù)據(jù)正是其中可被讀取、修改、刪除、新增的一部分。二、泛型簽名4.1遞歸語(yǔ)法與 SignatureVisitor 組件4.1.1 結(jié)構(gòu)簽名Signature與描述符Descriptor的關(guān)系由于類(lèi)型和方法描述符的定義遠(yuǎn)早于 Java 5 引入泛型出于后向兼容原因泛型信息沒(méi)有存入描述符而是存儲(chǔ)在獨(dú)立的簽名Signature構(gòu)造中類(lèi)型簽名、方法簽名、類(lèi)簽名。在涉及泛型時(shí)這些簽名與描述符一并存入類(lèi)、字段和方法的聲明中。值得強(qiáng)調(diào)的是泛型不影響方法字節(jié)碼——編譯器用它們做靜態(tài)類(lèi)型檢查但會(huì)在必要時(shí)重新引入類(lèi)型轉(zhuǎn)換就像方法未被泛型化一樣進(jìn)行編譯。類(lèi)型簽名的語(yǔ)法完整規(guī)則見(jiàn)《Java 虛擬機(jī)規(guī)范》因泛型的遞歸本質(zhì)而非常復(fù)雜——一個(gè)泛型可將另一泛型作為參數(shù)例如ListListETypeSignature: Z | C | B | S | I | F | J | D | FieldTypeSignature FieldTypeSignature: ClassTypeSignature | [ TypeSignature | TypeVar ClassTypeSignature: L Id ( / Id )* TypeArgs? ( . Id TypeArgs? )* ; TypeArgs: TypeArg TypeArg: * | ( | - )? FieldTypeSignature TypeVar: T Id ;規(guī)則要點(diǎn)類(lèi)型簽名要么是基元類(lèi)型描述符要么是字段類(lèi)型簽名字段類(lèi)型簽名定義為類(lèi)類(lèi)型簽名、數(shù)組類(lèi)型簽名或類(lèi)型變量類(lèi)類(lèi)型簽名即類(lèi)類(lèi)型描述符在主類(lèi)名或內(nèi)部類(lèi)名之后可攜帶尖括號(hào)中的類(lèi)型參數(shù)內(nèi)部類(lèi)名以點(diǎn)前綴區(qū)分。常見(jiàn)的 Java 泛型類(lèi)型與對(duì)應(yīng)類(lèi)型簽名的對(duì)照如下Java 類(lèi)型相應(yīng)的類(lèi)型簽名ListELjava/util/ListTE;;List?Ljava/util/List*;List? extends NumberLjava/util/ListLjava/lang/Number;;List? super IntegerLjava/util/List-Ljava/lang/Integer;;ListListString[]Ljava/util/List[Ljava/util/ListLjava/lang/String;;;HashMapK, V.HashIteratorKLjava/util/HashMapTK;TV;.HashIteratorTK;;方法簽名擴(kuò)展了方法描述符描述方法參數(shù)的類(lèi)型簽名與返回類(lèi)型簽名此外還包含所拋出異常的簽名前綴^并可在尖括號(hào)中包含可選的形式類(lèi)型參數(shù)MethodTypeSignature: TypeParams? ( TypeSignature* ) ( TypeSignature | V ) Exception* Exception: ^ClassTypeSignature | ^TypeVar TypeParams: TypeParam TypeParam: Id : FieldTypeSignature? ( : FieldTypeSignature )*例如泛型靜態(tài)方法static T Class? extends T m (int n)對(duì)應(yīng)的方法簽名為T(mén):Ljava/lang/Object;(I)Ljava/lang/ClassTT;;類(lèi)簽名注意與類(lèi)類(lèi)型簽名區(qū)分定義為超類(lèi)的類(lèi)型簽名、所實(shí)現(xiàn)接口的類(lèi)型簽名以及可選的形式類(lèi)型參數(shù)ClassSignature: TypeParams? ClassTypeSignature ClassTypeSignature*例如CE extends ListE的類(lèi)簽名為E:Ljava/lang/Object;Ljava/util/ListTE;;。4.1.2 接口與組件SignatureVisitor 與 SignatureReader/Writer與描述符一樣ASM API 以簽名在編譯類(lèi)中的存儲(chǔ)形式直接暴露簽名出現(xiàn)在ClassVisitor的visit、visitField、visitMethod方法中分別作為可選的類(lèi)簽名、類(lèi)型簽名或方法簽名參數(shù)。同時(shí)org.objectweb.asm.signature包提供了基于SignatureVisitor抽象類(lèi)的工具用于生成和轉(zhuǎn)換簽名public abstract class SignatureVisitor { public final static char EXTENDS ; public final static char SUPER -; public final static char INSTANCEOF ; public SignatureVisitor(int api); public void visitFormalTypeParameter(String name); public SignatureVisitor visitClassBound(); public SignatureVisitor visitInterfaceBound(); public SignatureVisitor visitSuperclass(); public SignatureVisitor visitInterface(); public SignatureVisitor visitParameterType(); public SignatureVisitor visitReturnType(); public SignatureVisitor visitExceptionType(); public void visitBaseType(char descriptor); public void visitTypeVariable(String name); public SignatureVisitor visitArrayType(); public void visitClassType(String name); public void visitInnerClassType(String name); public void visitTypeArgument(); public SignatureVisitor visitTypeArgument(char wildcard); public void visitEnd(); }訪問(wèn)類(lèi)型簽名時(shí)粗體標(biāo)注的方法必須按以下順序調(diào)用它直接反映前面的語(yǔ)法規(guī)則。注意其中兩個(gè)方法返回SignatureVisitor——這正是類(lèi)型簽名遞歸定義的體現(xiàn)visitBaseType | visitArrayType | visitTypeVariable | ( visitClassType visitTypeArgument* ( visitInnerClassType visitTypeArgument* )* visitEnd ) )訪問(wèn)方法簽名的方法順序?yàn)? visitFormalTypeParameter visitClassBound? visitInterfaceBound* )* visitParameterType* visitReturnType visitExceptionType*訪問(wèn)類(lèi)簽名的方法順序?yàn)? visitFormalTypeParameter visitClassBound? visitInterfaceBound* )* visitSuperClass visitInterface*關(guān)鍵約束這些返回SignatureVisitor的方法必須順序使用——在完全訪問(wèn)一個(gè)嵌套簽名之前不得調(diào)用父訪問(wèn)器的任何方法。這與ClassVisitor返回的MethodVisitor可以并行處理不同因?yàn)榍短缀灻脑L問(wèn)是嚴(yán)格遞歸的。另外返回的SignatureVisitor不允許為null。與類(lèi)訪問(wèn)模型相同ASM 基于該 API 提供了兩個(gè)組件SignatureReader分析一個(gè)簽名針對(duì)給定的簽名訪問(wèn)器調(diào)用適當(dāng)?shù)脑L問(wèn)方法事件產(chǎn)生器SignatureWriter基于接收的方法調(diào)用生成一個(gè)簽名事件使用器其轉(zhuǎn)發(fā)方法總是返回this。簽名轉(zhuǎn)換實(shí)戰(zhàn)重命名類(lèi)名的簽名適配器。下面這個(gè)適配器利用除visitClassType和visitInnerClassType之外全部原樣轉(zhuǎn)發(fā)的策略對(duì)簽名中出現(xiàn)的類(lèi)名做重命名public class RenameSignatureAdapter extends SignatureVisitor { private SignatureVisitor sv; private MapString, String renaming; private String oldName; public RenameSignatureAdapter(SignatureVisitor sv, MapString, String renaming) { super(ASM4); this.sv sv; this.renaming renaming; } public void visitFormalTypeParameter(String name) { sv.visitFormalTypeParameter(name); } public SignatureVisitor visitClassBound() { sv.visitClassBound(); return this; } public SignatureVisitor visitInterfaceBound() { sv.visitInterfaceBound(); return this; } // ... public void visitClassType(String name) { oldName name; String newName renaming.get(oldName); sv.visitClassType(newName null ? name : newName); } public void visitInnerClassType(String name) { oldName oldName . name; String newName renaming.get(oldName); sv.visitInnerClassType(newName null ? name : newName); } public void visitTypeArgument() { sv.visitTypeArgument(); } public SignatureVisitor visitTypeArgument(char wildcard) { sv.visitTypeArgument(wildcard); return this; } public void visitEnd() { sv.visitEnd(); } }注意內(nèi)部類(lèi)的處理技巧visitClassType記錄外層類(lèi)名visitInnerClassType將外層名與內(nèi)部名拼接如java/util/HashMap.HashIterator再查表替換。以下代碼將Ljava/util/HashMapTK;TV;.HashIteratorTK;;重命名為L(zhǎng)ATK;TV;.BTK;;String s Ljava/util/HashMapTK;TV;.HashIteratorTK;;; MapString, String renaming new HashMapString, String(); renaming.put(java/util/HashMap, A); renaming.put(java/util/HashMap.HashIterator, B); SignatureWriter sw new SignatureWriter(); SignatureVisitor sa new RenameSignatureAdapter(sw, renaming); SignatureReader sr new SignatureReader(s); sr.acceptType(sa); sw.toString();4.1.3 工具用 TraceClassVisitor / ASMifier 反查簽名2.3 工具 中介紹的TraceClassVisitor和ASMifier類(lèi)以內(nèi)部形式打印類(lèi)文件中的簽名。反查技巧編寫(xiě)一個(gè)帶有目標(biāo)泛型的 Java 類(lèi) → 用javac編譯 → 用上述命令行工具查看即可得到與給定泛型對(duì)應(yīng)的精確簽名文本。這比手推語(yǔ)法規(guī)則高效得多也是理解復(fù)雜簽名如多層嵌套泛型的捷徑。三、注解4.2AnnotationVisitor 與增刪注解適配器類(lèi)、字段、方法和方法參數(shù)注解如Deprecated、Override只要保留策略不是RetentionPolicy.SOURCE就會(huì)存儲(chǔ)在編譯后的類(lèi)中。與泛型類(lèi)似注解信息不在運(yùn)行時(shí)供字節(jié)碼指令使用但當(dāng)保留策略為RetentionPolicy.RUNTIME時(shí)可通過(guò)反射 API 訪問(wèn)也可供編譯器使用。4.2.1 結(jié)構(gòu)所有注解的統(tǒng)一內(nèi)部形態(tài)源碼中的注解形態(tài)各異Deprecated、Retention(RetentionPolicy.CLASS)、Task(descrefactor, id1)。但在類(lèi)文件內(nèi)部所有注解形式統(tǒng)一為一種注解類(lèi)型 一組名稱/值對(duì)取值僅限于基元、String或Class值枚舉值注解值上述值的數(shù)組由于注解可以包含其他注解甚至注解數(shù)組注解結(jié)構(gòu)可能非常復(fù)雜這正是AnnotationVisitor遞歸模型存在的原因。4.2.2 接口與組件AnnotationVisitor 抽象類(lèi)public abstract class AnnotationVisitor { public AnnotationVisitor(int api); public AnnotationVisitor(int api, AnnotationVisitor av); public void visit(String name, Object value); public void visitEnum(String name, String desc, String value); public AnnotationVisitor visitAnnotation(String name, String desc); public AnnotationVisitor visitArray(String name); public void visitEnd(); }方法調(diào)用順序visitEnd除外可按任意順序( visit | visitEnum | visitAnnotation | visitArray )* visitEnd各方法語(yǔ)義visit(name, value)訪問(wèn)基元、String和Class值Class用Type對(duì)象表示visitEnum(name, desc, value)訪問(wèn)枚舉值desc為枚舉類(lèi)型的描述符visitAnnotation(name, desc)返回嵌套注解的訪問(wèn)器用于注解中包含注解visitArray(name)返回?cái)?shù)組元素訪問(wèn)器。注意數(shù)組元素未命名因此返回的訪問(wèn)器會(huì)忽略name參數(shù)可傳null。與ClassVisitor返回的MethodVisitor不同返回的嵌套AnnotationVisitor必須順序使用在完全訪問(wèn)一個(gè)嵌套注解前不能調(diào)用父訪問(wèn)器的任何方法。實(shí)戰(zhàn)一刪除注解 —— 返回 null 即可與字段/方法移除同理見(jiàn) 2.2.5 移除類(lèi)成員在visitAnnotation中返回null即可刪除對(duì)應(yīng)注解public class RemoveAnnotationAdapter extends ClassVisitor { private String annDesc; public RemoveAnnotationAdapter(ClassVisitor cv, String annDesc) { super(ASM4, cv); this.annDesc annDesc; } Override public AnnotationVisitor visitAnnotation(String desc, boolean vis) { if (desc.equals(annDesc)) { return null; } return cv.visitAnnotation(desc, vis); } }實(shí)戰(zhàn)二添加類(lèi)注解 —— 必須尊重調(diào)用順序添加類(lèi)注解比刪除更難因?yàn)楸仨氉袷谻lassVisitor的調(diào)用順序約束visit→visitSource?→visitOuterClass?→(visitAnnotation | visitAttribute)*→(visitInnerClass | visitField | visitMethod)*→visitEnd。所有可能跟在注解訪問(wèn)之后的方法都必須被重寫(xiě)以便在所有注解都已訪問(wèn)完畢的恰當(dāng)時(shí)機(jī)補(bǔ)插新的注解方法注解的添加因visitCode的存在而更容易public class AddAnnotationAdapter extends ClassVisitor { private String annotationDesc; private boolean isAnnotationPresent; public AddAnnotationAdapter(ClassVisitor cv, String annotationDesc) { super(ASM4, cv); this.annotationDesc annotationDesc; } Override public void visit(int version, int access, String name, String signature, String superName, String[] interfaces) { cv.visit(v, access, name, signature, superName, interfaces); } Override public AnnotationVisitor visitAnnotation(String desc, boolean visible) { if (visible desc.equals(annotationDesc)) { isAnnotationPresent true; } return cv.visitAnnotation(desc, visible); } Override public void visitInnerClass(String name, String outerName, String innerName, int access) { addAnnotation(); cv.visitInnerClass(name, outerName, innerName, access); } Override public FieldVisitor visitField(int access, String name, String desc, String signature, Object value) { addAnnotation(); return cv.visitField(access, name, desc, signature, value); } Override public MethodVisitor visitMethod(int access, String name, String desc, String signature, String[] exceptions) { addAnnotation(); return cv.visitMethod(access, name, desc, signature, exceptions); } Override public void visitEnd() { addAnnotation(); cv.visitEnd(); } private void addAnnotation() { if (!isAnnotationPresent) { AnnotationVisitor av cv.visitAnnotation(annotationDesc, true); if (av ! null) { av.visitEnd(); } isAnnotationPresent true; } } }實(shí)現(xiàn)要點(diǎn)通過(guò)isAnnotationPresent標(biāo)志去重避免重復(fù)添加addAnnotation()插在visitInnerClass/visitField/visitMethod/visitEnd的入口處保證新增注解總是位于所有已有注解之后符合調(diào)用順序若原類(lèi)版本低于 1.5適配器應(yīng)將其更新至該版本——因?yàn)?JVM 會(huì)忽略版本低于 1.5 的類(lèi)中的注解。實(shí)戰(zhàn)三以注解實(shí)現(xiàn)轉(zhuǎn)換參數(shù)化 —— 最常見(jiàn)的應(yīng)用注解在類(lèi)和方法適配器中最重要的應(yīng)用場(chǎng)景是用注解參數(shù)化轉(zhuǎn)換行為僅轉(zhuǎn)換帶Persistent注解的字段、僅對(duì)帶Log注解的方法添加日志代碼等。這一切之所以容易實(shí)現(xiàn)是因?yàn)樽⒔饪偸亲钕缺辉L問(wèn)類(lèi)注解先于字段和方法方法/參數(shù)注解先于代碼。只需在檢測(cè)到所需注解時(shí)置位標(biāo)志如上例的isAnnotationPresent供后續(xù)轉(zhuǎn)換邏輯使用即可。這與倉(cāng)庫(kù)實(shí)戰(zhàn)中字節(jié)碼增強(qiáng)監(jiān)控耗時(shí)基于字節(jié)碼插樁采集數(shù)據(jù)見(jiàn) ASM 實(shí)戰(zhàn)系列的攔截-標(biāo)志-改寫(xiě)模式一脈相承。4.2.3 工具用 ASMifier 生成注解創(chuàng)建代碼2.3 工具 中的TraceClassVisitor、CheckClassAdapter、ASMifier均支持注解也可用TraceAnnotationVisitor或CheckAnnotationAdapter在單個(gè)注解級(jí)別工作。運(yùn)行java -classpath asm.jar:asm-util.jar \ org.objectweb.asm.util.ASMifier \ java.lang.Deprecated輸出如下經(jīng)微小重構(gòu)展示如何用ACC_ANNOTATION標(biāo)志創(chuàng)建注解類(lèi)以及如何創(chuàng)建兩個(gè)類(lèi)注解——一個(gè)無(wú)值、一個(gè)帶枚舉值package asm.java.lang; import org.objectweb.asm.*; public class DeprecatedDump implements Opcodes { public static byte[] dump() throws Exception { ClassWriter cw new ClassWriter(0); AnnotationVisitor av; cw.visit(V1_5, ACC_PUBLIC ACC_ANNOTATION ACC_ABSTRACT ACC_INTERFACE, java/lang/Deprecated, null, java/lang/Object, new String[]{java/lang/annotation/Annotation}); { av cw.visitAnnotation(Ljava/lang/annotation/Documented;, true); av.visitEnd(); } { av cw.visitAnnotation(Ljava/lang/annotation/Retention;, true); av.visitEnum(value, Ljava/lang/annotation/RetentionPolicy;, RUNTIME); av.visitEnd(); } cw.visitEnd(); return cw.toByteArray(); } }方法注解和參數(shù)注解可用MethodVisitor中的visitAnnotation與visitParameterAnnotation方法以類(lèi)似方式創(chuàng)建。如果你對(duì)注解的樹(shù) API 感興趣可進(jìn)一步閱讀 9.2 注釋AnnotationNode擴(kuò)展了AnnotationVisitor提供desc與values字段并可在visitEnd中通過(guò)accept(cv.visitAnnotation(...))完成匿名內(nèi)部類(lèi)式的注解轉(zhuǎn)換。四、調(diào)試信息4.3行號(hào)、局部變量與 SKIP_DEBUG 選項(xiàng)以javac -g編譯的類(lèi)包含三類(lèi)可選調(diào)試信息源文件名源代碼行號(hào)與字節(jié)碼指令之間的映射源碼局部變量名與字節(jié)碼局部變量槽之間的映射。這些信息在調(diào)試器和異常棧軌跡中使用。調(diào)試信息是可選的——移除它們不影響類(lèi)功能這正是 2.2.5 移除類(lèi)成員 中RemoveDebugAdapter刪除visitSource/visitOuterClass/visitInnerClass事件后類(lèi)仍然具有全部功能的原因。4.3.1 結(jié)構(gòu)行號(hào)映射與局部變量元組行號(hào)映射存儲(chǔ)為(line number, label)對(duì)列表位于方法的已編譯代碼部分。若l1、l2、l3按序出現(xiàn)則對(duì)(n1, l1)、(n2, l2)、(n3, l3)的含義是l1與l2之間的指令來(lái)自第n1行l(wèi)2與l3之間的指令來(lái)自n2l3之后的指令來(lái)自n3。注意一個(gè)行號(hào)可出現(xiàn)在多個(gè)對(duì)中——因?yàn)橥辉创a行的表達(dá)式其字節(jié)碼指令可能不連續(xù)例如for (init; cond; incr) statement;通常編譯為init statement incr cond的順序。局部變量映射存儲(chǔ)為(name, type descriptor, type signature, start, end, index)多元組列表在start與end兩個(gè)標(biāo)記之間槽index中的局部變量對(duì)應(yīng)源碼中名為name、類(lèi)型由描述符/簽名描述的局部變量。編譯器可能復(fù)用同一局部變量槽存放不同作用域的變量如下例中槽 1 依次存放i、j、il1: ... // 這里的槽 1 包含局部變量i l2: ... // 這里的槽 1 包含局部變量j l3: ... // 這里的槽 1 再次包含局部變量i end:對(duì)應(yīng)多元組為(i, I, null, l1, l2, 1) (j, I, null, l2, l3, 1) (i, I, null, l3, end, 1)4.3.2 接口與組件visitSource / visitLineNumber / visitLocalVariable調(diào)試信息通過(guò)ClassVisitor和MethodVisitor的三個(gè)方法訪問(wèn)源文件名 →ClassVisitor.visitSource(String source, String debug)行號(hào)映射 →MethodVisitor.visitLineNumber(int line, Label start)每次訪問(wèn)一對(duì)局部變量映射 →MethodVisitor.visitLocalVariable(String name, String desc, String signature, Label start, Label end, int index)每次訪問(wèn)一個(gè)多元組。visitLineNumber必須在作為參數(shù)傳入的標(biāo)記已被訪問(wèn)之后調(diào)用實(shí)踐中緊跟該標(biāo)記立即調(diào)用從而可隨時(shí)得知當(dāng)前指令的源碼行號(hào)public class MyAdapter extends MethodVisitor { int currentLine; public MyAdapter(MethodVisitor mv) { super(ASM4, mv); } Override public void visitLineNumber(int line, Label start) { mv.visitLineNumber(line, start); currentLine line; } ... }類(lèi)似地visitLocalVariable也必須在傳入標(biāo)記被訪問(wèn)后調(diào)用。與上節(jié)結(jié)構(gòu)對(duì)應(yīng)的方法調(diào)用序列為visitLineNumber(n1, l1); visitLineNumber(n2, l2); visitLineNumber(n3, l3); visitLocalVariable(i, I, null, l1, l2, 1); visitLocalVariable(j, I, null, l2, l3, 1); visitLocalVariable(i, I, null, l3, end, 1);忽略調(diào)試信息SKIP_DEBUG 選項(xiàng)為訪問(wèn)行號(hào)和局部變量名ClassReader可能需要引入人為L(zhǎng)abel對(duì)象——即跳轉(zhuǎn)指令并不需要、僅為表示調(diào)試信息而創(chuàng)建的標(biāo)記。這可能在指令刪除類(lèi)轉(zhuǎn)換中造成誤判指令序列中部的一個(gè)Label被當(dāng)作跳轉(zhuǎn)目標(biāo)從而禁止該序列被刪除。規(guī)避方式是在ClassReader.accept方法中使用SKIP_DEBUG選項(xiàng)讀取器將不再訪問(wèn)調(diào)試信息、也不創(chuàng)建人為標(biāo)記。當(dāng)然調(diào)試信息會(huì)從類(lèi)中刪除僅在不會(huì)影響應(yīng)用功能時(shí)使用。ClassReader還提供其他常用選項(xiàng)SKIP_CODE跳過(guò)對(duì)已編譯代碼的訪問(wèn)只需類(lèi)結(jié)構(gòu)時(shí)很有用SKIP_FRAMES跳過(guò)棧映射幀EXPAND_FRAMES解壓縮棧映射幀。這些選項(xiàng)與 3.3 工具 中的分析工具配合可以顯著提升類(lèi)分析效率。4.3.3 工具TraceClassVisitor / CheckClassAdapter / ASMifier與泛型、注解場(chǎng)景一致可用TraceClassVisitor、CheckClassAdapter、ASMifier查看調(diào)試信息的訪問(wèn)方式例如在 2.2.3 生成類(lèi) 的ClassWriter生成流程中若需保留調(diào)試能力可在方法訪問(wèn)器上補(bǔ)充visitLineNumber與visitLocalVariable調(diào)用或在轉(zhuǎn)換鏈中保持這些事件不丟失。五、與倉(cāng)庫(kù)實(shí)戰(zhàn)的結(jié)合從文檔到可運(yùn)行的字節(jié)碼增強(qiáng)本章的元數(shù)據(jù) API 并非孤立理論它與倉(cāng)庫(kù)中 ASM 實(shí)戰(zhàn)系列一脈相承泛型簽名在用ClassWriter.visitMethod生成帶泛型的方法時(shí)簽名參數(shù)signature即按本章語(yǔ)法傳入用ASMifier反查簽名可免去手工推導(dǎo)。注解倉(cāng)庫(kù)實(shí)戰(zhàn) ASM字節(jié)碼編程 展示了ClassWriter生成HelloWorld的完整流程visit定義對(duì)象頭、visitMethod添加方法、visitFieldInsn/visitLdcInsn/visitMethodInsn/visitInsn生成指令、visitMaxs設(shè)置操作數(shù)棧深度與局部變量大小、visitEnd收尾。若在此基礎(chǔ)上疊加visitAnnotation與visitParameterAnnotation即可為生成的類(lèi)和方法注入注解實(shí)現(xiàn)框架級(jí)參數(shù)化。調(diào)試信息在 JavaAgentASM 字節(jié)碼插樁采集方法信息 這類(lèi)非入侵監(jiān)控場(chǎng)景中保持visitLineNumber/visitLocalVariable事件的透?jìng)骺纱_保增強(qiáng)后的類(lèi)仍具備完整調(diào)試體驗(yàn)而SKIP_DEBUG則適用于無(wú)需調(diào)試信息、追求轉(zhuǎn)換鏈精簡(jiǎn)的場(chǎng)景。六、小結(jié)本章圍繞類(lèi)文件元數(shù)據(jù)給出了一條完整的學(xué)習(xí)主線元數(shù)據(jù)類(lèi)型存儲(chǔ)位置核心 ASM API關(guān)鍵組件泛型簽名類(lèi)/字段/方法聲明中的 signatureSignatureVisitorSignatureReader/SignatureWriter注解類(lèi)、字段、方法、參數(shù)AnnotationVisitor返回null刪除、遞歸嵌套訪問(wèn)調(diào)試信息源文件名、行號(hào)映射、局部變量元組visitSource/visitLineNumber/visitLocalVariableSKIP_DEBUG等ClassReader選項(xiàng)三者共享相同的訪問(wèn)者Visitor設(shè)計(jì)哲學(xué)事件產(chǎn)生器Reader→ 事件篩選器Adapter→ 事件使用器Writer且都要求嵌套訪問(wèn)器順序使用、完整訪問(wèn)。掌握這套模式后配合TraceClassVisitor、CheckClassAdapter、ASMifier等工具即可在字節(jié)碼層面自由地生成、轉(zhuǎn)換、刪除和檢測(cè)元數(shù)據(jù)為 APM 監(jiān)控、框架注解、動(dòng)態(tài)代理等高級(jí)能力打下堅(jiān)實(shí)基礎(chǔ)。后續(xù)章節(jié)將繼續(xù)深入方法的代碼結(jié)構(gòu)3.0 方法與后向兼容規(guī)則5.0 后向兼容完整體系可參閱 1 引言。贊分享文檔教程后端【免費(fèi)下載鏈接】CodeGuide:books: 本代碼庫(kù)是作者小傅哥多年從事一線互聯(lián)網(wǎng) Java 開(kāi)發(fā)的學(xué)習(xí)歷程技術(shù)匯總旨在為大家提供一個(gè)清晰詳細(xì)的學(xué)習(xí)教程側(cè)重點(diǎn)更傾向編寫(xiě)Java核心內(nèi)容。如果本倉(cāng)庫(kù)能為您提供幫助請(qǐng)給予支持(關(guān)注、點(diǎn)贊、分享)項(xiàng)目地址https://gitcode.com/gh_mirrors/code/CodeGuide點(diǎn)擊查看免費(fèi)下載相關(guān)推薦深入 ASM 元數(shù)據(jù)編程AnnotationVisitor 生成與轉(zhuǎn)換類(lèi)文件注釋全解析深入 ASM 元數(shù)據(jù)編程AnnotationVisitor 生成與轉(zhuǎn)換類(lèi)文件注釋全解析 導(dǎo)讀 本文圍繞小傅哥《CodeGuide 編程指南》倉(cāng)庫(kù)中 ASM 文文檔教程后端終極指南Blazor調(diào)試中的TypeInfo與AssemblyInfo元數(shù)據(jù)解析技巧終極指南Blazor調(diào)試中的TypeInfo與AssemblyInfo元數(shù)據(jù)解析技巧 Blazor作為.NET生態(tài)中革命性的Web開(kāi)發(fā)框架其調(diào)試機(jī)制依賴于對(duì)前端Web框架Stocks!替代方案探索IEX Cloud關(guān)閉后的數(shù)據(jù)源遷移策略Stocks!替代方案探索IEX Cloud關(guān)閉后的數(shù)據(jù)源遷移策略 當(dāng)IEX Cloud服務(wù)宣布關(guān)閉后許多依賴其獲取股票行情的應(yīng)用程序面臨數(shù)據(jù)中斷風(fēng)險(xiǎn)。St創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考