kris/datai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
dd3c36207e
datai/datai-scenes/datai-scene-salesforce/docs/api-docs/file/SysFileInfoController/index.md
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

3.2 KiB
Raw Blame History

SysFileInfoController 接口文档

概述

SysFileInfoController 提供文件信息管理接口，包括文件列表查询、导出、新增、修改、删除等功能。用于管理系统中所有文件的元数据信息。

接口列表

查询接口

接口名称 接口路径 请求方法 说明
查询文件列表 /file/info/list GET 查询文件列表，支持分页和条件过滤
获取文件详细信息 /file/info/{fileId} GET 根据文件 ID 获取文件详细信息

管理接口

接口名称 接口路径 请求方法 说明
新增文件 /file/info POST 新增文件记录
修改文件 /file/info PUT 修改文件信息
删除文件 /file/info/{fileIds} DELETE 删除文件记录，支持批量删除

导出接口

接口名称 接口路径 请求方法 说明
导出文件列表 /file/info/export POST 导出文件列表到 Excel

数据模型

SysFileInfo

字段名 类型 描述 必填
fileId Long 文件主键 否（新增时自动生成）
fileName String 原始文件名 是
filePath String 统一逻辑路径（/开头） 是
storageType String 存储类型（local/minio/oss） 是
fileType String 文件类型/后缀 否
fileSize Long 文件大小（字节） 否
md5 String 文件MD5 否
createBy String 创建人 否（自动设置）
createTime String 创建时间 否（自动设置）
updateBy String 更新人 否（自动设置）
updateTime String 更新时间 否（自动设置）
delFlag String 删除标志（0代表存在 2代表删除） 否（默认为0）

权限说明

所有接口都需要认证，具体权限如下：

接口 权限
查询文件列表 system:file:list
导出文件列表 system:file:export
获取文件详细信息 system:file:query
新增文件 system:file:add
修改文件 system:file:edit
删除文件 system:file:remove

使用流程

文件信息查询流程

  1. 调用 查询文件列表 查询文件列表
  2. 使用 fileId 调用 获取文件详细信息 获取详细信息

文件信息管理流程

  1. 调用 新增文件 创建文件记录
  2. 调用 修改文件 更新文件信息
  3. 调用 删除文件 删除文件记录

文件导出流程

  1. 调用 导出文件列表 导出文件列表到 Excel
  2. 浏览器会自动下载 Excel 文件

注意事项

  1. 所有接口都需要认证（需要携带 Authorization 头）
  2. 文件路径必须以 / 开头
  3. 存储类型必须是有效的值：local、minio、oss
  4. 删除操作是逻辑删除，将 delFlag 设置为 2
  5. 只能查询和操作删除标志为 0 的文件（未删除的文件）
  6. 支持批量删除，多个 fileId 用逗号分隔

相关文档