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 第一个程序

python 复制代码
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方法

python 复制代码
app = FastAPI()

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

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

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

参数 描述 默认值 示例值
app 要运行的ASGI应用对象,通常是在模块中定义的如FastAPI或Starlette应用实例。 app(假设app是在当前模块中定义的应用对象)
host 服务器监听的主机地址。 127.0.0.1 0.0.0.0(可以从外部访问)
port 服务器监听的端口号。 8000 8080
reload 是否开启自动重载功能。当代码文件发生变化时自动重新加载应用。 False True(用于开发环境)
workers 工作进程数,用于处理多个并发请求。在生产环境中可以通过增加工作进程来提高性能。 1 4(根据服务器资源和负载情况设置)
loop 指定事件循环类型。如uvloop可以提高性能(如果已安装)。 auto(自动选择合适的循环) uvloop(如果安装了uvloop
http 指定HTTP协议实现。如h11httptools auto(自动选择合适的实现) httptools(如果安装了httptools
ws 指定WebSocket协议实现。 auto(自动选择合适的实现) websockets(如果安装了websockets
lifespan ASGI应用生命周期管理。用于处理应用启动和关闭时的事件。 auto(自动遵循应用定义) on(手动开启生命周期管理)
interface 指定服务器接口类型,如asgi3asgi2。用于兼容不同版本的ASGI规范。 asgi3 asgi2(如果应用遵循ASGI 2规范)
env_file 指定环境变量文件路径。文件中的环境变量会被加载用于配置应用。 ".env"(当前目录下的.env文件)
相关推荐
蹦蹦跳跳真可爱5894 小时前
Python----OpenCV(图像増强——高通滤波(索贝尔算子、沙尔算子、拉普拉斯算子),图像浮雕与特效处理)
人工智能·python·opencv·计算机视觉
nananaij4 小时前
【Python进阶篇 面向对象程序设计(3) 继承】
开发语言·python·神经网络·pycharm
雷羿 LexChien4 小时前
从 Prompt 管理到人格稳定:探索 Cursor AI 编辑器如何赋能 Prompt 工程与人格风格设计(上)
人工智能·python·llm·编辑器·prompt
敲键盘的小夜猫5 小时前
LLM复杂记忆存储-多会话隔离案例实战
人工智能·python·langchain
高压锅_12205 小时前
Django Channels WebSocket实时通信实战:从聊天功能到消息推送
python·websocket·django
胖达不服输7 小时前
「日拱一码」020 机器学习——数据处理
人工智能·python·机器学习·数据处理
吴佳浩7 小时前
Python入门指南-番外-LLM-Fingerprint(大语言模型指纹):从技术视角看AI开源生态的边界与挑战
python·llm·mcp
吴佳浩7 小时前
Python入门指南-AI模型相似性检测方法:技术原理与实现
人工智能·python·llm
叶 落7 小时前
计算阶梯电费
python·python 基础·python 入门
Python大数据分析@8 小时前
Origin、MATLAB、Python 用于科研作图,哪个最好?
开发语言·python·matlab