{"id":4911,"date":"2010-10-20T14:34:43","date_gmt":"2010-10-20T12:34:43","guid":{"rendered":"https:\/\/www.artera.net\/it\/blog\/?p=4911"},"modified":"2023-02-27T14:54:51","modified_gmt":"2023-02-27T14:54:51","slug":"utilizzare-jasper-reports-integrazione-con-maven","status":"publish","type":"post","link":"https:\/\/www.artera.net\/it\/sviluppo\/utilizzare-jasper-reports-integrazione-con-maven\/","title":{"rendered":"Utilizzare Jasper Reports – Integrazione con Maven"},"content":{"rendered":"

\"UtilizzareNell’ultimo appuntamento abbiamo visto come preparare un ambiente di lavoro<\/a> adatto allo sviluppo dei report, siamo quindi pronti per passare ad argomenti pi\u00f9 impegnativi. In questa lezione vediamo come generare dei report direttamente dai nostri programmi scritti in Java, senza dover quindi passare da iReport.<\/p>\n

Set-up del progetto<\/h3>\n

Per comodit\u00e0 utilizzeremo Maven<\/a> come sistema di build, questo ci permetter\u00e0 di creare al volo un progetto Java con tutte le directory necessarie e di includere la libreria Jasper Reports senza perderci troppo tempo. Purtroppo Maven \u00e8 un sistema piuttosto complesso, per chi non l’avesse installato consigliamo di seguire il tutorial che si trova sul sito ufficiale: Maven in 5 Minutes<\/a>.<\/p>\n

Una volta installato Maven possiamo creare lo scheletro del nostro progetto, eseguendo il goal<\/em>:<\/p>\n

mvn archetype:generate -DgroupId=it.artera.jr -DartifactId=jasper-tutorial -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
\n<\/code><\/p>\n

Attenzione:<\/strong> il comando deve essere digitato tutto sulla stessa linea! Eventualmente copiatelo in un editor, eliminate i fine-linea e incollate la stringa di comando sulla vostra console.<\/p>\n

Verr\u00e0 creata una directory jasper-tutorial<\/em> con questi contenuti:<\/p>\n

[html]
\n<ul>
\n\t<li><em>pom.xml<\/em> : \u00e8 il cosiddetto <em>project descriptor<\/em>, che ha la stessa funzione dei vecchi <em>makefile<\/em>;<\/li>
\n\t<li><em>src\/main\/java<\/em> : sorgenti dell’applicazione;<\/li>
\n\t<li><em>src\/test\/java<\/em> : test JUnit;<\/li>
\n<\/ul>
\n[\/html]<\/p>\n

Aggiungiamo quindi la directory src\/main\/jasperreports<\/em><\/strong>, dove salveremo i sorgenti dei report. Tenerli in una directory separata ci permette di usare una caratteristica molto apprezzata di Jasper Reports, ovvero di poter compilare i report durante la fase di build del progetto<\/strong>; ci\u00f2 ovviamente evita di dover compilare a mano tutti i report tramite iReport, automatizzando il processo. Molto comodo!<\/p>\n

Per sfruttare questa caratteristica dobbiamo:<\/p>\n

[html]
\n<ul>
\n\t<li>aggiungere Jasper Reports come <em>dependency<\/em> del progetto, in modo che Maven possa scaricare tutti i jar necessari;<\/li>
\n\t<li>indicare a Maven che vogliamo usare il plugin <em><a title="Jasper Reports Maven Plugin" href="http:\/\/mojo.codehaus.org\/jasperreports-maven-plugin\/" target="_blank">jasperreports-maven-plugin<\/a><\/em>;<\/li>
\n\t<li>specificare la configurazione del plugin stesso.<\/li>
\n<\/ul>
\n[\/html]<\/p>\n

Ecco il file pom.xml dopo le dovute modifiche:<\/p>\n

[html]
\n <project xmlns="http:\/\/maven.apache.org\/POM\/4.0.0" xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance"
\n xsi:schemaLocation="http:\/\/maven.apache.org\/POM\/4.0.0 http:\/\/maven.apache.org\/maven-v4_0_0.xsd"><\/p>\n

<modelVersion>4.0.0<\/modelVersion>
\n <groupId>it.artera.jr<\/groupId>
\n <artifactId>jasper-tutorial<\/artifactId>
\n <packaging>jar<\/packaging>
\n <version>1.0-SNAPSHOT<\/version>
\n <name>jasper-tutorial<\/name>
\n <url>http:\/\/maven.apache.org<\/url><\/p>\n

<build>
\n <plugins>
\n <plugin>
\n <groupId>org.apache.maven.plugins<\/groupId>
\n <artifactId>maven-compiler-plugin<\/artifactId>
\n <configuration>
\n <source>1.5<\/source>
\n <target>1.5<\/target>
\n <\/configuration>
\n <\/plugin>
\n <plugin>
\n <groupId>org.codehaus.mojo<\/groupId>
\n <artifactId>jasperreports-maven-plugin<\/artifactId>
\n <executions>
\n <execution>
\n <goals>
\n <goal>compile-reports<\/goal>
\n <\/goals>
\n <\/execution>
\n <\/executions>
\n <dependencies>
\n<!–note this must be repeated here to pick up correct xml validation –>
\n <dependency>
\n <groupId>net.sf.jasperreports<\/groupId>
\n <artifactId>jasperreports<\/artifactId>
\n <version>${jasperreports.version}<\/version>
\n <\/dependency>
\n <\/dependencies>
\n <\/plugin>
\n <\/plugins>
\n <\/build><\/p>\n

<repositories>
\n <repository>
\n <id>jasperreports<\/id>
\n <url>http:\/\/jasperreports.sourceforge.net\/maven2<\/url>
\n <\/repository>
\n <\/repositories><\/p>\n

<dependencies>
\n <dependency>
\n <groupId>net.sf.jasperreports<\/groupId>
\n <artifactId>jasperreports<\/artifactId>
\n <version>${jasperreports.version}<\/version>
\n <\/dependency>
\n <dependency>
\n <groupId>junit<\/groupId>
\n <artifactId>junit<\/artifactId>
\n <version>3.8.1<\/version>
\n <scope>test<\/scope>
\n <\/dependency>
\n <\/dependencies><\/p>\n

<properties>
\n <jasperreports.version>3.7.2<\/jasperreports.version>
\n <\/properties><\/p>\n

<\/project>
\n[\/html]<\/p>\n

Una volta preparato il tutto, consigliamo di eseguire un commit sul proprio sistema di versioning dei sorgenti<\/strong> prima di eseguire il comando:<\/p>\n

mvn package<\/pre>\n
che esegue un build completo. Durante il primo di questi build Maven scaricher\u00e0 parecchie librerie per cui ci potrebbe mettere anche parecchi minuti a seconda del tipo di connessione, ma quelli successivi saranno sicuramente pi\u00f9 veloci. \u00c8 possibile generare anche i file di progetto per Eclipse:<\/p>\n
mvn eclipse:eclipse<\/pre>\n
Mentre Netbeans, che ha il supporto nativo per Maven, non ha bisogno di alcuna configurazione.<\/p>\n
Un report di test<\/h3>\n
Apriamo iReport e creiamo un report in questo modo:<\/p>\n