more ami

1 files changed, 16 insertions, 7 deletions

diff --git a/java/src/IceInternal/Outgoing.java b/java/src/IceInternal/Outgoing.java
index b58d004b76e..fcbf6b1b6a3 100644
--- a/java/src/IceInternal/Outgoing.java
+++ b/java/src/IceInternal/Outgoing.java
@@ -28,6 +28,22 @@ public final class Outgoing
         writeHeader(operation, mode, context);
     }
 
+    //
+    // Do NOT use a finalizer, this would cause a severe performance
+    // penalty! We must make sure that destroy() is called instead,
+    // to reclaim resources.
+    //
+    public void
+    destroy()
+    {
+        _os.destroy();
+        _is.destroy();
+    }
+
+    //
+    // This function allows this object to be reused, rather than
+    // reallocated.
+    //
     public void
     reset(String operation, Ice.OperationMode mode, java.util.Map context)
     {
@@ -40,13 +56,6 @@ public final class Outgoing
         writeHeader(operation, mode, context);
     }
 
-    public void
-    destroy()
-    {
-        _os.destroy();
-        _is.destroy();
-    }
-
     // Returns true if ok, false if user exception.
     public boolean
     invoke()