Класс 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