TsgcWSPServer_sgcMethoden › Publish

Publish Methode

Veröffentlicht eine Nachricht an jeden Client, der einen Kanal abonniert hat.

Überladungen

Overload 1

Syntax

procedure Publish(const aMessage, aChannel: String; const aExclude: String = ''; const aInclude: String = ''; const aQueue: TwsQueue = queueLevel0);

Parameter

NameTypBeschreibung
aMessageconst StringPayload, die veröffentlicht werden soll; wird an Abonnenten über ihren OnEvent-Handler zugestellt.
aChannelconst StringKanal, auf dem die Nachricht veröffentlicht wird; Platzhalter wie news* werden auf jeden passenden Kanal mit aktiven Abonnenten verteilt.
aExcludeconst StringSemikolongetrennte Liste von Verbindungs-Guids, die beim Fanning-Out übersprungen werden sollen.
aIncludeconst StringSemikolongetrennte Liste von Verbindungs-GUIDs, auf die die Veröffentlichung beschränkt ist.
aQueueconst TwsQueueAufbewahrungsrichtlinie: queueLevel0 (keine Aufbewahrung), queueLevel1 (letzte Nachricht pro Kanal behalten) oder queueLevel2 (jede Nachricht in die Queue stellen), sodass Abonnenten, die sich später verbinden, sie erhalten.

Hinweise

Vollständige Überladung. Expandiert Platzhalter-Kanäle gegen aktuelle Abonnements, schreibt eine beibehaltene Kopie in die serverseitige Queue, wenn aQueue queueLevel1 oder queueLevel2 ist, und überträgt dann die Nutzlast an alle passenden Abonnenten unter Berücksichtigung der Exclude/Include-Filter.

Beispiel

oProtocol.Publish('breaking news', 'news');
oProtocol.Publish('sticky banner', 'news', '', '', queueLevel1);

Überladung 2

Syntax

procedure Publish(const aMessage, aChannel: String; const aQueue: TwsQueue);

Parameter

NameTypBeschreibung
aMessageconst StringZu veröffentlichende Nutzlast; wird über OnEvent an Abonnenten geliefert.
aChannelconst StringKanal, auf dem veröffentlicht wird; Platzhalter werden unterstützt.
aQueueconst TwsQueueAufbewahrungsrichtlinie (queueLevel0, queueLevel1, queueLevel2) für spät hinzukommende Abonnenten.

Hinweise

Praktische Überladung, die an die vollständige Überladung mit leeren Exclude- und Include-Filtern delegiert. Verwenden Sie diese, wenn Sie nur eine Aufbewahrungsstufe auswählen müssen und möchten, dass jeder passende Abonnent die Nachricht erhält.

Beispiel

oProtocol.Publish('tick', 'prices', queueLevel1);

Zurück zu Methoden