FASTAPI系列 14-使用JSONResponse 返回JSON内容

2024-03-26 21:44

本文主要是介绍FASTAPI系列 14-使用JSONResponse 返回JSON内容,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

FASTAPI系列 14-使用JSONResponse 返回JSON内容


文章目录

  • FASTAPI系列 14-使用JSONResponse 返回JSON内容
  • 前言
  • 一、默认返回的JSON格式
  • 二、JSONResponse 自定义返回
  • 三、自定义返回 headers 和 media_type
  • 总结


前言

当你创建一个 FastAPI 接口时,可以正常返回以下任意一种数据:dict,list,Pydantic 模型,数据库模型等等。FastAPI 默认会使用 jsonable_encoder 将这些类型的返回值转换成 JSON 格式,默认情况下会以content-type: application/json 格式返回。

在有些情况下,我们需要在路径操作中直接返回Response对象,这样我们能有更多的操作灵活性,比如自定义头headers 信息、自定义Cookie信息等


提示:以下是本篇文章正文内容,下面案例可供参考

一、默认返回的JSON格式

定义一个字典类型,然后fastpai会默认转化成json然后返回

from fastapi import FastAPI
import uvicornapp = FastAPI()@app.get('/users')
def users():user = {"user_name": "Teacher Li","email": "Teacher_Li@qq.com"}return user

当使用get请求时,返回的格式:

HTTP/1.1 200 OK
date: Tue, 25 Mar 2023 10:40:41 GMT
server: uvicorn
content-length: 36
content-type: application/json{"user_name": "Teacher Li","email": "Teacher_Li@qq.com"}

二、JSONResponse 自定义返回

可以使用 from starlette.responses import JSONResponse 定制返回内容,包含响应状态码,响应headers 和 响应body;
JSONResponse 继承自 Response 类,部分源码如下:

class JSONResponse(Response):  media_type = "application/json"  def __init__(  self,  content: typing.Any,  status_code: int = 200,  headers: typing.Optional[typing.Dict[str, str]] = None,  media_type: typing.Optional[str] = None,  background: typing.Optional[BackgroundTask] = None,  ) -> None:  super().__init__(content, status_code, headers, media_type, background)

JSONResponse可传参数:

  • content: 响应body内容,str 或者 bytes.
  • status_code: 响应状态码,int类型,默认200.
  • headers: 响应头部,dict类型.
  • media_type:media type. 例如"text/html".
  • background:后台任务

自定义 JSONResponse 响应, status_code 可以自定义状态码,FastAPI 会自动包含 Content-Length,以及Content-Type,charset等头信息。

from fastapi import FastAPI, status
from fastapi.responses import JSONResponse
import uvicornapp = FastAPI()@app.get('/users')
def users():user = {"user_name": "Teacher Li","email": "Teacher_Li@qq.com"}return JSONResponse(content=user, status_code=status.HTTP_200_OK)

当使用get请求时,返回的格式:

HTTP/1.1 200 OK
date: Tue, 25 Mar 2023 10:40:41 GMT
server: uvicorn
content-length: 36
content-type: application/json{"user_name": "Teacher Li","email": "Teacher_Li@qq.com"}

三、自定义返回 headers 和 media_type

响应头部添加 headers 内容和设置 media_type 响应 body 媒体类型

@app.get('/resp/users')
async def users():user = {"user_name": "Teacher Li", "email": "Teacher_Li@qq.com"}return JSONResponse(content=user,status_code=status.HTTP_201_CREATED,headers={"x-token": "abcdefghijklmnop"},media_type="text/html")

当使用get请求时,返回的格式:

HTTP/1.1 201 Created
date: Tue, 25 Mar 2023 10:40:41 GMT
server: uvicorn
x-token: abcdefghijklmnop
content-length: 36
content-type: text/html{"user_name": "Teacher Li","email": "Teacher_Li@qq.com"}

总结

jsonable_encoder 是 FastAPI(一个用于构建高性能 Web 应用的现代、异步 Python 框架)中的一个实用函数,其主要功能是对 Pydantic 模型或任何其他可迭代对象进行编码,使其转换为可以安全地序列化为 JSON 的格式。

该函数会遍历对象的所有属性,并对其中的复杂数据类型如 datetime、UUID 等进行特殊处理,确保它们能够被 JSON 序列化引擎识别和正确处理。例如,datetime 对象会被转换为 ISO8601 格式的字符串,而 UUID 对象则通常会转换为字符串形式。

