Kaydet (Commit) b09964e9 authored tarafından Stephan Bergmann's avatar Stephan Bergmann

update documentation

Change-Id: Icd966a850b7c5e276e8b1d74566a4ea02e5b4a5c
üst ebd2d28c
...@@ -24,15 +24,17 @@ import java.util.LinkedList; ...@@ -24,15 +24,17 @@ import java.util.LinkedList;
* Helper class to asynchronously execute finalize methods. * Helper class to asynchronously execute finalize methods.
* *
* <p>Current JVMs seem not to be robust against long-running finalize methods, * <p>Current JVMs seem not to be robust against long-running finalize methods,
* in that such long-running finalize methods may lead to OutOfMemoryErrors. This * in that such long-running finalize methods may lead to OutOfMemoryErrors.
* class mitigates the problem by asynchronously shifting the bodies of * This class mitigates the problem by asynchronously shifting the bodies of
* potentially long-running finalize methods into an extra thread. Classes that * 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 * 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 * intra-process JNI UNO bridge and the inter-process Java URP UNO bridge (where
* in both cases finalizers lead to synchronous UNO release calls).</p> * in both cases finalizers lead to synchronous UNO release calls).</p>
* *
* <p>If JVMs are getting more mature and should no longer have problems with * <p>Irrespective whether JVMs are getting more mature and should no longer
* long-running finalize methods, this class could be removed again.</p> * 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().</p>
*/ */
public final class AsynchronousFinalizer { public final class AsynchronousFinalizer {
public AsynchronousFinalizer() { public AsynchronousFinalizer() {
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment