JasperReports-vejledning: Hvad bruges Jasper Report til? Java?

Hvad er JasperReports til Java?

Jasper Rapporter er et open source-rapporteringsværktøj til Java der bruges til rapportering af applikationer. Dette rapporteringsværktøj hjælper med at skrive rigt indhold på skærmen, på printeren eller i en række forskellige filer som HTML, PDF, XLS, RTF, CSV, XML, ODT og TXT. JasperReports kan også bruges til Java-aktiverede applikationer som Java EE eller webapplikationer til at generere dynamisk indhold.

Tre produktnavne optræder sammen i de fleste diskussioner, og at adskille dem tidligt forhindrer forvirring senere på denne side.

Denne side fokuserer på biblioteket og Jaspersoft Studio, fordi disse to komponenter er alt, hvad der kræves for at designe og køre en første rapport. Bemærk, at community-udgaven nu kun dækker disse to komponenter, da JasperReports Server ikke længere tilbydes som en community-download.

Hvorfor bruge Jasper Reports?

Her er mange grunde til at bruge et Jasper-rapportværktøj:

• Det tilbyder rapportgenereringsydelse og levering til brugere.
• Det hjælper dig med at repræsentere dine data i tekst- eller grafisk format.
• Det er en selvstændig og indlejret rapporteringsserver til rapportering kompilering og eksekvering.
• Det tillader rollebaseret adgangskontrol til alle rapporter i lageret.
• Et Spring Security-framework er tilgængeligt til integration med interne autentificeringssystemer.
• Den tilbyder en sikker, planlagt og automatisk leveret interaktiv rapporteringsmotor.
• Du kan integrere rapporter i Java eller ikke-Java applikationer.
• Forskellige formater af rapporter kan eksporteres.
• Det kan generere vandmærker, der lægges over det primære billede.
• Det tilbyder et komplet sæt af SOAP, REST og webtjenester.
• Det giver dig mulighed for at bruge enkelt rapportdata fra flere datakilder.

Da biblioteket er udgivet under LGPL-licensen, kan det bundles i kommercielle produkter uden et gebyr pr. seat, hvilket er grunden til, at mange Java teams vælger det frem for proprietære rapporteringsmotorer.

Funktioner i Jasper Reports

Nu vil vi gennemgå funktionerne i JasperReports.

Her er de vigtige funktioner i Jasper Reports-værktøjet:

• Tilbyder fleksibelt rapportlayout på tværs af bånd, kolonner og områder med frit format.
• Udviklere kan levere data på flere måder, herunder JavaBeans-samlinger, SQL-forespørgsler og XML-dokumenter.
• Flere datakilder kan kombineres i en enkelt rapport via underrapporter og dataadaptere.
• Vandmærker kan også anvendes oven på det primære billede.
• Du kan generere underrapporter, der er indlejret i et overordnet layout.
• Det hjælper dig med at eksportere rapporter i en række forskellige formater som f.eks PDF, HTML, RTF og Microsoft Excel-filer.
• Systemet tillader rapportdefinitioner at inkludere diagrammer som søjlediagrammer, cirkeldiagrammer, linjer og tidsserier.
• Rapportudtryk kan skrives i Java, Groovy eller JavaManuskript.

Disse funktioner eksponeres gennem en fast behandlingssekvens, som beskrives trin for trin i næste afsnit.

Livscyklus for JasperReports

Nu vil vi lære om livscyklussen for JasperReports.

Følgende er den generelle livscyklus for Jasper Reports:

Diagrammet ovenfor viser de fire faser i rækkefølge. Hver fase producerer en fil, der bliver input til den næste fase, hvilket er grunden til, at rækkefølgen aldrig kan vendes om.

Design af rapporten

Dette er det første trin, hvor vi opretter JRXML-filen. Det er et simpelt XML-dokument, der definerer rapportlayoutet. Du kan udvikle denne fil ved hjælp af en hvilken som helst teksteditor eller en rapportdesigner.

Men hvis du bruger rapportdesigneren, kan vi visualisere rapportens layout, og den faktiske struktur af JRXML kan ignoreres.

Udarbejdelse af rapporten

I denne livscyklusfase kompileres den JRXML, der blev bygget i den første fase, og et binært objekt kaldet Jasper-filen (fil med jasper-filtypenavnet) genereres.

Denne kompilering er lavet for at få bedre ydeevne under udførelse. Disse genererede Jasper-filer skal sendes sammen med din applikation for at køre rapporterne.

Udførelse af rapporten

I denne fase samles dataene fra applikationen og udfyldes i det kompilerede rapportformat. Der er en klasse kaldet net.sf.jasperreports.engine.JasperFillManager, som tilbyder funktioner til at udfylde dataene i rapporterne.

Outputtet gemmes i en Jasper print-fil (fil med filtypenavnet jrprint), som kan bruges til at udskrive eller eksportere rapporten.

