mirror of https://github.com/tiangolo/fastapi.git
🌐 Add Portuguese translation for `docs/pt/docs/tutorial/dependencies/dependencies-in-path-operation-operators.md` (#11804)
This commit is contained in:
parent
4343170a28
commit
4eb8db3cd3
|
|
@ -0,0 +1,138 @@
|
|||
# Dependências em decoradores de operações de rota
|
||||
|
||||
Em alguns casos você não precisa necessariamente retornar o valor de uma dependência dentro de uma *função de operação de rota*.
|
||||
|
||||
Ou a dependência não retorna nenhum valor.
|
||||
|
||||
Mas você ainda precisa que ela seja executada/resolvida.
|
||||
|
||||
Para esses casos, em vez de declarar um parâmetro em uma *função de operação de rota* com `Depends`, você pode adicionar um argumento `dependencies` do tipo `list` ao decorador da operação de rota.
|
||||
|
||||
## Adicionando `dependencies` ao decorador da operação de rota
|
||||
|
||||
O *decorador da operação de rota* recebe um argumento opcional `dependencies`.
|
||||
|
||||
Ele deve ser uma lista de `Depends()`:
|
||||
|
||||
=== "Python 3.9+"
|
||||
|
||||
```Python hl_lines="19"
|
||||
{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
|
||||
```
|
||||
|
||||
=== "Python 3.8+"
|
||||
|
||||
```Python hl_lines="18"
|
||||
{!> ../../../docs_src/dependencies/tutorial006_an.py!}
|
||||
```
|
||||
|
||||
=== "Python 3.8 non-Annotated"
|
||||
|
||||
!!! tip "Dica"
|
||||
Utilize a versão com `Annotated` se possível
|
||||
|
||||
```Python hl_lines="17"
|
||||
{!> ../../../docs_src/dependencies/tutorial006.py!}
|
||||
```
|
||||
Essas dependências serão executadas/resolvidas da mesma forma que dependências comuns. Mas o valor delas (se existir algum) não será passado para a sua *função de operação de rota*.
|
||||
|
||||
!!! tip "Dica"
|
||||
Alguns editores de texto checam parâmetros de funções não utilizados, e os mostram como erros.
|
||||
|
||||
Utilizando `dependencies` no *decorador da operação de rota* você pode garantir que elas serão executadas enquanto evita errors de editores/ferramentas.
|
||||
|
||||
Isso também pode ser útil para evitar confundir novos desenvolvedores que ao ver um parâmetro não usado no seu código podem pensar que ele é desnecessário.
|
||||
|
||||
!!! info "Informação"
|
||||
Neste exemplo utilizamos cabeçalhos personalizados inventados `X-Keys` e `X-Token`.
|
||||
|
||||
Mas em situações reais, como implementações de segurança, você pode obter mais vantagens em usar as [Ferramentas de segurança integradas (o próximo capítulo)](../security/index.md){.internal-link target=_blank}.
|
||||
|
||||
## Erros das dependências e valores de retorno
|
||||
|
||||
Você pode utilizar as mesmas *funções* de dependências que você usaria normalmente.
|
||||
|
||||
### Requisitos de Dependências
|
||||
|
||||
Dependências podem declarar requisitos de requisições (como cabeçalhos) ou outras subdependências:
|
||||
|
||||
=== "Python 3.9+"
|
||||
|
||||
```Python hl_lines="8 13"
|
||||
{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
|
||||
```
|
||||
|
||||
=== "Python 3.8+"
|
||||
|
||||
```Python hl_lines="7 12"
|
||||
{!> ../../../docs_src/dependencies/tutorial006_an.py!}
|
||||
```
|
||||
|
||||
=== "Python 3.8 non-Annotated"
|
||||
|
||||
!!! tip "Dica"
|
||||
Utilize a versão com `Annotated` se possível
|
||||
|
||||
```Python hl_lines="6 11"
|
||||
{!> ../../../docs_src/dependencies/tutorial006.py!}
|
||||
```
|
||||
|
||||
### Levantando exceções
|
||||
|
||||
Essas dependências podem levantar exceções, da mesma forma que dependências comuns:
|
||||
|
||||
=== "Python 3.9+"
|
||||
|
||||
```Python hl_lines="10 15"
|
||||
{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
|
||||
```
|
||||
|
||||
=== "Python 3.8+"
|
||||
|
||||
```Python hl_lines="9 14"
|
||||
{!> ../../../docs_src/dependencies/tutorial006_an.py!}
|
||||
```
|
||||
|
||||
=== "Python 3.8 non-Annotated"
|
||||
|
||||
!!! tip "Dica"
|
||||
Utilize a versão com `Annotated` se possível
|
||||
|
||||
```Python hl_lines="8 13"
|
||||
{!> ../../../docs_src/dependencies/tutorial006.py!}
|
||||
```
|
||||
|
||||
### Valores de retorno
|
||||
|
||||
E elas também podem ou não retornar valores, eles não serão utilizados.
|
||||
|
||||
Então, você pode reutilizar uma dependência comum (que retorna um valor) que já seja utilizada em outro lugar, e mesmo que o valor não seja utilizado, a dependência será executada:
|
||||
|
||||
=== "Python 3.9+"
|
||||
|
||||
```Python hl_lines="11 16"
|
||||
{!> ../../../docs_src/dependencies/tutorial006_an_py39.py!}
|
||||
```
|
||||
|
||||
=== "Python 3.8+"
|
||||
|
||||
```Python hl_lines="10 15"
|
||||
{!> ../../../docs_src/dependencies/tutorial006_an.py!}
|
||||
```
|
||||
|
||||
=== "Python 3.8 non-Annotated"
|
||||
|
||||
!!! tip "Dica"
|
||||
Utilize a versão com `Annotated` se possível
|
||||
|
||||
```Python hl_lines="9 14"
|
||||
{!> ../../../docs_src/dependencies/tutorial006.py!}
|
||||
```
|
||||
|
||||
## Dependências para um grupo de *operações de rota*
|
||||
|
||||
Mais a frente, quando você ler sobre como estruturar aplicações maiores ([Bigger Applications - Multiple Files](../../tutorial/bigger-applications.md){.internal-link target=_blank}), possivelmente com múltiplos arquivos, você aprenderá a declarar um único parâmetro `dependencies` para um grupo de *operações de rota*.
|
||||
|
||||
## Dependências globais
|
||||
|
||||
No próximo passo veremos como adicionar dependências para uma aplicação `FastAPI` inteira, para que ela seja aplicada em toda *operação de rota*.
|
||||
Loading…
Reference in New Issue