首先进行FastAPI  Flask  Django

对比维度 FastAPI Flask Django
性能 高(异步支持) 中 较低(同步)
异步支持 内置async/await 需扩展 不原生
数据验证 Pydantic自动校验 手动处理 ORM级验证
自动文档 自动生成 需插件 需扩展
使用场景 API,微服务，AI推理 小型web项目 大型网站

FastAPI基础

为什么异步比同步快10s呢？

同步的执行流程

异步：

第一次创建FastAPI项目

from fastapi import FastAPI

#创建FastAPI实例
app = FastAPI()  

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


@app.get("/hello/{name}")
async def say_hello(name: str):
    return {"message": f"Hello {name}"}
标红的app是实例名有大用处

为什么创建虚拟环境

隔离项目运行环境，避免依赖冲突，保持全局环境的干净和稳定

怎么运行FastAPI项目

run 项目 就是点击绿色的按钮

uvicorn main:app --reload     --reload  更改代码自动重启服务器

怎么访问FastAPI交互式文档

https://127.0.0.1:8000/docs

路由

FastAPI的路由定义基于Python的装饰器模式

同一接口逻辑，根据参数不同返回不同的数据

参数就是客户端发送请求时附带的额外信息和指令

参数的作用是让同一个接口能根据不同的输入，返回不同的输出，实现动态交互

路径参数 查询参数 请求体
位置 URL路径的一部分/book/{id} URL?之后k1=v1&k2=v2 HTTP请求的消息体中
作用 指向唯一的，特定的资源 对资源集合进行过虑，排序，分页等操作 创建，更新资源携带大量数据
方法 GET GET POST,PUT

需求：以用户id为路径参数设计URL,要求响应结果包含用户id和名称(普通用户id)

@app.get("/{user_id}/{id}")
async def get_user(user_id:str,id:int):
    return {"user_id":user_id,"id":id}

路径参数- 类型注解Path:

FastAPI允许为参数声明额外的信息和校验

Path参数 说明
... 必填

gt/ge

lt/le

大于/大于等于

小于/小于等于
description 描述

min_length

max_length

 长度限制 

@app.get("book/{id}")
async def get_book(id:int = Path(...,gt=0,lt=100,description="书本")):
    return {"id":id,"title":f"这是第{id}本书"}

... 好像代表id是必填的

description里面填的，会在上面显示，但是小于和大于啊这些的，如果超出范围，发送的请求会返回错误

需求： 查看书籍的作者,路径参数name,长度范围

@app.get("/author/{name}")
async def get_name(name:str = Path(...,min_length=2,max_length=10)):
    return {"name":name}

路径参数出现在什么位置

URL路径的一部分  /book/{id}

如何为路径参数添加类型注解

Pyhton原生注解和Path注解

@app.get("/{new_id}")
async def get_new_id(new_id:int = Path(...,gt=1,lt=100)):
    return {"new_id":new_id}

@app.get("/{new_name}")
async def get_new_name(new_name:str = Path(...,min_length=2,max_length=10)):
    return {"new_name":new_name}
@app.get("/{new_id}")
async def get_new_id(new_id:int = Path(...,gt=1,lt=100)):
    return {"new_id":new_id}

@app.get("/{new_name}")
async def get_new_name(new_name:str = Path(...,min_length=2,max_length=10)):
    return {"new_name":new_name}

查询参数：

声明的参数不是路径参数时，路径操作函数会把该参数自动解释为查询参数

# 需求 查询新闻->分页 skip:跳过的记录数，limit:返回的记录数 10
@app.get("/news/news_list")
async def get_name_list(skip:int,limit:int = 10):
    return {"skip":skip,"limit":limit}

查询参数出现在什么位置

URL?之后，k1=v1&k2=v2

如何为查询参数添加类型注解？

Pyhton原生注解和Query注解(参数和Path一样)

@app.get("/library")
async def get_price(
        name: str = Query("Python", min_length=3, max_length=255),
      price: float = Query(..., gt=50, lt=100)
):
    return {"name":name,"price":price}

