Browse Source

🌐 Add Japanese translation for `docs/ja/docs/tutorial/encoder.md` (#1955)

pull/11011/head
SwftAlpc 1 year ago
committed by GitHub
parent
commit
851daec754
No known key found for this signature in database GPG Key ID: B5690EEEBB952194
  1. 34
      docs/ja/docs/tutorial/encoder.md

34
docs/ja/docs/tutorial/encoder.md

@ -0,0 +1,34 @@
# JSON互換エンコーダ
データ型(Pydanticモデルのような)をJSONと互換性のあるもの(`dict`や`list`など)に変更する必要がある場合があります。
例えば、データベースに保存する必要がある場合です。
そのために、**FastAPI** は`jsonable_encoder()`関数を提供しています。
## `jsonable_encoder`の使用
JSON互換のデータのみを受信するデータベース`fase_db`があるとしましょう。
例えば、`datetime`オブジェクトはJSONと互換性がないので、このデーターベースには受け取られません。
そのため、`datetime`オブジェクトは<a href="https://en.wikipedia.org/wiki/ISO_8601" class="external-link" target="_blank">ISO形式</a>のデータを含む`str`に変換されなければなりません。
同様に、このデータベースはPydanticモデル(属性を持つオブジェクト)を受け取らず、`dict`だけを受け取ります。
そのために`jsonable_encoder`を使用することができます。
Pydanticモデルのようなオブジェクトを受け取り、JSON互換版を返します:
```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>でエンコードできるものです。
これはJSON形式のデータを含む大きな`str`を(文字列として)返しません。JSONと互換性のある値とサブの値を持つPython標準のデータ構造(例:`dict`)を返します。
!!! note "備考"
`jsonable_encoder`は実際には **FastAPI** が内部的にデータを変換するために使用します。しかしこれは他の多くのシナリオで有用です。
Loading…
Cancel
Save