TsgcWSPServer_sgcMethods › Publish

Publish Methode

Publiceert een bericht naar alle clients die zijn geabonneerd op een kanaal.

Overloads

Overload 1

Syntaxis

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

Parameters

NaamTypeBeschrijving
aMessageconst StringPayload om te publiceren; geleverd aan abonnees via hun OnEvent-handler.
aChannelconst StringKanaal waarop het bericht wordt gepubliceerd; jokertekens zoals news* worden uitgewaaierd naar elk overeenkomend kanaal met actieve abonnees.
aExcludeconst StringDoor puntkomma's gescheiden lijst van verbindings-Guids die overgeslagen moeten worden bij de fan-out.
aIncludeconst StringDoor puntkomma's gescheiden lijst van verbindingsGuids waartoe de publicatie is beperkt.
aQueueconst TwsQueueRetentiebeleid: queueLevel0 (geen retentie), queueLevel1 (bewaar het laatste bericht per kanaal) of queueLevel2 (sla elk bericht in de wachtrij op) zodat abonnees die later verbinding maken ze ontvangen.

Opmerkingen

Volledige overload. Breidt wildcardkanalen uit ten opzichte van huidige abonnementen, schrijft een bewaarde kopie naar de server-side wachtrij wanneer aQueue queueLevel1 of queueLevel2 is, en verzendt vervolgens de payload naar alle overeenkomende abonnees met inachtneming van de Exclude/Include-filters.

Voorbeeld

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

Overload 2

Syntaxis

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

Parameters

NaamTypeBeschrijving
aMessageconst StringPayload to publish; delivered to subscribers through OnEvent.
aChannelconst StringKanaal om op te publiceren; wildcards worden ondersteund.
aQueueconst TwsQueueRetentiebeleid (queueLevel0, queueLevel1, queueLevel2) voor late abonnees.

Opmerkingen

Handige overload die delegeert naar de volledige overload met lege Exclude- en Include-filters. Gebruik dit wanneer u alleen een bewaaringsniveau hoeft te selecteren en wilt dat elke overeenkomende abonnee het bericht ontvangt.

Voorbeeld

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

Terug naar methoden