You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
2.3 KiB
2.3 KiB
03 — 图片异步生成
What to build: 缩略图生成管线骨架——ThumbnailRenderer 接口 + 图片类型实现 + 异步生成任务 + 上传触发。新建 ThumbnailRenderer 接口（supports(contentType, ext) + render(originalStream, ext, width, maxHeight)），提供图片实现（Java ImageIO 读取 → 等比缩放固定宽度 200px 上限高度 400px → JPEG 输出）。新建 ThumbnailGenerationTask（@Async），执行流程：从 MinIO 拉原文件 → 调 ThumbnailRenderer.render → 缩略图字节数组写入 MinIO thumbnails/{fileId}.jpg → 更新 thumbnail_status = READY + thumbnail_retry_count = 0。FileApiImpl 的 upload()/uploadDirect()/completeMultipart() 完成后：判断文件类型——图片（jpg/png/webp/gif/bmp）置 PENDING 并提交异步任务，其余类型置 UNSUPPORTED 不提交。本票只覆盖图片类型，PDF/Office 在后续票扩展。完成后上传一张图片，等异步任务跑完，调 02 的 API 即可拿到真缩略图。
Blocked by: 02 — 缩略图 API 读路径 + 占位图
Status: ready-for-agent
ThumbnailRenderer接口：boolean supports(String contentType, String ext)+byte[] render(InputStream original, String ext, int width, int maxHeight)- 图片实现（Java ImageIO）：读取 → 等比缩放至 width=200px，高度上限 400px → JPEG 输出 byte[]
ThumbnailGenerationTask新建（@Async），从 MinIO 拉原文件 → render → 写thumbnails/{fileId}.jpg→ 状态置 READY + retry_count 归零FileApiImpl注入ThumbnailRenderer（作为可选依赖或列表注入，支持后续多实现）和ThumbnailGenerationTaskupload()/uploadDirect()/completeMultipart()完成后判断类型：图片 → 置 PENDING + 提交异步任务；非图片 → 置 UNSUPPORTED- 类型判断逻辑：从扩展名/contentType 判断是否为支持的图片格式（jpg/png/webp/gif/bmp）
- 测试：upload 图片后 → thumbnail_status 初始为 PENDING，异步任务被提交
- 测试：upload 非图片（如 .txt）→ thumbnail_status 初始为 UNSUPPORTED，不提交异步任务
- 测试：completeMultipart 图片后 → 同上 PENDING + 提交
- 测试：异步任务生成成功 → 写 MinIO 缩略图对象 + 状态置 READY + retry_count 归零