mirror
/
tiangolo.fastapi
mirror of https://github.com/tiangolo/fastapi
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Browse Source

update advanced/websockets.md

pull/14228/head
Rafael de Oliveira Marques 8 months ago
parent
c9709b2f4f
commit
20168b03c0
1 changed files with 20 additions and 20 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 40
      docs/pt/docs/advanced/websockets.md

40
docs/pt/docs/advanced/websockets.md
View File

@ -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**. 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"> <div class="termy">
@ -16,9 +16,9 @@ $ pip install websockets
</div> </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. 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] *} {* ../../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`: 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 /// note | Detalhes Técnicos
@ -54,15 +54,15 @@ 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. Em sua rota WebSocket você pode esperar (`await`) por mensagens e enviar mensagens.
{*../../docs_src/websockets/tutorial001.py hl[48:52]*} {* ../../docs_src/websockets/tutorial001.py hl[48:52] *}
Você pode receber e enviar dados binários, de texto e JSON. 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: 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. 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: Nos endpoints WebSocket você pode importar do `fastapi` e usar:
@ -109,7 +109,7 @@ Nos endpoints WebSocket você pode importar do `fastapi` e usar:
Eles funcionam da mesma forma que para outros endpoints FastAPI/*operações de rota*: Eles funcionam da mesma forma que para outros endpoints FastAPI/*operações de rota*:
{*../../docs_src/websockets/tutorial002_an_py310.py hl[68:69,82]*} {* ../../docs_src/websockets/tutorial002_an_py310.py hl[68:69,82] *}
/// info | Informação /// info | Informação
@ -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: Se seu arquivo for nomeado `main.py`, execute sua aplicação com:
@ -133,11 +133,11 @@ $ fastapi dev main.py
</div> </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: 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. * O "Token" usado como um parâmetro de consulta.
/// tip | Dica /// tip | Dica
@ -150,15 +150,15 @@ Com isso você pode conectar o WebSocket e então enviar e receber mensagens:
<img src="/img/tutorial/websockets/image05.png"> <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. 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.
{*../../docs_src/websockets/tutorial003_py39.py hl[79:81]*} {* ../../docs_src/websockets/tutorial003_py39.py hl[79:81] *}
Para testar: 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. * Escreva mensagens a partir delas.
* Então feche uma das abas. * 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. 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>. 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: Para aprender mais sobre as opções, verifique a documentação do Starlette para:

Write Preview
Loading…
Cancel
Save