请求体参数

在HTTP协议中，一个完整的请求有三部分组成：

1.请求行： 包含方法，URL，协议版本

2.请求头： 元数据信息

3.请求体： 实际要发送的数据内容

from pydantic import BaseModel
class User(BaseModel):
    username: str
    password: str

@app.post("/register")
async def register(user: User):
    return user

请求体类型的参数注解Field:

导入pydantic的Field函数

请求参数的作用是什么?

创建，更新资源

如何定义，使用请求体参数？

如何为请求体参数添加类型注解？

Python原生注解和Field注解

class User(BaseModel):
    book_name: str = Field(...,min_length=2,max_length=20)
    name:str =Field(...,min_length=2,max_length=10)
    res:str = Field(default="黑马出版社")
    price:int = Field(...,gt=0)

@app.post("/book")
async def get_book(user:User):
    return user

响应类型

响应类型设置方式

装饰器中指定响应类 

场景： 固定返回类型(HTML,纯文本等)

返回响应对象

场景：文本下载，图片，流失响应

装饰器中指定相应类

from fastapi.responses import HTMLResponse
@app.get("/html",response_class=HTMLResponse)
async def get_html():
    return """
    <html>
        <body>
            <h1>这是HTML</h1>
        </body>
    </html>
    """

响应文件格式

FileResponse 是FastAPI提供的专门用于高效返回文件内容的响应类。它能够智能处理文件路径，媒体类型推断，范围请求和缓存头部，是服务静态文件的推荐方式

自定义响应数据类型

response_model是路径操作装饰器的关键参数，它通过一个Pydanticc模型来严格定义和约束API端点的输出格式。

response_model 指定的是News的返回类型

异常处理

对于客户端引发的错误，应使用fastapi.HTTPException来中断正常处理流程，并返回标准错误响应

from fastapi import HTTPException

@app.get("/news/{id}")
async def get_news(id:int):
    id_list = [1,2,3,4,5,6]
    if id not in id_list:
        raise HTTPException(status_code=404,detail="新闻不存在")

    return {"id":id}
# fastapi
Logo
腾讯云开发者社区

腾讯云面向开发者汇聚海量精品云计算使用和开发经验，营造开放的云计算技术生态圈。

更多推荐

终极指南：Flink SQL连接器版本管理从混乱到有序的升级之路

Apache Flink作为流处理领域的佼佼者，其SQL连接器的版本管理一直是开发者面临的核心挑战。本文将系统讲解Flink SQL连接器版本管理的最佳实践，帮助你轻松应对版本兼容性问题，实现从混乱到有序的升级之旅。## 连接器版本管理的常见痛点 😫在Flink应用开发中，连接器版本管理常常让开发者头疼不已。不同版本的连接器可能导致各种兼容性问题，例如API变更、功能差异甚至运行时错误。

avatar 腾讯云开发者社区

Elasticsearch复杂数据类型终极指南：从入门到精通

Elasticsearch作为功能强大的搜索引擎，支持多种复杂数据类型，让开发者能够灵活处理各种结构化和非结构化数据。本文将带你全面了解Elasticsearch中的复杂数据类型，从基础概念到实际应用，助你轻松掌握数据建模的核心技巧。## 内部对象：构建层级化数据结构在Elasticsearch中，对象类型（Object）是最基础的复杂数据类型之一，用于表示具有嵌套关系的数据。例如，我们可

avatar 腾讯云开发者社区

如何快速搭建Neon无服务器PostgreSQL：面向初学者的完整指南

Neon是一款革命性的无服务器PostgreSQL解决方案，它通过分离存储和计算层，实现了自动扩缩容、类代码式数据库分支以及零级扩展能力。本指南将帮助你从零开始搭建Neon开发环境，体验这款创新数据库的强大功能。## 准备工作：环境要求与依赖项在开始搭建Neon环境前，请确保你的系统满足以下要求：- Linux操作系统（推荐Ubuntu 20.04+或Debian 11+）- Git

avatar 腾讯云开发者社区