跳转至

JSON 兼容编码器⚓︎

在某些情况下,您可能需要将数据类型(如Pydantic模型)转换为与JSON兼容的数据类型(如dictlist等)。

比如,如果您需要将其存储在数据库中。

对于这种要求, FastAPI提供了jsonable_encoder()函数。

使用jsonable_encoder⚓︎

让我们假设你有一个数据库名为fake_db,它只能接收与JSON兼容的数据。

例如,它不接收datetime这类的对象,因为这些对象与JSON不兼容。

因此,datetime对象必须将转换为包含ISO格式化str类型对象。

同样,这个数据库也不会接收Pydantic模型(带有属性的对象),而只接收dict

对此你可以使用jsonable_encoder

它接收一个对象,比如Pydantic模型,并会返回一个JSON兼容的版本:

=== "Python 3.10+"

```Python hl_lines="4  21"
{!> ../../../docs_src/encoder/tutorial001_py310.py!}
```

=== "Python 3.8+"

```Python hl_lines="5  22"
{!> ../../../docs_src/encoder/tutorial001.py!}
```

在这个例子中,它将Pydantic模型转换为dict,并将datetime转换为str

调用它的结果后就可以使用Python标准编码中的json.dumps()

这个操作不会返回一个包含JSON格式(作为字符串)数据的庞大的str。它将返回一个Python标准数据结构(例如dict),其值和子值都与JSON兼容。

Note

jsonable_encoder实际上是FastAPI内部用来转换数据的。但是它在许多其他场景中也很有用。


最后更新: November 25, 2023
创建日期: November 25, 2023