JAddIn - Java Toolkit for Domino Add-In Server Tasks (Freeware) - Beta Version

Do you need to write a Domino add-in task in Java? The JAddIn framework is a very thin and convenient layer between the Domino RunJava task and your Java application code. It greatly helps you to create Java tasks for Domino by freeing you to learn all the Domino add-in specifics such as message queue handling, sub-thread creation, Domino resource cleanup, etc. It is written entirely in Java to support all Domino versions since 7.0 and processor architectures (32-bit, 64-bit and 128-bit) on all platforms.

Downloads:

HelloWorld Example
JAddIn Framework
JAddIn JavaDoc

Freeware License:

"This software shall be used for Good, not Evil."

Installation:

• The framework consists of the two Java class files JAddIn.class and JAddinThread.class. To install the framework (and your application) you need to copy all necessary Java class files to the program directory (Windows) or to the data directory (Linux) on your Domino server.
• Alternatively you can combine all class files in one JAR container and add this JAR file name to the Domino Notes.Ini parameter, e.g. JavaUserClasses=C:\Lotus\Domino\traveler.jar;C:\Apps\Application.jar.
• If you update any Java class file on the Domino server, you first need to stop the RunJava Domino task to free the class cache used by RunJava.

 

Execution:

• To start the Java add-in, you need to load the class thru the RunJava Domino task, e.g.
  Load RunJava HelloWorld OptionalParameters
  The Java class name (HelloWorld in our example) must be entered in correct upper/lowercase characters.
• The add-in can also be started either by editing the ServerTasks= Notes.Ini parameter or thru a Program Document in the Domino Directory.

 

Hints & Tips:

• If you develop your code in Eclipse, make sure to include notes.jar (installed with Notes and Domino) as an external JAR file in your project. To be compatible with Domino 7.0 and higher, the compiler settings must be set to Java 4 (Java 1.4).
• The Domino Notes.Ini parameter Debug_JAddIn can be used to set the debug option. The value of this parameter must be <1> or <0> to enable or disable the debug log. The default value of this parameter is <0>. All debug messages are formatted by Domino and JAddIn to include the add-in name, thread id, class name, method name and line number, e.g.
  18.08.2010 08:10:50 RunJava JVM: HelloWorld[5].JAddIn.runNotes(63): Add-In main-thread started
• Since all Java add-ins are running in one JVM under the control of RunJava, the default Java heap space may not be large enough. The Domino Notes.Ini parameter JavaMaxHeapSize= (default 64MB) may be used to increase the heap space.
• Please send an email to Administrator@ABData.CH if you have any question, suggestion or if you have found a problem using this software.

 

Release History:

* Planned *	Add: New method sendMessage() to create and send a message.
Version 0.5.0 22/Aug/2010	First public beta version.