yuhaibo
|
45d7e34678
|
fix: officeweb.ftl 数值水印缺省值改为字符串，避免按 locale 格式化
上一版给六个数值水印变量用的是数值缺省值（${watermarkAlpha!0.2} 等）。
FreeMarker 按请求的 locale 格式化数值：Accept-Language 为 de-DE / fr-FR 时
0.2 输出成 0,2，ar-EG 时数字变成阿拉伯-印度数字，内联脚本解析失败，
initWaterMark 与 isLoading 都没有定义，xlsx 预览照样起不来——而此时响应是 200、
页面也有 </html>，只看页面完整性看不出来。
改为字符串缺省值，与 WatermarkConfigConstants.DEFAULT_* 的类型一致，原样输出。
已配置的值本来就是字符串，不受影响。
测试改为按 zh-CN / en-US / de-DE / fr-FR / ar-EG 逐个渲染，并逐个断言全部数值
输出；已有配置那条也按 zh-CN / de-DE / ar-EG 跑。改模板前先跑：de-DE、fr-FR
红在 watermark_alpha: 0,2，ar-EG 红在 watermark_x_space: ١٠，其余五条通过；
改后 8 条全过。
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
|
2026-09-27 08:48:33 -07:00 |
|
yuhaibo
|
c4e1929ecf
|
fix: 水印配置缺失时 xlsx 预览白页 —— officeweb.ftl 补上缺省值
未提供外部 config/application.properties 的部署上，预览任何 xlsx 都失败：
FreeMarker 在 officeweb.ftl 第 25 行抛 InvalidReferenceException，点名
watermarkTxt。DEBUG 模式把错误内联进 HTML，页面断在半截 JavaScript 里、
永远没有 </html>，浏览器上是白页或一直转圈，而 HTTP 状态码是 200 ——
看起来像转换超时，不像模板错。
两处叠在一起：
1. 十个 watermark* 请求属性可能整族不存在。WatermarkConfigConstants 没有
类级注解（对比 ConfigConstants 上的 @Component），不是 Spring bean，
那十个 @Value 的 setter 从来不会被调用；唯一填充它们的
ConfigRefreshComponent#loadConfig() 在配置文件不存在时直接 return。
于是十个 getter 全返回 null，AttributeSetFilter 的
setAttribute(name, null) 按 Servlet 规范等同于删除属性。
2. officeweb.ftl 是唯一没有 classic_compatible 兜底的预览模板。
commonHeader.ftl 第 1 行是 <#setting classic_compatible=true>，
所有 include 它的模板在属性缺失时把变量渲染成空串、照常出页面；
officeweb.ftl 既不 include 它、自己也没有这个设置。
缺省值取 WatermarkConfigConstants.DEFAULT_*，watermarkTxt 取空串——
空串会让下一行的 if (watermarkTxt !== '') 跳过 watermark.init()，不会给
所有预览凭空加上水印。其余九个只在水印开着时才用到，但那个 if 是
JavaScript 的、不是模板的，FreeMarker 两条分支都渲染，所以十个都要给。
新增的测试直接用 FreeMarker 渲染这个模板，不需要把服务跑起来：
数据模型里一个 watermark* 都不给（那正是缺陷发生时的情形），断言渲染得出
</html>；另一条把十个值全给上，断言逐个原样渲染，保证缺省值不会盖掉真实配置。
改模板之前先跑过一遍，第一条报 InvalidReferenceException、第二条通过。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
|
2026-09-08 00:54:15 -07:00 |
|