JasperReports 国际化简介

JasperReports 是一个用于创建和管理报表的框架，其中包括图形化的设计工具 - iReport 和 JasperStudio。国际化是指为了适应不同国家或地区而添加的本地化功能。

为什么需要国际化？

当您的应用程序被部署到多个国家或地区时，您会发现您需要适应每个不同的市场来满足当地用户的需求。这是需要国际化的原因。

具体来说，JasperReports 国际化的主要目的是：

• 提供多语言支持
• 提供多重货币支持
• 提供本地日期和时间格式支持

如何进行国际化？

JasperReports 国际化功能需要您运用一些工具和技巧：

• ResourceBundle 类。ResourceBundle 类使得您可以将内置资源捆绑到程序中，该类具有诸如获取本地化字符串和日期格式之类的方法。
• Localization tags 在您的报告中添加 CSS 以使用 JasperReport 标记，以便它们能够使用 ResourceBundle 类。
• Parameter Mapping。JasperReports 允许您在您的应用程序中传递参数以实现本地化。例如，您可以传递日期格式，以便 JasperReports 可以为不同地区使用不同的日期格式。

如何实现 JasperReports 国际化？

下面是一个简单的教程，说明如何在您的 JasperReports 报表中实现国际化：

第一步：准备属性文件

首先，你需要为您的 JasperReports 报表准备资源文件，并将其命名为 reportBundle.properties 文件。在资源文件中您需要添加键值对，用于将键值映射到本地化字符串。

hello.world.message=Hello World!
good.morning.message=Good morning!
currency=USD
date.format=dd/MM/yyyy
time.format=HH:mm:ss

第二步：使用 ResourceBundle 类

接下来，您需要将 ResourceBundle 类用于获取本地化字符串和日期格式。在 iReport 的 Report Properties 窗口中添加以下代码：

public class LocaleHelper {
    private static ResourceBundle bundle;

    static {
        Locale locale = new Locale("en_US");
        bundle = ResourceBundle.getBundle("reportBundle", locale);
    }
    public static String getLocalized(String key){
        return bundle.getString(key);
    }
}

在报表中，您需要添加 Localization tags 以便 JasperReport 可以使用 ResourceBundle 类。

例如，在 iReport 中，您可以使用以下标记来获取显示本地日期：

<textField>
    <reportElement x="0" y="0" width="140" height="20" uuid="a152f6a7-17ba-49fd-afc1-09e13439a842"/>
    <textFieldExpression><![CDATA[new java.text.SimpleDateFormat($P{REPORT_PARAMETERS_MAP}.get("date.format")).format($F{dateField})]]></textFieldExpression>
</textField>

第三步：传递参数

最后，您需要传递您所需的参数，以便您的 JasperReports 报表能够正确地使用本地化。

您可以使用 JasperReports 的 Parameter Mapping 功能来实现此目的。在 Java 代码中传递参数以实现本地化：

Map<String, Object> params = new HashMap<>();
params.put("REPORT_LOCALE", new Locale("en_US"));
params.put("currency", "USD");
params.put("date.format", "dd/MM/yyyy");
params.put("time.format", "HH:mm:ss");
JasperPrint jasperPrint = JasperFillManager.fillReport(report, params, data);

在 JasperReports 报表中，您可以引用传递的参数以实现本地化。例如：

<textField>
    <reportElement x="0" y="0" width="140" height="20" uuid="a152f6a7-17ba-49fd-afc1-09e13439a842"/>
    <textFieldExpression><![CDATA[new java.text.SimpleDateFormat($P{REPORT_PARAMETERS_MAP}.get("date.format")).format($F{dateField})]]></textFieldExpression>
</textField>

结论

JasperReports 国际化功能是多语言应用程序的必备功能之一。通过使用 ResourceBundle 类和 Parameter Mapping 功能，您可以轻松地为您的 JasperReports 报表添加本地化支持。