TsgcWebSocketServer › Méthodes › WriteData

WriteData Méthode

Envoie un message à un seul client identifié par son GUID de connexion.

Surcharges

Surcharge 1

Syntaxe

function WriteData(const aGuid, aMessage: string): Boolean;

Paramètres

Nom	Type	Description
`aGuid`	`const string`	Identifiant de la connexion cible tel qu'assigné par le serveur lors de la complétion de la handshake du client.
`aMessage`	`const string`	Charge utile textuelle à livrer à ce client sous forme de trame de texte WebSocket.

Valeur de retour

True lorsqu'une connexion avec le GUID donné a été trouvée et que la trame a été transmise à son socket ; False lorsqu'aucune connexion active correspondante n'existe. (Boolean)

Remarques

Cette surcharge recherche la connexion dont le GUID correspond à aGuid et envoie le message texte à ce seul client. Le GUID est la valeur exposée par TsgcWSConnection.Guid, généralement capturée dans OnConnect et stockée par l'application. Lorsque QueueOptions.Text est défini à une valeur autre que qmNone, la trame est mise en file d'attente et distribuée depuis le thread de connexion plutôt que depuis le thread de l'appelant (non pris en charge lorsque IOHandlerOptions.IOHandlerType = iohIOCP). Utilisez Broadcast pour atteindre chaque client actif en un seul appel.

Exemple


oServer.WriteData('guid', 'My First sgcWebSockets Message!.');

Surcharge 2

Syntaxe

function WriteData(const aGuid: String; aStream: TStream; aSize: Integer = 0; const aStreaming: TwsStreaming = stmNone) : Boolean;

Paramètres

Nom	Type	Description
`aGuid`	`const String`	Identifiant de la connexion cible tel qu'assigné par le serveur lors de la complétion de la handshake du client.
`aStream`	`TStream`	Flux source dont le contenu est envoyé au client sous forme de trame binaire WebSocket. L'appelant reste propriétaire du flux.
`aSize`	`Integer`	Taille de fragment optionnelle en octets ; lorsqu'elle est supérieure à zéro, le flux est découpé en plusieurs fragments de cette taille. Utilisez 0 (la valeur par défaut) pour envoyer l'intégralité du flux en une seule trame.
`aStreaming`	`const TwsStreaming`	Mode de streaming pour la transmission fragmentée (`stmNone`, `stmStart`, `stmContinue`, `stmFinish`). La valeur par défaut est `stmNone`, qui envoie un message autonome complet.

Valeur de retour

True si une connexion avec le GUID donné a été trouvée et que le flux a été remis à son socket ; False si aucune connexion active correspondante n'existe. (Boolean)

Remarques

Cette surcharge cible un seul client avec une charge utile binaire lue depuis le flux fourni. Le flux est consommé à partir de sa position actuelle et le serveur n'en prend pas possession, de sorte que l'appelant doit le maintenir actif jusqu'au retour de WriteData (ou, lors d'une mise en file d'attente, jusqu'à ce que l'envoi soit terminé). Lorsque QueueOptions.Binary est défini à une valeur autre que qmNone, la trame est mise en file d'attente et distribuée depuis le thread de connexion plutôt que depuis le thread de l'appelant (non pris en charge lorsque IOHandlerOptions.IOHandlerType = iohIOCP). Utilisez aSize conjointement avec aStreaming lors de l'envoi de très grandes charges utiles qui doivent être fragmentées sur plusieurs trames WebSocket.

Exemple


oStream := TMemoryStream.Create;
try
  oStream.LoadFromFile('payload.bin');
  oServer.WriteData('guid', oStream);
finally
  oStream.Free;
end;

Retour aux méthodes