Thanks to the tireless efforts of Jesse Gallagher, Tim Tripcony, Declan Lynch, Rene Winklemeyer, and Paul Withers, the OpenNTF.org Domino API has reached it’s first milestone. You can download the JAR file, including source, from OpenNTF here
I am seriously excited about this first release. It represents some world-class code-slinging from a team made up entirely of IBM Champions. M1 is all about fixing things that are fundamentally broken in the lotus.domino API, and I think we’ve accomplished that in spades:
- No more .recycle() calls required. PhantomReferences rule.
- No more NotesException catching required everywhere. Proper logging of Exceptions is provided
- Proper iterators for DocumentCollection, ViewEntryCollection and ACL
- Use of generics
- Massively overloaded .replaceItemValue and .getItemValue to allow for the inclusion of almost any Java object into an Item
- Complete encapsulation of Name, DateTime and International objects so they no longer need to maintain C++ handles, fixing a major source of handle leaks
- Parameter names for all methods across the entire API match the documentation, and have Javadoc to make content assist useful at last
There’s some other goodies in there too, including some useful Helper classes to both demonstrate how to use the API and provide some solutions to common real world problems.
I’m going to start using the M1 release in dev environments TOMORROW. I hope you’ll consider taking it for a ride too.