Tutorial su JasperReports: a cosa serve JasperReports? Java?

A cosa serve JasperReports Java?

Jasper Reports è uno strumento di reporting open source per Java che viene utilizzato per la creazione di report sulle applicazioni. Questo strumento di reporting aiuta a scrivere contenuti multimediali sullo schermo, sulla stampante o in una varietà di file come HTML, PDF, XLS, RTF, CSV, XML, ODT e TXT. JasperReports può essere utilizzato anche per Java-applicazioni abilitate come Java EE o applicazioni web per generare contenuti dinamici.

Nella maggior parte delle discussioni compaiono insieme tre nomi di prodotti, e separarli fin da subito evita confusione in seguito in questa pagina.

Questa pagina si concentra sulla libreria e su Jaspersoft Studio, poiché questi due componenti sono tutto ciò che serve per progettare ed eseguire un primo report. Si noti che l'edizione Community ora include solo questi due componenti, dato che JasperReports Server non è più disponibile per il download nella versione Community.

Perché utilizzare Jasper Reports?

Ecco molti motivi per utilizzare uno strumento di reporting Jasper:

• Offre prestazioni di generazione e distribuzione di report agli utenti.
• Ti aiuta a rappresentare i tuoi dati in formato testuale o grafico.
• È un server di reporting autonomo e incorporato per la compilazione e l'esecuzione di report.
• Consente il controllo dell'accesso basato sui ruoli a tutti i report nel repository.
• È disponibile un framework Spring Security per l'integrazione con i sistemi di autenticazione interni.
• Offre un motore di reporting interattivo sicuro, programmato e con consegna automatica.
• Puoi incorporare report in Java o nonJava applicazioni.
• È possibile esportare vari formati di report.
• Può generare filigrane sovrapposte all'immagine primaria.
• Offre un set completo di SOAP, REST e servizi Web.
• Consente di utilizzare dati di report singoli provenienti da più origini dati.

Poiché la libreria è rilasciata sotto licenza LGPL, può essere inclusa in prodotti commerciali senza un costo per postazione, motivo per cui molti Java I team lo preferiscono ai sistemi di reporting proprietari.

Caratteristiche di Jasper Report

Ora esamineremo le funzionalità di JasperReports.

Ecco le caratteristiche principali dello strumento Jasper Reports:

• Offre un layout di report flessibile che si articola su fasce, colonne e aree a forma libera.
• Gli sviluppatori possono fornire dati in diversi modi, tra cui: JavaCollezioni di bean, query SQL e documenti XML.
• È possibile combinare più fonti di dati all'interno di un singolo report tramite sottoreport e adattatori di dati.
• È possibile applicare filigrane anche sull'immagine principale.
• È possibile generare sottoreport annidati all'interno di un layout principale.
• Ti aiuta a esportare report in una varietà di formati come PDF, HTML, RTF e Microsoft File Excel.
• Il motore consente di includere nelle definizioni dei report grafici come istogrammi, grafici a torta, grafici a linee e serie temporali.
• Le espressioni di report possono essere scritte in Java, Groovy, o JavaScript.

Queste funzionalità vengono rese disponibili attraverso una sequenza di elaborazione predefinita, che la sezione successiva descrive fase per fase.

Ciclo di vita di JasperReports

Ora analizzeremo il ciclo di vita di JasperReports.

Di seguito viene illustrato il flusso generale del ciclo di vita di Jasper Reports:

Il diagramma qui sopra mostra le quattro fasi in sequenza. Ogni fase produce un file che diventa l'input della fase successiva, motivo per cui la sequenza non può mai essere invertita.

Progettazione del report

Questo sarà il primo passaggio in cui creeremo il file JRXML. Si tratta di un semplice documento XML che definisce il layout del report. È possibile sviluppare questo file utilizzando qualsiasi editor di testo o un programma di progettazione di report.

Tuttavia, se si utilizza lo strumento di progettazione dei report, è possibile visualizzare il layout del report, ignorando la struttura effettiva del file JRXML.

