JasperReports ResourceBundle
last modified February 21, 2024
In this article we create a report in multiple languages in JasperReports library. The sources for the example can be found at the author's Github repository.
JasperReports is an open-source reporting library. It can create reports in various formats including PDF, HTML, XLS, or CSV. JasperReports creates page-oriented, ready-to-print documents.
A resource bundle is a Java properties file that contains locale-specific data. It is a way of internationalizing Java applications by making the code locale-independent.
Localized report in JasperReports
The following application creates a report that can be generated in three different languages.
flags ├── england.png ├── russia.png └── slovakia.png in18 ├── labels.properties ├── labels_ru.properties └── labels_sk.properties report.gvy report.xml
This is the project structure.
message=Tea report flag=flags/england.png
These are English properties.
message=Чайный oтчет flag=flags/russia.png
These are Russian properties.
message=Čajový report flag=flags/slovakia.png
These are Slovak properties.
<?xml version = "1.0" encoding = "UTF-8"?>
<!DOCTYPE jasperReport PUBLIC "//JasperReports//DTD Report Design//EN"
"http://jasperreports.sourceforge.net/dtds/jasperreport.dtd">
<jasperReport xmlns = "http://jasperreports.sourceforge.net/jasperreports"
xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation = "http://jasperreports.sourceforge.net/jasperreports
http://jasperreports.sourceforge.net/xsd/jasperreport.xsd"
name="report2" pageWidth="595" pageHeight="842"
columnWidth="555" leftMargin="20" rightMargin="20"
topMargin="20" bottomMargin="20">
<style name="title" fontSize="18" fontName="DejaVu Sans" hAlign="Center" />
<background>
<band height="802">
<staticText>
<reportElement mode="Opaque" x="0" y="0" width="555"
height="802" backcolor="#cccccc"/>
<textElement/>
<text><![CDATA[]]></text>
</staticText>
</band>
</background>
<title>
<band height="200">
<textField>
<reportElement x="0" y="10" width="595" height="25" style="title" />
<textElement />
<textFieldExpression class = "java.lang.String">
<![CDATA[$R{message}]]>
</textFieldExpression>
</textField>
<image>
<reportElement x="15" y="50" width="150" height="100" />
<imageExpression><![CDATA[$R{flag}]]></imageExpression>
</image>
</band>
</title>
</jasperReport>
This is the report template file. It displays a localized text and image.
<background>
<band height="802">
<staticText>
<reportElement mode="Opaque" x="0" y="0" width="555"
height="802" backcolor="#cccccc"/>
<textElement/>
<text><![CDATA[]]></text>
</staticText>
</band>
</background>
Some flags have a white stripe; therefore, we change the background colour of
the report using the backcolor tag.
<textFieldExpression class = "java.lang.String">
<![CDATA[$R{message}]]>
</textFieldExpression>
The message of the report is retrieved from the properties file with the
$R{} syntax.
<image>
<reportElement x="15" y="50" width="150" height="100" />
<imageExpression><![CDATA[$R{flag}]]></imageExpression>
</image>
Similarly, we get the path to the flag with the $R{} syntax. The
path is passed to the imageExpression tag.
package com.zetcode
@Grab(group='net.sf.jasperreports', module='jasperreports', version='6.21.0')
@Grab(group='net.sf.jasperreports', module='jasperreports-fonts', version='6.21.0')
@Grab(group='com.github.librepdf', module='openpdf', version='1.3.39')
import net.sf.jasperreports.engine.JasperCompileManager
import net.sf.jasperreports.engine.JasperFillManager
import net.sf.jasperreports.engine.JasperExportManager
import net.sf.jasperreports.engine.JREmptyDataSource
def xmlFile = "report.xml"
def jrReport = JasperCompileManager.compileReport(xmlFile)
def bundle = ResourceBundle.getBundle("in18/labels", new Locale("ru", "RU"))
def params = ["REPORT_RESOURCE_BUNDLE": bundle]
def jrPrint = JasperFillManager.fillReport(jrReport, params,
new JREmptyDataSource())
JasperExportManager.exportReportToPdfFile(jrPrint, "report.pdf")
The JasperResourceBundle creates a JasperPrint file
from the data source and the report.xml template.
JasperPrintrepresents a page-oriented document that can be viewed,
printed, or exported to other formats.
def xmlFile = "report.xml" def jrReport = JasperCompileManager.compileReport(xmlFile)
The XML template file is compiled into a JasperReport.
JasperReport is a compiled template ready to be filled
with data.
def bundle = ResourceBundle.getBundle("in18/labels", new Locale("ru", "RU"))
A ResourceBundle is created. Is specifies the location of the
properties files and the current locale used.
def params = ["REPORT_RESOURCE_BUNDLE": bundle]
The bundle is passed as a REPORT_RESOURCE_BUNDLE parameter to the
report.
def jrPrint = JasperFillManager.fillReport(jrReport, params,
new JREmptyDataSource())
A JasperPrint object is created; an object that can be viewed,
printed, or exported to other formats. We pass an empty data source and
parameters to the JasperFillManager.fillReport method.
JasperExportManager.exportReportToPdfFile(jrPrint, "report.pdf")
The JasperExportManager.exportReportToPdfFile method exports the
JasperPrint into a PDF file.
In this article we have generated a multi-language report in JasperReports.