TsgcWSPServer_sgcMetody › Publish

Publish Metoda

Publikuje wiadomość do wszystkich klientów subskrybujących dany kanał.

Przeciążenia

Przeciążenie 1

Składnia

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

Parametry

NazwaTypOpis
aMessageconst StringŁadunek do opublikowania; dostarczany subskrybentom za pośrednictwem ich procedury obsługi OnEvent.
aChannelconst StringKanał, na którym publikowana jest wiadomość; symbole wieloznaczne, takie jak news*, rozgałęziają się do wszystkich pasujących kanałów z aktywnymi subskrybentami.
aExcludeconst StringRozdzielona średnikami lista identyfikatorów GUID połączeń do pominięcia podczas rozsyłania.
aIncludeconst StringRozdzielona średnikami lista identyfikatorów GUID połączeń, do których ograniczona jest publikacja.
aQueueconst TwsQueuePolityka przechowywania: queueLevel0 (brak przechowywania), queueLevel1 (zachowaj ostatnią wiadomość na kanał) lub queueLevel2 (kolejkuj każdą wiadomość), dzięki czemu subskrybenci łączący się później je otrzymają.

Uwagi

Pełne przeciążenie. Rozszerza kanały z symbolami wieloznacznymi względem bieżących subskrypcji, zapisuje zachowaną kopię w kolejce po stronie serwera, gdy parametr aQueue ma wartość queueLevel1 lub queueLevel2, a następnie rozsyła ładunek do wszystkich pasujących subskrybentów z zachowaniem filtrów Exclude/Include.

Przykład

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

Przeciążenie 2

Składnia

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

Parametry

NazwaTypOpis
aMessageconst StringŁadunek do opublikowania; dostarczany subskrybentom przez zdarzenie OnEvent.
aChannelconst StringKanał do publikowania; obsługiwane są symbole wieloznaczne.
aQueueconst TwsQueuePolityka retencji (queueLevel0, queueLevel1, queueLevel2) dla późnych subskrybentów.

Uwagi

Wygodne przeciążenie, które deleguje do pełnego przeciążenia z pustymi filtrami Exclude i Include. Należy go używać, gdy wystarczy wybrać poziom retencji i chce się, aby każdy pasujący subskrybent otrzymał wiadomość.

Przykład

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

Powrót do metod