kongdeqiang
2026-10-12 7c687dd3c8fba9f7632f5e29d94a708e5f497abd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
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();
}