使用 jsonable_encoder 可以确保你在将数据返回给前端或者存入数据库时,不会因为数据类型的复杂性而出现问题。这极大地方便了开发者处理 API 返回的数据结构,提高了开发效率。

总结来说,jsonable_encoder 在 FastAPI 中的作用是提供一种便捷的方法,将符合 Pydantic 模型或其他特定类型的数据结构转换成适合 JSON 序列化的格式。

这篇关于FASTAPI系列 14-使用JSONResponse 返回JSON内容的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/849939

相关文章

MySQL 8 中的一个强大功能 JSON_TABLE示例详解

《MySQL8中的一个强大功能JSON_TABLE示例详解》JSON_TABLE是MySQL8中引入的一个强大功能,它允许用户将JSON数据转换为关系表格式,从而可以更方便地在SQL查询中处理J... 目录基本语法示例示例查询解释应用场景不适用场景1. ‌jsON 数据结构过于复杂或动态变化‌2. ‌性能要

postgresql使用UUID函数的方法

《postgresql使用UUID函数的方法》本文给大家介绍postgresql使用UUID函数的方法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧... 目录PostgreSQL有两种生成uuid的方法。可以先通过sql查看是否已安装扩展函数,和可以安装的扩展函数

Spring的RedisTemplate的json反序列泛型丢失问题解决

《Spring的RedisTemplate的json反序列泛型丢失问题解决》本文主要介绍了SpringRedisTemplate中使用JSON序列化时泛型信息丢失的问题及其提出三种解决方案,可以根据性... 目录背景解决方案方案一方案二方案三总结背景在使用RedisTemplate操作redis时我们针对

如何使用Lombok进行spring 注入

《如何使用Lombok进行spring注入》本文介绍如何用Lombok简化Spring注入,推荐优先使用setter注入,通过注解自动生成getter/setter及构造器,减少冗余代码,提升开发效... Lombok为了开发环境简化代码,好处不用多说。spring 注入方式为2种,构造器注入和setter

MySQL中比较运算符的具体使用

《MySQL中比较运算符的具体使用》本文介绍了SQL中常用的符号类型和非符号类型运算符,符号类型运算符包括等于(=)、安全等于(=)、不等于(/!=)、大小比较(,=,,=)等,感兴趣的可以了解一下... 目录符号类型运算符1. 等于运算符=2. 安全等于运算符<=>3. 不等于运算符<>或!=4. 小于运

使用zip4j实现Java中的ZIP文件加密压缩的操作方法

《使用zip4j实现Java中的ZIP文件加密压缩的操作方法》本文介绍如何通过Maven集成zip4j1.3.2库创建带密码保护的ZIP文件,涵盖依赖配置、代码示例及加密原理,确保数据安全性,感兴趣的... 目录1. zip4j库介绍和版本1.1 zip4j库概述1.2 zip4j的版本演变1.3 zip4

Python 字典 (Dictionary)使用详解

《Python字典(Dictionary)使用详解》字典是python中最重要,最常用的数据结构之一,它提供了高效的键值对存储和查找能力,:本文主要介绍Python字典(Dictionary)... 目录字典1.基本特性2.创建字典3.访问元素4.修改字典5.删除元素6.字典遍历7.字典的高级特性默认字典

使用Python构建一个高效的日志处理系统

《使用Python构建一个高效的日志处理系统》这篇文章主要为大家详细讲解了如何使用Python开发一个专业的日志分析工具,能够自动化处理、分析和可视化各类日志文件,大幅提升运维效率,需要的可以了解下... 目录环境准备工具功能概述完整代码实现代码深度解析1. 类设计与初始化2. 日志解析核心逻辑3. 文件处

一文详解如何使用Java获取PDF页面信息

《一文详解如何使用Java获取PDF页面信息》了解PDF页面属性是我们在处理文档、内容提取、打印设置或页面重组等任务时不可或缺的一环,下面我们就来看看如何使用Java语言获取这些信息吧... 目录引言一、安装和引入PDF处理库引入依赖二、获取 PDF 页数三、获取页面尺寸(宽高)四、获取页面旋转角度五、判断

C++中assign函数的使用

《C++中assign函数的使用》在C++标准模板库中,std::list等容器都提供了assign成员函数,它比操作符更灵活,支持多种初始化方式,下面就来介绍一下assign的用法,具有一定的参考价... 目录​1.assign的基本功能​​语法​2. 具体用法示例​​​(1) 填充n个相同值​​(2)