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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
package com.custom.webui.service;
 
import com.custom.webui.exception.BusinessException;
 
/**
 * 会话导出服务:把一个对话导出成 JSON / TXT / PDF。
 *
 * <p>三者的定位不同,不是同一份内容换三种后缀:
 * <ul>
 *   <li><b>JSON</b> —— 给程序用的。除当前显示的分支外,还带上扁平的全量消息
 *       (含 parentId),因此**分支结构不会丢**,可以完整还原消息树。</li>
 *   <li><b>TXT</b> —— 给人看的纯文本,随便什么工具都能打开、能 grep。</li>
 *   <li><b>PDF</b> —— 用于归档、打印、发给别人。中文字体按子集嵌入,
 *       在任何阅读器里都能正确显示。</li>
 * </ul>
 */
public interface ChatExportService {
 
    /** 导出格式 */
    enum Format {
        JSON, TXT, PDF;
 
        /** 解析格式参数,不认识的值直接报错而不是悄悄按默认值处理 */
        public static Format parse(String raw) {
            if (raw == null || raw.isBlank()) {
                return TXT;
            }
            for (Format f : values()) {
                if (f.name().equalsIgnoreCase(raw.trim())) {
                    return f;
                }
            }
            throw BusinessException.badRequest(
                    "不支持的导出格式:" + raw + "(可选 json / txt / pdf)");
        }
 
        public String extension() {
            return name().toLowerCase();
        }
 
        public String contentType() {
            return switch (this) {
                case JSON -> "application/json;charset=UTF-8";
                case TXT -> "text/plain;charset=UTF-8";
                case PDF -> "application/pdf";
            };
        }
    }
 
    /**
     * 导出结果。
     *
     * @param data        文件字节
     * @param filename    建议的文件名(已做非法字符清洗)
     * @param contentType MIME 类型
     */
    record ExportFile(byte[] data, String filename, String contentType) {
    }
 
    /**
     * 导出一个会话。
     *
     * @throws com.custom.webui.exception.BusinessException 会话不存在或不属于该用户(404)
     */
    ExportFile export(Long userId, Long chatId, Format format);
}