All lotus.domino classes contain the following methods:

public void recycle()

public void recycle(java.util.Vector objects)

Java has no knowlege of the heavyweight back-end Domino Objects, only the lightweight Java objects representing them. Garbage collection has no effect on Domino Objects unless you first explicitly recycle them.

If you appear to have memory problems, try recycle but adhere to the following guidelines:

• Recycle an object only if it is no longer needed.
• Recycle an object in the same thread in which it is created.
• Recycling a parent recycles all the children.
• In Session, call recycle() only after all other threads exit.
• Where NotesThread.sinitThread() and NotesThread.stermThread() are used, call recycle() before stermThread.

In a remote (IIOP) environment, recycle releases resources on the server. Although a client-side cache exists, the Java object can no longer communicate with its remote counterpart.

In a remote (IIOP) environment, recycle can be called from any thread on any object.

If you create more than one object to represent the same Domino element, recycling one recycles all. For example:

View v1 = db.getView("All");
View v2 = db.getView("All");
v1.recycle(); // also recycles v2

See Also

Supporting components

Glossary