Compilazione del rapporto

In questa fase del ciclo di vita, il file JRXML creato nella prima fase viene compilato e viene generato un oggetto binario chiamato file Jasper (un file con estensione .jasper).

Questa compilazione viene eseguita per ottenere prestazioni migliori durante l'esecuzione. Questi file Jasper generati devono essere spediti insieme all'applicazione per eseguire i report.

Esecuzione del report

In questa fase, i dati dell'applicazione vengono raccolti e compilati nel formato del report compilato. Esiste una classe chiamata net.sf.jasperreports.engine.JasperFillManager che offre funzioni per inserire i dati nei report.

L'output verrà salvato in un file di stampa Jasper (file con estensione jrprint) che potrà essere utilizzato per stampare o esportare il report.

Esportazione del report nel formato desiderato

In quest'ultima fase, è necessario esportare il file di stampa Jasper creato in precedenza in qualsiasi formato utilizzando la classe JasperExportManager. Poiché Jasper offre più formati di esportazione, possiamo utilizzare lo stesso input per creare varie rappresentazioni dei dati.

Come installare Jasper Reports – Configurazione dell'ambiente

Ora, vediamo la procedura passo passo per la configurazione dell'ambiente JasperReports. Gli screenshot seguenti sono stati acquisiti con il programma di installazione 6.9. La versione community corrente è la 6.21.3, pubblicata il 23 aprile 2024, e la sequenza delle schermate è rimasta invariata, sebbene il numero di versione nel nome del file sia diverso.

Passo 1) Scarica l'edizione della community di Jasper Report
Vai a questo vetro e fai clic sull'opzione Scarica ora per installare Jasper Reports Community Edition.

Passo 2) Seleziona Jaspersoft Studio CE
Tra le edizioni community, selezionare Jaspersoft Studio CE.

Passo 3) Scarica Jaspersoft Studio
Vai a questo link e fai clic sul pulsante Scarica, quindi apri il file eseguibile di installazione scaricato per il tuo sistema operativo.

Passo 4) Fai clic sul pulsante "Accetto".
Verrà visualizzata la schermata seguente. Selezionare il pulsante "Accetto".

Passo 5) Scegli la posizione
Seleziona il luogo di installazione e fai clic sul pulsante Avanti.

Passo 6) Il progresso è in corso ora
Vedrai l'avanzamento nella schermata successiva.

Passo 7) Fare clic sul pulsante Fine
Nella schermata successiva, fare clic sul pulsante Fine.

Passo 8) Il progresso è completo
Nella tua finestra apparirà la seguente schermata.

Passo 9) Inizia ora
Successivamente, fai clic sull'opzione "Inizia".

Passo 10) Inizia a lavorare con lo studio Jasper Reports
Verrà visualizzata la schermata successiva e potrai iniziare a lavorare con Jasper Reports Studio.

Esempio di creazione di un modello di report

Ora impariamo come creare un modello di report in JasperReports.

Il file modello di report utilizzato in JasperReports è un semplice file XML con estensione jrxml. Questo file contiene il tag jasperReport come elemento radice. Il framework JasperReports è in grado di gestire diversi tipi di origini dati.

Un modello di report viene progettato e creato seguendo i passaggi descritti di seguito.

Passo 1) Creazione del file JRXML in Jaspersoft Studio.

1. Vai all'opzione File.
2. Selezionare il sottomenu Nuovo.
3. Fai clic sull'opzione Jasper Report.

Passo 2) Selezione del modello desiderato.

1. Seleziona il tuo modello, ad esempio, ciliegia.
2. Fare clic sul pulsante "Avanti".

Passo 3) Selezione di una cartella principale.

1. Seleziona la cartella I miei report.
2. Inserisci il nome del file, ad esempio "Cherry Report".
3. Fare clic sul pulsante "Avanti".

