JasperReports-veiledning: Hva brukes Jasper Report til? Java?

Hva er JasperReports for Java?

Jasper rapporterer er et åpen kildekode-rapporteringsverktøy for Java som brukes til rapportering av applikasjoner. Dette rapporteringsverktøyet hjelper med å skrive rikt innhold på skjermen, til skriveren eller til en rekke filer som HTML, PDF, XLS, RTF, CSV, XML, ODT og TXT. JasperReports kan også brukes til Java-aktiverte applikasjoner som Java EE eller webapplikasjoner for å generere dynamisk innhold.

Tre produktnavn vises sammen i de fleste diskusjoner, og å skille dem tidlig forhindrer forvirring senere på denne siden.

Denne siden fokuserer på biblioteket og Jaspersoft Studio, fordi disse to komponentene er alt som kreves for å designe og kjøre en første rapport. Merk at fellesskapsutgaven nå bare dekker disse to komponentene, siden JasperReports Server ikke lenger tilbys som en fellesskapsnedlasting.

Hvorfor bruke Jasper Reports?

Her er mange grunner til å bruke et Jasper-rapportverktøy:

• Det tilbyr ytelse og levering av rapporter til brukere.
• Det hjelper deg å representere dataene dine i tekstlig eller grafisk format.
• Det er en frittstående og innebygd rapporteringsserver for rapporteringskompilering og utførelse.
• Den tillater rollebasert tilgangskontroll til alle rapporter i depotet.
• Et Spring Security-rammeverk er tilgjengelig for integrasjon med interne autentiseringssystemer.
• Den tilbyr en sikker, planlagt og automatisk levert interaktiv rapporteringsmotor.
• Du kan bygge inn rapporter i Java eller ikke-Java applikasjoner.
• Ulike formater av rapporter kan eksporteres.
• Det kan generere vannmerker som legges over primærbildet.
• Den tilbyr et komplett sett med SOAP, REST og webtjenester.
• Den lar deg bruke enkeltrapportdata fra flere datakilder.

Fordi biblioteket er utgitt under LGPL-lisensen, kan det pakkes inn i kommersielle produkter uten en avgift per sete, noe som er grunnen til at mange Java teamene velger det fremfor proprietære rapporteringsmotorer.

Funksjoner i Jasper Reports

Nå skal vi dekke funksjonene til JasperReports.

Her er de viktigste funksjonene i Jasper Reports-verktøyet:

• Tilbyr fleksibel rapportoppsett på tvers av bånd, kolonner og områder med fritt format.
• Utviklere kan levere data på flere måter, inkludert JavaBeans-samlinger, SQL-spørringer og XML-dokumenter.
• Flere datakilder kan kombineres i én rapport gjennom delrapporter og dataadaptere.
• Vannmerker kan også brukes over hovedbildet.
• Du kan generere delrapporter som er nestet i et overordnet oppsett.
• Det hjelper deg å eksportere rapporter i en rekke formater som PDF, HTML, RTF og Microsoft Excel-filer.
• Motoren tillater at rapportdefinisjoner inkluderer diagrammer som søyle-, kake-, linje- og tidsserier.
• Rapportuttrykk kan skrives i Java, Groovyeller JavaManus.

Disse funksjonene eksponeres gjennom en fast prosesseringssekvens, som neste avsnitt beskriver trinn for trinn.

Livssyklusen til JasperReports

Nå skal vi lære om livssyklusen til JasperReports.

Følgende er den generelle flyten av livssyklusen til Jasper Reports:

Diagrammet ovenfor viser de fire trinnene i rekkefølge. Hvert trinn produserer en fil som blir input for neste trinn, og det er derfor sekvensen aldri kan reverseres.

Utforming av rapporten

Dette blir det første trinnet der vi oppretter JRXML-filen. Det er et enkelt XML-dokument som definerer rapportoppsettet. Du kan utvikle denne filen ved hjelp av et hvilket som helst tekstredigeringsprogram eller en rapportdesigner.

Men hvis du bruker rapportdesigneren, kan vi visualisere rapportens layout, og den faktiske strukturen til JRXML kan ignoreres.

Utarbeidelse av rapporten

I denne livssyklusfasen kompileres JRXML som ble bygget i den første fasen, og et binært objekt kalt Jasper-filen (fil med jasper-filtypen) genereres.

Denne kompileringen er gjort for å få bedre ytelse under utførelse. Disse genererte Jasper-filene skal sendes sammen med applikasjonen din for å kjøre rapportene.

Utførelse av rapporten

På dette stadiet samles dataene fra applikasjonen og fylles ut i det kompilerte rapportformatet. Det er en klasse kalt net.sf.jasperreports.engine.JasperFillManager som tilbyr funksjoner for å fylle ut dataene i rapportene.

Resultatet lagres i en Jasper-utskriftsfil (fil med filtypen jrprint) som kan brukes til å skrive ut eller eksportere rapporten.

