Εκπαιδευτικό βίντεο JasperReports: Σε τι χρησιμεύει το Jasper Report; Java?

Σε τι χρησιμεύει το JasperReports Java?

JasperReports είναι ένα εργαλείο αναφοράς ανοιχτού κώδικα για Java που χρησιμοποιείται για την αναφορά εφαρμογών. Αυτό το εργαλείο αναφοράς βοηθά στην εγγραφή πλούσιου περιεχομένου στην οθόνη, στον εκτυπωτή ή σε μια ποικιλία αρχείων όπως HTML, PDF, XLS, RTF, CSV, XML, ODT και TXT. Το JasperReports μπορεί επίσης να χρησιμοποιηθεί για Java-Ενεργοποιημένες εφαρμογές όπως Java Εφαρμογές EE ή web για τη δημιουργία δυναμικού περιεχομένου.

Τρία ονόματα προϊόντων εμφανίζονται μαζί στις περισσότερες συζητήσεις και ο έγκαιρος διαχωρισμός τους αποτρέπει τη σύγχυση αργότερα σε αυτήν τη σελίδα.

Αυτή η σελίδα εστιάζει στη βιβλιοθήκη και στο Jaspersoft Studio, επειδή αυτά τα δύο στοιχεία είναι όλα όσα απαιτούνται για τον σχεδιασμό και την εκτέλεση μιας πρώτης αναφοράς. Σημειώστε ότι η έκδοση κοινότητας καλύπτει πλέον μόνο αυτά τα δύο στοιχεία, καθώς ο JasperReports Server δεν προσφέρεται πλέον ως λήψη από την κοινότητα.

Γιατί να χρησιμοποιήσετε το Jasper Reports;

Ακολουθούν πολλοί λόγοι για τη χρήση ενός εργαλείου αναφοράς Jasper:

• Προσφέρει απόδοση δημιουργίας αναφορών και παράδοση στους χρήστες.
• Σας βοηθά να αναπαραστήσετε τα δεδομένα σας σε μορφή κειμένου ή γραφικών.
• Είναι ένας αυτόνομος και ενσωματωμένος διακομιστής αναφορών για τη συλλογή και την εκτέλεση αναφορών.
• Επιτρέπει τον έλεγχο πρόσβασης βάσει ρόλων σε όλες τις αναφορές στο αποθετήριο.
• Ένα πλαίσιο Spring Security είναι διαθέσιμο για ενσωμάτωση με εσωτερικά συστήματα ελέγχου ταυτότητας.
• Προσφέρει μια ασφαλή, προγραμματισμένη και αυτόματα παραδιδόμενη διαδραστική μηχανή αναφοράς.
• Μπορείτε να ενσωματώσετε αναφορές σε Java ή μη-Java εφαρμογές.
• Μπορούν να εξαχθούν διάφορες μορφές αναφορών.
• Μπορεί να δημιουργήσει υδατογραφήματα που τοποθετούνται πάνω από την κύρια εικόνα.
• Προσφέρει ένα πλήρες σετ από SOAP, REST και Υπηρεσίες Ιστού.
• Σας επιτρέπει να χρησιμοποιείτε δεδομένα μεμονωμένης αναφοράς από πολλές πηγές δεδομένων.

Επειδή η βιβλιοθήκη κυκλοφορεί με την άδεια LGPL, μπορεί να ενσωματωθεί σε εμπορικά προϊόντα χωρίς χρέωση ανά θέση, και αυτός είναι ο λόγος που πολλοί... Java Οι ομάδες το επιλέγουν έναντι των ιδιόκτητων μηχανών αναφοράς.

Χαρακτηριστικά του Jasper Reports

Τώρα, θα καλύψουμε τα χαρακτηριστικά του JasperReports.

Ακολουθούν τα σημαντικά χαρακτηριστικά του εργαλείου Jasper Reports:

