이로 인해 많은 유연성을 얻을 수 있습니다. 어떤 데이터 유형이든 반환할 수 있고, 데이터 선언이나 유효성 검사를 재정의할 수 있습니다.

또한 많은 책임도 따릅니다. 반환하는 데이터가 올바르고, 올바른 형식이며, 직렬화가 가능하도록 여러분이 직접 보장해야 합니다.

## `Response`에서 `jsonable_encoder` 사용하기 { #using-the-jsonable-encoder-in-a-response }

**FastAPI**는 반환하는 `Response`에 아무런 변경도 하지 않으므로, 그 내용이 준비되어 있는지 확인해야 합니다.

예를 들어, Pydantic 모델을 먼저 `dict`로 변환하고 `datetime`, `UUID` 등의 모든 데이터 타입을 JSON 호환 타입으로 변환하지 않으면 Pydantic 모델을 `JSONResponse`에 넣을 수 없습니다.

**FastAPI** 不会用 Pydantic 模型做任何数据转换，不会将响应内容转换成任何类型，等等。

这种特性给你极大的可扩展性。你可以返回任何数据类型，重写任何数据声明或者校验，等等。

这也带来了很大的责任。你必须确保你返回的数据是正确的、格式正确、可被序列化，等等。

## 在 `Response` 中使用 `jsonable_encoder` { #using-the-jsonable-encoder-in-a-response }

由于 **FastAPI** 并未对你返回的 `Response` 做任何改变，你必须确保你已经准备好响应内容。

例如，如果不首先将 Pydantic 模型转换为 `dict`，并将所有数据类型（如 `datetime`、`UUID` 等）转换为兼容 JSON 的类型，则不能将其放入 `JSONResponse` 中。

當你回傳一個 `Response` 時，**FastAPI** 會直接傳遞它。

它不會對 Pydantic 模型做任何資料轉換，也不會把內容轉成其他型別等。

這給了你很大的彈性。你可以回傳任何資料型別、覆寫任何資料宣告或驗證等。

同時也帶來了很大的責任。你必須確保你回傳的資料是正確的、格式正確、可被序列化等。

## 在 `Response` 中使用 `jsonable_encoder` { #using-the-jsonable-encoder-in-a-response }

因為 **FastAPI** 不會對你回傳的 `Response` 做任何更動，你需要自行確保它的內容已經準備好。

例如，你不能直接把一個 Pydantic 模型放進 `JSONResponse`，需要先把它轉成 `dict`，並將所有資料型別（像是 `datetime`、`UUID` 等）轉成與 JSON 相容的型別。

それは、Pydanticモデルのデータ変換や、コンテンツを任意の型に変換したりなどはしません。

これは多くの柔軟性を提供します。任意のデータ型を返したり、任意のデータ宣言やバリデーションをオーバーライドできます。

同時に多くの責任も伴います。返すデータが正しく、正しいフォーマットであり、シリアライズ可能であることなどを、あなたが保証しなければなりません。

## `jsonable_encoder` を `Response` の中で使う { #using-the-jsonable-encoder-in-a-response }

**FastAPI** はあなたが返す `Response` に対して何も変更を加えないので、コンテンツが準備できていることを保証しなければなりません。

例えば、Pydanticモデルを `JSONResponse` に含めるには、すべてのデータ型 (`datetime` や `UUID` など) をJSON互換の型に変換された `dict` に変換しなければなりません。

    def jsonFile

    def setup() {
        jsonFile = new File(temporaryFolder, 'acceptedChanges.json')
    }

    def "can clean existing API changes"() {
        given:
        jsonFile << existingAcceptedApiChanges()

        when:
        jsonFileManager.emptyAcceptedApiChanges(jsonFile)

        then:
        jsonFile.text == nonExistentAcceptedApiChanges()
    }

            Set<String> allExistingAnchors = findAllAdocAnchors(directoryPath);

            for (File jsonFile : jsonFiles) {
                getLogger().info("Verifying documentation for file: {}", jsonFile.getName());
                allErrors.addAll(findMissingAdocFiles(jsonFile, directoryPath));
                allErrors.addAll(findMissingAnchors(jsonFile, allExistingAnchors));
            }

            if (!allErrors.isEmpty()) {

 */

package gradlebuild.binarycompatibility

import com.google.gson.Gson
import com.google.gson.stream.JsonWriter

class AcceptedApiChangesJsonFileManager {

    void emptyAcceptedApiChanges(File jsonFile) {
        jsonFile.withWriter { fileWriter ->
            def writer = new JsonWriter(fileWriter)
            writer.setIndent("    ")
            new Gson().toJson([acceptedApiChanges: []], Object, writer)
            writer.close()

}

data class JsonBasedGradleSubprojectProvider(
    private val jsonFile: File,
) : GradleSubprojectProvider {
    private val objectMapper = ObjectMapper().registerKotlinModule()

    override val subprojects = objectMapper.readValue<List<Map<String, Any>>>(jsonFile.readText()).map { toSubproject(it) }

    private val nameToSubproject = subprojects.map { it.name to it }.toMap()

    private val buckets: Map<TestCoverage, List<SmallSubprojectBucket>> = buildBuckets(testTimeDataJson, model)

    fun generate(jsonFile: File) {
        val output =
            buckets.map {
                TestCoverageAndBucketSplits(it.key.uuid, it.value.map { it.toJsonBucket() })
            }
        jsonFile.writeText(gson.toJson(output))
    }

    private fun buildBuckets(
        buildClassTimeJson: File,

        * Before this, the return content was first passed through `jsonable_encoder` to ensure it was a "jsonable" object, like a `dict`, instead of an arbitrary object with attributes (like an ORM model). That's why you should make sure to update your Pydantic models for objects with attributes to use `orm_mode = True`.