package com.custom.webui.service; import java.util.List; /** * 临时附件文本暂存。 * *

为什么需要它:图片的 OCR 文字可能有几千字,中文经 URL 百分号编码后 * 一个字约 9 字节,2000 字就是 18KB —— 而 Tomcat 默认请求行上限是 8KB, * 直接塞进 SSE 的 query string 会得到 * {@code IllegalArgumentException: Request header is too large}, * 前端只看到一个没有正文的 HTTP 400,完全不知道发生了什么。 * *

所以改成两步:前端先用 POST 把文字存进来换一个 id, * SSE 请求只带这个短 id。 * *

为什么不直接存数据库:这份文字在消息落库时会写进 * {@code message.metadata},这里只是「从 OCR 完成到发送消息」之间的中转, * 生命周期只有几秒到几分钟。为几秒的中间态建表不划算, * 用带 TTL 的内存缓存即可;即使进程重启导致丢失,用户重发一次图片即可, * 不会造成数据不一致。 */ public interface PendingAttachmentService { /** * 暂存一段附件文本,返回可用于检索的短 id。 * * @param userId 归属用户,取回时校验,避免 id 被猜到后读到他人内容 * @param text 文本内容(图片 OCR 结果等) * @return 短 id */ String store(Long userId, String text); /** * 取回并**消费**暂存文本。 * *

取一次即失效:附件文本只在发送那一次用得上, * 用完立即释放,避免长会话把内存堆满。 * * @return 文本;id 不存在、已过期或不属于该用户时返回 null */ String consume(Long userId, String id); /** 存放多个附件文本(一次上传多张图时用) */ List consumeAll(Long userId, List ids); /** 清理过期条目,返回清理数量(供定时任务调用) */ int evictExpired(); /** 当前缓存条目数(供健康检查与调试) */ int size(); }