Added in API level 33

SystemCleaner


public final class SystemCleaner
extends Object

java.lang.Object
   ↳ android.system.SystemCleaner


Java.lang.ref.Cleaner encourages each library to create a Cleaner, with an associated thread, to process Cleaner Runnables for that library's registered cleaning actions. This approach isolates cleaning actions from different libraries from each other; a slow cleaning action in one library will only minimally affect cleaning actions in another. However, this comes at the cost of introducing one Cleaner thread per library that uses Cleaners. This could introduce dozens of additional threads per process, which is often not an acceptable cost, especially on memory-limited devices. SystemCleaner instead provides access to a shared Cleaner, shared across the entire process. It is greatly preferred when all cleaning actions registered by a client are known to complete quickly, without explicit I/O, interprocess communication, or network access. Registering a non-terminating or excessively slow cleaning action with the shared cleaner may cause the process to perform very badly, hang, or be killed.

Summary

Public methods

static Cleaner cleaner()

Return a single Cleaner that's shared across the entire process.

Inherited methods

Object clone()

Creates and returns a copy of this object.

boolean equals(Object obj)

Indicates whether some other object is "equal to" this one.

void finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

final Class<?> getClass()

Returns the runtime class of this Object.

int hashCode()

Returns a hash code value for the object.

final void notify()

Wakes up a single thread that is waiting on this object's monitor.

final void notifyAll()

Wakes up all threads that are waiting on this object's monitor.

String toString()

Returns a string representation of the object.

final void wait(long timeoutMillis, int nanos)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait(long timeoutMillis)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait()

Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public methods

cleaner

Added in API level 33
public static Cleaner cleaner ()

Return a single Cleaner that's shared across the entire process. Thread-safe. Unlike normal Cleaners, uncaught exceptions during cleaning will throw an uncaught exception from the daemon running the cleaning action. This will normally cause the process to crash, and thus cause the problem to be reported.

Returns
Cleaner This value cannot be null.