Andrew Pollack's Blog

Technology, Family, Entertainment, Politics, and Random Noise

When to use .recycle() in your Domino Java agents...

By Andrew Pollack on 11/11/2004 at 10:08 PM EST

There are some things that drive me nuts about the way Domino has implemented the Java interfaces to the back end classes. One of them is the need to call .recycle(). The problem is that if you don't explicitly call recycle() on each object your have created, it hangs around forever -- even after the agent has finished. Of course, you can't call recycle() on an object you don't have a handle to, so you have to do things like use another handle "nextDoc" along with your "doc" object when you loop through collections. Since you're dealing with lots of objects as you go through a collection, you need to remember to call doc.recycle() just before you set "doc = nextDoc;" and then "nextDoc = docCollection.getNextDocument(doc);".

In most cases, that's enough. If you do that, and then at the end of your agent call session.recycle() you've done enough because recycling the session causes all the objects that stem from the session to get recycled too.

Not always though. I got reminded of this debugging a problem today in a pre-release of some new software I'm getting close to release on. The people doing the testing ran the product against all the databases on a server -- at once. That's what the product does, so it should be no problem -- but there were many thousands of them. It wasn't enough that I was managing the recycle() on the documents, I needed to recycle the database objects as I went through them as well. There weren't enough handles within the system to allow me to have them all out there until the end of the agent.

Poor handling on my part of course -- my laziness in that regard cost me many hours of coding today.

There are  - loading -  comments....

Agreed...By Ben Poole on 11/12/2004 at 12:24 PM EST
... so annoying. Julian Robichaux has done a lot of investigation in this area.
He published his latest post on this topic just the other day:
and the congregation said...By jonvon on 11/12/2004 at 01:30 PM EST

My own thoughts on this are...By Bob Balaban on 11/12/2004 at 04:31 PM EST
Yeah, it sucks. I could give you a long dissertation on why it *had* to be that
way (architecture of garbage colleciton and basic flaws in JVM, thread
management in Domino, etc etc etc etc), but that would be boring.

Bottom line: there was NO way to make it all happen automatically, the way it
does in LotusScript. Sorry!

Other Recent Stories...

  1. 01/26/2023Better Running VirtualBox or VMWARE Virtual Machines on Windows 10+ Forgive me, Reader, for I have sinned. I has been nearly 3 years since my last blog entry. The truth is, I haven't had much to say that was worthy of more than a basic social media post -- until today. For my current work, I was assigned a new laptop. It's a real powerhouse machine with 14 processor cores and 64 gigs of ram. It should be perfect for running my development environment in a virtual machine, but it wasn't. VirtualBox was barely starting, and no matter how many features I turned off, it could ...... 
  2. 04/04/2020How many Ventilators for the price of those tanks the Pentagon didn't even want?This goes WAY beyond Trump or Obama. This is decades of poor planning and poor use of funds. Certainly it should have been addressed in the Trump, Obama, Bush, Clinton, Bush, and Reagan administrations -- all of which were well aware of the implications of a pandemic. I want a military prepared to help us, not just hurt other people. As an American I expect that with the ridiculous funding of our military might, we are prepared for damn near everything. Not just killing people and breaking things, but ...... 
  3. 01/28/2020Copyright Troll WarningThere's a copyright troll firm that has automated reverse-image searches and goes around looking for any posted images that they can make a quick copyright claim on. This is not quite a scam because it's technically legal, but it's run very much like a scam. This company works with a few "clients" that have vast repositories of copyrighted images. The trolls do a reverse web search on those images looking for hits. When they find one on a site that looks like someone they can scare, they work it like ...... 
  4. 03/26/2019Undestanding how OAUTH scopes will bring the concept of APPS to your Domino server 
  5. 02/05/2019Toro Yard Equipment - Not really a premium brand as far as I am concerned 
  6. 10/08/2018Will you be at the NYC Launch Event for HCL Domino v10 -- Find me! 
  7. 09/04/2018With two big projects on hold, I suddenly find myself very available for new short and long term projects.  
  8. 07/13/2018Who is HCL and why is it a good thing that they are now the ones behind Notes and Domino? 
  9. 03/21/2018Domino Apps on IOS is a Game Changer. Quit holding back. 
  10. 02/15/2018Andrew’s Proposed Gun Laws 
Click here for more articles.....

pen icon Comment Entry
Your Name
*Your Email
* Your email address is required, but not displayed.
Your thoughts....
Remember Me  

Please wait while your document is saved.