TsgcWSPServer_sgcMétodos › Publish

Publish Método

Publica un mensaje a todos los clientes suscritos a un canal.

Sobrecargas

Sobrecarga 1

Sintaxis

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

Parámetros

NombreTipoDescripción
aMessageconst StringCarga útil a publicar; entregada a los suscriptores a través de su controlador OnEvent.
aChannelconst StringCanal en el que se publica el mensaje; los comodines como news* se distribuyen a todos los canales coincidentes con suscriptores activos.
aExcludeconst StringLista de Guids de conexión separados por punto y coma que se omiten al distribuir en abanico.
aIncludeconst StringLista de Guids de conexión separados por punto y coma a los que se restringe la publicación.
aQueueconst TwsQueuePolítica de retención: queueLevel0 (sin retención), queueLevel1 (conservar el último mensaje por canal) o queueLevel2 (encolar cada mensaje), de modo que los suscriptores que se conecten más tarde los reciban.

Observaciones

Sobrecarga completa. Expande los canales con comodines contra las suscripciones actuales, escribe una copia retenida en la cola del lado del servidor cuando aQueue es queueLevel1 o queueLevel2, y luego transmite el payload a todos los suscriptores coincidentes respetando los filtros Exclude/Include.

Ejemplo

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

Sobrecarga 2

Sintaxis

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

Parámetros

NombreTipoDescripción
aMessageconst StringCarga útil a publicar; entregada a los suscriptores mediante OnEvent.
aChannelconst StringCanal en el que publicar; se admiten comodines.
aQueueconst TwsQueuePolítica de retención (queueLevel0, queueLevel1, queueLevel2) para suscriptores tardíos.

Observaciones

Sobrecarga de conveniencia que delega en la sobrecarga completa con filtros de exclusión e inclusión vacíos. Úsela cuando solo necesite seleccionar un nivel de retención y desee que todos los suscriptores coincidentes reciban el mensaje.

Ejemplo

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

Volver a Métodos