前言
- 前面讲过如何获取 Cookies
- 也顺带提了下如何设置 Response Cookie，还是比较简单的
有两种实现场景
- 路径操作函数声明 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 |
|
expires | cookie 的过期时间，以秒为单位，int |
path | cookie 种在哪个路径之下，默认根路径，str |
domain | cookie 有效的域，str |
secure | 如果使用 SSL 和 HTTPS 协议发出请求，cookie 只会发送到服务器，bool |
httponly | 无法通过 JS 的 Document.cookie、XMLHttpRequest 或请求 API 访问 cookie，bool |
samesite |
|
