FastAPI（52）- Response Cookies 响应设置 Cookies

FastAPI（52）- Response Cookies 响应设置 Cookies 

 

前言

 

有两种实现场景

  • 路径操作函数声明 Response 参数来设置 Cookie
  • 在函数内，通过 return Response 来设置 Cookie

 

路径操作函数声明 Response 参数来设置 Cookie

from fastapi import FastAPI, Response

app = FastAPI()


@app.get("/item")
# 路径操作函数声明一个 Response 类型的参数
async def get_item(response: Response):
    response.set_cookie("test_token", "tokenABC")
    return {"name": "设置Cookie"}
  • 然后可以像往常一样返回需要的任何对象（字典、数据库模型等）
  • 如果声明了一个 response_model，它仍将用于过滤和转换返回的对象
  • FastAPI 将使用该临时响应来提取 cookie（还有 headers、status_code），并将它们放入包含返回值的最终响应中，由任何 response_model 过滤
  • 还可以在依赖项中声明 Response 参数，并在其中设置 cookie、headers

 

请求结果

 

再看看 Application

设置 Cookie 成功啦

 

声明 response_model 和使用依赖项的栗子

from fastapi import FastAPI, Response, Depends
from pydantic import BaseModel

app = FastAPI()


class Item(BaseModel):
    id: str
    name: str


async def depnds_set_cookie(response: Response):
    response.set_cookie("x-depends-token", "************")


@app.get("/item2", dependencies=[Depends(depnds_set_cookie)], response_model=Item)
async def get_item():
    return {"id": "12345", "name": "测试 dependencies和response_model", "age": 24}

 

请求结果

 

通过 return Response 来设置 Cookie

from fastapi import FastAPI, Response
from fastapi.responses import JSONResponse

app = FastAPI()

@app.get("/items")
async def get_item():
    response = JSONResponse(content={"name": "JSONResponse"})
    response.set_cookie("test_token", "ABC_token")
    return response

 

请求结果

 

set_cookie 的源码

它是 Starlette 库的 Response 类里面的方法哦

 

参数详解

参数 作用
key cookie 的键，str
value cookie 的值，str
max_age
  • cookie 的生命周期，以秒为单位，int
  • 负数或0表示立即丢弃该 cookie
expires cookie 的过期时间，以秒为单位，int
path cookie 种在哪个路径之下，默认根路径，str
domain cookie 有效的域，str
secure 如果使用 SSL 和 HTTPS 协议发出请求，cookie 只会发送到服务器，bool
httponly 无法通过 JS 的 Document.cookie、XMLHttpRequest 或请求 API 访问 cookie，bool
samesite
  • 为 cookie 指定相同站点策略，str
  • 有效值：“lax”（默认）、“strict”和“none”

 

posted @ 2022-01-06 12:19  小学弟-  阅读(281)  评论(0)  编辑  收藏  举报