A biblioteca padrãoSlide 67 de 85
67wsA biblioteca padrão
WebSockets
WebSockets são RFC 6455 de ponta a ponta: o handshake, o enquadramento, a máscara, ping e pong e a fragmentação são assunto do runtime, e um programa só vê mensagens inteiras, como Str.
wsServe(port, handler)chama umproc(WsConnection): voiduma vez por conexão, cada uma numa thread própria, e a conexão fecha quando o handler retorna — então um handler que pretende conversar mais de uma vez faz um laço.wsConnect(url)abre uma como cliente, respondendo com umResult.wsReceive(conn)espera a próxima mensagem;wsSend(conn, message)responde com os bytes que enviou;wsClose(conn)a encerra deste lado.wsRequest(conn)é oHttpRequestque abriu a conexão, como um valor simples.conn.addressé quem está do outro lado, como"host:porta"— um campo, enquanto todo o resto sobre uma conexão é uma chamada.httpWsServe(port, handler, wsHandler)serve HTTP e WebSockets numa só porta: toda requisição chega aohandler, um handler dehttpServe, e responder101entrega aquela requisição aowsHandler.
Um hive.net.WsError é Handshake, Protocol, Closed, Send ou Receive, cada um com uma message. O outro lado desligar é WsError.Closed, que é como uma conversa termina e não uma falha que valha reportar.
proc handle(conn: hive.net.WsConnection): void {
// A conexão dura enquanto o handler durar, então ele faz um laço
// até o outro lado desligar.
mut open := true
for ; open; {
got := hive.net.wsReceive(conn)
if got is Result.Ok(msg) {
hive.net.wsSend(conn, "eco: {msg}")
} else {
open = false
}
}
}
proc main(): void {
hive.net.wsServe(8081, handle)
}HTTP e WebSockets numa só porta
proc route(req: hive.net.HttpRequest): hive.net.HttpResponse {
if req.url == "/feed" {
// Responder 101 entrega esta requisição ao handler de WebSocket.
return hive.net.HttpResponse(101, [], "")
}
return hive.net.HttpResponse(200, [], "uma página")
}
proc feed(conn: hive.net.WsConnection): void {
// O outro lado, como "host:porta".
hive.net.wsSend(conn, "olá, {conn.address}")
}
proc main(): void {
hive.net.httpWsServe(8080, route, feed)
}