TsgcWebSocketHTTPServer › Yöntemler › WriteData

WriteData Yöntem

Bağlantı GUID'siyle tanımlanan tek bir istemciye bir WebSocket mesajı gönderir.

Aşırı Yüklemeler

Aşırı Yükleme 1

Sözdizimi

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

Parametreler

Name	Type	Açıklama
`aGuid`	`const string`	İstemci handshake'i tamamlandığında sunucu tarafından atanan hedef bağlantının tanımlayıcısı.
`aMessage`	`const string`	O istemciye bir WebSocket metin çerçevesi olarak teslim edilecek metin yükü.

Dönüş Değeri

Verilen GUID'e sahip bir bağlantı bulunduğunda ve çerçeve yuvasına teslim edildiğinde True; eşleşen etkin bağlantı olmadığında False. (Boolean)

Remarks

Bu aşırı yükleme, GUID'i aGuid ile eşleşen WebSocket bağlantısını arar ve metin mesajını o tek istemciye gönderir. GUID, TsgcWSConnection.Guid tarafından gösterilen değerdir, genellikle OnConnect'te yakalanır ve uygulama tarafından saklanır. Yalnızca yükseltilmiş WebSocket oturumları uygundur; saf HTTP isteklerine ait GUID'ler reddedilir ve False döndürülür. QueueOptions.Text, qmNone dışında bir değere ayarlandığında, çerçeve sıraya alınır ve çağıranın iş parçacığı yerine bağlantı iş parçacığından gönderilir (IOHandlerOptions.IOHandlerType = iohIOCP olduğunda desteklenmez). Tek bir çağrıda her etkin istemciye ulaşmak için Broadcast'i kullanın.

Örnek


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

Overload 2

Sözdizimi

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

Parametreler

Name	Type	Açıklama
`aGuid`	`const String`	İstemci handshake'i tamamlandığında sunucu tarafından atanan hedef bağlantının tanımlayıcısı.
`aStream`	`TStream`	İçeriği istemciye bir WebSocket ikili çerçevesi olarak gönderilen kaynak akışı. Çağıran, akışın sahibi olmaya devam eder.
`aSize`	`Integer`	İsteğe bağlı bayt cinsinden parça boyutu; sıfırdan büyük olduğunda akış bu boyutta birden çok parçaya bölünür. Tüm akışı tek bir çerçeve olarak göndermek için 0 (varsayılan) kullanın.
`aStreaming`	`const TwsStreaming`	Parçalı iletim için akış modu (`stmNone`, `stmStart`, `stmContinue`, `stmFinish`). Tam, bağımsız bir mesaj gönderen `stmNone` varsayılandır.

Dönüş Değeri

Belirtilen GUID'e sahip bir bağlantı bulunduğunda ve akış soketine teslim edildiğinde True; eşleşen etkin bağlantı olmadığında False. (Boolean)

Remarks

Bu aşırı yükleme, sağlanan akıştan okunan ikili bir yükle tek bir WebSocket istemcisini hedefler. Akış geçerli konumundan tüketilir ve sunucu sahipliği almaz, dolayısıyla çağıran, WriteData dönene kadar (veya kuyruğa alındığında gönderme tamamlanana kadar) akışı canlı tutmalıdır. QueueOptions.Binary, qmNone dışında bir değere ayarlandığında çerçeve kuyruğa alınır ve çağıranın iş parçacığı yerine bağlantı iş parçacığından gönderilir (IOHandlerOptions.IOHandlerType = iohIOCP olduğunda desteklenmez). Birden çok WebSocket çerçevesine bölünmesi gereken çok büyük yükler gönderirken aSize öğesini aStreaming ile birlikte kullanın.

Örnek


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

Yöntemlere Dön