TsgcWSPServer_sgc › Methoden › Publish
Veröffentlicht eine Nachricht an jeden Client, der einen Kanal abonniert hat.
procedure Publish(const aMessage, aChannel: String; const aExclude: String = ''; const aInclude: String = ''; const aQueue: TwsQueue = queueLevel0);
| Name | Typ | Beschreibung |
|---|---|---|
aMessage | const String | Payload, die veröffentlicht werden soll; wird an Abonnenten über ihren OnEvent-Handler zugestellt. |
aChannel | const String | Kanal, auf dem die Nachricht veröffentlicht wird; Platzhalter wie news* werden auf jeden passenden Kanal mit aktiven Abonnenten verteilt. |
aExclude | const String | Semikolongetrennte Liste von Verbindungs-Guids, die beim Fanning-Out übersprungen werden sollen. |
aInclude | const String | Semikolongetrennte Liste von Verbindungs-GUIDs, auf die die Veröffentlichung beschränkt ist. |
aQueue | const TwsQueue | Aufbewahrungsrichtlinie: 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. |
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.
oProtocol.Publish('breaking news', 'news');
oProtocol.Publish('sticky banner', 'news', '', '', queueLevel1);
procedure Publish(const aMessage, aChannel: String; const aQueue: TwsQueue);
| Name | Typ | Beschreibung |
|---|---|---|
aMessage | const String | Zu veröffentlichende Nutzlast; wird über OnEvent an Abonnenten geliefert. |
aChannel | const String | Kanal, auf dem veröffentlicht wird; Platzhalter werden unterstützt. |
aQueue | const TwsQueue | Aufbewahrungsrichtlinie (queueLevel0, queueLevel1, queueLevel2) für spät hinzukommende Abonnenten. |
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.
oProtocol.Publish('tick', 'prices', queueLevel1);