WebSocketConnection
The WebSocketConnection
class API allows you to handle WebSocket connections, once established using the WebSocketServer
class.
For an overview and some examples of the WebSocket server implementation in 4D, please refer to the WebSocketServer
class.
História
Release | Mudanças |
---|---|
20 | Adicionado |
Objecto WebSocketConnection
A WebSocketConnection
object is automatically created when the WSHandler.onConnection
callback function of the WebSocketServer object returns a connectionHandler
object.
Os objectos Httprequest fornecem as seguintes propriedades e funções:
.handler : Object the accessor that gets the connectionHandler object used to initiate the connection |
.id : Integer the unique identifier of the connection |
.send( message : Text ) .send( message : Blob ) .send( message : Object ) sends a message to the client |
.status : Text the connection status (can be "Closing", "Closed" or "Connected") |
.terminate( { code : Integer ; message : Text } ) forces the connection to close |
.wss : 4D.WebSocketServer the WebSocketServer parent object of the connection |
.handler
.handler : Object
Descrição
The .handler
property contains the accessor that gets the connectionHandler
object used to initiate the connection.
.id
.id : Integer
Descrição
The .id
property contains the unique identifier of the connection.
Esta propriedade é só de leitura.
.send()
.send( message : Text )
.send( message : Blob )
.send( message : Object )
Parâmetro | Tipo | Descrição | |
---|---|---|---|
message | Text / Blob / Object | -> | A mensagem a enviar |
Descrição
The .send()
function sends a message to the client.
Os conteúdos seguintes são enviados em função do tipo de message:
Tipo | Conteúdo |
---|---|
Text | Texto em UTF-8 |
Blob | Dados binários |
Object | Text in JSON UTF-8 (same result as with JSON Stringify ) |
.status
.status : Text
Descrição
The .status
property contains the connection status (can be "Closing", "Closed" or "Connected").
Esta propriedade é só de leitura.
.terminate()
.terminate( { code : Integer ; message : Text } )
Parâmetro | Tipo | Descrição | |
---|---|---|---|
code | Integer | -> | Error code sent to the client (must be > 3000, otherwise the message is not sent) |
message | Text | -> | Mensagem de erro enviada ao cliente |
Descrição
The .terminate()
function forces the connection to close.
A code and message can be sent to the client during the closure to indicate the reason of the termination.
.wss
.wss : 4D.WebSocketServer
Descrição
The .wss
property contains the WebSocketServer
parent object of the connection.
Esta propriedade é só de leitura.