Eksport av rapporten til ønsket format

I dette siste stadiet må du eksportere Jasper-utskriftsfilen som er opprettet tidligere til et hvilket som helst format ved å bruke klassen JasperExportManager. Siden Jasper tilbyr flere formater for eksport, kan vi bruke den samme inngangen til å lage ulike representasjoner av dataene.

Slik installerer du Jasper Reports – Miljøoppsett

La oss nå se på den trinnvise prosessen for oppsett av JasperReports-miljøet. Skjermbildene nedenfor ble tatt med installasjonsprogrammet 6.9. Den nåværende fellesskapsversjonen er 6.21.3, publisert 23. april 2024, og rekkefølgen på skjermbildene er uendret, selv om versjonsnummeret i filnavnet er forskjellig.

Trinn 1) Last ned jasper reports community edition
Gå til dette link og klikk på alternativet Last ned nå for å installere Jasper Reports Community-utgaven.

Trinn 2) Velg Jaspersoft Studio CE
Fra fellesskapsutgavene velger du Jaspersoft Studio CE.

Trinn 3) Last ned Jaspersoft Studio
Gå til dette link og klikk på Last ned-knappen, og åpne deretter den nedlastede installasjonsfilen for operativsystemet ditt.

Trinn 4) Klikk på godta-knappen
Følgende skjermbilde vil vises. Velg Jeg godtar-knappen.

Trinn 5) Velg beliggenhet
Velg installasjonsstedet ditt og klikk på Neste-knappen.

Trinn 6) Fremgangen går nå
Du vil se fremdriften på neste skjermbilde.

Trinn 7) Klikk på fullfør-knappen
I neste skjermbilde klikker du på fullfør-knappen.

Trinn 8) Fremdriften er fullført
Følgende skjermbilde vil vises i vinduet ditt.

Trinn 9) Kom i gang
Klikk deretter på alternativet Kom i gang.

Trinn 10) Begynn å jobbe med Jasper Reports studio
Følgende skjermbilde vil vises, og du kan begynne å jobbe med Jasper Reports Studio.

Opprette en rapportmal Eksempel

La oss nå lære hvordan vi lager en rapportmal i JasperReports.

Rapportmalfilen som brukes i JasperReports er en enkel XML-fil med filtypen jrxml. Denne filen inneholder jasperReport-taggen som rotelement. JasperReports-rammeverket kan håndtere forskjellige typer datakilder.

En rapportmal utformes og opprettes ved hjelp av følgende trinn.

Trinn 1) Opprette JRXML-filen i Jaspersoft Studio.

1. Gå til Fil-alternativet.
2. Velg undermenyen Ny.
3. Klikk på alternativet Jasper-rapport.

Trinn 2) Velge ønsket mal.

1. Velg malen din, for eksempel kirsebær.
2. Klikk på "Neste" -knappen.

Trinn 3) Velge en overordnet mappe.

1. Velg Mine rapporter-mappen.
2. Skriv inn filnavnet, for eksempel "Cherry Report."
3. Klikk på "Neste" -knappen.

Trinn 4) I datakildevinduet klikker du på «Ny»-knappen for å opprette en ny dataadapter.

Trinn 5) Velge en dataadapter.

1. Velg dataadapteren fra listeboksen. For eksempel, «Samling av Javabønner."
2. Klikk på "Neste" -knappen.

Trinn 6) Legger inn dataadapterdetaljer og velger fabrikkklasse.

1. Skriv inn et navn for adapteren.
2. Velg fabrikkklassen ved å klikke på «…»-knappen.

Trinn 7) Skrive inn prefikset eller mønsteret.

1. Skriv inn navneprefikset eller mønsteret.
2. Klikk på samsvarende elementer.
3. Klikk på “OK” -knappen.

Trinn 8) Definere fabrikkklassen og legge til banen til jar-filer.

1. Skriv inn navnet på en statisk metode i fabrikkklassen. I dette Jasper-rapporteksemplet er dette createBeanCollection.
2. Hvis din JavaBeans-definisjonen har feltbeskrivelser, og hvis du vil bruke disse som navn i Jaspersoft Studio, merk av for bruk feltbeskrivelse.
3. Legg til en bane til jar-filene dine.
4. Klikk på «Fullfør»-knappen.

Trinn 9) Klikk på "Neste" -knappen.

Trinn 10) Gratulerer! Du har lagt til all nødvendig informasjon for rapportoppretting. Klikk på «Fullfør»-knappen.

Rapporten vil bli generert som vist på skjermbildet nedenfor.

Filen ovenfor krever kompilering til JasperReport binærformat, som kalles jasper-filen.

Grensesnittet net.sf.jasperreports.engine.design.JRCompiler, som er en del av JasperReports-biblioteket, spiller en viktig rolle i kompileringen av denne rapportmalfilen.

