一文掌握异步web框架FastAPI（一）-- 基础、路由、请求体

WSGI (Web Server Gateway Interface): 是一种 Python 标准，定义了 Web 服务器与 Python Web 应用之间的接口。传统的 Python Web 框架如 Flask 和 Django 使用的是 WSGI。
ASGI (Asynchronous Server Gateway Interface): 是 WSGI 的异步版本，设计用于支持异步代码。FastAPI、Quart 和 Sanic 等现代 Web 框架使用 ASGI。

2、Uvicorn 的特点

高性能: Uvicorn 利用了 asyncio 和 uvloop (一个快速的 asyncio 事件循环)，可以处理大量并发连接，适合高流量网站。
异步支持: Uvicorn 支持异步代码，可以更好地利用硬件资源，减少阻塞等待的时间。
简单易用: Uvicorn 提供了一个简单的命令行工具来启动应用，同时也支持配置文件。

二、一个简单的FastAPI 应用

模块：main.py

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def root():
    return {"message": "Hello World"}

通过命令行启动应用(切到main.py目录下)：

uvicorn main:app --reload

或者在main脚本中直接启动uvicorn:

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def root():
    return {"message": "Hello World"}


# 运行服务器
if __name__ == "__main__":
    import uvicorn

    uvicorn.run(app, host="localhost", port=8000)

此时访问 http://localhost:8000（http://127.0.0.1:8000） 就可以看到返回的 JSON 对象。

三、路由参数与请求体

1. 基础路由

FastAPI 支持常见的 HTTP 方法，如 GET、POST、PUT、DELETE 等。


from fastapi import FastAPI

app = FastAPI()


@app.get("/items/{item_id}")
async def read_item(item_id: int):
    return {"item_id": item_id}


@app.post("/items/")
async def create_item(item: dict):
    return item


@app.put("/items/{item_id}")
async def update_item(item_id: int, item: dict):
    return {"item_id": item_id, **item}


@app.delete("/items/{item_id}")
async def delete_item(item_id: int):
    return {"item_id": item_id}

定义一个发送请求的脚本：


import requests
import json


def festapi_request(method, url, headers=None, params=None):
    if method == 'GET':
        response = requests.get(url, params=params, headers=headers)
    elif method == 'POST':
        response = requests.post(url, data=params, headers=headers)

    elif method == 'PUT':
        response = requests.put(url, data=params, headers=headers)

    elif method == 'DELETE':
        response = requests.delete(url, params=params, headers=headers)

    else:
        raise ValueError('只支持GET、POST、PUT、DELETE请求')

    print(f'{method}, resp: {response.json()}')
    return response.json()


if __name__ == '__main__':

    get_resp = festapi_request('GET', 'http://127.0.0.1:8000/items/1