Browse Source

update advanced/websockets.md

pull/14228/head
Rafael de Oliveira Marques 8 months ago
parent
commit
20168b03c0
  1. 34
      docs/pt/docs/advanced/websockets.md

34
docs/pt/docs/advanced/websockets.md

@ -1,10 +1,10 @@
# WebSockets
# WebSockets { #websockets }
Você pode usar <a href="https://developer.mozilla.org/en-US/docs/Web/API/WebSockets_API" class="external-link" target="_blank">WebSockets</a> com **FastAPI**.
## Instalando `WebSockets`
## Instale `websockets` { #install-websockets }
Garanta que você criou um [ambiente virtual](../virtual-environments.md){.internal-link target=_blank}, o ativou e instalou o `websockets`:
Garanta que você criou um [ambiente virtual](../virtual-environments.md){.internal-link target=_blank}, o ativou e instalou o `websockets` (uma biblioteca Python que facilita o uso do protocolo "WebSocket"):
<div class="termy">
@ -16,9 +16,9 @@ $ pip install websockets
</div>
## Cliente WebSockets
## Cliente WebSockets { #websockets-client }
### Em produção
### Em produção { #in-production }
Em seu sistema de produção, você provavelmente tem um frontend criado com um framework moderno como React, Vue.js ou Angular.
@ -40,11 +40,11 @@ Mas é a maneira mais simples de focar no lado do servidor de WebSockets e ter u
{* ../../docs_src/websockets/tutorial001.py hl[2,6:38,41:43] *}
## Criando um `websocket`
## Crie um `websocket` { #create-a-websocket }
Em sua aplicação **FastAPI**, crie um `websocket`:
{*../../docs_src/websockets/tutorial001.py hl[46:47]*}
{* ../../docs_src/websockets/tutorial001.py hl[1,46:47] *}
/// note | Detalhes Técnicos
@ -54,7 +54,7 @@ A **FastAPI** fornece o mesmo `WebSocket` diretamente apenas como uma conveniên
///
## Aguardar por mensagens e enviar mensagens
## Aguarde mensagens e envie mensagens { #await-for-messages-and-send-messages }
Em sua rota WebSocket você pode esperar (`await`) por mensagens e enviar mensagens.
@ -62,7 +62,7 @@ Em sua rota WebSocket você pode esperar (`await`) por mensagens e enviar mensag
Você pode receber e enviar dados binários, de texto e JSON.
## Tente você mesmo
## Tente { #try-it }
Se seu arquivo for nomeado `main.py`, execute sua aplicação com:
@ -96,7 +96,7 @@ Você pode enviar (e receber) muitas mensagens:
E todas elas usarão a mesma conexão WebSocket.
## Usando `Depends` e outros
## Usando `Depends` e outros { #using-depends-and-others }
Nos endpoints WebSocket você pode importar do `fastapi` e usar:
@ -119,7 +119,7 @@ Você pode usar um código de fechamento dos <a href="https://tools.ietf.org/htm
///
### Tente os WebSockets com dependências
### Tente os WebSockets com dependências { #try-the-websockets-with-dependencies }
Se seu arquivo for nomeado `main.py`, execute sua aplicação com:
@ -133,11 +133,11 @@ $ fastapi dev main.py
</div>
Abrar seu browser em: <a href="http://127.0.0.1:8000" class="external-link" target="_blank">http://127.0.0.1:8000</a>.
Abra seu navegador em: <a href="http://127.0.0.1:8000" class="external-link" target="_blank">http://127.0.0.1:8000</a>.
Lá você pode definir:
* O "Item ID", usado na rota.
* O "Item ID", usado no path.
* O "Token" usado como um parâmetro de consulta.
/// tip | Dica
@ -150,7 +150,7 @@ Com isso você pode conectar o WebSocket e então enviar e receber mensagens:
<img src="/img/tutorial/websockets/image05.png">
## Lidando com desconexões e múltiplos clientes
## Lidando com desconexões e múltiplos clientes { #handling-disconnections-and-multiple-clients }
Quando uma conexão WebSocket é fechada, o `await websocket.receive_text()` levantará uma exceção `WebSocketDisconnect`, que você pode então capturar e lidar como neste exemplo.
@ -158,7 +158,7 @@ Quando uma conexão WebSocket é fechada, o `await websocket.receive_text()` lev
Para testar:
* Abrar o aplicativo com várias abas do navegador.
* Abra o aplicativo com várias abas do navegador.
* Escreva mensagens a partir delas.
* Então feche uma das abas.
@ -172,13 +172,13 @@ Client #1596980209979 left the chat
O app acima é um exemplo mínimo e simples para demonstrar como lidar e transmitir mensagens para várias conexões WebSocket.
Mas tenha em mente que, como tudo é manipulado na memória, em uma única lista, ele só funcionará enquanto o processo estiver em execução e só funcionará com um único processo.
Mas tenha em mente que, como tudo é manipulado na memória, em uma única list, ele só funcionará enquanto o processo estiver em execução e só funcionará com um único processo.
Se você precisa de algo fácil de integrar com o FastAPI, mas que seja mais robusto, suportado por Redis, PostgreSQL ou outros, verifique o <a href="https://github.com/encode/broadcaster" class="external-link" target="_blank">encode/broadcaster</a>.
///
## Mais informações
## Mais informações { #more-info }
Para aprender mais sobre as opções, verifique a documentação do Starlette para:

Loading…
Cancel
Save