FlaskAPI-初识

​

1 简介

Flask API 是 Flask 的直接替代品，它提供类似于 Django REST 框架提供的可浏览 API的实现。它为你提供适当的内容协商响应和智能请求解析。这是官网的解释，那我们用Flask框架来介绍Flask API。

Flask是一个基于 WSGI（Web Server Gateway Interface）的 Web 框架。WSGI 是一种规范，它定义了 Web 服务器和 Python Web 应用程序之间的接口。Flask 本身遵循这个规范，使得它可以和各种支持 WSGI 的服务器（如 Gunicorn）一起工作。然而，WSGI 有一些局限性。它是同步的，在处理高并发场景（如大量的同时请求）时效率相对较低。例如，当一个请求在等待数据库查询结果或者进行一些耗时的 I/O 操作时，整个线程会被阻塞，其他请求就需要等待。

ASGI（Asynchronous Server Gateway Interface）是 WSGI 的异步版本。它允许应用程序以异步的方式处理请求，能够更好地利用系统资源，提高应用程序的性能和并发处理能力。在现代的 Web 开发中，尤其是在处理大量实时通信（如 WebSockets）或者高并发的 API 场景下，ASGI 的优势就凸显出来了。比如在一个实时聊天应用中，多个用户同时发送消息，ASGI 服务器可以更高效地处理这些并发的 WebSocket 连接。

Uvicorn是ASGI服务器的实现，它基于 uvloop 和 httptools 构建。uvloop 是一个用 Cython 编写的高性能 Python 异步 I/O 循环库，它比标准的 asyncio 事件循环要快很多。Uvicorn 在性能方面表现出色，能够快速地处理请求。例如，在处理大量的 API 请求时，它可以利用异步 I/O，减少请求的等待时间，提高吞吐量。它还支持 HTTP/1.1 和 HTTP/2 协议，能够更好地适应现代网络环境。

2 第一个程序

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"Hello": "World"}

3 启动方式

3.1 命令行启动

uvicorn flask_demo.main:app --reload 

• uvicorn是启动服务器的命令。

• main:app是一个参数，它指定了应用的位置。其中main是 Python 模块的名称（通常是一个.py文件，在这里是main.py，但在命令中不需要写.py后缀），app是在main模块中定义的 ASGI 应用对象（例如在 FastAPI 应用中，app = FastAPI()这一行定义的app对象）。

• –reload是一个可选的参数。它的作用是开启自动重载功能，当然还有其他可选参数例如port、host等。

这是目录的结构：

my_project/
    ├── fask_demo/
    │   └── main.py
    └── other_files/

uvicorn 启动命令中：前的代表包含ASGI实例对象文件的位置，层级用.隔开

3. 2 uvicorn.run方法

app = FastAPI()

@app.get("/")
def read_root():
    return {"Hello": "World"}

if __name__ == '__main__':
    uvicorn.run(app)

当然我们还可以设置一些参数，下面是一些常用参数：