Implementering av dette grensesnittet kan skrives inn Java, JavaScript, Groovy, eller et annet skriptspråk.

Du kan kompilere en JRXML-fil ved hjelp av følgende to metoder:

• Programmatisk kompilering fra Java kode.
• Kompilering ved hjelp av en Apache Ant oppgave.

Kodeutdraget nedenfor viser den programmatiske ruten, der én linje kompilerer malen og en annen linje fyller 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");
    }
}

Utgang:

Report exported successfully

Forstå de ulike rapportbåndene

Et JasperReports-layout er delt inn i horisontale seksjoner kalt bånd. Hvert bånd har en fast utskriftsregel, og det å forstå disse reglene er det som lar en designer kontrollere nøyaktig hvor en verdi vises i det ferdige dokumentet.

Følgende er standardrapportbåndene som brukes av de fleste kommersielle rapportgenereringsverktøy.

• Tittel
• Sideoverskrift
• Kolonneoverskrift
• Detalj
• Kolonnebunntekst
• Sidebunntekst
• Bunntekst på siste side
• Sammendrag
• Gruppeoverskrift
• Gruppebunntekst
• Bakgrunn
• Ingen data

La oss lære hvert rapporteringsbånd i detalj.

Tittel

Dette båndet vises i begynnelsen av rapporten. Det kan plasseres på sin egen første side ved å angi attributtet isTitleNewPage="true".

Sideoverskrift

Sidetopptekstfeltet vises på begynnelsen av hver side. Det ekskluderer den første siden hvis tittelfeltet brukes, og den siste siden hvis sammendragsfeltet brukes med innstillingen isSummaryWithPageHeaderAndFooter="false".

Kolonneoverskrift

Kolonneoverskrifter vises foran detaljbåndet på hver side.

Detalj

Detaljdelen itereres for hver post i den oppgitte datakilden. Det er også tillatt å ha flere detaljbånd (1, 2 osv.).

Kolonnebunntekst

Denne delen vises under detaljfeltet på hver side der detaljfeltet finnes. Standardinnstillingen er slutten av siden, men dette kan endres til å plasseres under det siste detaljfeltet ved å angi attributtet isFloatColumnFooter="true".

Sidefot

Denne delen vises på slutten av hver side, unntatt sammendragsbåndet, tittelbåndet og det siste ikke-sammendragsbåndet.

Bunntekst for siste side

Denne delen vises på siste side, i stedet for den vanlige sidebunnteksten, når det ikke er gitt noe sammendragsbånd.

Sammendrag

Sammendragsdelen vises bare på slutten av rapporten på en ny side når isSummaryNewPage="true" er angitt, og med sidetopptekst og -bunntekst når isSummaryWithPageHeaderAndFooter="true" er satt.

Gruppeoverskrift

Denne delen vises bare når den er definert, hver gang gruppeuttrykket endres, før detaljbåndet.

Gruppebunntekst

Denne delen vises bare hvis en gruppe er definert, hver gang før gruppeuttrykket endres, etter detaljbåndet.

Bakgrunn

Den vises på alle sidene som bakgrunn for alle andre rapporteringsbånd.

Ingen data

Dette båndet vises når ingen datakilde ble sendt, eller datakilden er tom og whenNoDataType="NoDataSection" er satt.

Jasper mot Pentaho

Nå skal vi lære om forskjellen mellom Jasper og Pentaho.

Her er de viktigste forskjellene mellom Jasper og Pentaho:

Lagene har allerede investert i Java stack velger vanligvis Jasper, mens team som trenger mye dataintegrasjon ved siden av rapportering ofte velger Pentaho.

Utfordringer du møter når du oppretter JasperReports

Her er noen utfordringer du vil møte når du lager Jasper-rapporter:

• Kjerneendringer – når forretningsreglene endres eller forbedres, er det nødvendig å endre rapportens kjernelogikk.
• Kompliserte rapporter – delrapporter og krysstabellrapporter er gode eksempler.
• Diagramrapporter eller visuelle diagrammer, for eksempel graf-, XY-linje-, sektor-, søyle-, tidsserie- og målediagrammer.

Ulemper ved å bruke Jasper Reports

Her er ulempene med å bruke Jasper Reports.

• Når du først begynner å gjøre endringer i deler av pakken og fjerne funksjoner, er det veldig vanskelig å gå tilbake til standard pakkeinnstillingen.
• Den er for rigid, og redigering av linjer og oppretting av krysstabeller er en utfordrende oppgave.
• Noen vanlige oppgaver, som å angi delsummer for en gruppert rapport, er enklere i andre rapportdesignere.
• Jasper krever at du kompilerer rapporter før du kjører dem. Dette betyr at rapportutviklere må ha hele Java SDK installert.
• Noen ganger når du redigerer rapporten, viser den ikke den samme forhåndsvisningen som den vises på nettet.

Spørsmål og svar