Класс Cleaner

public final class Cleaner extends Object

Примечание API:

Действие очистки вызывается только после того, как связанный объект становится доступным только через слабую ссылку, поэтому важно, чтобы объект, реализующий действие очистки, не содержал ссылок на объект. В этом примере статический класс инкапсулирует состояние очистки и действие. Нельзя использовать вложенный класс, анонимный или нет, потому что он неявно содержит ссылку на внешний экземпляр, препятствуя тому, чтобы он стал доступным только через слабую ссылку. Выбор нового очистителя или использования существующего определяется случаем использования.

Если CleaningExample используется в блоке try-finally, то метод close вызывает действие очистки. Если метод close не вызывается, действие очистки вызывается очистителем Cleaner, когда экземпляр CleaningExample стал доступным только через слабую ссылку.

 public class CleaningExample implements AutoCloseable {
        // A cleaner, preferably one shared within a library
        private static final Cleaner cleaner = <cleaner>;

        static class State implements Runnable {

            State(...) {
                // initialize State needed for cleaning action
            }

            public void run() {
                // cleanup action accessing State, executed at most once
            }
        }

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

        public CleaningExample() {
            this.state = new State(...);
            this.cleanable = cleaner.register(this, state);
        }

        public void close() {
            cleanable.clean();
        }
    }
 

Действие очистки может быть лямбда-выражением, но слишком легко захватывает ссылку на объект, ссылаясь на поля очищаемого объекта, препятствуя тому, чтобы объект стал доступным только через слабую ссылку. Использование статического вложенного класса, как показано выше, позволит избежать случайного сохранения ссылки на объект.

Действия очистки должны быть готовы к вызову одновременно с другими действиями очистки. Как правило, действия очистки должны выполняться очень быстро и не блокироваться. Если действие очистки блокируется, оно может замедлить обработку других действий очистки, зарегистрированных для того же очистителя. Все действия очистки, зарегистрированные для очистителя, должны быть взаимосовместимыми.

С:

9