CXI-Basis-Programmierreferenz / Version 2 / Datenaustausch / Ebene 1 /

CxiMessageHandlerBase

class CxiMessageHandlerBase : public CxiMessageIdent

Diese Klasse repräsentiert die untere Stufe des Meldungssystems.

Um einen Meldungsempfänger zu definieren, muss eine Ableitung dieser Klasse erstellt werden, wobei die virtuelle Funktion Handler1 überschrieben wird.

Jede eintreffende Meldung (ein CxiNode) wird danach sofort als Parameter an die Funktion Handler1 übergeben und muss von ihr verarbeitet werden. Nach der Rückkehr wird die Verarbeitung als beendet betrachtet und der Block ggf. zum Sender zurückübertragen (SendMessageBlock).

Während das Empfängerobjekt existiert, können beliebige Prozesse mit den Funktionen PostMessageBlock und SendMessageBlock Meldungen an diesen Empfänger schicken. Sie müssen dazu lediglich den symbolischen Namen kennen.

Besonderheiten und Einschränkungen sind bei der Funktion Handler1 beschrieben.

Die folgenden Abschnitte enthalten nur die Beschreibungen der für den Programmierer relevanten Funktionen. Die Klasse enthält noch weitere Memberfunktionen, die ausschließlich für die interne Realisierung der Klasse benötigt werden.

Portabilität:
Diese Klasse ist in allen unterstützten Systemen verfügbar, unter DOS müssen sich Sender und Empfänger im gleichen Programm befinden.

Memberfunktionen:
CxiMessageHandlerBase(const char*) - Konstruktor
~CxiMessageHandlerBase() - Destruktor
IsInHandler - Ist der Handler aktiv?
QueryReceiverState - Aktivierungsstatus
RequestShutDown - Herunterfahren eines Empfängers
CreateLocalAlias - Lokaler Aliasname
WaitState - Wartezustand
Handler1 - Bearbeitungsfunktion

Geerbte Memberfunktionen:
Status - Statusabfrage
IsValid - Ist Objekt gültig?
IsLocal - Ist Objekt lokal?
CountChildren - Anzahl untergeordneter Objekte
QueryIdent - Abfrage des Namens
QueryIdentAbs - Abfrage des absoluten Namens

Globale Funktionen:
PostMessageBlock - Versenden einer Meldung ohne Warten
SendMessageBlock - Versenden einer Meldung mit Warten
CreateGlobalAlias - Globaler Aliasname

Siehe auch:
Allgemeines zum Meldungssystem
Klassenhierarchie Meldungssystem
class CxiMessageIdent - Adresse eines Meldungsempfängers
class CxiMessageHandlerBase - Meldungsempfänger Ebene 1
class CxiMessageHandler - Erweiterter Meldungsempfänger
class CxiMessageHandlerWithQueue - Erweiterter Meldungsempfänger mit Queue