Passo 4) Nella finestra Origine dati, fai clic sul pulsante "Nuovo" per creare un nuovo adattatore dati.

Passo 5) Selezione di un adattatore dati.

1. Seleziona l'adattatore dati dalla casella di riepilogo. Ad esempio, "Raccolta di JavaFagioli."
2. Fare clic sul pulsante "Avanti".

Passo 6) Inserimento dei dettagli dell'adattatore dati e selezione della classe di fabbrica.

1. Inserisci un nome per l'adattatore.
2. Seleziona la classe di fabbrica cliccando sul pulsante “…”.

Passo 7) Inserimento del prefisso o del modello.

1. Immettere il prefisso o il modello del nome.
2. Fai clic sugli elementi corrispondenti.
3. Fare clic sul pulsante "OK".

Passo 8) Definizione della classe factory e aggiunta del percorso ai file jar.

1. Immettere il nome di un metodo statico nella classe factory. In questo esempio di report Jasper, si tratta di createBeanCollection.
2. Se la tua JavaLa definizione dei bean include descrizioni di campo e, se desideri utilizzarle come nomi in Jaspersoft Studio, seleziona la casella di controllo "Usa descrizione campo".
3. Aggiungi un percorso ai tuoi file jar.
4. Fai clic sul pulsante “Fine”.

Passo 9) Fare clic sul pulsante "Avanti".

Passo 10) Congratulazioni! Hai inserito correttamente tutte le informazioni necessarie per la creazione del report. Fai clic sul pulsante "Fine".

Il report verrà generato come mostrato nella schermata sottostante.

Il file sopra riportato richiede la compilazione nel formato binario di JasperReport, che viene chiamato file jasper.

L'interfaccia net.sf.jasperreports.engine.design.JRCompiler, che fa parte della libreria JasperReports, svolge un ruolo importante nella compilazione di questo file modello di report.

L'implementazione di questa interfaccia può essere scritta Java, JavaCopione, Groovyo qualsiasi altro linguaggio di scripting.

È possibile compilare un file JRXML utilizzando i due metodi seguenti:

• Compilazione programmatica da Java codice.
• Compilazione utilizzando un Anti Apache compito.

Il frammento seguente mostra il percorso programmatico, dove una riga compila il modello e una seconda riga lo riempie con un JavaCollezione di fagioli.

import net.sf.jasperreports.engine.*;
import net.sf.jasperreports.engine.data.JRBeanCollectionDataSource;

public class ReportRunner {

    public static void main(String[] args) throws JRException {

        // 1. Compile the JRXML template into a .jasper file
        JasperReport report = JasperCompileManager.compileReport("CherryReport.jrxml");

        // 2. Fill the compiled template with a collection of beans
        JRBeanCollectionDataSource source =
                new JRBeanCollectionDataSource(EmployeeFactory.createBeanCollection());

        JasperPrint print = JasperFillManager.fillReport(report, null, source);

        // 3. Export the filled report to PDF
        JasperExportManager.exportReportToPdfFile(print, "CherryReport.pdf");

        System.out.println("Report exported successfully");
    }
}

Produzione:

Report exported successfully

Comprensione delle diverse fasce di report

Il layout di JasperReports è suddiviso in sezioni orizzontali chiamate bande. Ogni banda ha una regola di stampa fissa e la comprensione di queste regole permette al progettista di controllare con precisione la posizione di un valore nel documento finale.

Di seguito sono riportate le fasce di report standard adottate dalla maggior parte degli strumenti commerciali per la generazione di report.

• Titolo
• Intestazione di pagina
• Intestazione di colonna
• Eccezionale
• Piè di pagina della colonna
• Piè di pagina
• Piè di pagina dell'ultima pagina
• Sintesi
• Intestazione del gruppo
• Piè di pagina del gruppo
• sfondo
• Non ci sono dati

Analizziamo nel dettaglio ciascuna fascia di segnalazione.

Titolo

