đDebugging Tips
Hints and tips on the usage of the JAddin framework
Last updated
Was this helpful?
Hints and tips on the usage of the JAddin framework
Last updated
Was this helpful?
During execution, the JAddin maintains statistics and status information. They can be displayed with the Show Stat AddinName command:
The framework supports a number of special commands:
For a detailed problem determination, you may use the built-in debugging features.
While active debugging adds a significant amount of data to the console log and to the log.nsf database, it can be helpful in finding the root of a problem.
The debug output is written to the HCL Domino console and includes the name of the Java method with the source line number issuing the message.
Q: How do I develop my JAddin project in Eclipse?
A: Make sure you include the two JAddin framework class files and the notes.jar file (installed with HCL Notes or HCL Domino) as external files in your Eclipse project.
Q: What is the heartbeart in JAddin?
A: The main thread in JAddin gets triggered every 15 seconds to perform some internal housekeeping tasks. One of these checks makes sure that the Java heap space does not get filled up to avoid out-of-memory errors. If the free space falls below 10 percent, the Java virtual machine garbage collector is invoked and a message is written to the console (see Notes.ini parameter JavaMaxHeapSize).
Q: I have copied a new version of my add-in to the server, but it does not get active during application startup. A: The RunJava task caches the Java classes in use. You must terminate all other RunJava tasks - and therefore terminate RunJava itself - to be able to force the reloading of your class file.
Error Message
Possible Reason
RunJava: Can't find class AddinName lotus/notes/addins/jaddin/AddinName in the classpath. Class names are case-sensitive.
The RunJava task was unable to load the class. Make sure that it is written with exact upper and lower case characters and it can be found by the RunJava class loader
JAddin: Unable to load Java class AddinName
The JAddin framework was unable to load the application class. Make sure that it is written with exact upper and lower case characters.
RunJava: Can't find stopAddin method for class AddinName.
The application class must be loaded thru the JAddin framework and not directly from RunJava. Use the command Load RunJava JAddin AddinName to start your application.
RunJava JVM: java.lang.NoClassDefFoundError: AddinName (wrong name: addinname)
The user class name in the command and the internal name do not match. Most likely you have not typed the name with correct upper and lower case characters.
Out of memory
All Java add-ins execute in a single Java Virtual Machine (JVM) in RunJava. The Domino Notes.Ini parameter JavaMaxHeapSize=xxxxMB may be used to increase the heap space.
Domino Console Command
Description
Load RunJava JAddin AddinName Debug!
Start add-in in debug mode
Tell AddinName Debug!
Start the debug mode while the add-in is running
Tell AddinName NoDebug!
Stop the debug mode while the add-in is running