Android Gradle学习（十一）- ASM库解析

一：概述

ASM 是一个轻量级、高性能的 Java 字节码操作与分析框架，它允许开发者直接读取、修改和生成 Java 字节码（.class 文件），而无需了解字节码的底层细节。相比其他字节码工具（如 BCEL、Javassist），ASM 以体积小、执行效率高著称，广泛用于 AOP 框架（如 Spring AOP）、代码生成工具、混淆工具等场景。

二：ASM 的核心功能

1. 字节码读取：解析 .class 文件，获取类结构、方法、字段、指令等信息。
2. 字节码修改：在现有类的基础上添加 / 删除方法、修改指令、注入代码等。
3. 字节码生成：从零开始动态生成全新的类、方法和字节码指令。
4. 字节码分析：对字节码进行数据流分析、控制流分析等高级操作。

三：ASM 的核心组件

ASM 采用访问者模式（Visitor Pattern）  设计，核心类包括：

组件	作用
ClassReader	读取 .class 文件的字节流，解析为内部结构。
ClassWriter	生成或修改字节码，输出最终的 .class 字节流。
ClassVisitor	访问类结构（类名、父类、接口、方法、字段等），是修改类的入口。
MethodVisitor	访问方法结构（指令、参数、异常等），用于修改方法的字节码。
FieldVisitor	访问字段信息（名称、类型、访问修饰符等）。
AnnotationVisitor	访问注解信息。

四：基本使用流程

1. 读取字节码：通过 ClassReader 加载 .class 文件或类的字节数组。
2. 处理字节码：通过 ClassVisitor、MethodVisitor 等访问者接口，对类结构或方法指令进行修改。
3. 生成字节码：通过 ClassWriter 将修改后的结构转换为字节流，可保存为 .class 文件或直接加载到 JVM 中。

五：ClassReader

ClassReader 是 ASM 框架中负责解析 Java 字节码文件（.class）  的核心组件，它能将二进制字节码转换为 ASM 可处理的结构化数据，并通过访问者模式（Visitor Pattern）暴露给开发者。深入理解 ClassReader 是掌握 ASM 字节码操作的基础。

5.1、ClassReader 的核心功能

1. 字节码解析：按照 Java 虚拟机规范（JVMS）定义的 .class 文件格式，解析二进制字节流，提取类的所有信息（类名、父类、接口、方法、字段、常量池、注解等）。
2. 驱动访问者回调：通过 accept() 方法触发 ClassVisitor、MethodVisitor 等接口的回调，将解析出的信息传递给开发者实现的访问者。
3. 支持多输入源：可从字节数组、文件、类名、输入流等多种来源加载字节码。

5.2、.class 文件结构与 ClassReader 的解析逻辑

.class 文件是严格按照 JVMS 定义的二进制格式存储的，ClassReader 会按以下顺序解析其结构，对应触发不同的访问者方法：

.class 文件结构	解析逻辑	对应 ClassVisitor 回调方法
魔数（0xCAFEBABE）、版本号	验证文件合法性，确定 Java 版本	无（内部处理）
常量池	解析字符串、类名、方法名等常量	无（通过索引间接引用）
类访问标志（如 public、final）	解析类的修饰符	visit(version, access, ...)
类名、父类名、接口列表	解析类的继承关系	visit(version, access, name, ...)
字段表（字段名、类型、修饰符）	逐个解析字段信息	visitField(access, name, desc, ...)
方法表（方法名、参数、指令）	逐个解析方法信息，包括方法内的字节码指令	visitMethod(access, name, desc, ...)
属性表（如注解、源文件名）	解析类级别的附加信息	visitAttribute(attr)
结束	完成解析	visitEnd()

ClassReader 会严格按照上述顺序遍历 .class 文件，确保访问者能按正确的逻辑处理类结构。

5.3、ClassReader 的关键 API

5.3.1. 构造方法（加载字节码）

构造方法	说明	适用场景
ClassReader(byte[] b)	从字节数组加载字节码	内存中已有的字节码（如动态生成或网络获取）
ClassReader(String className)	通过类名加载（依赖类加载器）	解析当前类路径中存在的类
ClassReader(InputStream is)	从输入流加载	读取本地 .class 文件或网络流
ClassReader(File file)	从文件加载	直接解析本地 .class 文件

5.3.2. 核心方法 accept()

启动解析流程并回调访问者，是 ClassReader 的核心方法：

public void accept(ClassVisitor cv, int flags)
public void accept(ClassVisitor cv, Attribute[] attrs, int flags)

• 参数 cv：ClassVisitor 实例，用于接收解析结果（必须实现）。
• 参数 attrs：需要保留的自定义属性（可选，默认保留所有属性）。
• 参数 flags：解析标志，控制解析行为（常用值如下）：

