ClassValue 是 Java 中为每个 Class 对象关联延迟初始化、线程安全元数据值的轻量机制，用于类级别缓存（如反射信息、注解解析结果），核心特点是无锁、按需加载、每个类一份值。
ClassValue 是 Java 中一种高效、线程安全的机制，用于为每个类（Class 对象）关联一份独立的、延迟初始化的元数据值。它不是为每个类实例服务，而是为每个 Class 对象本身服务——即“每个类一份值”，天然适合存储类级别的缓存、反射信息、序列化描述符、注解解析结果等。
核心设计目标：轻量、无锁、按需加载
ClassValue 的本质是解决传统 ConcurrentHashMap<class>, T></class> 方案的几个痛点：
- 避免为未使用该元数据的类预先分配空间（惰性绑定）
- 不依赖全局哈希表，减少 GC 压力和哈希冲突开销
- 在多线程首次访问同一类时，自动保证只计算一次值（类似双重检查 + 内部同步）
- 当类被卸载（ClassLoader 被回收）时，自动清理对应值（通过弱引用 + 清理线程）
基本用法：继承 ClassValue 并实现 computeValue
你需要定义一个子类，重写 computeValue(Class> type) 方法，返回该类所需的元数据：
class MethodCache extends ClassValue<Map<String, Method>> {
@Override
protected Map<String, Method> computeValue(Class<?> type) {
Map<String, Method> map = new HashMap<>();
for (Method m : type.getDeclaredMethods()) {
map.put(m.getName(), m);
}
return Collections.unmodifiableMap(map);
}
}
// 使用
MethodCache cache = new MethodCache();
Map<String, Method> methods = cache.get(String.class); // 首次调用触发 computeValue
注意：computeValue 只会被调用一次/类，且结果会缓存；后续 get() 直接返回缓存值。
生命周期与清理：自动适配类加载器生命周期
ClassValue 内部使用弱引用持有对 Class 的引用，并配合一个后台守护线程（sun.misc.Cleaner 或 JDK 9+ 的 java.lang.ref.Cleaner）监听类卸载事件。这意味着：
- 只要类还存活（未被 GC），其对应的值就一直有效
- 一旦类所在的 ClassLoader 被回收，ClassValue 自动丢弃该条目，不会造成内存泄漏
- 无需手动
remove或clear，也不需要注册 shutdown hook
适用场景举例
以下情况特别适合 ClassValue：
- 为每个类缓存其所有
@JsonCreator方法（Jackson 内部使用） - 记录每个类的字段序列化顺序（如 Protobuf 编译插件生成的运行时描述）
- 预计算并缓存某个类的泛型类型参数结构（如 TypeVariable 解析树）
- 构建轻量级的“类级别单例”——比如每个类对应一个专用的
ObjectStreamField[]
不适合的场景：需要频繁更新值、值依赖实例状态、或要求强一致性跨类操作——它本质是只读、不可变、类粒度的。
