package com.custom.webui.config.props;
|
|
import lombok.Data;
|
import org.springframework.boot.context.properties.ConfigurationProperties;
|
|
/**
|
* 会话导出配置,前缀 {@code webui.export}。
|
*/
|
@Data
|
@ConfigurationProperties(prefix = "webui.export")
|
public class ExportProperties {
|
|
/**
|
* PDF 中文字体文件路径,留空时按内置候选列表自动探测。
|
*
|
* <p><b>为什么需要它</b>:PDF 里的中文必须靠**嵌入字体**才能保证任何阅读器
|
* 都能正确显示。PDF 内置的 14 个标准字体(Helvetica 等)只覆盖 Latin-1,
|
* 中文写进去会直接抛 {@code IllegalArgumentException: No glyph for U+4E2D};
|
* 而使用不嵌入的「标准 CJK 字体」(如 STSong-Light + UniGB-UCS2-H)
|
* 虽然不用带字体文件,但 macOS 预览等阅读器未必装了对应字体,
|
* 打开就是一片空白或乱码 —— 导出的文件是给用户长期保存的,
|
* 不能赌对方机器上装了什么。
|
*
|
* <p>所以默认自动探测系统里现成的中文字体(macOS 的 Arial Unicode、
|
* Linux 的 Noto CJK、Windows 的微软雅黑等)。探测失败不会让程序起不来,
|
* 只是 PDF 导出会返回一条带操作指引的错误,TXT / JSON 导出不受影响。
|
*/
|
private String pdfFontPath = "";
|
|
/**
|
* 单次导出最多包含的消息条数。
|
*
|
* <p>防止一条超长对话生成几十兆的 PDF 把内存和响应时间拖垮;
|
* 超出时会截断并在文件末尾写明「已截断」。
|
*/
|
private int maxMessages = 2000;
|
|
/**
|
* 单条消息正文进入导出文件的字符上限。
|
*
|
* <p>比 maxMessages 更常见的失控来源其实是**单条**超长消息
|
* (比如把一整篇文档粘进对话)。
|
*/
|
private int maxCharsPerMessage = 20000;
|
}
|