优化更新

2026-09-13 20:29:19 +08:00
parent d7a081e8b7
commit 74f41f651f
65 changed files with 1061 additions and 1321 deletions
@@ -4,22 +4,22 @@
 `src/common/utils/request.py` 提供请求数据解析相关的工具函数，包括批量 ID 解析、SQL LIKE 安全处理、分页参数解析等。这些工具函数在各业务模块中广泛使用。
 :::

-## parse_id_list
+## parse_batch_ids

 从请求体解析批量删除的 ID 数组，校验并转为整数列表。

 ```python
 from flask import request
-from src.common.utils.request import parse_id_list
+from src.common.utils.request import parse_batch_ids

-def parse_id_list(request) -> list:
+def parse_batch_ids(request) -> list:
    """
    从请求体解析 ID 数组
    请求体格式: [1, 2, 3]
    返回: [1, 2, 3]

    示例:
-    >>> parse_id_list(request)
+    >>> parse_batch_ids(request)
    [1, 2, 3]
    """
    ids = request.get_json()
@@ -38,9 +38,9 @@ def parse_id_list(request) -> list:
@position_blue.route('/batchDelete', methods=['DELETE'])
@check_permission('sys:position:batchDelete')
 def batch_delete():
-    from src.modules.system.position.service import batch_delete_positions
-    id_list = parse_id_list(request)
-    return batch_delete_positions(id_list)
+    from src.modules.system.position.service import delete_positions
+    id_list = parse_batch_ids(request)
+    return delete_positions(id_list)
 ```

 ## parse_request_body
@@ -207,4 +207,4 @@ def get_client_ip() -> str:

 ## 总结

-请求解析工具函数覆盖了批量操作、模糊查询安全、分页参数等常见场景。`parse_id_list` 和 `parse_pagination` 通过防御性校验避免畸形参数导致 500 错误，`like_escape` 防止 LIKE 通配符注入，`parse_request_body` 使用 WTForms 进行参数校验。
+请求解析工具函数覆盖了批量操作、模糊查询安全、分页参数等常见场景。`parse_batch_ids` 和 `parse_pagination` 通过防御性校验避免畸形参数导致 500 错误，`like_escape` 防止 LIKE 通配符注入，`parse_request_body` 使用 WTForms 进行参数校验。