Overview

This project demonstrates how to generate PDF reports using JasperReports in a Spring Boot web application.

Prerequisites

Before running this project, ensure you have the following installed:

There are two models for generating reports.
- Pre-modeled Reports (with strict validation and mapping).
- Direct Filling Reports (with translation capability) ~ Also referred to as v2.
Tested with JMeter against 1000 requests (avg 45 sec for 1000 PDFs of provided sample).
Support for LTR & RTL languages; Given English and Arabic as an example with the same workflow except for data input.
Notes for different workflows created as "how to" to help users [in progress].
Supported output formats {PDF, XLS, CSV, HTML}.

Load this project on your preferred IDE, e.g., Intellij or Netbeans ...etc. and Maven will load all dependencies and configure directories.
Every Jasperreports workflow starts with the creation of a template, exported to a .jrxml file. This file will be compiled later (during runtime) to a .jasper file.
To create these templates easily, you'll need to use the Jaspersoft Studio.
After exporting your templates from the editor, you can insert them here.
To support multiple languages/locales per record, you'll have to create a template for each reportLocale.
On the first example, I've provided two templates {invoice_en, invoice_ar} representing the two reportLocale implementations of a report called invoice.
You'll have to follow a certain structure/hierarchy for data input. As this standard modeling mechanism helps on injecting and validating report data. See the following figure:

The second example v2 is for getting translated reposts; Also two samples {receipt_en, receipt_ar} were added.
For translation APIs, visit this url to get a free mirror for LibreTranslate.

Provided with two testing templates for both types of models, You can use Postman for testing by importing this collections file.
Also, you can utilize swagger-ui.
A console.sql file is added here to validate the db.

This project is licensed under the MIT License — see the LICENSE file for details.

Special thanks to the JasperReports community for providing a powerful reporting library.
Thanks to the LibreTranslate team for providing a reliable translation service.
Gratitude to the Spring Boot team for making it easy to integrate with Spring applications.