Setup Eclipse

This section describes how to install Eclipse, and set it up as a Keep API development environment.

Note: Eclipse is a popular choice for IDE as it has a rich and extensible feature set, and is familiar to many team members. That said, since Keep is Maven based and built from the command line, it does not require any one IDE. Other choices worth investigating include:

Installing Eclipse

Begin by downloading and installing the 64 bit version of Eclipse from Eclipse.org. The offical downlaods page is here:

https://www.eclipse.org/downloads/

Once you have Eclipse properly installed, select: File / Import… from the top level menu to bring up the Import dialog:

EclipseImport  
 

1) Select Existing Maven Projects as shown above and click Next.

2) Click the Browse… button and select your domino-keep directory, and click Finish to import it. You should now see the Keep source code in your Package Explorer.

Configuring Java

If you haven’t already, take a momment now to install the OpenJdk version of Java 8. Instructions are here:

Setup Java 8

You will need to setup two versions of Java for your development environment: To Run KEEP successfully the Notes or Domino JVM is required. To run a successful Maven build, the Domino JVM is insufficient, since Maven requires a true JDK, as found in OpenJdk 8.

Each JRE needs to be configured with the Notes jar files on the classpath.

For Eclipse it could look like this:

Eclipse 1

Eclipse 2

Eclipse 3  
 

Debugging Keep within Eclipse

Once you have a Debug Configuration properly set up, it is very easy to debug Keep APIs within Eclipse.

To get started, select Run \ Debug Configurations… from the top menu.

Next right click on Java Application and select New Configuration:
 
Debug Configuration

1) Give your configuration a name, Launch in this case, and set Project to com.hcl.domino.keep and Main Class to com.hcl.domino.keep.Launch

2) Switch to the JRE tab and select Alternate JRE. Select the Notes 11 JRE you created above from the dropdown list. (Using the Notes 11 JRE will allow Eclipse to resolve Notes\Domino classes.)

3) Now switch to your Classpath tab. You should see a layout like the one below, with the Notes 11 JRE on your classpath.

 
Eclipse Classpath

 
4) Next switch to your Environment tab, and enter the environment variables shown below. Of course you will need to adjust the Notes path to match your system.

 
Eclipse Debug Vars

5) When you’re done, remember to hit Apply, and you should be good to go.

6) When you wish to start debugging, select Run \ Debug Configurations… from the top menu. Make sure your Keep Debug configuration is selected (Launch in this example), and press Debug to begin debugging. If you’ve done everything correctly you should see Domino KEEP API open for business at the bottom of the console window.

Java Editor Preferences

Before you use Eclipse to edit and submit code, you should import two XML files that help to enforce good coding practices.

1) Select Window / Preferences from the top level menu.

2) In the Preferences dialog, select Java / Code Style / Clean Up.

3) Next select the Import button in the right panel and import CodeCleanupSettings.xml from your domino-keep directory.

4) Make sure stw.default is now set as your active profile.

5) Now select Java / Code Style / Formatter and import eclipse-java-google-style from your domino-keep directory.

6) Make sure GoogleStyle is now set as your active profile. Click Apply and Close to save your settings.

Now the next time you edit a Java file, you can take advantage of four commands on the Source menu:

Correct Indentation: Control I

Format: Control Shift F

Format Element

Cleanup…