Package de.willuhn.jameica.messaging

Messaging-System von Jameica.

See:
Description

Interface Summary

Message	Das ist das gemeinsame Interface aller Nachrichten.
MessageConsumer	Dieses Interface muss implementiert werden, wenn man die Nachrichten des Messaging-Systems erhalten will.
MessagingQueue	Eine Queue, ueber die Nachrichten verschickt werden koennen.

Class Summary

CheckTrustMessage	Message, die synchron verschickt wird, wenn die Vertrauensstellung eines Zertifikates geprueft werden soll.
FileChangedMessage	Wird gesendet, wenn sich im System eine Programm-Datei geaendert hat.
FileChangedMessageConsumer	Ueberwacht alle Programm-Dateien auf Aenderungen und informiert ggf das System.
KeystoreChangedMessage	Nachricht, die gesendet wird, wenn sich der Keystore geaendert hat.
LogMessageConsumer	Ein Nachrichten-Consumer, der alle Nachrichten in's Log schreibt.
LookupService	Dieser Service erlaubt die automatische Suche nach Service-URLs im LAN via Multicast.
MessageCollector	Hilfsklasse, um Nachrichten eines bestimmten Typs zu sammeln.
MessagingFactory	Die Nachrichtenzentrale von Jameica ;).
NamedQueue	Implementierung einer Queue, die einen Namen hat.
QueryMessage	Generische Nachricht, die verschickt werden kann, wenn man zum Beispiel von einem anderen Plugin Informationen abfragen will.
ServerPopupMessageConsumer	Nimmt Popup-Messages im Server-Mode entgegen und gibt sie auf der Konsole aus.
SettingsChangedMessage	Wird versendet, wenn der User die System-Einstellungen von Jameica geaendert hat.
StatusBarMessage	Wenn man eine Nachricht in der Statuszeile von Jameica anzeigen will, dann schickt man einfach eine Nachricht dieses Typs an die MessagingFactory.
SystemMessage	Diese Nachricht wird gesendet, wenn sich am System-Status von Jameica etwas geaendert hat.
TextMessage	Eine Standard-Textnachricht mit Text und Titel.

Package de.willuhn.jameica.messaging Description

Messaging-System von Jameica.

Das Design-Pattern Listener/Event ist ein sehr sinnvolles Prinzip, wenn ein Objekt ueber Aenderungen eines anderen informiert werden will. Es ist elementarer Bestandteil (vermutlich) aller Widget-Toolkits um im Programmcode ueber die Interaktionen des Benutzers informiert zu werden. Mit dem Jameica-Messaging-System steht eine Moeglichkeit bereit, pluginuebergreifend in ganz Jameica ueber Ereignisse benachrichtigt zu werden. Um als Nachrichten-Empgfaenger im System registriert zu werden, genuegt es, das Interface MessageConsumer zu implementieren. Beim Start von Jameica ermittelt die MessagingFactory selbstaendig alle existierenden Nachrichten-Verbraucher und registriert diese.
Von nun an kann jede Klasse mittels Application.getMessagingFactory().sendMessage(Message). eine Nachricht versenden. Alle registrierten MessageConsumer erhalten dann diese Nachricht und koennen darauf reagieren. Auf diese Weise kann z.Bsp. ein Plugin A Nachrichten an ein Plugin B senden ohne pruefen zu muessen, ob Plugin B ueberhaupt installiert ist.

WICHTIG: Die Nachrichtenzustellung erolgt in einem separaten Thread. Das ist wichtig, damit ein Nachrichten- Verbraucher Jameica nicht zum Stehen bringen kann, wenn das Verarbeiten der Nachricht zeitaufwendig ist. Also nicht vergessen: Nachrichten-Sender und Verbraucher befinden sich in verschiedenen Threads.