domingo - Open Source Java-API für Lotus Notes/Domino

[kriede]

Die Lotus-Notes-Experten von beck et al. projects haben domingo als Open Source veröffentlicht, eine einfache, konsistente, objekt-orientierte leicht nutzbare Open Source Java-API für Lotus Notes/Domino. Mit domingo kann man in Java so einfach wie in Lotus-Script auf Notes-Datenbanken zugreifen: ohne aufwändiges Exception-Handling und vollständig ohne Recycling der Notes-Objekte. domingo is kompatible mit Lotus Notes/Domino R5, R6, R6.5 and R7.

Alle weiteren Informationen finden sich auf der domingo-Webseite:
http://domingo.sourceforge.net/

Hier kann domingo heruntergeladen werden:
http://domingo.sourceforge.net/download.html

domingo ist unter der GNU lesser general public license (LGPL) veröffentlicht:
http://domingo.sourceforge.net/license.html

Mit freundlichen Grüßen,

Kurt Riede

beck et al. projects GmbH, München
http://www.bea-projects.de/

[flaite]

Das sieht interessant aus.
Wollt ihr darüber ein kleines Tutorial oder ähnliches schreiben?

Gruß Axel 

[kriede]

Hallo Axel,

auf den Webseiten von domingo existiert ein einfaches "Getting started":
  http://domingo.sourceforge.net/getting-started.html
und mehrere Beispiel:
  http://domingo.sourceforge.net/examples.html

Hattest Du noch an etwas anderes oder spezielleres gedacht? Oder auf deutsch statt englisch? Wir freuen uns über jede Anregung.

Gruß
Kurt

[flaite]

Hallo Kurt,

ich dachte mehr an eine Art Artikel der die Intention der verschiedenen Klassen erläutert, obwohl - wie ich bei flüchtiger Betrachtung feststelle (ich arbeite noch) - vieles in den Kommentaren steht.
- Einfache Implementierung eines Thread Pools.
- Benutzen von MockDocument.
- etc.

In jedem Fall werde ich mir den Source code noch öfters ansehen 

Vielleicht gibts sogar auf notes.net (lotus@developerworks) Interesse dafür, einen solchen Artikel zu finanzieren. Wo die ja angeblich Interesse daran haben, LotusScript Developer an Java ranzuführen weil wie Bob Balaban meint:
http://www.edbrill.com/ebrill/edbrill.nsf/dx/javaschmava-a-guest-blog



Gruß Axel

 

[flaite]

Ich habe diesen code nun erstmals in einem ein wenig größeren Einsatz.
Falls das jemand von Beck et. al. (spelling?) liest, ein großes Dankeschön.
Vor allem hab ich keine Bauchschmerzen bezüglich des Vergessens von invalidate() und es ist nicht nur somit eine echte Arbeitserleichterung.
Vielleicht noch mehr für Leute, die nicht so viel Erfahrung mit Domino haben?
Tatsache ist jedenfalls, dass ich zunehmend in meinen Projekten Zugriffe auf Portal-Api, Domino, Excel mit hippen Junit-Tests gleichzeitig habe (wobei das hip keine Ironie ist) und da ist alles, das eins von mehreren Subsystemen erleichtert Grund von echter Freude und Dankbarkeit.

Jedem der mit Java auf Domino zugreift (und das sind nicht wenige), empfehle ich dieses Paket (ist ja nur 1 jar).

Axel

[kriede]

Due to the big feedback with many questions, tips, feature-requests and acceptance, we decided to publish a new release 1.3 with answers and fixes to all questions to all previous releases.

This release adds new methods for dealing with attachments, the whole bunch of functions related to full-text search and many other details. It also improves handling and reporting of misconfigurations like incomplete classpath or PATH.

Please read about all further changes here:
http://domingo.sourceforge.net/changes-report.html

Here you can download domingo 1.3:
http://domingo.sourceforge.net/download.html

Best regards
Kurt Riede

beck et al. projects GmbH, München
http://www.bea-projects.de/

[Prince]

Wahrscheinlich eine ziemlich doofe Frage, aber ich bin kein Notes-Profi.

Aber warum domingo?

Man kann doch ganz normal die notes.jar usw. in Eclipse importieren und damit auf die Notes-Objekte zugreifen. Dazu stehen dann noch alle Funktionen zur Verfügung.

Danke für die Aufklärung.

[kriede]

Hallo Prince,

Klar kann auch das notes.jar eingebunden werden und die Notes-Java-API benutzt werden. In der Tat mach das bisher viele so. Allerdings kämpfen die meisten dann mit der Speicherverwaltung von Lotus Notes, die, anders als in Java gewohnt, explizit erfolgen muss, um Speicherlöcher oder gar einen Absturz von Lotus Notes und der Java-VM zu vermeiden.

Weitere Probleme können bei multithreading-Anwedungen entstehen, denn eine Notes-Session kann nicht beliebig von verschiedenen Threads gemeinsam benutzt werden. Ausserdem muss jeder Thread, der die Notes-Java-API nutzen möchte, bei Notes angemeldet werden. Insbesondere bei Anwendungen mit Benutzerschnittstellen, bei denen jede Aktion einen neuen Thread erzeugt, entstehen dadurch Performance- und Stabilitätsprobleme.

Domingo selbst nutzt intern das notes.jar, trifft aber einen Menge von Massnahmen, um den Entwickler von o.g. Problemen erfolgreich freizuhalten.

Gruß
Kurt

[flaite]

Kurt Riede hat definitiv recht.
Vereinfacht gesprochen müssen Domino Objekte ähnlich wie swt-Objekte in Eclipse-Entwicklung im Code selbst entsorgt werden. Ansonsten kommt es irgendwann dazu, dass es keine offenen Verbindungen mehr gibt (die Erklärung ist ziemlich unvollständig und doof, aber es ist heiss und es ist Freitag und ich müsste nachschlagen).
Dieser Fehler macht sich aber erst nach einiger Zeit bemerkbar, fällt also nicht unbedingt während der Entwicklung auf und möglicherweise erst in Produktion. Und das kann eine Menge Ärger versuchen.
Meine Augen haben eine MENGE auf Domino zugreifenden Java Code gesehen,  der das nicht berücksichtigte. Domingo beseitigt also eine Sache, die in der realen Welt für wirkliche Verwirrung sorgt.

Gruß Axel

[Prince]

Danke für Eure Erklärungen. Hört sich vernünftig an.

Noch eine Frage: wieso legt domingo nicht alle Methoden der API frei?

[flaite]

Noch eine Frage: wieso legt domingo nicht alle Methoden der API frei?

Mir ist nicht ganz klar was du hier mit "freilegen" meinst.
Ich denke, dass es eine Menge Fleissarbeit ist für jede Api Methode in der Notes API eine entsprechende Methode in Domingo zu programmieren. Da das openSource ist, können sich ja auch Freiwillige melden, die das implementieren.