A biblioteca padrão
Slide 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 um proc(WsConnection): void uma 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 um Result.
  • wsReceive(conn) espera a próxima mensagem; wsSend(conn, message) responde com os bytes que enviou; wsClose(conn) a encerra deste lado.
  • wsRequest(conn) é o HttpRequest que 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 ao handler, um handler de httpServe, e responder 101 entrega aquela requisição ao wsHandler.

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)
}