Questa banda viene mostrata all'inizio del report. Può essere posizionata sulla sua prima pagina impostando l'attributo isTitleNewPage="true".

Intestazione di pagina

La banda dell'intestazione di pagina viene visualizzata all'inizio di ogni pagina. Esclude la prima pagina se viene utilizzata la banda del titolo e l'ultima pagina se viene utilizzata la banda di riepilogo con l'impostazione isSummaryWithPageHeaderAndFooter="false".

Intestazione di colonna

Le intestazioni delle colonne vengono visualizzate prima della fascia dei dettagli su ciascuna pagina.

Eccezionale

La sezione dei dettagli viene iterata per ogni record presente nell'origine dati fornita. È inoltre possibile che contenga più livelli di dettaglio (1, 2 e così via).

Piè di pagina della colonna

Questa sezione appare sotto la banda dei dettagli su ogni pagina in cui è presente la banda dei dettagli. L'impostazione predefinita è la fine della pagina, ma può essere modificata per posizionarsi sotto l'ultima banda dei dettagli impostando l'attributo isFloatColumnFooter="true".

Piè di pagina

Questa sezione verrà visualizzata alla fine di ogni pagina, escludendo la sezione riassuntiva, la sezione del titolo e l'ultima sezione non riassuntiva.

Piè di pagina dell'ultima pagina

Questa sezione compare nell'ultima pagina, al posto del normale piè di pagina, quando non è presente una sezione riassuntiva.

Sintesi

La sezione di riepilogo appare solo alla fine del report su una nuova pagina quando isSummaryNewPage="true" è impostato, e con intestazione e piè di pagina quando isSummaryWithPageHeaderAndFooter="true" è impostato.

Intestazione del gruppo

Questa sezione appare solo quando è definita, ogni volta che cambia l'espressione del gruppo, prima della sezione dei dettagli.

Piè di pagina del gruppo

Questa sezione viene visualizzata solo se è definito un gruppo, ogni volta prima che l'espressione del gruppo cambi, dopo la banda dei dettagli.

sfondo

Viene visualizzato su tutte le pagine come sfondo di tutte le altre bande di segnalazione.

No Data

Questa banda apparirà quando non è stata passata alcuna fonte di dati oppure la fonte di dati è vuota e whenNoDataType="NoDataSection" è impostato.

Jasper contro Pentaho

Ora scopriremo la differenza tra Jasper e Pentaho.

Ecco le principali differenze tra Jasper e Pentaho:

I team hanno già investito nel Java Gli stack di solito scelgono Jasper, mentre i team che necessitano di una forte integrazione dei dati insieme alla reportistica spesso scelgono Pentaho.

Sfide affrontate durante la creazione di JasperReports

Ecco alcune delle sfide che incontrerai durante la creazione di report con Jasper:

• Modifiche fondamentali: quando le regole aziendali cambiano o vengono migliorate, è necessario modificare la logica principale del report.
• Esempi validi sono i report complessi, come i sottoreport e i report a tabella incrociata.
• Report grafici o diagrammi visivi, ad esempio grafici a linee XY, a torta, a barre, a serie temporali e a indicatore.

Svantaggi dell'utilizzo di Jasper Reports

Ecco gli svantaggi derivanti dall'utilizzo di Jasper Reports.

• Una volta che si inizia ad apportare modifiche a parti del pacchetto e a rimuovere funzionalità, è molto difficile tornare alle impostazioni predefinite.
• È troppo rigido e la modifica delle righe e la creazione di tabelle incrociate risultano operazioni complesse.
• Alcune operazioni comuni, come specificare i subtotali per un report raggruppato, sono più semplici in altri strumenti di progettazione di report.
• Jasper richiede la compilazione dei report prima di eseguirli. Ciò significa che gli sviluppatori del report devono avere l'intero file Java SDK installato.
• A volte, quando modifichi il report, non viene mostrata la stessa anteprima di come viene visualizzata sul Web.

DOMANDE FREQUENTI