Java ClassValue 怎样按类缓存元数据并支持失效

如果一个程序需要“给每种 Class 计算一份元数据并重复使用”，例如缓存字段描述、序列化策略或消息分发表，直接用 Map, Object> 往往还要自己处理并发、懒加载和失效。Java 的 ClassValue 把这个关联关系封装起来：第一次 get 时计算，之后按类型复用；规则变化时调用 remove，下一次访问会重新计算。

官方地址：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/ClassValue.html

本文只讨论 get、computeValue、remove 的生命周期与并发边界，不把 ClassValue 当作通用缓存或类加载器方案。

ClassValue 的核心关系：按 Class 关联一个懒计算值

可以把它理解成“以 Class 为键的专用关联表”。调用者持有一个 ClassValue 对象，传入具体的 Class>；如果这个类型还没有值，框架会调用 computeValue 生成一个值并关联起来。这里的值不应该依赖某次请求的短暂状态，而应当描述该类型本身。

例如，下面的实现按类型计算字段数量。computeValue 是受保护方法，通常通过匿名类或具名子类实现。代码中的计数只是示例元数据，重点是“输入是 Class，输出与该 Class 关联”。

import java.lang.reflect.RecordComponent;

final class FieldCountCache extends ClassValue {
    @Override
    protected Integer computeValue(Class> type) {
        // 只根据类型计算元数据，不把请求级状态放进缓存值。
        if (type.isRecord()) {
            // record 的组件数量是稳定的类型信息。
            return type.getRecordComponents().length;
        }
        // 普通类使用声明字段数量，避免把继承字段混入本例边界。
        return type.getDeclaredFields().length;
    }
}

FieldCountCache cache = new FieldCountCache();
int count = cache.get(Order.class); // 第一次访问时按 Order 计算
int again = cache.get(Order.class); // 后续访问复用同一关联值

这里的两个 get 针对同一个 Order.class。不要把返回值误解成“全局只计算一次”：在并发竞争下，computeValue 可能被多个线程调用，但最终只会有一个值与该 Class 建立关联。

用 remove 让单个类型的元数据失效

ClassValue 没有按时间自动过期的语义。若元数据的计算规则依赖应用配置、注解扫描结果或动态注册表，规则变化后应针对受影响的 Class 调用 remove，而不是替换整个缓存对象。这样能保留其它类型的关联值。

void refreshType(ClassValue cache, Class> type) {
    // 配置或类型描述发生变化后，只清理受影响的 Class。
    cache.remove(type);
    // 下一次 get 会重新进入 computeValue，得到新规则下的值。
    Integer refreshed = cache.get(type);
    System.out.println(type.getName() + " = " + refreshed);
}

remove 只改变指定 Class 的关联，不是清空所有类型。若计算过程中发生异常，当前 get 不会建立关联；调用方应让异常带着真实原因返回，避免把失败结果伪装成可缓存的默认值。

并发边界：不要把 computeValue 当成只执行一次

官方 API 明确允许竞争中的多次计算，因此 computeValue 应尽量是无副作用、可重复的函数。如果计算过程会注册全局资源、发送通知或写入外部系统，就可能因为竞争而重复执行。更稳妥的方式是让它只读取类型信息和只读配置，把有副作用的动作放到显式初始化流程中。

还要区分两个动作：get 负责读取或尝试关联计算结果，remove 负责让旧关联失效。若配置更新与读取并发发生，应把配置快照设计成不可变对象，让一次 computeValue 只观察一个明确版本；不要在方法内部拼接多个可能变化的全局变量。

落地清单与常见问题

• 缓存键是否确实是 Class，而不是请求 ID、租户 ID 或用户输入？
• 计算结果是否只描述类型，且允许并发重复计算？
• 规则变化时是否只 remove 受影响的 Class？
• computeValue 抛错时，调用方是否能区分“没有关联值”和“计算失败”？

ClassValue 会不会自动按时间过期？不会。它提供的是按 Class 关联、按 Class 移除的生命周期；时间过期要由外部规则或重新设计缓存值完成。

为什么不用 ConcurrentHashMap, T>？如果你需要普通键值缓存，Map 仍然合适；当需求正好是“每个 Class 一份懒计算的类型元数据，并且支持单类型失效”时，ClassValue 能减少并发与关联生命周期的自定义代码。

记住一句话：get 读取或建立按类关联，computeValue 负责可重复计算，remove 负责让指定类型在下一次访问时重新计算。