Das EventHandler-Modell

Allgemein

Das EventHandler-Basispaket realisiert eine bessere Trennung der Code-Schichten des Datenmodells und der Backends. Im Datenmodell werden nur Ereignisse ausgelöst werden (z.B. create, delete usw.), welche dann bestimmt durch die Konfiguration in den Property-Dateien verarbeitet werden. Es existiert ein allgemein gültiges Template-Modell, welches für die erforderlichen Anwendungsfälle ausgebaut wird. Ein singleton-Manager-Prozess nimmt nur ein Ereignis entgegen, wählt die dafür bestimmte Konfiguration aus und startet die Methode doHandleEvent(MCREvent evt). Dies geschieht in der Reihenfolge, welche in der Konfiguration angegeben ist und stellt ein Pipeline-Verfahren dar. Das Event-Objekt wird dabei nacheinander an die Handler durchgereicht. Änderungen an den im Event-Objekt gespeicherten Daten werden also für alle folgenden Handler wirksam. Kommt es bei einem Handler zu einer Ausnahme, so wird diese vom Manager aufgefangen und es wird für alle in der Pipeline davor liegenden Handler die Methode undoHandleEvent(MCREvent evt) initiiert. Somit ist ein Rollback möglich. Je nach Anwendung ist es möglich, verschiedene Pipelines für unterschiedliche Abläufe unabhängig voneinander zu implementieren, z.B. eine Pipeline für die Verarbeitung der Metadaten und eine andere für die Volltextindizierung der Dokumente. Die Pipelines und die damit verbundenen Ereignisse unterscheiden sich am Namen der jeweiligen Pipeline.

Das EventHandler-Modell (Bsp. Metadaten-Objekte)

Das EventHandler-Modell wird beispielsweise eingesetzt, um Objekte vom Typ MCRObject persistent zu speichern. Das Klassendiagramm (Abbildung 1.6) verdeutlicht die Zusammenhänge.

1. Das MCRObject erzeugt ein neues Ereignis, welches in diesem Fall die vordefinierte Pipeline OBJECT_TYPE und das vordefinierte Ereignis CREATE_EVENT nutzt. Es können aber auch beliebige Strings eingetragen werden. Dabei ist aber auf die Konsistenz zu achten.
   MCREvent evt = new MCREvent(MCREvent.OBJECT_TYPE, MCREvent.CREATE_EVENT);
2. Nun wird dem neuen Ereignis das Datum übergeben, welches an die Handler weitergereicht werden soll. Ein Ereignis kann auch mehrere Daten beinhalten.
   evt.put("object",this);
   

   Abbildung: Klassendiagramm des EventHandler-Modells

3. Die folgende Zeile ruft abschließend den MCREventManager auf und stößt die Handler für die Pipeline an.
   MCREventManager.instance().handleEvent(evt);

Die Konfiguration des EventHandler-Managers

Für die Nutzung des EventHandler-Konzeptes gib es in der vom Kern mitgelieferten Konfiguration mycore.properties eine Reihe von Voreinstellungen, welche im Standardfall vollständig funktionieren. Sollen davon abweichende Implementierungen zum Einsatz kommen, so sind die entsprechenden Properies in den lokalen Property-Dateien zu überschreiben. Sollen Schritte zwischen zwei Handlern durch eigene Handler durchgeführt werden, können diese über das Nummernschema an die entsprechende Stelle eingefügt werden.

Für jeden Event-Typ (in diesem Fall ist es MCRObject = MCREvent.OBJECT_TYPE) ist eine Kette von Handlern in der folgenden Form definiert. Jeder Standard-Handler bekommt dabei eine aufsteigende Nummer in Zehnerschritten. Einige EventHandler enthalten die Implementation sowohl für MCRObjecte wie auch MCRDerivate.

1

MCR.EventHandler.MCRObject.010.class=org.mycore.access.MCRAccessEventHandler

Wollen Sie eigene EventHandler schreiben und diese einbinden, so ist es ratsam diese direkt von MCREventHandler abzuleiten und analog zu den bestehenden Handlern einzubinden. Sie können dafür auch neue Pipelines und Ereignisse definieren. Den MCREventManager können Sie nun an beliebiger Code-Stelle einbauen und ihm ein von Ihnen definiertes Ereignis übergeben. Diese Komponente ist allgemein verwendbar und nicht auf das MyCoRe-Datenmodell festgelegt.

Liste der verfügbaren EventHandler