Java ClassValue 怎样缓存与类关联的计算结果

如果缓存值天然是“某个 Class 的派生结果”，Java 的 ClassValue 比手动维护 Map, Object> 更贴合问题。你只需要实现 computeValue，第一次调用 get 时按类计算，之后继续读取已经关联的值；需要让依据变化时，再对指定类型调用 remove。

官方 API 文档：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/ClassValue.html

ClassValue 解决的是“按 Class 懒惰关联一个派生值”，不是所有对象缓存问题。先确认缓存键就是类型，再决定是否使用它。

ClassValue 到底缓存了什么

可以把它理解成一个带泛型结果的类型关联表：缓存对象本身不保存一个业务字符串键，而是针对传入的 Class> 建立关联。比如反射框架可以为每个实体类计算字段元数据、消息分发表或访问策略。

它与普通 Map 的边界可以先这样判断：

用 computeValue 定义按类计算逻辑

ClassValue 是抽象类，最小实现是覆写 computeValue(Class> type)。下面用不可变的 TypeMetadata 表示派生结果；示例重点是 API 关系，不依赖框架。

import java.lang.reflect.Field;
import java.util.Arrays;

// 每个 Class 对应一份不可变的字段元数据，避免调用方修改缓存内容。
record TypeMetadata(String typeName, String[] fieldNames) {}

final class MetadataCache {
    private static final ClassValue VALUES = new ClassValue() {
        @Override
        protected TypeMetadata computeValue(Class> type) {
            // 只在该 Class 尚未关联值时计算；结果必须由当前 type 决定。
            String[] names = Arrays.stream(type.getDeclaredFields())
                    .map(Field::getName)
                    .toArray(String[]::new);
            return new TypeMetadata(type.getName(), names);
        }
    };

    static TypeMetadata get(Class> type) {
        // get 会返回已有值；没有值时由 computeValue 建立关联。
        return VALUES.get(type);
    }

    static void invalidate(Class> type) {
        // 只有元数据依据发生变化时才清除该类型的旧结果。
        VALUES.remove(type);
    }
}

这里的关键不是把所有反射调用都塞进缓存，而是让 computeValue 成为一个由类型决定的纯计算边界。真实项目中还要考虑是否需要复制数组、隐藏字段、父类字段以及访问权限；这些规则应当属于元数据设计，而不是由 ClassValue 自动决定。

通过 get 读取并保持类型安全

调用方只需要传入目标类：

final class Order {
    private long id;
    private String status;
}

// 返回值已经是 TypeMetadata，不需要从 Object 强制转换。
TypeMetadata metadata = MetadataCache.get(Order.class);
System.out.println(metadata.typeName());

首次访问某个类型时，get 会尝试读取关联值；没有关联值时触发计算。后续访问同一个 Class 会读取已关联的结果。传入 null 会抛出 NullPointerException，因此不要把可能为空的反射结果直接传给它。

这也是 ClassValue 比 Map, Object> 更清楚的地方：缓存结果的类型在声明处确定，调用方不需要自己处理通用 Object，也没有把“键类型”和“缓存策略”散落在多个方法里。

remove 什么时候有用

remove(type) 会清除指定 Class 的关联值。它适用于计算依据发生变化的场景，例如开发期热替换元数据规则、重新加载某类的访问描述，或主动让下一次访问重新计算。它不是普通的“清空全部缓存”按钮，调用时应明确目标类型。

// 配置规则发生变化后，只让 Order 的派生元数据失效。
MetadataCache.invalidate(Order.class);

// 下一次读取会再次进入 computeValue，拿到新的关联结果。
TypeMetadata refreshed = MetadataCache.get(Order.class);

需要注意，remove 只影响指定类型的关联，不会替你通知业务对象，也不会自动刷新已经复制到其它地方的旧元数据。如果外部还持有旧的 TypeMetadata，应由业务层决定它是否继续可用。

并发计算和异常应该怎样理解

并发首次访问同一个类型时，computeValue 可能因为竞争被调用多次，但最终只会有一个值与该 Class 关联并被返回。因此计算函数不要执行只能发生一次的副作用，例如只允许一次的扣款、注册监听器或写入外部系统。

如果 computeValue 抛出异常，本次 get 不会建立关联；下一次访问仍可能再次尝试计算。适合的做法是让计算函数尽量快速、可重复，并把外部失败转换成清晰的异常边界，而不是在里面偷偷吞掉错误。

static TypeMetadata safeGet(Class> type) {
    try {
        // 将 ClassValue 的异常边界保留给上层，便于记录具体类型。
        return MetadataCache.get(type);
    } catch (RuntimeException ex) {
        // 这里只补充上下文，不把失败伪装成空元数据。
        throw new IllegalStateException("读取类型元数据失败: " + type.getName(), ex);
    }
}

哪些情况不该使用 ClassValue

• 缓存键不是 Class，而是用户、地域、版本或任意组合条件。
• 需要按大小、时间或访问频率淘汰，并且这些策略是核心业务要求。
• 缓存值必须在多个 JVM 之间共享，或者必须持久化后跨进程读取。
• computeValue 计算成本很高且无法安全重复，或者计算依赖频繁变化却没有可靠的失效时机。

这几类问题应回到带明确键、生命周期和淘汰规则的缓存设计。ClassValue 的价值在于把“类型到派生值”的关系表达清楚，而不是替代所有缓存组件。

小结

把 ClassValue 记成三步即可：computeValue 定义按类计算，get 负责读取或懒惰建立关联，remove 负责让指定类型的旧结果失效。计算应可重复、无一次性副作用，结果类型应在泛型中固定；如果问题需要业务键、跨进程共享或复杂淘汰，使用更明确的缓存方案。

常见问题

ClassValue 会把所有 Class 映射到同一个值吗？

不会。一个 ClassValue 对象可以关联多个 Class，但每个 Class 都有自己的关联值；computeValue 接收的参数就是当前类型。

为什么不直接用 ConcurrentHashMap, Object>？

如果确实需要自定义键、淘汰、统计或复合条件，Map 可以更合适。ClassValue 的优势是把按类关联、懒惰计算和泛型结果收拢到一个 API 中，减少手动同步与类型转换。

remove 后是不是马上在当前线程重新计算？

不是。remove 清除指定关联；后续访问该类型时才会再次触发计算。不要把 remove 当成同步刷新结果的返回值。