扫描二维码
关注或者微信搜一搜:编程智域 前端至全栈交流与成长
发现1000+提升效率与开发的AI工具和实用程序:https://tools.cmdragon.cn/
基于HTTP协议的标准架构模式,采用资源导向设计理念。在FastAPI中,REST接口通过路径操作装饰器实现:
# 依赖库版本:fastapi==0.68.0, pydantic==1.10.7
from fastapi import FastAPI
from pydantic import BaseModel
app = FastAPI()
class User(BaseModel):
id: int
name: str
email: str
users_db = {1: User(id=1, name="Alice", email="alice@example.com")}
@app.get("/users/{user_id}")
async def get_user(user_id: int):
return users_db.get(user_id)
该实现展示了典型的RESTful端点设计,通过URL路径参数定位资源。请求示例:
GET /users/1 HTTP/1.1
基于类型系统的查询语言,采用单端点设计。FastAPI集成Strawberry实现GraphQL服务:
# 依赖库版本:strawberry-graphql==0.9.4
import strawberry
from fastapi import FastAPI
from strawberry.asgi import GraphQL
@strawberry.type
class User:
id: int
name: str
email: str
@strawberry.type
class Query:
@strawberry.field
def user(self, id: int) -> User:
return User(id=id, name="Bob", email="bob@example.com")
schema = strawberry.Schema(query=Query)
graphql_app = GraphQL(schema)
app = FastAPI()
app.add_route("/graphql", graphql_app)
查询示例:
query {
user(id: 1) {
name
email
}
}
特性 | REST API | GraphQL |
---|---|---|
请求端点 | 多端点 | 单端点 |
数据获取 | 多个请求 | 单请求获取 |
响应结构 | 服务端定义 | 客户端定义 |
版本管理 | URL版本控制 | Schema演化 |
错误处理 | HTTP状态码 | 自定义错误格式 |
缓存机制 | 浏览器级缓存 | 需自定义实现 |
REST接口的典型嵌套数据获取需要多个请求:
GET /users/1
GET /users/1/orders
GET /orders/5/items
GraphQL单次查询实现相同效果:
query {
user(id: 1) {
orders {
items {
productId
quantity
}
}
}
}
FastAPI使用Pydantic模型验证数据格式:
class OrderCreate(BaseModel):
user_id: int
items: List[Item]
@app.post("/orders")
async def create_order(order: OrderCreate):
return process_order(order)
GraphQL的类型定义:
@strawberry.input
class OrderInput:
user_id: int
items: List[ItemInput]
使用Locust进行压力测试(100并发用户):
场景 | RPS | 平均延迟 |
---|---|---|
REST简单查询 | 3420 | 29ms |
GraphQL简单查询 | 2980 | 33ms |
REST复杂关联查询 | 520 | 192ms |
GraphQL复杂查询 | 890 | 112ms |
from fastapi import APIRouter
router = APIRouter()
# REST端点
@router.get("/legacy/users")
async def get_legacy_users():
return [...]
# GraphQL端点
router.add_route("/graphql", graphql_app)
使用DataLoader解决N+1查询问题:
from strawberry.dataloader import DataLoader
async def load_users(keys):
return [await fetch_user(k) for k in keys]
loader = DataLoader(load_fn=load_users)
@strawberry.type
class Query:
@strawberry.field
async def user(self, id: int) -> User:
return await loader.load(id)
在REST接口中如何实现类似GraphQL的字段选择功能?
?fields=name,email
,在响应处理层进行字段过滤GraphQL查询可能引发哪些性能问题?
典型场景:
POST /users
Content-Type: application/json
{"name": "Alice"}
解决方案:
class UserCreate(BaseModel):
name: str
email: str = None
错误特征:
{
"errors": [
{
"message": "Cannot query field 'phone' on type 'User'"
}
]
}
处理步骤:
pip install fastapi==0.68.0
pydantic==1.10.7
strawberry-graphql==0.9.4
uvicorn==0.15.0
uvicorn main:app --reload --port 8000
余下文章内容请点击跳转至 个人博客页面 或者 扫码关注或者微信搜一搜:编程智域 前端至全栈交流与成长
,阅读完整的文章:REST和GraphQL究竟谁才是API设计的终极赢家?
参与评论
手机查看
返回顶部