# 高级用户指南 { #advanced-user-guide }

## 附加功能 { #additional-features }

主要的[教程 - 用户指南](../tutorial/index.md)足以带你了解 **FastAPI** 的所有主要特性。

在接下来的章节中，你将看到其他选项、配置和附加功能。

/// tip | 提示

接下来的章节**不一定是“高级”的**。

对于你的用例，解决方案很可能就在其中之一。

///

## 先阅读教程 { #read-the-tutorial-first }

仅凭主要[教程 - 用户指南](../tutorial/index.md)中的知识，你已经可以使用 **FastAPI** 的大多数功能。

## Consequences

* X
* Y
* Z
```

## Consequences

* We start to use Architectural Decision Records
* We use the proposed template from this ADR
* We locate `.md` files in the folder `/architecture/standards`
* We highly encourage usage of ADR to communicate decisions

The platforms and modules are defined using a DSL in [settings.gradle.kts](../settings.gradle.kts)

## 文件摘要與描述 - OpenAPI { #documentation-summary-and-description-openapi }

要為你的*路徑操作*加入摘要與描述，並在文件 UI 中顯示，請參閱[教學 - 路徑操作設定 - 摘要與描述](../tutorial/path-operation-configuration.md#summary-and-description)。

## 文件回應描述 - OpenAPI { #documentation-response-description-openapi }

要定義在文件 UI 中顯示的回應描述，請參閱[教學 - 路徑操作設定 - 回應描述](../tutorial/path-operation-configuration.md#response-description)。

* 그런 다음 해당 **응답**에 대해 무언가를 하거나 필요한 코드를 실행할 수 있습니다.
* 그런 다음 **응답**을 반환합니다.

/// note | 기술 세부사항

`yield`를 사용하는 의존성이 있다면, exit 코드는 미들웨어 *후에* 실행됩니다.

백그라운드 작업(뒤에서 보게 될 [백그라운드 작업](background-tasks.md) 섹션에서 다룹니다)이 있다면, 모든 미들웨어 *후에* 실행됩니다.

///

## 미들웨어 만들기 { #create-a-middleware }

미들웨어를 만들기 위해 함수 상단에 데코레이터 `@app.middleware("http")`를 사용합니다.

미들웨어 함수는 다음을 받습니다:

* `request`.

│   ├── maven.yml                  # Build and test workflow
│   └── codeql-analysis.yml        # Security analysis
├── pom.xml                        # Maven build configuration
├── README.md                      # Project documentation
└── CLAUDE.md                      # This file
```

## Development Commands

### Build and Test
```bash
# Clean build and run tests
mvn clean test

# Full build with packaging

## Mevcut sürümler { #available-versions }

Mevcut sürümleri (ör. en güncel son sürümün hangisi olduğunu kontrol etmek için) [Sürüm Notları](../release-notes.md) sayfasında görebilirsiniz.

## Sürümler Hakkında { #about-versions }

Semantic Versioning kurallarına göre, `1.0.0` altındaki herhangi bir sürüm breaking change içerebilir.

# Подключение WSGI — Flask, Django и другие { #including-wsgi-flask-django-others }

Вы можете монтировать WSGI‑приложения, как вы видели в [Подприложения — Mounts](sub-applications.md), [За прокси‑сервером](behind-a-proxy.md).

Для этого вы можете использовать `WSGIMiddleware` и обернуть им ваше WSGI‑приложение, например Flask, Django и т.д.

## Использование `WSGIMiddleware` { #using-wsgimiddleware }

/// info | Информация

# Adicionando WSGI - Flask, Django, entre outros { #including-wsgi-flask-django-others }

Como você viu em [Subaplicações - Montagens](sub-applications.md) e [Atrás de um Proxy](behind-a-proxy.md), você pode montar aplicações WSGI.

Para isso, você pode utilizar o `WSGIMiddleware` para encapsular a sua aplicação WSGI, como por exemplo Flask, Django, etc.

## Usando `WSGIMiddleware` { #using-wsgimiddleware }

/// info | Informação

/// note | Технічні деталі

Якщо у вас є залежності з `yield`, код виходу виконається *після* middleware.

Якщо були заплановані фонові задачі (розглянуто в розділі [Фонові задачі](background-tasks.md), ви побачите це пізніше), вони виконаються *після* всіх middleware.

///

## Створення middleware { #create-a-middleware }

Щоб створити middleware, ви використовуєте декоратор `@app.middleware("http")` над функцією.