问题抛出

前面我们已经了解了查询参数，但是实际开发中我们可能需要限定参数的类型，长度等其他属性。这个时候我们就需要对查询参数进行校验。

类型我们可以通过显示类型进行限制，但是长度等其他属性我们需要借助 FastApi 的 Query 对象来实现。

实例

实现方式

参数限定，我们需要借助 fastapi 中的 Query 对象来实现。

导入 Query

from fastapi import Query

限定参数最大长度

使用参数：max_length

@app.get('/len')
async def get_len(q:str=Query(...,max_length=2)):
    res = {'name':'phyger'}
    if q:
        res.update({'q':q})
    return res

restful多参数查询_css

从以上测试可知：

查询参数 q 为可选参数、最大长度为 2，超过最大长度 fastapi 将会报错。

限定参数最小长度

使用参数：min_length

@app.get('/len')
async def get_len(q:Optional[str]=Query(None,min_length=2,max_length=5)):
    res = {'name':'phyger'}
    if q:
        res.update({'q':q})
    return res


restful多参数查询_restful多参数查询_02

Query 类型的查询参数必须制定默认值。形如：Query(...,min_length=2,max_length=5)

除了限定长度，我们还可以通过 regex 属性来通过正则表达式限定参数格式

默认查询参数

可选查询参数： 通常我们使用 Optional 类型结合 Query 类型的默认值来实现；

async def get_len(q:Optional[str]=Query(None,min_length=2,max_length=5)):
    pass
async def get_len(q:str=Query(None,min_length=2,max_length=5)):
    pass

以上两种方式都可。

必选查询参数： 通常我们指定 Query 的默认值为...来实现。

async def get_len(q:str=Query(...,min_length=2,max_length=5)):
    pass

当 Optional 类型和...默认参数同时存在的时候，查询参数依然为必选。

多个查询参数

当我们需要设计多个查询参数的时候，我们可以这样写。

from typing import List
from fastapi import Query
@app.get('/len')
async def get_len(q:Optional[List[str]]=Query(...,min_length=2,max_length=5)):
    res = {'name':'phyger'}
    if q:
        res.update({'q':q})
    return res


restful多参数查询_css_03

直接使用 list 也可以

from typing import List
from fastapi import Query
@app.get('/len')
async def get_len(q:Optional[list]=Query(...)):
    res = {'name':'phyger'}
    if q:
        res.update({'q':q})
    return res


restful多参数查询_css_04

更多的元数据

title

Query 的 title 属性可以让我们指定参数的标题，用做提示。

from fastapi import Query
@app.get('/title/')
async def title(name:str = Query(...,title="test title",max_length=5,min_length=2)):
    return {'result':name}

description

from fastapi import Query
@app.get('/title/')
async def title(name:str = Query(...,title="test title",max_length=5,min_length=2,description='test desc')):
    return {'result':name}

doc 中的效果


restful多参数查询_restful多参数查询_05

别名

实际应用中，有时候查询参数可能形如 x-name，这在 python 中不是合法的变量，为了解决类似问题，FastApi 为我们提供了别名 alias 功能。

from fastapi import Query
@app.get('/title/')
async def title(name:str = Query(...,max_length=5,min_length=2,alias='x-name')):
    return {'result':name}


restful多参数查询_restful多参数查询_06

参数弃用

当我们计划在后续版本中废弃参数时，我们可以通过 deprecated 属性来提示用户。

from fastapi import Query
@app.get('/title/')
async def title(name:str = Query(...,max_length=5,min_length=2,alias='x-name',deprecated=True)):
    return {'result':name}

接口文档中的效果


restful多参数查询_restful_07


完

restful多参数查询_css_08