如何通过外部JSON控制Jaspersoft报表本地化语言？

问题原因 #

报表设计界面中直接配置Localization/LocaleReport_$F{language}作为Resource Bundle路径无法生效，核心原因是Resource Bundle的路径属于编译阶段解析的静态配置，而$F{language}是运行时才会获取的字段值，编译阶段无法识别该变量，因此无法动态加载对应语言的资源包。手动指定_en或_de属于静态路径，编译时能直接定位到资源文件，所以可以正常工作。

可行解决方案 #

1. 通过报表参数传递语言编码，动态加载全局Resource Bundle

适合整个报表统一使用一种语言的场景：

• 第一步：在报表中创建参数p_language，类型设为java.lang.String，用于接收外部JSON传入的语言编码（如"en"、"de"）。
• 第二步：在报表的Initialize Script中添加Groovy代码，根据参数值加载对应资源包并设置为全局资源：

String langCode = $P{p_language};
Locale targetLocale = new Locale(langCode);
ResourceBundle bundle = ResourceBundle.getBundle("Localization.LocaleReport", targetLocale);
$P{REPORT_PARAMETERS_MAP}.put(JRParameter.RESOURCE_BUNDLE, bundle);

• 第三步：调用报表时，从外部JSON提取语言编码传入p_language参数即可。

2. 在文本框表达式中直接动态获取多语言文本

如果需要逐行控制语言（比如每行数据对应不同语言），可跳过全局Resource Bundle配置，直接在文本框表达式中编写逻辑：

// 根据当前行的language字段加载资源包，获取指定键的文本
ResourceBundle.getBundle("Localization.LocaleReport", new Locale($F{language})).getString("report.title")

注意：这种方式会增加运行时资源包加载次数，数据量大时可能影响性能，仅适合小数据量场景。

3. Java代码调用报表时直接传入Resource Bundle

若通过自定义Java程序调用报表，可提前解析外部JSON的语言编码，加载资源包后传入报表参数：

import net.sf.jasperreports.engine.JasperFillManager;
import net.sf.jasperreports.engine.JasperPrint;
import net.sf.jasperreports.engine.JRParameter;

import java.util.HashMap;
import java.util.Locale;
import java.util.ResourceBundle;

// 从外部JSON解析语言编码
String langCode = "en"; // 替换为实际JSON获取的值
Locale locale = new Locale(langCode);
ResourceBundle bundle = ResourceBundle.getBundle("Localization.LocaleReport", locale);

// 构建报表参数
HashMap<String, Object> params = new HashMap<>();
params.put(JRParameter.RESOURCE_BUNDLE, bundle);

// 填充报表
JasperPrint jasperPrint = JasperFillManager.fillReport("path/to/your/report.jasper", params, dataSource);

内容的提问来源于stack exchange，提问作者Tim Quartier