mirror of
https://github.com/fastapiadmin/FastapiAdmin.git
synced 2026-09-20 20:39:55 +00:00
zhangtao
c2ca6d19ac
style: 统一代码风格和格式 docs: 完善函数和方法的文档字符串 refactor(base_model): 移除冗余的表名和表参数生成方法 refactor(constant): 更新返回码注释格式 refactor(router_class): 添加路由处理器的详细文档 refactor(database): 完善数据库连接函数的文档 refactor(security): 添加认证类和方法的详细文档 refactor(validator): 更新验证器函数的文档格式 refactor(serialize): 优化序列化工具类的文档 refactor(response): 完善响应类的文档字符串 refactor(dependencies): 添加依赖函数的详细文档 refactor(initialize): 完善初始化脚本的文档 refactor(plugin): 添加生命周期和中间件注册的文档 refactor(service): 完善服务层方法的文档 refactor(controller): 添加控制器方法的详细文档 refactor(crud): 完善CRUD操作的文档字符串 refactor(schema): 简化模型类并移除冗余字段 refactor(param): 更新查询参数类的注释格式 refactor(template): 优化代码生成模板的格式 refactor(console): 添加控制台输出功能的实现 refactor(util): 完善工具函数的文档字符串
43 lines
1.5 KiB
Python
43 lines
1.5 KiB
Python
# -*- coding: utf-8 -*-
|
|
|
|
from typing import Optional
|
|
from fastapi import Query
|
|
|
|
|
|
class PaginationQueryParam:
|
|
"""分页查询参数基类"""
|
|
|
|
def __init__(
|
|
self,
|
|
page_no: Optional[int] = Query(default=None, description="当前页码", ge=1),
|
|
page_size: Optional[int] = Query(default=None, description="每页数量", ge=1, le=100),
|
|
order_by: Optional[str] = Query(default=None, description="排序字段,格式:field1,asc;field2,desc"),
|
|
) -> None:
|
|
"""
|
|
初始化分页查询参数。
|
|
|
|
参数:
|
|
- page_no (int | None): 当前页码，默认 None。
|
|
- page_size (int | None): 每页数量，默认 None，最大 100。
|
|
- order_by (str | None): 排序字段，格式 'field,asc;field2,desc'。
|
|
|
|
返回:
|
|
- None
|
|
"""
|
|
self.page_no = page_no
|
|
self.page_size = page_size
|
|
# 将字符串格式的order_by转换为服务层需要的List[Dict[str, str]]格式
|
|
if order_by:
|
|
try:
|
|
self.order_by = []
|
|
for item in order_by.split(';'):
|
|
if item.strip():
|
|
field, direction = item.split(',', 1)
|
|
self.order_by.append({field.strip(): direction.strip().lower()})
|
|
except ValueError:
|
|
# 如果解析失败，使用默认排序
|
|
self.order_by = [{'id': 'asc'}]
|
|
else:
|
|
self.order_by = [{'id': 'asc'}]
|
|
|