标志常量	作用	适用场景
ClassReader.SKIP_DEBUG	跳过调试信息（行号表、局部变量表）	仅需类结构信息，无需调试细节（提升效率）
ClassReader.SKIP_FRAMES	跳过栈映射帧（StackMapTable）	仅分析字节码，不修改或重新生成类
ClassReader.EXPAND_FRAMES	展开栈映射帧（将压缩格式转为完整格式）	需要修改字节码时（ClassWriter 需完整帧信息生成新类）
ClassReader.SKIP_CODE	跳过方法体内的字节码指令	仅需类结构（类名、字段、方法签名），无需方法实现

5.4、解析流程深度解析

以 ClassReader 解析 java.lang.String 为例，详细流程如下：

1. 初始化：ClassReader cr = new ClassReader("java.lang.String"); 从类路径加载 String.class 的字节流。

2. 验证与版本检查：解析魔数（0xCAFEBABE）确认是合法 .class 文件，读取版本号（如 Java 8 对应 52.0）。

3. 解析常量池：常量池是 .class 文件的 “字典”，包含字符串、类名、方法名等常量。ClassReader 会将其解析为内部数组，供后续步骤通过索引引用。

4. 解析类基本信息：调用 ClassVisitor.visit(version, access, name, ...)，传递类的版本、修饰符（如 public final）、类名（java/lang/String）、父类（java/lang/Object）、接口（如 java/io/Serializable）。

