* Side Public License, v 1.
 */

package org.elasticsearch.gradle.internal.test;

import org.elasticsearch.gradle.internal.ExportElasticsearchBuildResourcesTask;
import org.elasticsearch.gradle.internal.info.BuildParams;
import org.elasticsearch.gradle.internal.precommit.FilePermissionsPrecommitPlugin;
import org.elasticsearch.gradle.internal.precommit.ForbiddenPatternsPrecommitPlugin;

因此，即便上面的代码没有显式使用 Pydantic，FastAPI 也会使用 Pydantic 将那些标准数据类转换为 Pydantic 风格的 dataclasses。

并且，它仍然支持以下功能：

* 数据验证
* 数据序列化
* 数据文档等

这与使用 Pydantic 模型时的工作方式相同。而且底层实际上也是借助 Pydantic 实现的。

/// info | 信息

请注意，数据类不能完成 Pydantic 模型能做的所有事情。

因此，你可能仍然需要使用 Pydantic 模型。

但如果你已有一堆数据类，这个技巧可以让它们很好地为使用 FastAPI 的 Web API 所用。🤓

///

## 在 `response_model` 中使用数据类 { #dataclasses-in-response-model }

{* ../../docs_src/response_status_code/tutorial001_py310.py hl[6] *}

/// note | 注意

注意，`status_code` 是（`get`、`post` 等）**装饰器**方法中的参数。与之前的参数和请求体不同，不是*路径操作函数*的参数。

///

`status_code` 参数接收表示 HTTP 状态码的数字。

/// info | 信息

`status_code` 还能接收 `IntEnum` 类型，比如 Python 的 [`http.HTTPStatus`](https://docs.python.org/3/library/http.html#http.HTTPStatus)。

///

它可以：

* 在响应中返回状态码
* 在 OpenAPI 概图（及用户界面）中存档：

# 파일 요청 { #request-files }

`File`을 사용하여 클라이언트가 업로드할 파일들을 정의할 수 있습니다.

/// info | 정보

업로드된 파일을 전달받기 위해 먼저 [`python-multipart`](https://github.com/Kludex/python-multipart)를 설치해야합니다.

[가상 환경](../virtual-environments.md)을 생성하고, 활성화한 다음, 예를 들어 다음과 같이 설치하세요:

```console
$ pip install python-multipart
```

업로드된 파일들은 "폼 데이터"의 형태로 전송되기 때문에 이 작업이 필요합니다.

///

## `File` 임포트 { #import-file }

### `shutdown` 事件 { #shutdown-event }

使用事件 `"shutdown"` 声明一个在应用关闭时运行的函数：

{* ../../docs_src/events/tutorial002_py310.py hl[6] *}

此处，`shutdown` 事件处理器函数会向文件 `log.txt` 写入一行文本 `"Application shutdown"`。

/// info | 信息

在 `open()` 函数中，`mode="a"` 指的是“追加”。因此这行文本会添加在文件已有内容之后，不会覆盖之前的内容。

///

/// tip | 提示

注意，本例使用 Python 标准的 `open()` 函数与文件交互。

这个函数执行 I/O（输入/输出）操作，需要“等待”内容写进磁盘。

                deleteIndex(backupIndex);

                logger.info("[Rebuild] Completed rebuild for {}", indexName);
            } catch (final Exception e) {
                logger.warn("[Rebuild] Failed to rebuild index: {}", indexName, e);
                if (existsIndex(backupIndex)) {
                    logger.info("[Rebuild] Backup index {} remains for recovery", backupIndex);
                }

Webargs는 Flask를 포함한 여러 framework 위에서 이를 제공하기 위해 만들어진 도구입니다.

내부적으로 Marshmallow를 사용해 데이터 검증을 수행합니다. 그리고 같은 개발자들이 만들었습니다.

아주 훌륭한 도구이며, 저도 **FastAPI**를 만들기 전에 많이 사용했습니다.

/// info | 정보

Webargs는 Marshmallow와 같은 개발자들이 만들었습니다.

///

/// check | **FastAPI**에 영감을 준 것

들어오는 요청 데이터의 자동 검증을 갖기.

///

### [APISpec](https://apispec.readthedocs.io/en/stable/) { #apispec }

Esto es similar a [Stream JSON Lines](stream-json-lines.md), pero usa el formato `text/event-stream`, que los navegadores soportan de forma nativa con la [`EventSource` API](https://developer.mozilla.org/en-US/docs/Web/API/EventSource).

/// info | Información

Añadido en FastAPI 0.135.0.

///

## ¿Qué son los Server-Sent Events? { #what-are-server-sent-events }

SSE es un estándar para hacer streaming de datos desde el servidor al cliente sobre HTTP.

///

## Renvoyer une `Response` { #return-a-response }

Vous pouvez renvoyer une `Response` ou n'importe laquelle de ses sous-classes.

/// info

`JSONResponse` est elle-même une sous-classe de `Response`.

///

Et lorsque vous renvoyez une `Response`, **FastAPI** la transmet directement.

En ese caso, puedes desactivar esta funcionalidad en **FastAPI**, con el parámetro `separate_input_output_schemas=False`.

/// info | Información

El soporte para `separate_input_output_schemas` fue agregado en FastAPI `0.102.0`. 🤓

///

{* ../../docs_src/separate_openapi_schemas/tutorial002_py310.py hl[10] *}