随笔 - 214  文章 - 12  评论 - 40  阅读 - 38万

FastAPI Response(三) 定制化的Response

作者：麦克煎蛋   出处：https://www.cnblogs.com/mazhiyong/ 转载请保留这段声明，谢谢！

 

默认情况下，FastAPI会基于JSONResponse来返回Response。

如果我们直接返回Response，数据格式不会被自动转换，并且交互式文档也不会自动生成。

下面是一些常用的Response类型。

Response

Response主类，所有其他的Response都继承自这个类。

它接收以下参数信息：

  • content - str 或者 bytes.
  • status_code - HTTP 状态码.
  • headers - 字符串字典.
  • media_type - media type. 例如"text/html".

FastAPI会自动包含Content-Length，以及Content-Type，charset等头信息。

复制代码
from fastapi import FastAPI, Response

app = FastAPI()


@app.get("/legacy/")
def get_legacy_data():
    data = """<?xml version="1.0"?>
    <shampoo>
    <Header>
        Apply shampoo here.
    </Header>
    <Body>
        You'll have to use soap here.
    </Body>
    </shampoo>
    """
    return Response(content=data, media_type="application/xml")
复制代码

 

我们可以在路径操作装饰器中声明要返回的具体Response类型，返回的内容会被放入到指定的Response中。

并且如果我们指定的Response支持JSON media类型，例如JSONResponse或者UJSONResponse，那么返回的数据就会被自动转换成Pydantic模型(通过response_model指定)。

HTMLResponse

接收文本或者字节内容，返回HTML reponse。

复制代码
from fastapi import FastAPI
from fastapi.responses import HTMLResponse

app = FastAPI()


@app.get("/items/", response_class=HTMLResponse)
async def read_items():
    return """
    <html>
        <head>
            <title>Some HTML in here</title>
        </head>
        <body>
            <h1>Look ma! HTML!</h1>
        </body>
    </html>
    """
复制代码

PlainTextResponse

接收文本或者字节内容，返回纯文本 reponse。

复制代码
from fastapi import FastAPI
from fastapi.responses import PlainTextResponse

app = FastAPI()


@app.get("/", response_class=PlainTextResponse)
async def main():
    return "Hello World"
复制代码

JSONResponse

返回application/json格式的response。FastAPI默认返回的response。

RedirectResponse

返回HTTP重定向。默认状态码为307(临时重定向)。

复制代码
from fastapi import FastAPI
from fastapi.responses import RedirectResponse

app = FastAPI()


@app.get("/typer")
async def read_typer():
    return RedirectResponse("https://typer.tiangolo.com")
复制代码

StreamingResponse

接收一个异步的发生器或者普通的发生器/枚举器，对返回结果流式输出。

复制代码
from fastapi import FastAPI
from fastapi.responses import StreamingResponse

app = FastAPI()


async def fake_video_streamer():
    for i in range(10):
        yield b"some fake video bytes"


@app.get("/")
async def main():
    return StreamingResponse(fake_video_streamer())
复制代码

如果我们有一个file-like对象(比如用open()打开)，我们就可以用StreamingResponse来返回该对象。

复制代码
from fastapi import FastAPI
from fastapi.responses import StreamingResponse

some_file_path = "large-video-file.mp4"
app = FastAPI()


@app.get("/")
def main():
    file_like = open(some_file_path, mode="rb"return StreamingResponse(file_like, media_type="video/mp4")
复制代码

FileResponse

异步流式输出一个文件。

不同于其他response的初始化参数信息：

  • path - 文件路径
  • headers - 定制头信息，字典格式
  • media_type - media type，如果没有设置则会根据文件名或文件路径来推断media type
  • filename - 文件名。如果设置，会被包含到response的Content-Disposition中

文件response会包含合适的Content-Length, Last-Modified 以及 ETag 头信息内容。

复制代码
from fastapi import FastAPI
from fastapi.responses import FileResponse

some_file_path = "large-video-file.mp4"
app = FastAPI()


@app.get("/")
async def main():
    return FileResponse(some_file_path)
复制代码

 

缺省response类

我们可以指定缺省response类，如下我们指定了ORJSONResponse为缺省使用的response类。

复制代码
from fastapi import FastAPI
from fastapi.responses import ORJSONResponse

app = FastAPI(default_response_class=ORJSONResponse)


@app.get("/items/")
async def read_items():
    return [{"item_id": "Foo"}]
复制代码

 

posted on   麦克煎蛋  阅读(7425)  评论(0)  编辑  收藏  举报
编辑推荐：
· 开发者必知的日志记录最佳实践
· SQL Server 2025 AI相关能力初探
· Linux系列：如何用 C#调用 C方法造成内存泄露
· AI与.NET技术实操系列（二）：开始使用ML.NET
· 记一次.NET内存居高不下排查解决与启示
阅读排行：
· 阿里最新开源QwQ-32B，效果媲美deepseek-r1满血版，部署成本又又又降低了！
· 开源Multi-agent AI智能体框架aevatar.ai，欢迎大家贡献代码
· Manus重磅发布：全球首款通用AI代理技术深度解析与实战指南
· 被坑几百块钱后，我竟然真的恢复了删除的微信聊天记录！
· AI技术革命，工作效率10个最佳AI工具
< 2025年3月 >
日 一 二 三 四 五 六
23 24 25 26 27 28 1
2 3 4 5 6 7 8
9 10 11 12 13 14 15
16 17 18 19 20 21 22
23 24 25 26 27 28 29
30 31 1 2 3 4 5

Powered by: 博客园 Copyright © 2025 麦克煎蛋
Powered by .NET 9.0 on Kubernetes
点击右上角即可分享
微信分享提示
AI IDE Trae