Kapitel 5. Klassen- und Funktionsüberblick

Die jadice document platform enthält verschiedene Klassen, die den Umgang mit der Java Collections API vereinfachen und deren Möglichkeiten erweitern. Zentrales Interface ist die EventList, mit der gewöhnliche Java Listen um die Möglichkeit zur Eventverarbeitung und Listener-Registrierung ergänzt werden.^[50]

Als konkrete Implementationen der EventList stehen viele unterschiedliche Klassen zur Verfügung, die dementsprechend verschiedene Funktionsausprägungen bereitstellen. Wichtige Beispiele sind:

Zusätzlich zu den genannten Klassen existieren noch andere Ausprägungen, die weitere Zusatzfunktionalitäten bieten.

Sämtlichen Varianten ist gemein, dass sie Methoden zur Registrierung eines Listeners bereithalten. Über addListEventListener(...) ist es möglich, Implementationen von ListEventListener anzumelden, sodass diese über Änderungen an der Liste informiert werden.

Bei Verwendung einer EventList durch mehrere Threads ist es notwendig, die Zugriffe auf die Liste zu synchronisieren. Zu diesem Zweck existiert ein eingebautes Locking-System, das gleichzeitige Zugriffe serialisiert. Von jeder EventList kann eine Instanz von ReadWriteLock angefordert werden, die zwei unterschiedliche Lock-Objekte für rein lesenden oder lesenden und schreibenden Zugriff bereithält.^[51] Zugriffe auf eine Liste dürfen stets nur nach Erwerb des jeweiligen Lock-Objektes erfolgen.^[52]

Der folgende Code-Ausschnitt zeigt die generelle Verwendung von Lock-Objekten am Beispiel der Seitenliste eines Dokuments der jadice document platform:

EventList<Page> pageList = ... // get some Document's Pages
Lock writeLock = pageList.getReadWriteLock().writeLock();
writeLock.lock();
try {
  // manipulate pageList
} finally {
  writeLock.unlock();
}