5. 解析字段：对每个字段（如 value 字符数组），调用 ClassVisitor.visitField(access, name, desc, ...)，传递字段修饰符、名称、类型（[C 表示 char[]）等。

6. 解析方法：对每个方法（如 length()、equals()）：

   • 调用 ClassVisitor.visitMethod(access, name, desc, ...)，传递方法修饰符、名称、签名（如 length()I 表示返回 int 的无参方法）。
   • 若未设置 SKIP_CODE，则进一步解析方法体内的字节码指令，通过 MethodVisitor 的 visitInsn()、visitLdcInsn() 等方法回调。

7. 解析属性与注解：如源文件名（SourceFile 属性）、注解（RuntimeVisibleAnnotations）等，调用 visitAttribute() 或 visitAnnotation()。

8. 结束解析：调用 ClassVisitor.visitEnd()，通知访问者解析完成。

六：ClassVisitor

ClassVisitor 是 ASM 框架中基于访问者模式（Visitor Pattern）  的核心接口，用于访问和处理类的结构信息。它是连接 ClassReader（字节码解析器）和 ClassWriter（字节码生成器）的桥梁，负责接收 ClassReader 解析出的类信息（如类名、方法、字段等），并根据业务需求进行分析或修改。

6.1、ClassVisitor 的核心作用

1. 接收类结构信息：从 ClassReader 接收解析出的类基础信息（类名、父类、接口）、字段、方法、注解等。
2. 分发处理逻辑：将字段、方法等细节信息分发给对应的访问者（FieldVisitor、MethodVisitor）处理。
3. 支持字节码修改：通过重写访问方法，在传递信息给下一个访问者（如 ClassWriter）的过程中插入、修改或删除类结构。

6.2、ClassVisitor 的类结构与核心方法

ClassVisitor 接口定义了一系列用于访问类结构的方法，这些方法会被 ClassReader 按 .class 文件的解析顺序调用：

调用顺序	方法名	方法说明	参数说明
0	visitModule	访问模块信息（Java 9+ 模块系统特性），仅当类属于某个模块时调用	- name：模块名称（如 java.base） - access：模块访问修饰符（如 ACC_OPEN、ACC_TRANSITIVE 等） - version：模块版本字符串（可为 null） 返回值：ModuleVisitor 实例，用于访问模块的依赖、导出包等细节
1	visit	访问类的基础元信息，是解析类结构的核心方法，第一个被调用的主要方法	- version：类的版本号（如 52 对应 Java 8，61 对应 Java 17） - access：类的访问修饰符（如 ACC_PUBLIC、ACC_FINAL、ACC_RECORD 等） - name：类的内部名称（格式为 包名/类名，如 java/lang/String） - signature：类的泛型签名（非泛型类为 null） - superName：父类的内部名称（如 java/lang/Object，接口的父类为 null） - interfaces：实现的接口内部名称数组（如 [java/io/Serializable]）
2	visitNestHost	访问嵌套宿主类（Java 11+ 嵌套类特性），标识当前类的嵌套宿主	- nestHost：嵌套宿主类的内部名称（如内部类 A$B 的宿主为 A）
3	visitSource	访问类的源文件信息，可选方法（若类未保留源文件信息则不调用）	- source：源文件名（如 String.java） - debug：调试信息字符串（通常为 null）
4	visitOuterClass	访问外部类信息（仅当当前类是内部类时调用）	- owner：外部类的内部名称 - name：外部类中声明当前内部类的方法名（非方法内声明则为 null） - descriptor：外部类方法的描述符（非方法内声明则为 null）
5	visitAnnotation	访问类级别的注解（每个注解调用一次）	- descriptor：注解类型的描述符（如 Lcom/xxx/MyAnnotation;） - visible：是否为运行时可见注解（true 对应 @Retention(RUNTIME)）返回值：AnnotationVisitor 实例，用于访问注解的属性
6	visitTypeAnnotation	访问类的类型注解（Java 8+ 类型注解特性，如泛型参数上的注解）	- typeRef：类型引用（标识注解作用的位置，如泛型参数、超类等） - typePath：类型路径（用于嵌套类型的注解定位） - descriptor：注解类型描述符 - visible：是否为运行时可见注解 返回值：AnnotationVisitor 实例，用于访问类型注解的属性
7	visitAttribute	访问类的自定义属性（非标准属性，如编译器生成的自定义元数据）	- attribute：Attribute 实例，包含自定义属性的名称和数据
8	visitNestMember	访问嵌套成员类（Java 11+ 嵌套类特性），声明当前宿主类包含的嵌套成员	- nestMember：嵌套成员类的内部名称（如宿主类 A 包含 A$B，则 A$B 是嵌套成员）
9	visitPermittedSubclass	访问允许的子类（Java 16+ 密封类特性），声明密封类允许的子类	- permittedSubclass：允许的子类的内部名称
10	visitInnerClass	访问内部类声明信息（每个内部类声明调用一次，包括嵌套内部类）	- name：内部类的内部名称（如 java/util/ArrayList$Itr） - outerName：外部类的内部名称（如 java/util/ArrayList） - innerName：内部类在外部类中的名称（如 Itr） - access：内部类的访问修饰符
11	visitRecordComponent	访问记录组件（Java 16+ 记录类特性），仅记录类（Record）会调用	- name：记录组件名称（对应记录的字段名）- descriptor：记录组件的类型描述符- signature：记录组件的泛型签名（非泛型为 null） 返回值：RecordComponentVisitor 实例，用于访问记录组件的注解等
12	visitField	访问类的字段信息（每个字段调用一次）	- access：字段的访问修饰符（如 ACC_PRIVATE、ACC_STATIC、ACC_FINAL 等） - name：字段名（如 value） - descriptor：字段类型描述符（如 [C 表示 char[]） - signature：字段的泛型签名（非泛型为 null） - value：字段的初始值（仅静态字段可能有值，如 100） 返回值：FieldVisitor 实例，用于访问字段的注解、属性等
13	visitMethod	访问类的方法信息（每个方法调用一次，包括构造方法和静态初始化方法）	- access：方法的访问修饰符（如 ACC_PUBLIC、ACC_STATIC、ACC_ABSTRACT 等） - name：方法名（构造方法为 <init>，静态初始化方法为 <clinit>） - descriptor：方法的描述符（如 (Ljava/lang/String;)I 表示参数为 String、返回 int） - signature：方法的泛型签名（非泛型为 null） - exceptions：方法抛出的异常类内部名称数组（如 [java/lang/IOException]） 返回值：MethodVisitor 实例，用于访问方法的指令、局部变量等
14	visitEnd	结束类的访问，是最后一个被调用的方法，通常用于添加新元素（如动态生成的字段 / 方法）	无参数

关键说明：

1. 版本兼容性：源码中大量方法包含版本检查（如 visitModule 要求 api >= 393216，即 ASM 6+），低版本 ASM 调用高版本特性方法会抛出 UnsupportedOperationException。

2. 链式委托：所有方法默认会将调用委托给构造函数传入的 ClassVisitor 实例（this.cv），若未传入则返回 null，这是 ASM 访问者链式处理的核心机制。

3. 新增特性：

   • visitRecordComponent 用于 Java 16+ 的记录类（Record）。
   • visitPermittedSubclass 用于 Java 16+ 的密封类（Sealed Class）。
   • visitTypeAnnotation 用于 Java 8+ 的类型注解（如 List<@NonNull String>）。

4. 调用条件：模块、嵌套类、记录类等相关方法仅在类满足对应条件时被调用（如非模块类不会调用 visitModule）。

七：ModuleVisitor

以下是 ASM 框架中 ModuleVisitor 类的方法说明表，按调用顺序排列（基于 Java 9+ 模块系统特性及 ASM 实现逻辑）：

调用顺序	方法名	方法说明	参数说明
1	visitMainClass	访问模块的主类（即 module-info.java 中声明的 main-class）	- mainClass：主类的内部名称（如 com/example/Main）
2	visitPackage	访问模块中声明的包（即 exports 或 opens 之前声明的包）	- packaze：包的内部名称（如 com/example/util）
3	visitRequire	访问模块的依赖（即 requires 声明），每个依赖调用一次	- module：依赖模块的名称（如 java.base） - access：依赖修饰符（如 ACC_TRANSITIVE、ACC_STATIC_PHASE 等） - version：依赖模块的版本号（可为 null）
4	visitExport	访问模块导出的包（即 exports 声明），每个导出包调用一次	- packaze：导出的包名称 - access：导出修饰符（如 ACC_SYNTHETIC、ACC_MANDATED 等） - modules：可访问该导出包的目标模块名称数组（null 表示导出给所有模块）
5	visitOpen	访问模块开放的包（即 opens 声明，允许反射访问），每个开放包调用一次	- packaze：开放的包名称 - access：开放修饰符（同 visitExport 的 access） - modules：可访问该开放包的目标模块名称数组（null 表示开放给所有模块）
6	visitUse	访问模块使用的服务（即 uses 声明，声明模块使用的服务接口），每个服务调用一次	- service：服务接口的内部名称（如 com/example/Service）
7	visitProvide	访问模块提供的服务实现（即 provides ... with 声明），每个服务实现调用一次	- service：服务接口的内部名称 - providers：服务实现类的内部名称数组（如 [com/example/ServiceImpl]）
8	visitAttribute	访问模块的自定义属性（非标准属性，如模块相关的额外元数据）	- attribute：Attribute 实例，包含自定义属性的名称和数据
9	visitEnd	结束模块的访问，是最后一个被调用的方法，用于收尾处理	无参数

关键说明：

1. 适用场景：ModuleVisitor 仅用于处理 Java 9+ 的模块信息（定义在 module-info.class 中），非模块类或低版本 Java 类不会触发此类方法的调用。

2. 调用逻辑：方法调用顺序严格对应 module-info.java 中声明的逻辑顺序：主类→包声明→依赖→导出→开放→服务使用→服务提供→自定义属性→结束。

3. 版本兼容性：

   • 需 ASM 6+ 支持（对应 api >= 393216），低版本 ASM 调用会抛出 UnsupportedOperationException。
   • 模块系统是 Java 9 引入的特性，解析低版本类时不会触发任何 ModuleVisitor 方法。

4. 核心作用：

   • 解析模块时：提取模块的依赖关系、导出 / 开放的包、服务接口与实现等信息（如模块依赖分析工具）。
   • 生成模块时：动态构建 module-info.class，声明模块的各项属性（如自动生成模块描述文件）。

5. 链式委托：与其他访问者一致，ModuleVisitor 通常通过构造函数接收一个委托对象，所有方法默认将调用传递给该委托，实现模块信息的链式处理。

6. 修饰符说明：access 参数的取值来自 Opcodes 类中的模块相关常量（如 ACC_TRANSITIVE 表示依赖是传递性的，ACC_STATIC_PHASE 表示依赖仅在编译期有效）。

八：AnnotationVisitor

以下是基于 ASM 框架中 AnnotationVisitor 类的核心方法（结合标准实现与源码逻辑），按调用顺序整理的详细说明表：

调用顺序	方法名	方法说明	参数说明
1	visit	访问注解的基本属性（非数组类型的普通属性），每个普通属性调用一次	- name：属性名称（若为注解的默认属性，名称为 null） - value：属性值（支持的类型包括 String、Integer、Long、Float、Double、Boolean、Type、byte[]、char[] 等基础类型或数组，以及嵌套注解 / 枚举值对应的 AnnotationVisitor/EnumConstantNode） 返回值：AnnotationVisitor 实例，仅当 value 是嵌套注解时返回（用于访问嵌套注解的属性），非嵌套注解返回 null
2	visitEnum	访问注解的枚举类型属性，枚举属性专用（区别于普通基础类型）	- name：枚举属性名称（同 visit 方法的 name） - descriptor：枚举类的类型描述符（格式为 L枚举类全限定名;，如 Lcom/xxx/Status;） - value：枚举常量的名称（如枚举 Status.SUCCESS 中的 SUCCESS）返回值：null（枚举属性无嵌套结构，无需后续访问）
3	visitAnnotation	访问注解的嵌套注解属性（显式处理嵌套注解，与 visit 中返回 AnnotationVisitor 功能一致，部分实现会优先调用此方法）	- name：嵌套注解属性的名称 - descriptor：嵌套注解的类型描述符（格式为 L注解类全限定名;，如 Lcom/xxx/MyNestedAnn;） 返回值：AnnotationVisitor 实例，用于访问嵌套注解的内部属性
4	visitArray	访问注解的数组类型属性，数组属性专用（包括基础类型数组、枚举数组、注解数组等）	- name：数组属性的名称返回值：AnnotationVisitor 实例，用于访问数组中的每个元素（数组元素的类型由后续 visit/visitEnum/visitAnnotation 决定，如数组元素是普通类型则调用 visit，是枚举则调用 visitEnum）
5	visitTypeAnnotation	访问注解的类型注解属性（Java 8+ 类型注解特性，用于注解中涉及泛型、参数化类型的属性）	- typeRef：类型引用（标识类型注解作用的位置，如泛型参数、数组元素类型等，取值来自 TypeReference 类，如 TypeReference.CLASS_PARAMETER） - typePath：类型路径（用于定位嵌套类型中的注解，如泛型参数的嵌套层级，非嵌套类型为 null） - name：类型注解属性的名称（同普通属性的 name） - value：类型注解的属性值（通常为 Type 类型，如泛型类型 List<String> 对应的 Type 对象）返回值：AnnotationVisitor 实例，仅当 value 是嵌套类型注解时返回，否则返回 null
6	visitEnd	结束注解的访问，是最后一个被调用的方法，用于收尾（如释放资源、确认属性完整性等）	无参数返回值：null（无后续处理）

关键说明：

1. 调用逻辑依赖：

   • 方法调用顺序严格依赖注解的属性结构：先处理普通属性（visit）、枚举属性（visitEnum）、嵌套注解（visitAnnotation），再处理数组属性（visitArray，数组内部元素的访问会递归调用上述方法），最后以 visitEnd 收尾。
   • 若注解无数组 / 枚举 / 嵌套注解属性，visitEnum/visitAnnotation/visitArray 不会被调用。

2. 版本兼容性：

   • visitTypeAnnotation 是 Java 8+ 新增方法（对应 ASM 5+），低版本 ASM （<5）无此方法，调用会抛出 UnsupportedOperationException。
   • 其他核心方法（visit/visitEnum/visitArray/visitEnd）在 ASM 3+ 中已稳定存在，兼容性较高。

3. 链式委托特性：与 ClassVisitor 类似，标准 AnnotationVisitor 实现（如 AnnotationWriter）会通过构造函数接收一个 “委托对象”，所有方法默认会将调用委托给该对象，确保注解属性的访问逻辑可链式传递（如 “解析→修改→生成” 流程）。

4. 典型使用场景：

   • 解析注解时：通过 visit/visitEnum 等方法提取注解的属性名和值（如 AOP 框架扫描 @Aspect 注解的属性）。
   • 生成注解时：通过 visit/visitArray 等方法手动添加注解属性（如动态生成类时为字段添加 @Deprecated 注解）。

九：FieldVisitor

以下是 ASM 框架中 FieldVisitor 类的方法说明表，按调用顺序排列（基于标准实现与源码逻辑）：

调用顺序	方法名	方法说明	参数说明
1	visitAnnotation	访问字段的注解（非类型注解），每个注解调用一次	- descriptor：注解类型描述符（格式为 L注解全限定名;，如 Ljava/lang/Deprecated;） - visible：是否为运行时可见注解（true 对应 @Retention(RUNTIME)） 返回值：AnnotationVisitor 实例，用于访问该注解的属性
2	visitTypeAnnotation	访问字段的类型注解（Java 8+ 特性，如泛型字段的注解）	- typeRef：类型引用（标识注解作用的位置，如字段的类型本身、泛型参数等） - typePath：类型路径（用于嵌套类型的注解定位，如泛型参数的层级） - descriptor：注解类型描述符 - visible：是否为运行时可见注解返回值：AnnotationVisitor 实例，用于访问类型注解的属性
3	visitAttribute	访问字段的自定义属性（非标准属性，如编译器生成的额外元数据）	- attribute：Attribute 实例，包含自定义属性的名称和数据
4	visitEnd	结束字段的访问，是最后一个被调用的方法，用于收尾处理	无参数

关键说明：

1. 调用逻辑：

   • 方法调用顺序固定：先处理普通注解（visitAnnotation），再处理类型注解（visitTypeAnnotation），接着是自定义属性（visitAttribute），最后以 visitEnd 结束。
   • 若字段无注解或属性，对应方法不会被调用。

2. 版本兼容性：

   • visitTypeAnnotation 是 Java 8+ 新增方法（需 ASM 5+ 支持），低版本 ASM 调用会抛出 UnsupportedOperationException。
   • 其他方法在 ASM 3+ 中已存在，兼容性较好。

3. 链式委托：与 ClassVisitor 类似，FieldVisitor 通常通过构造函数接收一个委托对象，所有方法默认会将调用传递给该委托，实现字段信息的链式处理（如解析→修改→生成）。

4. 使用场景：

   • 解析字段时：通过 visitAnnotation 获取字段上的注解（如 @Autowired），通过 visitAttribute 提取自定义元数据。
   • 生成 / 修改字段时：通过 visitAnnotation 为字段添加注解（如动态生成字段并标记 @NonNull）。

5. 与字段声明的关系：FieldVisitor 的方法仅处理字段的注解和属性，字段的基本信息（名称、类型、修饰符等）在 ClassVisitor.visitField() 中定义，不通过此类方法处理。

十：MethodVisitor

以下是 ASM 框架中 MethodVisitor 类的核心方法说明表，按调用顺序排列（基于标准实现与字节码解析流程）：

调用顺序	方法名	方法说明	参数说明
1	visitParameter	访问方法的参数信息（Java 8+ 特性），每个参数调用一次	- name：参数名称（未保留调试信息时为 null） - access：参数的访问修饰符（如 ACC_FINAL、ACC_SYNTHETIC 等）
2	visitAnnotationDefault	访问注解方法的默认值（仅当当前方法是注解接口中的方法时调用）	返回值：AnnotationVisitor 实例，用于访问默认值的具体内容
3	visitAnnotation	访问方法级别的注解（非类型注解），每个注解调用一次	- descriptor：注解类型描述符（如 Lcom/xxx/MyAnnotation;） - visible：是否为运行时可见注解（true 对应 @Retention(RUNTIME)） 返回值：AnnotationVisitor 实例，用于访问注解的属性
4	visitTypeAnnotation	访问方法的类型注解（Java 8+ 特性，如泛型返回值、参数类型上的注解）	- typeRef：类型引用（标识注解作用位置，如方法返回值、参数位置等） - typePath：类型路径（用于嵌套类型的注解定位） - descriptor：注解类型描述符 - visible：是否为运行时可见注解返回值：AnnotationVisitor 实例，用于访问类型注解的属性
5	visitParameterAnnotation	访问方法参数的注解，每个参数的每个注解调用一次	- parameter：参数索引（从 0 开始） - descriptor：注解类型描述符 - visible：是否为运行时可见注解返回值：AnnotationVisitor 实例，用于访问参数注解的属性
6	visitAttribute	访问方法的自定义属性（非标准属性，如编译器生成的元数据）	- attribute：Attribute 实例，包含自定义属性的名称和数据
7	visitCode	开始访问方法体的字节码指令，在所有指令解析前调用	无参数
8	visitFrame	访问栈映射帧（用于类验证，Java 6+ 引入），在指令流的特定位置调用	- type：帧类型（如 F_NEW、F_FULL 等） - nLocal：局部变量表大小- local：局部变量表中的类型数组 - nStack：操作数栈大小 - stack：操作数栈中的类型数组
9	visitInsn	访问单操作数指令（无参数的指令）	- opcode：指令操作码（如 IRETURN、POP、NOP 等）
10	visitIntInsn	访问带 int 操作数的指令	- opcode：指令操作码（如 BIPUSH、SIPUSH、NEWARRAY 等） - operand：int 类型的操作数（如 BIPUSH 10 中的 10）
11	visitVarInsn	访问局部变量相关指令（加载或存储局部变量）	- opcode：指令操作码（如 ILOAD、ISTORE、ALOAD_0 等） - var：局部变量索引（如 ALOAD_1 中的 1）
12	visitTypeInsn	访问类型相关指令	- opcode：指令操作码（如 NEW、ANEWARRAY、CHECKCAST 等） - type：类型描述符（如 NEW java/lang/String 中的 java/lang/String）
13	visitFieldInsn	访问字段操作指令（获取或设置字段值）	- opcode：指令操作码（如 GETFIELD、PUTFIELD、GETSTATIC 等） - owner：字段所属类的内部名称 - name：字段名 - descriptor：字段类型描述符
14	visitMethodInsn	访问方法调用指令（非接口方法）	- opcode：指令操作码（如 INVOKEVIRTUAL、INVOKESTATIC、INVOKESPECIAL 等） - owner：方法所属类的内部名称 - name：方法名- descriptor：方法描述符 - isInterface：是否为接口方法（ASM 5+ 新增参数）
15	visitInvokeDynamicInsn	访问动态方法调用指令（Java 7+ 特性，如 Lambda 表达式）	- name：动态方法名 - descriptor：动态方法描述符 - bootstrapMethodHandle：引导方法句柄 - bootstrapMethodArguments：引导方法参数数组
16	visitJumpInsn	访问跳转指令	- opcode：指令操作码（如 IFEQ、GOTO、JSR 等） - label：跳转目标标签（Label 实例）
17	visitLabel	访问标签（用于标识跳转目标位置）	- label：Label 实例（代表代码中的一个位置）
18	visitLdcInsn	访问常量加载指令（从常量池加载常量）	- cst：常量值（如 String、Integer、Type 等）
19	visitIincInsn	访问局部变量自增指令	- var：局部变量索引- increment：增量值（可正可负）
20	visitTableSwitchInsn	访问 tableswitch 指令（用于连续值的 switch 语句）	- min：case 的最小值 - max：case 的最大值 - dflt：默认跳转标签 - labels：case 对应的跳转标签数组（与 min~max 一一对应）
21	visitLookupSwitchInsn	访问 lookupswitch 指令（用于离散值的 switch 语句）	- dflt：默认跳转标签 - keys：case 的键值数组 - labels：键值对应的跳转标签数组（与 keys 一一对应）
22	visitMultiANewArrayInsn	访问多维数组创建指令	- descriptor：数组类型描述符（如 [[I 表示 int 二维数组） - dims：数组维度（如二维数组为 2）
23	visitTryCatchBlock	访问异常处理块（try-catch 结构），每个 catch 块调用一次	- start：try 块的起始标签-  end：try 块的结束标签 - handler：catch 块的起始标签 - type：异常类型的内部名称（null 表示 finally 块）
24	visitTryCatchFinallyBlock	访问 try-catch-finally 块（ASM 9+ 新增，简化 finally 处理）	- start：try 块起始标签 - end：try 块结束标签 - handler：finally 块起始标签 - excluded：排除的异常类型（通常为 null）
25	visitLocalVariable	访问局部变量表信息（调试信息）	- name：局部变量名 - descriptor：局部变量类型描述符 - signature：局部变量泛型签名（非泛型为 null） - start：变量作用域的起始标签 - end：变量作用域的结束标签 - index：局部变量索引
26	visitLineNumber	访问行号信息（调试信息，关联字节码与源码行号）	- line：源码行号 - start：该行号对应的起始标签
27	visitMaxs	访问方法的操作数栈和局部变量表的最大大小	- maxStack：操作数栈的最大深度 - maxLocals：局部变量表的最大大小
28	visitEnd	结束方法的访问，是最后一个被调用的方法	无参数

关键说明：

1. 调用顺序逻辑：

   • 方法信息解析分为三个阶段：方法元信息（参数、注解、属性）→方法体指令（字节码指令、标签、异常块）→收尾信息（局部变量、行号、栈大小）。
   • 指令相关方法（visitInsn、visitFieldInsn 等）的调用顺序严格对应字节码指令在方法体中的执行顺序。

2. 版本兼容性：

   • 新增特性方法（如 visitInvokeDynamicInsn 对应 Java 7+，visitTryCatchFinallyBlock 对应 ASM 9+）在低版本 ASM 中可能不存在或抛出异常。
   • 调试信息相关方法（visitLocalVariable、visitLineNumber）仅在未设置 ClassReader.SKIP_DEBUG 时调用。

3. 核心作用：

   • 解析方法时：通过指令相关方法提取字节码逻辑（如分析方法调用、循环结构）。
   • 修改 / 生成方法时：通过指令方法注入新逻辑（如 AOP 中的日志切入、动态代理方法生成）。

4. 标签（Label）的作用：Label 实例用于标识代码中的位置，是跳转指令、异常块、局部变量作用域的核心定位工具，由 MethodVisitor 自动维护其在字节码中的偏移量。

5. 链式委托：与其他访问者类似，MethodVisitor 通常委托给下一个访问者（如 ClassWriter 中的方法写入器），确保指令修改能被正确传递到底层字节码生成逻辑。

十一：ClassWriter

ClassWriter 是 ASM 框架中负责生成和修改字节码的核心类，它继承自 ClassVisitor，能够将访问者模式收集的类结构信息（类名、方法、字段等）编码为符合 Java 虚拟机规范的 .class 字节流。

ClassWriter 核心方法说明表（按调用顺序排列）

调用顺序	方法名	方法说明	参数说明
1	构造方法 ClassWriter(int flags)	初始化 ClassWriter 实例，指定字节码生成策略	- flags：生成标志，常用值： - 0：默认模式，需手动计算栈映射帧 - ClassWriter.COMPUTE_MAXS：自动计算操作数栈和局部变量表的最大大小 - ClassWriter.COMPUTE_FRAMES：自动计算栈映射帧（依赖 COMPUTE_MAXS）
2	构造方法 ClassWriter(ClassReader classReader, int flags)	基于已有类的字节码初始化，用于修改现有类	- classReader：已解析的 ClassReader 实例（提供原始类信息） - flags：同上述构造方法
3	visit	写入类的基础信息（版本、修饰符、类名等），是生成类的入口方法	- 同 ClassVisitor.visit() 参数：version、access、name、signature、superName、interfaces
4	visitSource	写入源文件信息（可选）	- source：源文件名 - debug：调试信息
5	visitModule	写入模块信息（Java 9+，仅模块类调用）	- 同 ClassVisitor.visitModule() 参数：name、access、version
6	visitNestHost	写入嵌套宿主类信息（Java 11+，仅嵌套类调用）	- nestHost：嵌套宿主类内部名称
7	visitOuterClass	写入外部类信息（仅内部类调用）	- 同 ClassVisitor.visitOuterClass() 参数：owner、name、descriptor
8	visitAnnotation	写入类级注解	- 同 ClassVisitor.visitAnnotation() 参数：descriptor、visible
9	visitTypeAnnotation	写入类的类型注解（Java 8+）	- 同 ClassVisitor.visitTypeAnnotation() 参数：typeRef、typePath、descriptor、visible
10	visitAttribute	写入类的自定义属性	- attribute：Attribute 实例
11	visitNestMember	写入嵌套成员类信息（Java 11+）	- nestMember：嵌套成员类内部名称
12	visitPermittedSubclass	写入密封类允许的子类（Java 16+）	- permittedSubclass：允许的子类内部名称
13	visitInnerClass	写入内部类声明信息	- 同 ClassVisitor.visitInnerClass() 参数：name、outerName、innerName、access
14	visitRecordComponent	写入记录类组件（Java 16+，仅记录类调用）	- 同 ClassVisitor.visitRecordComponent() 参数：name、descriptor、signature
15	visitField	写入字段信息，返回 FieldVisitor 用于字段细节处理	- 同 ClassVisitor.visitField() 参数：access、name、descriptor、signature、value
16	visitMethod	写入方法信息，返回 MethodVisitor 用于方法指令处理	- 同 ClassVisitor.visitMethod() 参数：access、name、descriptor、signature、exceptions
17	visitEnd	完成类的写入，触发字节码最终编码	无参数
18	toByteArray	获取生成的 .class 字节数组	无参数，返回值：byte[]（可直接保存为 .class 文件或加载到 JVM）
19	getCommonSuperClass	计算两个类的共同父类（用于自动生成栈映射帧）	- type1：第一个类的内部名称 - type2：第二个类的内部名称返回值：共同父类的内部名称

关键说明：

1. 核心功能：

   • ClassWriter 是 ClassVisitor 的实现类，所有 visitXxx() 方法会将类结构信息编码为字节码。
   • 最终通过 toByteArray() 输出完整的 .class 字节流，是字节码生成的 “出口”。

2. 构造方法标志：

   • COMPUTE_MAXS：自动计算方法的 maxStack 和 maxLocals（无需手动调用 visitMaxs()），推荐使用。
   • COMPUTE_FRAMES：自动计算栈映射帧（StackMapTable），适用于 Java 6+ 类，需配合 ClassReader.EXPAND_FRAMES 使用。

3. 与 ClassReader 协作：当修改现有类时，通过 new ClassWriter(cr, flags) 初始化，ClassWriter 会复用原始类的常量池和结构信息，减少重复编码。

4. 性能优化：

   • 自动计算 maxStack 和 maxLocals 可简化开发，但会增加计算开销。
   • 复用 ClassReader 实例可减少常量池重复生成，提升效率。

5. 典型使用流程：

   // 1. 读取原始类（可选，用于修改）
   ClassReader cr = new ClassReader("com/example/Original");
   // 2. 创建 ClassWriter，指定自动计算标志
   ClassWriter cw = new ClassWriter(cr, ClassWriter.COMPUTE_FRAMES);
   // 3. 自定义 ClassVisitor 处理类结构
   ClassVisitor cv = new MyClassVisitor(ASM9, cw);
   // 4. 启动解析和修改
   cr.accept(cv, ClassReader.EXPAND_FRAMES);
   // 5. 获取生成的字节码
   byte[] bytecode = cw.toByteArray();
   

ClassWriter 是 ASM 字节码生成的核心，它屏蔽了 .class 文件的二进制格式细节，让开发者可通过访问者模式轻松生成或修改类。