com.sun.star.lib.util

Class AsynchronousFinalizer

java.lang.Object

com.sun.star.lib.util.AsynchronousFinalizer

public final class AsynchronousFinalizer
extends Object

Helper class to asynchronously execute finalize methods.

Current JVMs seem not to be robust against long-running finalize methods, in that such long-running finalize methods may lead to OutOfMemoryErrors. This class mitigates the problem by asynchronously shifting the bodies of potentially long-running finalize methods into an extra thread. Classes that make use of this in their finalize methods are the proxies used in the intra-process JNI UNO bridge and the inter-process Java URP UNO bridge (where in both cases finalizers lead to synchronous UNO release calls).

Irrespective whether JVMs are getting more mature and should no longer have problems with long-running finalize methods, at least the JNI UNO bridge needs some way to stop finalization of proxies (to C++ objects) well before process exit, as provided by drain().

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	AsynchronousFinalizer.Job An interface to represent bodies of finalize methods.

Constructor Summary

Constructors

Constructor and Description
AsynchronousFinalizer()

Method Summary

Modifier and Type	Method and Description
void	add(AsynchronousFinalizer.Job job) Add a job to be executed asynchronously.
void	drain()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AsynchronousFinalizer

public AsynchronousFinalizer()

Method Detail

add

public void add(AsynchronousFinalizer.Job job)

Add a job to be executed asynchronously.

The run method of the given job is called exactly once. If it terminates abnormally by throwing any Throwable, that is ignored.

Parameters:

job - represents the body of some finalize method; must not be null.

drain

public void drain()
           throws InterruptedException

Throws:

InterruptedException