Browse Source

🌐 Add Chinese translation for `docs/zh/docs/advanced/using-request-directly.md` (#3802)

Co-authored-by: Sebastián Ramírez <[email protected]>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
pull/11377/head
jaystone776 1 year ago
committed by GitHub
parent
commit
23ddb24279
No known key found for this signature in database GPG Key ID: B5690EEEBB952194
  1. 54
      docs/zh/docs/advanced/using-request-directly.md

54
docs/zh/docs/advanced/using-request-directly.md

@ -0,0 +1,54 @@
# 直接使用请求
至此,我们已经使用多种类型声明了请求的各种组件。
并从以下对象中提取数据:
* 路径参数
* 请求头
* Cookies
* 等
**FastAPI** 使用这种方式验证数据、转换数据,并自动生成 API 文档。
但有时,我们也需要直接访问 `Request` 对象。
## `Request` 对象的细节
实际上,**FastAPI** 的底层是 **Starlette**,**FastAPI** 只不过是在 **Starlette** 顶层提供了一些工具,所以能直接使用 Starlette 的 <a href="https://www.starlette.io/requests/" class="external-link" target="_blank">`Request`</a> 对象。
但直接从 `Request` 对象提取数据时(例如,读取请求体),**FastAPI** 不会验证、转换和存档数据(为 API 文档使用 OpenAPI)。
不过,仍可以验证、转换与注释(使用 Pydantic 模型的请求体等)其它正常声明的参数。
但在某些特定情况下,还是需要提取 `Request` 对象。
## 直接使用 `Request` 对象
假设要在*路径操作函数*中获取客户端 IP 地址和主机。
此时,需要直接访问请求。
```Python hl_lines="1 7-8"
{!../../../docs_src/using_request_directly/tutorial001.py!}
```
把*路径操作函数*的参数类型声明为 `Request`,**FastAPI** 就能把 `Request` 传递到参数里。
!!! tip "提示"
注意,本例除了声明请求参数之外,还声明了路径参数。
因此,能够提取、验证路径参数、并转换为指定类型,还可以用 OpenAPI 注释。
同样,您也可以正常声明其它参数,而且还可以提取 `Request`
## `Request` 文档
更多细节详见 <a href="https://www.starlette.io/requests/" class="external-link" target="_blank">Starlette 官档 - `Request` 对象</a>
!!! note "技术细节"
您也可以使用 `from starlette.requests import Request`
**FastAPI**`from fastapi import Request` 只是为开发者提供的快捷方式,但其实它直接继承自 Starlette。
Loading…
Cancel
Save