## Créer un middleware { #create-a-middleware }

Pour créer un middleware, utilisez le décorateur `@app.middleware("http")` au-dessus d’une fonction.

La fonction de middleware reçoit :

* La `request`.
* Une fonction `call_next` qui recevra la `request` en paramètre.
    * Cette fonction transmettra la `request` au *chemin d'accès* correspondant.
    * Puis elle renverra la `response` générée par le *chemin d'accès* correspondant.

## Détails { #details }

Le premier `"/static"` fait référence au sous-chemin sur lequel cette « sous-application » sera « montée ». Ainsi, tout chemin qui commence par `"/static"` sera géré par elle.

Le `directory="static"` fait référence au nom du répertoire qui contient vos fichiers statiques.

Le `name="static"` lui donne un nom utilisable en interne par **FastAPI**.

* Pour passer un corps JSON, passez un objet Python (par exemple un `dict`) au paramètre `json`.
* Si vous devez envoyer des *Form Data* au lieu de JSON, utilisez le paramètre `data` à la place.
* Pour passer des en-têtes, utilisez un `dict` dans le paramètre `headers`.
* Pour les cookies, un `dict` dans le paramètre `cookies`.

# Tester les WebSockets { #testing-websockets }

Vous pouvez utiliser le même `TestClient` pour tester les WebSockets.

Pour cela, vous utilisez `TestClient` dans une instruction `with`, en vous connectant au WebSocket :

{* ../../docs_src/app_testing/tutorial002_py310.py hl[27:31] *}

/// note | Remarque

* aller au package parent (le répertoire `app/`)...
* puis aller au parent de ce package (il n'y a pas de package parent, `app` est le niveau supérieur 😱)...
* et là, trouver le module `dependencies` (le fichier `app/dependencies.py`)...
* et en importer la fonction `get_token_header`.

Par exemple, elle ne reçoit pas d'objets `datetime`, car ceux-ci ne sont pas compatibles avec JSON.

Ainsi, un objet `datetime` doit être converti en une `str` contenant les données au [format ISO](https://en.wikipedia.org/wiki/ISO_8601).

De la même manière, cette base de données n'accepterait pas un modèle Pydantic (un objet avec des attributs), seulement un `dict`.

# Utiliser des dataclasses { #using-dataclasses }

FastAPI est construit au‑dessus de **Pydantic**, et je vous ai montré comment utiliser des modèles Pydantic pour déclarer les requêtes et les réponses.

Mais FastAPI prend aussi en charge l'utilisation de [`dataclasses`](https://docs.python.org/3/library/dataclasses.html) de la même manière :

{* ../../docs_src/dataclasses_/tutorial001_py310.py hl[1,6:11,18:19] *}

Si vous avez une version plus ancienne, vous obtiendrez des erreurs en essayant d’utiliser `Annotated`.

Assurez-vous de [mettre à niveau la version de FastAPI](../deployment/versions.md#upgrading-the-fastapi-versions) vers au moins 0.95.1 avant d’utiliser `Annotated`.

///

## Utiliser `Annotated` dans le type pour le paramètre `q` { #use-annotated-in-the-type-for-the-q-parameter }

Vous pouvez également l'utiliser pour diffuser de gros fichiers binaires, en envoyant chaque bloc de données au fur et à mesure de la lecture, sans tout charger en mémoire d'un coup.

Vous pouvez aussi diffuser de la **vidéo** ou de l'**audio** de cette manière ; cela peut même être généré au fil du traitement et de l'envoi.

## Utiliser une `StreamingResponse` avec `yield` { #a-streamingresponse-with-yield }

Pour l'installer manuellement, vous devez vous assurer de créer un [environnement virtuel](../../virtual-environments.md), de l'activer, puis de l'installer avec :

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

Cela est dû au fait que **OAuth2** utilise des « form data » pour envoyer le `username` et le `password`.

///

Exécutez l'exemple avec :

<div class="termy">

```console
$ fastapi dev