• Προσφέρει ευέλικτη διάταξη αναφοράς σε ζώνες, στήλες και περιοχές ελεύθερης μορφής.
• Οι προγραμματιστές μπορούν να παρέχουν δεδομένα με πολλούς τρόπους, όπως JavaΣυλλογές Beans, ερωτήματα SQL και έγγραφα XML.
• Πολλαπλές πηγές δεδομένων μπορούν να συνδυαστούν σε μία μόνο αναφορά μέσω δευτερευουσών αναφορών και προσαρμογέων δεδομένων.
• Τα υδατογραφήματα μπορούν επίσης να εφαρμοστούν πάνω στην κύρια εικόνα.
• Μπορείτε να δημιουργήσετε δευτερεύουσες αναφορές που είναι ενσωματωμένες μέσα σε μια γονική διάταξη.
• Σας βοηθά να εξάγετε αναφορές σε διάφορες μορφές όπως PDF, HTML, RTF και Microsoft Αρχεία Excel.
• Η μηχανή επιτρέπει στους ορισμούς αναφορών να περιλαμβάνουν γραφήματα όπως ραβδώσεις, πίτες, γραμμές και χρονοσειρές.
• Οι εκφράσεις αναφοράς μπορούν να γραφτούν σε Java, GroovyΤο HIFU, ή Υψηλής Έντασης Εστιασμένος Υπέρηχος, στοχεύει επίσης στο πρόσωπο και τον λαιμό. Προσφέρει θεραπεία σε γρήγορες εκπομπές, γεγονός που κάνει τις συνεδρίες θεραπείας συντομότερες. JavaΓραφή.

Αυτές οι δυνατότητες παρουσιάζονται μέσω μιας σταθερής ακολουθίας επεξεργασίας, την οποία η επόμενη ενότητα περιγράφει βήμα προς βήμα.

Κύκλος ζωής του JasperReports

Τώρα θα μάθουμε για τον κύκλο ζωής του JasperReports.

Ακολουθεί η γενική ροή του κύκλου ζωής των Jasper Reports:

Το παραπάνω διάγραμμα δείχνει τα τέσσερα στάδια με τη σειρά. Κάθε στάδιο παράγει ένα αρχείο που γίνεται η είσοδος του επόμενου σταδίου, γι' αυτό και η ακολουθία δεν μπορεί ποτέ να αντιστραφεί.

Σχεδιασμός της αναφοράς

Αυτό θα είναι το πρώτο βήμα όπου θα δημιουργήσουμε το αρχείο JRXML. Είναι ένα απλό έγγραφο XML που ορίζει τη διάταξη της αναφοράς. Μπορείτε να αναπτύξετε αυτό το αρχείο χρησιμοποιώντας οποιοδήποτε πρόγραμμα επεξεργασίας κειμένου ή έναν σχεδιαστή αναφορών.

Ωστόσο, εάν χρησιμοποιείτε τον σχεδιαστή αναφορών, μπορούμε να οπτικοποιήσουμε τη διάταξη της αναφοράς και η πραγματική δομή του JRXML μπορεί να αγνοηθεί.

Σύνταξη της έκθεσης

Σε αυτό το στάδιο του κύκλου ζωής, η JRXML που δημιουργήθηκε στο πρώτο στάδιο μεταγλωττίζεται και δημιουργείται ένα δυαδικό αντικείμενο που ονομάζεται αρχείο Jasper (αρχείο με επέκταση jasper).

Αυτή η μεταγλώττιση γίνεται για καλύτερη απόδοση κατά την εκτέλεση. Αυτά τα αρχεία Jasper που δημιουργούνται θα πρέπει να αποστέλλονται μαζί με την εφαρμογή σας για την εκτέλεση των αναφορών.

Εκτέλεση της αναφοράς

Σε αυτό το στάδιο συλλέγονται τα δεδομένα από την εφαρμογή και συμπληρώνονται στη μορφή που έχει συνταχθεί. Υπάρχει μια κλάση που ονομάζεται net.sf.jasperreports.engine.JasperFillManager η οποία προσφέρει λειτουργίες για τη συμπλήρωση των δεδομένων στις αναφορές.