Eksport af rapporten til det ønskede format

I denne sidste fase skal du eksportere Jasper-udskriftsfilen, som er oprettet tidligere, til ethvert format ved hjælp af klassen JasperExportManager. Da Jasper tilbyder flere eksportformater, kan vi bruge det samme input til at skabe forskellige repræsentationer af dataene.

Sådan installeres Jasper Reports – Miljøopsætning

Lad os nu se den trinvise proces til opsætning af JasperReports-miljøet. Skærmbillederne nedenfor blev taget med installationsprogrammet 6.9. Den nuværende community-udgivelse er 6.21.3, udgivet den 23. april 2024, og rækkefølgen af ​​skærmbilleder er uændret, selvom versionsnummeret i filnavnet er anderledes.

Trin 1) Download jasper reports community-udgave
Gå til dette Link og klik på "Download nu" for at installere Jasper Reports Community-udgaven.

Trin 2) Vælg Jaspersoft Studio CE
Vælg Jaspersoft Studio CE fra community-udgaverne.

Trin 3) Download Jaspersoft Studio
Gå til dette link og klik på knappen Download, og åbn derefter den downloadede installationsfil til dit operativsystem.

Trin 4) Klik på knappen "Accepter"
Følgende skærmbillede vises. Vælg knappen Jeg accepterer.

Trin 5) Vælg placering
Vælg din installationsplacering, og klik på knappen Næste.

Trin 6) Fremskridtet kører nu
Du vil se fremskridtene på næste skærmbillede.

Trin 7) Klik på finish-knappen
På det næste skærmbillede skal du klikke på knappen Afslut.

Trin 8) Fremskridtet er fuldendt
Følgende skærmbillede vises i dit vindue.

Trin 9) Kom i gang
Klik derefter på indstillingen Kom i gang.

Trin 10) Begynd at arbejde med Jasper Reports studio
Følgende skærmbillede vises, og du kan begynde at arbejde med Jasper Reports Studio.

Oprettelse af et eksempel på en rapportskabelon

Lad os nu lære, hvordan man opretter en rapportskabelon i JasperReports.

Rapportskabelonfilen, der bruges i JasperReports, er en simpel XML-fil med filtypenavnet jrxml. Denne fil indeholder jasperReport-tagget som rodelement. JasperReports-frameworket kan håndtere forskellige typer datakilder.

En rapportskabelon designes og oprettes ved hjælp af følgende trin.

Trin 1) Oprettelse af JRXML-filen i Jaspersoft Studio.

1. Gå til indstillingen Fil.
2. Vælg undermenuen Ny.
3. Klik på indstillingen Jasper-rapport.

Trin 2) Valg af den ønskede skabelon.

1. Vælg din skabelon, for eksempel kirsebær.
2. Klik på knappen "Næste".

Trin 3) Valg af en overordnet mappe.

1. Vælg mappen Mine Rapporter.
2. Indtast filnavnet, for eksempel "Cherry Report."
3. Klik på knappen "Næste".

Trin 4) I vinduet Datakilde skal du klikke på knappen "Ny" for at oprette en ny dataadapter.

Trin 5) Valg af dataadapter.

1. Vælg dataadapteren fra listen. For eksempel "Samling af Javabønner."
2. Klik på knappen "Næste".

Trin 6) Indtastning af dataadapteroplysninger og valg af fabriksklasse.

1. Indtast et navn til din adapter.
2. Vælg fabriksklassen ved at klikke på knappen “…”.

Trin 7) Indtastning af præfikset eller mønsteret.

1. Indtast navnepræfikset eller mønsteret.
2. Klik på matchende varer.
3. Klik på knappen “OK”.

Trin 8) Definering af factory-klassen og tilføjelse af stien til jar-filer.

1. Indtast navnet på en statisk metode i fabriksklassen. I dette eksempel på Jasper-rapporter er dette createBeanCollection.
2. Hvis din JavaBeans-definitionen har feltbeskrivelser, og hvis du vil bruge disse som navne i Jaspersoft Studio, skal du markere afkrydsningsfeltet "Brug feltbeskrivelse".
3. Tilføj en sti til dine jar-filer.
4. Klik på knappen “Afslut”.

Trin 9) Klik på knappen "Næste".

Trin 10) Tillykke! Du har nu tilføjet alle nødvendige oplysninger om rapportoprettelse. Klik på knappen "Udfør".

Rapporten vil blive genereret som vist på skærmbilledet nedenfor.

Ovenstående fil kræver kompilering til det binære format JasperReport, som kaldes jasper-filen.

Grænsefladen net.sf.jasperreports.engine.design.JRCompiler, som er en del af JasperReports-biblioteket, spiller en vigtig rolle i kompileringen af ​​denne rapportskabelonfil.

Implementering af denne grænseflade kan skrives ind Java, JavaScript, Groovy, eller et hvilket som helst andet scriptsprog.

