Класс 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();
       }
   }

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

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

С версии:

9