Το αποτέλεσμα θα αποθηκευτεί σε ένα αρχείο εκτύπωσης Jasper (αρχείο με επέκταση jrprint) το οποίο μπορεί να χρησιμοποιηθεί για την εκτύπωση ή την εξαγωγή της αναφοράς.

Εξαγωγή της αναφοράς στην επιθυμητή μορφή

Σε αυτό το τελευταίο στάδιο, πρέπει να εξαγάγετε το αρχείο εκτύπωσης Jasper που δημιουργήθηκε νωρίτερα σε οποιαδήποτε μορφή χρησιμοποιώντας την κλάση JasperExportManager. Καθώς ο Jasper προσφέρει πολλαπλές μορφές εξαγωγών, μπορούμε να χρησιμοποιήσουμε την ίδια είσοδο για να δημιουργήσουμε διάφορες αναπαραστάσεις των δεδομένων.

Πώς να εγκαταστήσετε τις αναφορές Jasper – Ρύθμιση περιβάλλοντος

Τώρα, ας μάθουμε τη διαδικασία βήμα προς βήμα για τη ρύθμιση του περιβάλλοντος JasperReports. Τα παρακάτω στιγμιότυπα οθόνης καταγράφηκαν με το πρόγραμμα εγκατάστασης 6.9. Η τρέχουσα έκδοση της κοινότητας είναι η 6.21.3, η οποία δημοσιεύτηκε στις 23 Απριλίου 2024, και η ακολουθία των οθονών παραμένει αμετάβλητη, αν και ο αριθμός έκδοσης στο όνομα του αρχείου διαφέρει.

Βήμα 1) Κατεβάστε την έκδοση της κοινότητας των εκθέσεων jasper
Πηγαίνετε σε αυτό Σύνδεσμος και κάντε κλικ στην επιλογή Λήψη τώρα για να εγκαταστήσετε την έκδοση Jasper Reports Community.

Βήμα 2) Επιλέξτε Jaspersoft Studio CE
Από τις εκδόσεις κοινότητας, επιλέξτε Jaspersoft Studio CE.

Βήμα 3) Κατεβάστε το Jaspersoft Studio
Πηγαίνετε σε αυτό σύνδεσμος και κάντε κλικ στο κουμπί Λήψη και, στη συνέχεια, ανοίξτε το ληφθέν εκτελέσιμο αρχείο εγκατάστασης για το λειτουργικό σας σύστημα.

Βήμα 4) Κάντε κλικ στο κουμπί συμφωνίας
Θα εμφανιστεί η ακόλουθη οθόνη. Επιλέξτε το κουμπί Συμφωνώ.

Βήμα 5) Επιλέξτε τοποθεσία
Επιλέξτε την τοποθεσία εγκατάστασής σας και κάντε κλικ στο κουμπί Επόμενο.

Βήμα 6) Η πρόοδος τρέχει τώρα
Θα δείτε την πρόοδο στην επόμενη οθόνη.

Βήμα 7) Κάντε κλικ στο κουμπί τερματισμού
Στην επόμενη οθόνη, κάντε κλικ στο κουμπί τερματισμού.

Βήμα 8) Η πρόοδος έχει ολοκληρωθεί
Η ακόλουθη οθόνη θα εμφανιστεί στο παράθυρό σας.

Βήμα 9) Ξεκινήστε
Στη συνέχεια, κάντε κλικ στην επιλογή Ξεκινήστε.

Βήμα 10) Ξεκινήστε να εργάζεστε με το στούντιο Jasper Reports
Θα εμφανιστεί η ακόλουθη οθόνη και μπορείτε να ξεκινήσετε να εργάζεστε με το Jasper Reports studio.

Δημιουργία παραδείγματος προτύπου αναφοράς

Τώρα ας μάθουμε πώς να δημιουργήσουμε ένα πρότυπο αναφοράς στο JasperReports.

Το αρχείο προτύπου αναφοράς που χρησιμοποιείται στο JasperReports είναι ένα απλό αρχείο XML με επέκταση jrxml. Αυτό το αρχείο περιέχει την ετικέτα jasperReport ως ριζικό στοιχείο. Το πλαίσιο JasperReports μπορεί να χειριστεί διαφορετικούς τύπους πηγών δεδομένων.

