Browse Source

🌐 Add Russian translation for `docs/ru/docs/tutorial/encoder.md` (#10374)

pull/11016/head
Aleksandr Andrukhov 1 year ago
committed by GitHub
parent
commit
672b501b98
No known key found for this signature in database GPG Key ID: B5690EEEBB952194
  1. 42
      docs/ru/docs/tutorial/encoder.md

42
docs/ru/docs/tutorial/encoder.md

@ -0,0 +1,42 @@
# JSON кодировщик
В некоторых случаях может потребоваться преобразование типа данных (например, Pydantic-модели) в тип, совместимый с JSON (например, `dict`, `list` и т.д.).
Например, если необходимо хранить его в базе данных.
Для этого **FastAPI** предоставляет функцию `jsonable_encoder()`.
## Использование `jsonable_encoder`
Представим, что у вас есть база данных `fake_db`, которая принимает только JSON-совместимые данные.
Например, он не принимает объекты `datetime`, так как они не совместимы с JSON.
В таком случае объект `datetime` следует преобразовать в строку соответствующую <a href="https://en.wikipedia.org/wiki/ISO_8601" class="external-link" target="_blank">формату ISO</a>.
Точно так же эта база данных не может принять Pydantic модель (объект с атрибутами), а только `dict`.
Для этого можно использовать функцию `jsonable_encoder`.
Она принимает объект, например, модель Pydantic, и возвращает его версию, совместимую с JSON:
=== "Python 3.10+"
```Python hl_lines="4 21"
{!> ../../../docs_src/encoder/tutorial001_py310.py!}
```
=== "Python 3.6+"
```Python hl_lines="5 22"
{!> ../../../docs_src/encoder/tutorial001.py!}
```
В данном примере она преобразует Pydantic модель в `dict`, а `datetime` - в `str`.
Результатом её вызова является объект, который может быть закодирован с помощью функции из стандартной библиотеки Python – <a href="https://docs.python.org/3/library/json.html#json.dumps" class="external-link" target="_blank">`json.dumps()`</a>.
Функция не возвращает большой `str`, содержащий данные в формате JSON (в виде строки). Она возвращает стандартную структуру данных Python (например, `dict`) со значениями и подзначениями, которые совместимы с JSON.
!!! note "Технические детали"
`jsonable_encoder` фактически используется **FastAPI** внутри системы для преобразования данных. Однако он полезен и во многих других сценариях.
Loading…
Cancel
Save