Open replacement for lotus.domino package in IBM Domino
Collections using Domino data objects (eg:
Document implements Map<String, Object>)
ODA is organized as a Tycho-based Maven tree and depends on a p2 update site from Domino. Historically, the IBM-provided Update Site for Build Management was the route to use, but it has not kept up with additions to the Notes.jar API. It is not currently legal to redistribute newer versions, but you can create an appropriate update site from an existing Notes or Domino installation using the generate-domino-update-site tool.
Once that is run and you have a p2 site to work with, create a property in your Maven
notes-platform to point to it. For example:
<?xml version="1.0"?> <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> <profiles> <profile> <id>main</id> <properties> <notes-platform>file:///Users/someuser/Documents/Java/IBM/UpdateSite</notes-platform> </properties> </profile> </profiles> <activeProfiles> <activeProfile>main</activeProfile> </activeProfiles> </settings>
To develop in Eclipse, your Target Platform will need to include this directory, and should also include directory entries for the two directories in "dependencies" in the repository.
Running the compile-time tests requires either Notes or Domino installed locally with a bitness that matches the Java runtime used to execute the Maven build. Additionally, that installation should either have an ID with no password or should be configured in User Security to allow external Notes-based applications to run without a password prompt. In the latter case, Notes must be open during the test.
Maven-run tests are configured by the presence of a
notes-program property in your effective Maven settings pointing to the program directory of the Notes or Domino installation. For example, a minimal
.m2/settings.xml file to run tests via the Mac Notes client in its normal installation location would be:
For Windows it would be e.g.:
You will also need to amend your Target Platform in Eclipse to add the directory location from the repository "dependencies\Misc". That folder includes junit, which it's looking for. By telling the Target Platform where to find that, the project will no longer throw an error.
domino folder run:
mvn versions:set -DnewVersion=4.2.0 -DgenerateBackupPoms=false
mvn tycho-versions:set-version -DnewVersion=4.2.0
Then run the maven command (if you don't have up-to-date FP version in C:\UpdateSite folder, this will need to be run from Eclipse):
mvn -Pdistribution clean package
This generates Javadocs etc.
To deploy to artifactory, you need access to write to artifactory and the following block in your Maven settings (m2/settings.xml):
<servers> <server> <id>artifactory.openntf.org</id> <username>YOUR OPENNTF USERNAME</username> <password>YOUR OPENNTF PASSWORD</password> </server> </servers>
This is a child of the settings XML object. Then run
mvn deploy (I had to run this from Maven command line, I don't think eclipse has the right SSL settings).
Updating back to a Snapshot version
domino folder run:
mvn tycho-versions:set-version -DnewVersion=4.3.0-SNAPSHOT
mvn versions:set -DnewVersion=4.3.0-SNAPSHOT -DgenerateBackupPoms=false
YourKit is kindly supporting OPENNTF open source projects with its full-featured Java Profiler. YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications. Take a look at YourKit's leading software products: YourKit Java Profiler and YourKit .NET Profiler.
We cannot recommend YourKit enough. It's a superb profiling tool with great Eclipse integration. If you're serious about Java development, you need to be using YourKit. No arguments, just do it.