Java 9 Cleaner类正确用法咨询：示例代码解析与规范实现

我来给你补全并解释这个Cleaner的示例代码，同时梳理核心的使用规范：

完整可运行的示例代码 #

import java.lang.ref.Cleaner;

public class CleaningExample implements AutoCloseable {
    // 建议在库或类内部共享的Cleaner实例，用static final保证全局唯一且不可变
    private static final Cleaner cleaner = Cleaner.create();

    // 必须是静态内部类！避免持有外部类引用导致GC无法回收
    static class State implements Runnable {
        // 这里存放需要被清理的资源（比如文件句柄、Native内存、网络连接等）
        private final SomeResource resource;

        State(SomeResource resource) {
            this.resource = resource;
        }

        @Override
        public void run() {
            // 执行实际的资源清理逻辑，这个方法最多会被Cleaner执行一次
            resource.release();
            System.out.println("资源已通过Cleaner自动完成清理");
        }
    }

    private final State state;
    private final Cleaner.Cleanable cleanable;

    public CleaningExample(SomeResource resource) {
        this.state = new State(resource);
        // 将当前对象与State绑定，注册到Cleaner
        this.cleanable = cleaner.register(this, state);
    }

    @Override
    public void close() {
        // 主动调用close时，手动触发清理，不要依赖GC的不确定时机
        cleanable.clean();
        System.out.println("资源已通过close方法手动清理");
    }

    // 模拟需要清理的资源类
    static class SomeResource {
        public void release() {
            // 这里写实际的资源释放逻辑，比如关闭文件、释放Native内存等
        }
    }
}

核心使用规范要点 #

• Cleaner实例要共享：Cleaner是线程安全的，把它定义为static final的类级变量，不要为每个对象创建新的Cleaner，避免不必要的资源开销。
• State必须是静态内部类：如果用非静态内部类，会隐式持有外部类的引用，导致外部对象永远无法被GC回收，Cleaner自然也无法触发清理。静态内部类不会持有外部类引用，确保只有当外部对象被GC时，State才会被处理。
• 资源存放在State中：需要清理的资源一定要放在State类里，而不是外部的CleaningExample类。这样即使外部对象被GC回收，State里的资源还能被Cleaner访问到并完成清理。
• 实现AutoCloseable接口：强制自己的类实现AutoCloseable，在close()方法里调用cleanable.clean()。这样用户可以用try-with-resources语法主动释放资源，不要完全依赖GC——毕竟GC的触发时机是不确定的，可能导致资源长时间泄漏。
• 清理逻辑要幂等：虽然官方说明run()方法最多被执行一次，但最好保证你的清理逻辑是幂等的（比如执行多次也不会出问题），避免因为手动调用close()多次或者其他意外情况导致错误。
• 清理操作要快速：Cleaner使用的是守护线程，清理操作不能太耗时，否则会拖慢应用，甚至影响其他资源的回收。
• 不要把Cleaner当唯一方案：Cleaner是GC触发的兜底方案，永远优先让用户通过手动调用close()（或者try-with-resources）来释放资源，Cleaner只是在用户忘记手动清理时的最后保障。

内容的提问来源于stack exchange，提问作者Miss Chanandler Bong