Класс 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,
          // but for the sake of example, a new one is created here)
        private static final Cleaner cleaner = Cleaner.create();

        // State class captures information necessary for cleanup.
        // It must hold no reference to the instance being cleaned
        // and therefore it is a static inner class in this example.
        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();
        }
    }
 

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

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

C момента:

9