Java Class-File API 怎么读取类文件结构

做字节码扫描时，我更愿意先把“读取 class 文件”和“解释字节码”拆开。Java Class-File API 的入口是 ClassFile.of().parse(byte[])：它把字节数组转换成可导航的 ClassModel，然后再按需要读取类名、字段、方法、属性或方法体。这样不用先把 class 文件降级成一堆字符串，也不会一开始就解析所有细节。

官方资料地址：https://docs.oracle.com/en/java/javase/26/docs/api/java.base/java/lang/classfile/package-summary.html

读取类文件结构的稳定路径是：先得到 ClassModel，再选择随机访问器或元素遍历；需要分析依赖时，继续从 MethodModel 进入 CodeModel。把解析阶段、遍历深度和异常边界分开，代码会更容易维护。

先把 class 文件读成 ClassModel

先准备一个已经读入内存的 class 文件字节数组，再创建 ClassFile 实例。下面的例子只读取模型，不加载目标类，也不会执行其中的代码。

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.lang.classfile.ClassFile;
import java.lang.classfile.ClassModel;

static ClassModel readClassModel(Path classPath) throws IOException {
    // 读取 class 文件原始字节，解析器只负责建立类文件模型。
    byte[] bytes = Files.readAllBytes(classPath);
    return ClassFile.of().parse(bytes);
}

static void printHeader(Path classPath) throws IOException {
    ClassModel model = readClassModel(classPath);
    // thisClass 是类文件中的符号信息，不等于反射加载后的 Class 对象。
    System.out.println("class=" + model.thisClass().asSymbol().displayName());
    System.out.println("flags=" + model.flags().flagsMask());
}

ClassModel 是不可变描述，而且内容会惰性膨胀：只访问类名时，不必马上处理整个类文件。它适合做扫描器的中间表示，但官方文档也提醒，惰性模型不一定线程安全。如果同一个模型要跨线程使用，先明确所有权，或者在任务边界内重新解析。

按模型层级读取类、字段和方法

只关心声明信息时，优先使用 fields()、methods() 这类访问器；要保留类文件中的线性顺序，则遍历 ClassModel，根据元素类型分支。两种方式都比手动解析常量池索引更直接。

import java.lang.classfile.FieldModel;
import java.lang.classfile.MethodModel;

static void listMembers(ClassModel model) {
    // 随机访问字段和方法，适合生成类结构摘要。
    for (FieldModel field : model.fields()) {
        System.out.println("field=" + field.fieldName().stringValue());
    }
    for (MethodModel method : model.methods()) {
        // 方法名与描述符分开保留，避免重载方法被合并。
        System.out.println("method=" + method.methodName().stringValue()
                + " descriptor=" + method.methodTypeSymbol());
    }
}

字段和方法只是入口。属性可能挂在类、字段、方法、记录组件或 Code 属性上；如果扫描器只读取顶层成员，得到的结果会天然不完整。对未知属性，也要决定是保留、跳过还是交给自定义 AttributeMapper 处理。

深入 CodeModel 判断字节码关系

当需求从“有哪些方法”升级为“方法依赖了哪些类”时，继续向下走：方法模型包含代码模型，代码模型再提供指令级元素。调用指令和字段指令都能暴露所属者的符号描述，适合收集依赖边。

import java.lang.classfile.CodeElement;
import java.lang.classfile.CodeModel;
import java.lang.classfile.MethodElement;
import java.lang.classfile.MethodModel;
import java.lang.classfile.instruction.FieldInstruction;
import java.lang.classfile.instruction.InvokeInstruction;
import java.lang.constant.ClassDesc;
import java.util.HashSet;
import java.util.Set;

static Set collectDependencies(ClassModel model) {
    Set dependencies = new HashSet();
    for (MethodModel method : model.methods()) {
        // MethodModel 的子元素中可能包含 CodeModel，也可能只有属性。
        for (MethodElement element : method) {
            if (element instanceof CodeModel code) {
                for (CodeElement instruction : code) {
                    // 这里只收集指令的 owner，不把整个常量池误认为依赖。
                    if (instruction instanceof InvokeInstruction invoke) {
                        dependencies.add(invoke.owner().asSymbol());
                    } else if (instruction instanceof FieldInstruction field) {
                        dependencies.add(field.owner().asSymbol());
                    }
                }
            }
        }
    }
    return dependencies;
}

这个层级关系的关键不是把每一种指令都写成一个巨大分支，而是先确定分析目标：如果只查外部调用，保留 InvokeInstruction 就够了；如果还要识别共享状态，再加入 FieldInstruction。对所有元素做全量消费时，要为未来的 class 文件元素制定兼容策略；只关注局部元素时，可以让未知元素原样通过。

遇到解析异常时的边界处理

最容易误判的一点是：parse 返回并不代表所有内容都已经验证完毕。因为模型是惰性的，格式损坏可能在访问字段、方法或属性时才暴露。生产扫描器应把“读取字节”“创建模型”“访问目标节点”分别记录，避免只打印一个笼统的解析失败。

static void inspectSafely(Path classPath) {
    try {
        ClassModel model = readClassModel(classPath);
        // 主动访问目标节点，让惰性解析在可记录的边界内发生。
        model.fields().forEach(field -> field.fieldName().stringValue());
        model.methods().forEach(method -> method.methodName().stringValue());
        System.out.println("structure=readable");
    } catch (IOException | IllegalArgumentException ex) {
        // 输入损坏、格式不兼容和访问阶段失败都要保留文件路径与阶段。
        System.err.println("structure=unreadable path=" + classPath
                + " reason=" + ex.getMessage());
    }
}

最后按四项检查：输入是否确实是目标 class 文件；分析需要停在成员级还是指令级；未知属性是否要保留；异常日志能否区分输入错误与访问阶段错误。这样，Java Class-File API 就不只是“读取类名”的新接口，而是一个可以逐层导航、按需取数的类文件模型。

相关问题

ClassModel 能直接替代反射吗？

不能。Class-File API 面向 class 文件结构，不要求把类加载进当前运行时；反射则面对已加载类型及其运行时行为。做静态扫描、依赖分析或构建期转换时，前者更合适。

什么时候应该读取 constant pool？

只有当分析目标确实依赖常量池条目时再读取。字段、方法和指令访问器已经提供了更高层的模型；直接处理常量池会增加索引、符号描述和兼容性处理成本。