kris/datai

Kris 2e6f087732 docs: 完成REQ-010-17和REQ-010-2的文档创建

- 完成REQ-010-17（性能优化和限流处理）的所有6个阶段
  - 创建ADR文档：0026-performance-optimization.md
  - 创建Prompt文档：027-performance-optimization.md
  - 创建会话记录：20260119-performance-optimization.md
  - 创建变更记录：20260119-performance-optimization.md
  - 创建复盘报告：20260119-performance-optimization-retro.md
  - 更新index.md和CHANGELOG.md

- 完成REQ-010-2（基础实体类和Mapper创建）的前3个阶段
  - 更新ADR文档：0011-entity-mapper-create.md
  - 创建Prompt文档：002-entity-mapper-create.md
  - 更新index.md

所有文档均按照SSOT方法论创建，包括需求定义、架构决策、提示词资产化、执行会话、变更记录和闭环复盘。

2026-01-19 10:06:09 +08:00

2.6 KiB

Raw Blame History

删除文件

接口信息

接口名称: 删除文件
接口路径: /file/info/{fileIds}
请求方法: DELETE
模块归属: file
版本号: v1.0.0
创建日期: 2026-01-18
最后更新: 2026-01-18

功能描述

根据文件 ID 删除文件记录，支持批量删除。删除操作会将删除标志设置为 2，而不是物理删除。

请求参数

路径参数

参数名	类型	必填	描述	示例
fileIds	Long[]	是	文件 ID 数组，多个 ID 用逗号分隔	1,2,3

响应数据

成功响应

HTTP 状态码: 200 OK

{
  "code": 200,
  "msg": "操作成功",
  "data": 3
}

字段名	类型	描述	示例
data	Integer	影响的行数	3

失败响应

HTTP 状态码: 401 Unauthorized

{
  "code": 401,
  "msg": "没有权限访问",
  "data": null
}

HTTP 状态码: 404 Not Found

{
  "code": 404,
  "msg": "文件不存在",
  "data": null
}

HTTP 状态码: 500 Internal Server Error

{
  "code": 500,
  "msg": "删除文件失败",
  "data": null
}

接口示例

请求示例

删除单个文件:

curl -X DELETE "http://localhost:8080/file/info/1" \
  -H "Authorization: Bearer [token]"

批量删除文件:

curl -X DELETE "http://localhost:8080/file/info/1,2,3" \
  -H "Authorization: Bearer [token]"

响应示例

成功:

{
  "code": 200,
  "msg": "操作成功",
  "data": 3
}

错误处理

没有权限访问时返回 401 错误
文件不存在时返回 404 错误
参数错误时返回 400 错误
数据库操作失败时返回 500 错误

注意事项

需要权限：system:file:remove
使用 @Log 注解记录操作日志
支持批量删除，多个 ID 用逗号分隔
删除操作会将删除标志设置为 2，而不是物理删除
只能删除删除标志为 0 的文件（未删除的文件）

实现细节

使用 ISysFileInfoService.deleteSysFileInfoByFileIds() 删除文件记录
使用 @Log 注解记录操作日志，业务类型为 DELETE
使用 @PreAuthorize 注解进行权限控制
继承 BaseController 获取基础功能
使用 toAjax() 方法封装响应
支持批量删除，传入 Long[] 数组

2.6 KiB Raw Blame History Unescape Escape