Класс Cleaner

public final class Cleaner extends Object

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

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

Если CleaningExample используется в блоке try-finally, то метод close вызывает действие очистки. Если метод close не вызывается, действие очистки вызывается очистителем, когда экземпляр 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();
        }
    }
 

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

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

С:

9