How to recycle Notes objects in XPages and Java

May 28th, 2013

Using Notes objects in XPages and in Java require that you recycle those objects in order to avoid memory leaks and backend out of memory issues. Here I will summarize how to do proper recycling in XPages for server-side javascript, Java and Java using the new OpenNTF project org.openntf.domino.

Server-side JavaScript

With server-side JavaScript you have to use the recycle method available on Notes objects and you have to "nullify" your server-side JavaScript variables. Thank you, Tony McGuckin, for clarifying this.

Here's a very simple example that assumes that the variable doc has been initialized elsewhere:

doc = null;


In Java you have to use the recycle method available on Notes objects. So for looping through a document collection you have to do this:

try {
	Database dbCurrent = ExtLibUtil.getCurrentDatabase();
	DocumentCollection dc = db.getAllDocuments();
	Document doc = dc.getFirstDocument();
	While (doc != null) {
		// process doc
		tmp = dc.getNextDocument(doc);
		doc = tmp;
} catch (NotesException e) {


With org.openntf.domino you do nothing with regards to recycling! So when looping through a document collection you can concentrate on your business logic:

Database db = Factory.getSession().getCurrentDatabase();
for (Document doc : db.getAllDocuments())
	// process doc

Tags: , , ,

9 Responses to “How to recycle Notes objects in XPages and Java”

  1. Simon O'Doherty Says:

    Regarding your first example. Do your dc.recycle() in a finally block. In the loop dies you can be left with memory floating around. Particularly annoying leaks to find.

  2. Declan Lynch Says:

    If you use a finally block then the variable must be declared above the try block. Just a simple DocumentCollection dc = null; will do the trick then you can set it to the actual document collection inside the try block.

  3. Txemanu Says:

    So, in a ssjs loop, do you have to do something like this?
    var view:NotesView = database.getView("myView"),
    doc:NotesDocument = view.getFirstDocument(),

    while (doc) {
    temp = view.getNextDocument(doc);

    // .....

    doc = null; // << also nullify here?
    doc = temp;

    doc = temp = null; // << or just nullify here

    view = null; // << I suppose always here.
    And... is there any site where I can read that 'nullify' discussion?

  4. Txemanu Says:

    And thank you very much!!!

  5. Per Henrik Lausten Says:

    Hi Txemanu. Inside the loop you do not have to nullify as you assign the variable to temp right after.
    You need to recycle and nullify the doc variable outside the loop.

    Tony clarified the issue with nullifying objects in a call. I have not seen it stated elsewhere (for XPages and SSJS).

  6. Txemanu Says:

    Hi Per,

    Many thanks for your answer.
    From now on, I'll use this 'one line' recy-nuller:

    doc = doc.recycle() || null;

  7. Sean Cull Says:

    OK, so silly question time 🙂

    Why does doc need recycling but tmp doesn't ?

  8. Per Henrik Lausten Says:

    Hi Sean, you should probably recycle tmp when the loop ends. Since you reuse tmp inside the loop, I am not sure what would happen if you added a recycle call. Give it a try and let us know 🙂

  9. Sean Cull Says:

    So why not just recycle doc at the end ?
    is it because in the IBM example they set
    Document tmp = null; before the loop ?
    would post link but anti spam engine doesn't like it