PRB: COM Objects are not Being Released in Java

ID: Q179062


The information in this article applies to:
  • Microsoft SDK for Java, versions 1.51, 2.0, 2.01, 2.02, 3.0, 3.1, 3.2
  • Microsoft Visual J++, versions 1.0, 1.1


SYMPTOMS

When setting a COM object reference to null and possibly attempting to force garbage collection by calling gc(), COM objects may not be released in a timely or predictable fashion.


CAUSE

If you do not call ComLib.release, normal garbage-collection will attempt to perform the release for you. However, this mechanism is not guaranteed due to the threading limitations of many COM objects. That is, many COM objects can be called only on the thread on which they were created. Because garbage collection occurs at unpredictable times, the required thread may have expired or may be no longer responding to messages by the time garbage-collection reclaims the object. In addition, this unpredictability can obscure true memory leaks and/or tie up important system resources.


RESOLUTION

It is recommended that you use explicit releases by calling ComLib.release in order to free COM objects in a timely and predictable fashion.


MORE INFORMATION

For example, if you have the following code that creates a COM object in Java:


import excel8.*;
import com.ms.com.*;

_Global globXL=null;
_Application appXL=null;

try
{
   globXL = (_Global)new Global();
   appXL = (_Application)globXL.getApplication();
}
catch (ComFailException e)
{
   System.out.println(e.getMessage());
} 
You would use this to release these COM objects (note all references to COM objects should be released):

try
{
   ComLib.release(appXL);
   appXL=null;
   ComLib.release(globXL);
   globXL=null;
}
catch (ComFailException e)
{
   System.out.println(e.getMessage());
} 


REFERENCES

Please see the Microsoft SDK for Java documentation for more information.

For the latest Knowledge Base articles and other support information on Visual J++ and the SDK for Java, please see the following pages on the Microsoft Technical Support site:

http://support.microsoft.com/support/visualj/

http://support.microsoft.com/support/java/

Additional query words: JCOM garbage collection release com objects

Keywords : kbSDKJava300 kbSDKJava310 JCOM JVM kbSDKJava320
Version : WINDOWS:1.0,1.1,1.51,2.0,2.01,2.02,3.0,3.1
Platform : WINDOWS
Issue type : kbprb


Last Reviewed: November 16, 1999
© 2000 Microsoft Corporation. All rights reserved. Terms of Use.