package com.custom.webui.service;
|
|
import java.util.List;
|
|
/**
|
* 临时附件文本暂存。
|
*
|
* <p><b>为什么需要它</b>:图片的 OCR 文字可能有几千字,中文经 URL 百分号编码后
|
* 一个字约 9 字节,2000 字就是 18KB —— 而 Tomcat 默认请求行上限是 8KB,
|
* 直接塞进 SSE 的 query string 会得到
|
* {@code IllegalArgumentException: Request header is too large},
|
* 前端只看到一个没有正文的 HTTP 400,完全不知道发生了什么。
|
*
|
* <p>所以改成两步:前端先用 POST 把文字存进来换一个 id,
|
* SSE 请求只带这个短 id。
|
*
|
* <p><b>为什么不直接存数据库</b>:这份文字在消息落库时会写进
|
* {@code message.metadata},这里只是「从 OCR 完成到发送消息」之间的中转,
|
* 生命周期只有几秒到几分钟。为几秒的中间态建表不划算,
|
* 用带 TTL 的内存缓存即可;即使进程重启导致丢失,用户重发一次图片即可,
|
* 不会造成数据不一致。
|
*/
|
public interface PendingAttachmentService {
|
|
/**
|
* 暂存一段附件文本,返回可用于检索的短 id。
|
*
|
* @param userId 归属用户,取回时校验,避免 id 被猜到后读到他人内容
|
* @param text 文本内容(图片 OCR 结果等)
|
* @return 短 id
|
*/
|
String store(Long userId, String text);
|
|
/**
|
* 取回并**消费**暂存文本。
|
*
|
* <p>取一次即失效:附件文本只在发送那一次用得上,
|
* 用完立即释放,避免长会话把内存堆满。
|
*
|
* @return 文本;id 不存在、已过期或不属于该用户时返回 null
|
*/
|
String consume(Long userId, String id);
|
|
/** 存放多个附件文本(一次上传多张图时用) */
|
List<String> consumeAll(Long userId, List<String> ids);
|
|
/** 清理过期条目,返回清理数量(供定时任务调用) */
|
int evictExpired();
|
|
/** 当前缓存条目数(供健康检查与调试) */
|
int size();
|
}
|