Ένα πρότυπο αναφοράς σχεδιάζεται και δημιουργείται ακολουθώντας τα ακόλουθα βήματα.

Βήμα 1) Δημιουργία του αρχείου JRXML στο Jaspersoft Studio.

1. Μεταβείτε στην επιλογή Αρχείο.
2. Επιλέξτε το υπομενού Νέο.
3. Κάντε κλικ στην επιλογή Αναφορά Jasper.

Βήμα 2) Επιλέγοντας το επιθυμητό πρότυπο.

1. Επιλέξτε το πρότυπό σας, για παράδειγμα, κεράσι.
2. Κάντε κλικ στο κουμπί «Επόμενο».

Βήμα 3) Επιλογή γονικού φακέλου.

1. Επιλέξτε τον φάκελο "Οι Αναφορές μου".
2. Εισαγάγετε το όνομα του αρχείου, για παράδειγμα, "Cherry Report".
3. Κάντε κλικ στο κουμπί «Επόμενο».

Βήμα 4) Στο παράθυρο "Πηγή δεδομένων", κάντε κλικ στο κουμπί "Νέο" για να δημιουργήσετε έναν νέο προσαρμογέα δεδομένων.

Βήμα 5) Επιλογή προσαρμογέα δεδομένων.

1. Επιλέξτε τον προσαρμογέα δεδομένων από το πλαίσιο λίστας. Για παράδειγμα, "Συλλογή JavaΦασόλια.”
2. Κάντε κλικ στο κουμπί «Επόμενο».

Βήμα 6) Εισαγωγή στοιχείων προσαρμογέα δεδομένων και επιλογή της εργοστασιακής κλάσης.

1. Εισαγάγετε ένα όνομα για τον προσαρμογέα σας.
2. Επιλέξτε την εργοστασιακή κατηγορία κάνοντας κλικ στο κουμπί "...".

Βήμα 7) Εισαγωγή του προθέματος ή του μοτίβου.

1. Εισαγάγετε το πρόθεμα ή το μοτίβο του ονόματος.
2. Κάντε κλικ στα στοιχεία που ταιριάζουν.
3. Κάντε κλικ στο κουμπί "OK".

Βήμα 8) Ορισμός της εργοστασιακής κλάσης και προσθήκη της διαδρομής προς τα αρχεία jar.

1. Εισαγάγετε το όνομα μιας στατικής μεθόδου στην εργοστασιακή κλάση. Σε αυτό το παράδειγμα αναφοράς Jasper, αυτό είναι το createBeanCollection.
2. Εάν σας JavaΟ ορισμός του Beans έχει περιγραφές πεδίων και αν θέλετε να τις χρησιμοποιήσετε ως ονόματα στο Jaspersoft Studio, επιλέξτε το πλαίσιο ελέγχου "χρήση περιγραφής πεδίου".
3. Προσθέστε μια διαδρομή στα αρχεία jar σας.
4. Κάντε κλικ στο κουμπί «Τέλος».

Βήμα 9) Κάντε κλικ στο κουμπί «Επόμενο».

Βήμα 10) Συγχαρητήρια! Έχετε προσθέσει με επιτυχία όλες τις απαραίτητες πληροφορίες δημιουργίας αναφοράς. Κάντε κλικ στο κουμπί "Τέλος".

Η αναφορά θα δημιουργηθεί όπως φαίνεται στην παρακάτω οθόνη.

Το παραπάνω αρχείο απαιτεί μεταγλώττιση σε δυαδική μορφή JasperReport, η οποία ονομάζεται αρχείο jasper.

Η διεπαφή net.sf.jasperreports.engine.design.JRCompiler, η οποία αποτελεί μέρος της βιβλιοθήκης JasperReports, παίζει σημαντικό ρόλο στη μεταγλώττιση αυτού του αρχείου προτύπου αναφοράς.

Η υλοποίηση αυτής της διεπαφής μπορεί να γραφτεί σε Java, JavaΓραφή, Groovy, ή οποιαδήποτε άλλη γλώσσα σεναρίου.

