1.FastAPI简介

1.1FastAPI是什么？

FastAPI是一个现代的，快速（高性能）python web框架。基于标准的python类型提示，使用python3.6+构建API的Web框架。

FastAPI的主要特点如下：

• 快速：非常高的性能，与NodeJS和Go相当（这个要感谢Starlette和Pydantic），是最快的Python框架之一。

• 快速编码：将开发速度提高约200%到300%。

• 更少的bug：减少大约40%的开发人员人为引起的错误。

• 直观：强大的编辑器支持，调试时间更短。

• 简单：易于使用和学习。减少阅读文档的时间。

• 代码简洁：尽量减少代码重复。每个参数可以声明多个功能，减少程序的bug。

• 健壮：生产代码会自动生成交互式文档。

• 基于标准：基于并完全兼容API的开放标准：OpenAPI和JSON模式。

1.2环境准备

• 安装fastapi

pip install fastapi

• 对于生产环境，还需要一个ASGI服务器，如Uvicorn或Hypercorn

pip install "uvicorn[standard]"

1.3入门示例程序

新建一个main.py，编写如下程序：

from fastapi import FastAPI
​
app = FastAPI()
​
@app.get("/")
def read_root():    
    return {"Hello": "World"}
​
@app.get("/items/{item_id}")
def read_item(item_id: int, q: str = None):    
    return {"item_id": item_id, "q": q}

运行程序：

uvicorn main:app --reload
INFO:     Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
INFO:     Started reloader process [28720]
INFO:     Started server process [28722]
INFO:     Waiting for application startup.
INFO:     Application startup complete.

命令 uvicorn main:app：

• main：文件main.py（Python的“模块”）。

• app：在main.py中app=FastAPI()行中创建的对象。

• --reload：在代码更改后重新启动服务器。

在命令提示符下执行如下命令来检查程序返回结果：（我们使用curl作为请求工具）

C:\Users\Administrator>curl http://127.0.0.1:8000
{"Hello":"World"}
C:\Users\Administrator>curl http://127.0.0.1:8000/items/1
{"item_id":1,"q":null}
C:\Users\Administrator>curl http://127.0.0.1:8000/items/1?q=hello
{"item_id":1,"q":"hello"}

使用异步（async/await）实现同样的功能，定义方法时使用 async def：

from fastapi import FastAPI
​
app = FastAPI()
​
@app.get("/")
async def read_root():    
    return {"Hello": "World"}
​
@app.get("/items/{item_id}")
async def read_item(item_id: int, q: str = None):    
    return {"item_id": item_id, "q": q}