Du kan kompilere en JRXML-fil ved hjælp af følgende to metoder:

• Programmatisk kompilering fra Java kode.
• Kompilering ved hjælp af en Apache Ant opgave.

Uddraget nedenfor viser den programmatiske rute, hvor én linje kompilerer skabelonen, og en anden linje udfylder den med en JavaBønnesamling.

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");
    }
}

Output:

Report exported successfully

Forståelse af de forskellige rapportbånd

Et JasperReports-layout er opdelt i vandrette sektioner kaldet bånd. Hvert bånd har en fast udskrivningsregel, og det er forståelsen af ​​disse regler, der giver en designer mulighed for at kontrollere præcis, hvor en værdi vises i det færdige dokument.

Følgende er standardrapportbåndene, der anvendes af de fleste kommercielle rapportgenereringsværktøjer.

• Emne
• Sideoverskrift
• Kolonneoverskrift
• Detalje
• Kolonnesidefod
• Sidefod
• Sidefoden på sidste side
• Resumé
• Gruppeoverskrift
• Gruppefod
• Baggrund
• Ingen data

Lad os lære hvert rapporteringsbånd i detaljer.

Emne

Dette bånd vises i starten af ​​rapporten. Det kan placeres på sin egen første side ved at indstille attributten isTitleNewPage="true".

Sidehoved

Sidehovedbåndet vises i begyndelsen af ​​hver side. Det ekskluderer den første side, hvis titelbåndet bruges, og den sidste side, hvis resumébåndet bruges med indstillingen isSummaryWithPageHeaderAndFooter="false".

Kolonneoverskrift

Kolonneoverskrifter vises før detaljebåndet på hver side.

Detalje

Detaljeafsnittet itereres for hver post i den angivne datakilde. Det er også tilladt at have flere detaljebånd (1, 2 osv.).

Kolonnefod

Dette afsnit vises under detaljebåndet på hver side, hvor detaljebåndet er til stede. Standardindstillingen er slutningen af ​​siden, men dette kan ændres til at være under det sidste detaljebånd ved at indstille attributten isFloatColumnFooter="true".

Sidefod

Dette afsnit vises i slutningen af ​​hver side, eksklusive opsummeringsbåndet, titelbåndet og det sidste ikke-opsummeringsbånd.

Sidefod på sidste side

Dette afsnit vises på den sidste side i stedet for den normale sidefod, når der ikke er angivet et resumé.

Resumé

Oversigtsafsnittet vises kun i slutningen af ​​rapporten på en ny side, når isSummaryNewPage="true" er indstillet, og med sidehoved og sidefod når isSummaryWithPageHeaderAndFooter="true" er indstillet.

Gruppeoverskrift

Dette afsnit vises kun, når det er defineret, hver gang gruppeudtrykket ændres, før detaljebåndet.

Gruppefod

Dette afsnit vises kun, hvis en gruppe er defineret, hver gang før gruppeudtrykket ændres, efter detaljebåndet.

Baggrund

Den vises på alle sider som baggrund for alle andre rapporteringsbånd.

Ingen data

Dette bånd vises, når der ikke er blevet videregivet nogen datakilde, eller datakilden er tom, og whenNoDataType="NoDataSection" er indstillet.

Jasper vs. Pentaho

Nu vil vi lære om forskellen mellem Jasper og Pentaho.

Her er de største forskelle mellem Jasper og Pentaho:

Holdene har allerede investeret i Java stack vælger normalt Jasper, mens teams, der har brug for omfattende dataintegration sammen med rapportering, ofte vælger Pentaho.

Udfordringer, man står over for under oprettelsen af ​​JasperReports

Her er et par udfordringer, du vil støde på, når du opretter Jasper Reports:

• Kerneændringer – når forretningsreglerne ændres eller forbedres, er det nødvendigt at ændre rapportens kernelogik.
• Komplicerede rapporter – underrapporter og krydstabuleringsrapporter er gode eksempler.
• Diagramrapporter eller visuelle diagrammer, for eksempel graf-, XY-linje-, cirkel-, søjle-, tidsserie- og målerdiagrammer.

Ulemper ved at bruge Jasper Reports

Her er ulemperne ved at bruge Jasper Reports.

• Når du først begynder at foretage ændringer i dele af pakken og fjerne funktioner, er det meget vanskeligt at vende tilbage til standardpakkens indstilling.
• Det er for stift, og redigering af linjer og oprettelse af krydstabulaturer er en udfordrende opgave.
• Nogle almindelige opgaver, som f.eks. at angive subtotaler for en grupperet rapport, er nemmere i andre rapportdesignere.
• Jasper kræver, at du kompilerer rapporter, før du kører dem. Det betyder, at rapportudviklere skal have det hele Java SDK installeret.
• Nogle gange, når du redigerer rapporten, viser den ikke den samme forhåndsvisning, som den vises på nettet.

Ofte Stillede Spørgsmål