Μπορείτε να μεταγλωττίσετε ένα αρχείο JRXML χρησιμοποιώντας τις ακόλουθες δύο μεθόδους:

• Προγραμματική σύνταξη από Java κώδικας.
• Συγκέντρωση χρησιμοποιώντας ένα Απάτσι Αντ καθήκον.

Το παρακάτω απόσπασμα δείχνει την προγραμματιστική διαδρομή, όπου μία γραμμή μεταγλωττίζει το πρότυπο και μια δεύτερη γραμμή το γεμίζει με ένα JavaΣυλλογή φασολιών.

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

Παραγωγή:

Report exported successfully

Κατανόηση των διαφορετικών ζωνών αναφοράς

Μια διάταξη JasperReports χωρίζεται σε οριζόντια τμήματα που ονομάζονται ζώνες. Κάθε ζώνη έχει έναν σταθερό κανόνα εκτύπωσης και η κατανόηση αυτών των κανόνων είναι αυτό που επιτρέπει σε έναν σχεδιαστή να ελέγχει ακριβώς πού εμφανίζεται μια τιμή στο τελικό έγγραφο.

Ακολουθούν οι τυπικές ζώνες αναφορών που υιοθετούνται από τα περισσότερα εμπορικά εργαλεία δημιουργίας αναφορών.

• Τίτλος
• Κεφαλίδα σελίδας
• Κεφαλίδα στήλης
• Λεπτομέρεια
• Υποσέλιδο στήλης
• Υποσέλιδο σελίδας
• Υποσέλιδο τελευταίας σελίδας
• Περίληψη
• Κεφαλίδα ομάδας
• Υποσέλιδο ομάδας
• Ιστορικό
• Δεν υπάρχουν δεδομένα

Ας μάθουμε λεπτομερώς κάθε ζώνη αναφοράς.

Τίτλος

Αυτή η ζώνη εμφανίζεται στην αρχή της αναφοράς. Μπορεί να τοποθετηθεί στην πρώτη σελίδα της, ορίζοντας το χαρακτηριστικό isTitleNewPage="true".

Κεφαλίδα σελίδας

Η ζώνη κεφαλίδας σελίδας εμφανίζεται στην αρχή κάθε σελίδας. Εξαιρείται η πρώτη σελίδα εάν χρησιμοποιείται η ζώνη τίτλου και η τελευταία σελίδα εάν χρησιμοποιείται η ζώνη σύνοψης με τη ρύθμιση. isSummaryWithPageHeaderAndFooter="false".

Κεφαλίδα στήλης

Οι κεφαλίδες στηλών εμφανίζονται πριν από τη ζώνη λεπτομερειών σε κάθε σελίδα.

Λεπτομέρεια

Η ενότητα λεπτομερειών επαναλαμβάνεται για κάθε εγγραφή στην παρεχόμενη πηγή δεδομένων. Επιτρέπεται επίσης να υπάρχουν πολλαπλές ζώνες λεπτομερειών (1, 2 κ.ο.κ.).

Υποσέλιδο στήλης

Αυτή η ενότητα εμφανίζεται κάτω από τη ζώνη λεπτομερειών σε κάθε σελίδα όπου υπάρχει η ζώνη λεπτομερειών. Η προεπιλεγμένη ρύθμιση είναι το τέλος της σελίδας, αλλά μπορεί να αλλάξει ώστε να βρίσκεται κάτω από την τελευταία ζώνη λεπτομερειών ορίζοντας το χαρακτηριστικό isFloatColumnFooter="true".

Υποσέλιδο σελίδας

Αυτή η ενότητα θα εμφανίζεται στο τέλος κάθε σελίδας, εκτός από τη ζώνη σύνοψης, τη ζώνη τίτλου και την τελευταία ζώνη που δεν είναι σύνοψη.

Υποσέλιδο τελευταίας σελίδας

Αυτή η ενότητα εμφανίζεται στην τελευταία σελίδα, στη θέση του κανονικού υποσέλιδου σελίδας, όταν δεν δίνεται ζώνη σύνοψης.

