mirror of
https://gitee.com/technical-laohu/mpay_v2_webman.git
synced 2026-05-09 18:34:26 +08:00
47 lines
1.5 KiB
Markdown
47 lines
1.5 KiB
Markdown
# 文件资产
|
|
|
|
文件资产由后端记录元数据，实际文件交给本地、远程 URL、OSS 或 COS 驱动处理。
|
|
|
|
## 当前入口
|
|
|
|
- API 前缀：`/adminapi/file-asset`
|
|
- 控制器：`FileRecordController`
|
|
- 模型：`FileRecord`
|
|
- 数据表：`ma_file_asset`
|
|
|
|
## 接口
|
|
|
|
| 方法 | 路径 | 作用 |
|
|
| --- | --- | --- |
|
|
| `GET` | `/file-asset/options` | 文件选项 |
|
|
| `GET` | `/file-asset` | 文件列表 |
|
|
| `POST` | `/file-asset/upload` | 上传文件 |
|
|
| `POST` | `/file-asset/import-remote` | 导入远程文件 |
|
|
| `GET` | `/file-asset/{id}/preview` | 文件预览 |
|
|
| `GET` | `/file-asset/{id}/download` | 文件下载 |
|
|
| `GET` | `/file-asset/{id}` | 文件详情 |
|
|
| `DELETE` | `/file-asset/{id}` | 删除文件 |
|
|
|
|
## 服务与驱动
|
|
|
|
- `FileRecordService`
|
|
- `FileRecordQueryService`
|
|
- `FileRecordCommandService`
|
|
- `StorageConfigService`
|
|
- `StorageManager`
|
|
- `LocalStorageDriver`
|
|
- `RemoteUrlStorageDriver`
|
|
- `OssStorageDriver`
|
|
- `CosStorageDriver`
|
|
|
|
## 字段口径
|
|
|
|
- `object_key`：站点相对路径或对象存储 key。
|
|
- `url`：公开文件的完整访问地址，私有文件可以为空。
|
|
- `preview_url`：后台预览使用，不作为长期业务访问地址。
|
|
- `previewable`：列表返回给前端判断是否允许在线预览。
|
|
|
|
## 表单上传
|
|
|
|
系统配置和插件配置中的上传字段仍使用 `type: "upload"`。需要走项目定制选择器时，在 `props.fileUpload` 中声明 `selectorType`、`scene`、`isLocal`、`isPublic`、`getKey` 等配置。前端说明见 [管理后台前端](../frontend/admin.md)。
|