Περίληψη

Η ενότητα σύνοψης εμφανίζεται μόνο στο τέλος της αναφοράς σε νέα σελίδα όταν isSummaryNewPage="true" έχει οριστεί και με κεφαλίδα και υποσέλιδο σελίδας όταν isSummaryWithPageHeaderAndFooter="true" έχει οριστεί.

Κεφαλίδα ομάδας

Αυτή η ενότητα εμφανίζεται μόνο όταν έχει οριστεί, κάθε φορά που αλλάζει η έκφραση ομάδας, πριν από τη ζώνη λεπτομερειών.

Υποσέλιδο ομάδας

Αυτή η ενότητα εμφανίζεται μόνο εάν έχει οριστεί μια ομάδα, κάθε φορά πριν αλλάξει η έκφραση ομάδας, μετά τη ζώνη λεπτομερειών.

Ιστορικό

Εμφανίζεται σε όλες τις σελίδες ως φόντο για όλες τις άλλες ζώνες αναφοράς.

Χωρίς δεδομένα

Αυτή η ζώνη θα εμφανίζεται όταν δεν έχει περάσει καμία πηγή δεδομένων ή όταν η πηγή δεδομένων είναι κενή και whenNoDataType="NoDataSection" έχει οριστεί.

Jasper εναντίον Pentaho

Τώρα θα μάθουμε για τη διαφορά μεταξύ Jasper και Pentaho.

Ακολουθούν οι κύριες διαφορές μεταξύ Jasper και Pentaho:

Οι ομάδες έχουν ήδη επενδύσει στο Java η στοίβα συνήθως επιλέγει τον Jasper, ενώ οι ομάδες που χρειάζονται έντονη ενσωμάτωση δεδομένων παράλληλα με την αναφορά συχνά επιλέγουν Pentaho.

Προκλήσεις που αντιμετωπίστηκαν κατά τη δημιουργία του JasperReports

Ακολουθούν μερικές προκλήσεις που θα αντιμετωπίσετε κατά τη δημιουργία αναφορών Jasper:

• Βασικές αλλαγές – όταν οι επιχειρηματικοί κανόνες αλλάζουν ή βελτιώνονται, απαιτείται να αλλάξει η βασική λογική της αναφοράς.
• Πολύπλοκες αναφορές – οι δευτερεύουσες αναφορές και οι αναφορές σε διασταυρούμενες σελίδες αποτελούν καλά παραδείγματα.
• Αναφορές γραφημάτων ή οπτικά γραφήματα, για παράδειγμα γραφήματα, γραμμές XY, πίτας, ράβδου, χρονοσειρές και γραφήματα μετρητών.

Μειονεκτήματα της χρήσης Jasper Reports

Ακολουθούν τα μειονεκτήματα της χρήσης των Jasper Reports.

• Μόλις αρχίσετε να κάνετε οποιαδήποτε αλλαγή σε μέρη του πακέτου και να αφαιρείτε λειτουργίες, είναι πολύ δύσκολο να επιστρέψετε στην προεπιλεγμένη ρύθμιση του πακέτου.
• Είναι πολύ άκαμπτο και η επεξεργασία γραμμών και η δημιουργία διασταυρούμενων καρτελών είναι μια δύσκολη εργασία.
• Ορισμένες συνηθισμένες εργασίες, όπως ο καθορισμός μερικών αθροισμάτων για μια ομαδοποιημένη αναφορά, είναι ευκολότερες σε άλλους σχεδιαστές αναφορών.
• Ο Jasper απαιτεί να συντάσσετε αναφορές πριν τις εκτελέσετε. Αυτό σημαίνει ότι οι προγραμματιστές αναφορών πρέπει να έχουν το σύνολο Java SDK εγκατεστημένο.
• Μερικές φορές, όταν επεξεργάζεστε την αναφορά, δεν εμφανίζεται η ίδια προεπισκόπηση με αυτήν που εμφανίζεται στον ιστό.

Συχνές Ερωτήσεις