{"id":5092,"date":"2010-11-02T19:09:27","date_gmt":"2010-11-02T18:09:27","guid":{"rendered":"https:\/\/www.artera.net\/it\/blog\/?p=5092"},"modified":"2023-02-27T14:53:32","modified_gmt":"2023-02-27T14:53:32","slug":"utilizzare-jasper-reports-sviluppo-di-una-web-application","status":"publish","type":"post","link":"https:\/\/www.artera.net\/it\/sviluppo\/utilizzare-jasper-reports-sviluppo-di-una-web-application\/","title":{"rendered":"Utilizzare Jasper Reports – Sviluppo di una web application"},"content":{"rendered":"

In questo articolo vedremo un esempio di integrazione di Jasper Reports con una semplice web application<\/em>, scritta ovviamente in Java.<\/p>\n

Modificare il progetto<\/h3>\n

\"UtilizzareNelle ultime due puntate<\/a> di questa serie abbiamo creato un progetto completo grazie all’utilizzo del plugin maven-archetype-plugin<\/a><\/em>. Il progetto creato per\u00f2 non ha la struttura di web application, dobbiamo quindi apportare delle modifiche.<\/p>\n

Per prima cosa dobbiamo modificare il file pom.xml<\/strong> (la configurazione di Maven): la voce
\n<\/em> deve essere modificata da jar<\/em> (acronimo di Java Archive<\/em>) a war<\/em> (Web Application Archive<\/em>):<\/p>\n

[java]<packaging>war<\/packaging>[\/java]<\/p>\n

Bisogna anche aggiungere le dipendenze<\/em> relative alle servlet<\/strong> e JSP<\/strong> (Java Server Pages<\/em>). Per farlo bisogna aggiungere queste righe all’interno dell’elemento :<\/p>\n

[java]<dependency>
\n <groupId>javax.servlet<\/groupId>
\n <artifactId>servlet-api<\/artifactId>
\n <version>2.3<\/version>
\n <scope>provided<\/scope>
\n<\/dependency><\/p>\n

<dependency>
\n <groupId>javax.servlet.jsp<\/groupId>
\n <artifactId>jsp-api<\/artifactId>
\n <version>2.0<\/version>
\n <scope>provided<\/scope>
\n<\/dependency>[\/java]<\/p>\n

Creare quindi le directory:<\/p>\n

src\/main\/webapp\/WEB-INF<\/em><\/p>\n

e, all’interno di WEB-INF<\/em>, il file web.xml<\/em>, con questi contenuti:<\/p>\n

[java]<!DOCTYPE web-app PUBLIC
\n "-\/\/Sun Microsystems, Inc.\/\/DTD Web Application 2.3\/\/EN"
\n "http:\/\/java.sun.com\/dtd\/web-app_2_3.dtd" ><\/p>\n

<web-app>
\n <display-name>Tutorial Jasper Reports – Artera.it<\/display-name>
\n<\/web-app>[\/java]<\/p>\n

L’applicazione<\/h3>\n

Per il momento ci accontentiamo di una struttura molto semplice che utilizza una pagina HTML e una servlet, ma sappiate che un’applicazione reale avr\u00e0 bisogno di un’organizzazione ben pi\u00f9 strutturata, per poter gestire agevolmente molte maschere di inserimento dati, flussi di lavoro complessi, gestione degli errori, ecc.<\/p>\n

Creiamo quindi la pagina HTML:<\/p>\n

src\/main\/webapp\/index.html<\/em><\/p>\n

con questi contenuti:<\/p>\n

[java]<html>
\n<body>
\n<h1>Jasper Reports Tutorial<\/h1>
\n<a href="servlet\/reportServlet">Esegui Report<\/a>
\n<\/body>
\n<\/html>[\/java]<\/p>\n

Creiamo quindi la classe ReportServlet<\/em> nel package it.artera.jr<\/em>:<\/p>\n

[java]package it.artera.jr;<\/p>\n

import java.io.*;
\nimport java.util.*;<\/p>\n

import javax.servlet.ServletException;
\nimport javax.servlet.http.*;<\/p>\n

import net.sf.jasperreports.engine.*;
\nimport net.sf.jasperreports.engine.data.JRMapCollectionDataSource;<\/p>\n

public class ReportServlet extends HttpServlet {
\n @Override
\n protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {<\/p>\n

\/\/ indica al client il tipo di contenuto
\n resp.setContentType("application\/pdf");<\/p>\n

\/\/ carica il report compilato
\n InputStream is = getClass().getResourceAsStream("\/testReport.jasper");<\/p>\n

\/\/ crea una java.util.Collection contenente dei dati
\n Collection data = createSampleData();
\n \/\/ la avvolge in un’implementazione di JRDataSource
\n JRMapCollectionDataSource dataSource = new JRMapCollectionDataSource(data);<\/p>\n

try {
\n JasperRunManager.runReportToPdfStream(is, resp.getOutputStream(), null, dataSource);
\n } catch (JRException jrex) {
\n throw new ServletException("Errore generando il report", jrex);
\n }
\n }<\/p>\n

private Collection createSampleData() {
\n Map row;
\n Collection data = new ArrayList();<\/p>\n

row = new HashMap();
\n row.put("name", "Lorem");
\n data.add(row);<\/p>\n

row = new HashMap();
\n row.put("name", "Ipsum");
\n data.add(row);<\/p>\n

row = new HashMap();
\n row.put("name", "Docet");
\n data.add(row);<\/p>\n

return data;
\n }
\n}[\/java]<\/p>\n

Il codice di del metodo doGet()<\/em> \u00e8 in larga parte copiato dalla classe App<\/em>, con l’unica differenza che l’output non viene salvato su disco ma viene rediretto sull’output stream della servlet.<\/p>\n

L’ultimo passo \u00e8 la mappatura della servlet in web.xml, per farlo bisogna aggiungere queste righe all’interno di web.xml<\/em>, prima del tag di chiusura <\/em>:<\/p>\n

[java]<servlet>
\n <servlet-name>reportServlet<\/servlet-name>
\n <servlet-class>it.artera.jr.ReportServlet<\/servlet-class>
\n<\/servlet><\/p>\n

<servlet-mapping>
\n <servlet-name>reportServlet<\/servlet-name>
\n <url-pattern>\/servlet\/reportServlet<\/url-pattern>
\n<\/servlet-mapping>[\/java]<\/p>\n

Deploy & test<\/h3>\n

Per testare subito la vostra applicazione dovete prima preparare il pacchetto, con il comando:<\/p>\n

mvn package<\/pre>\n
il risultato del build \u00e8 il file<\/p>\n
target\/[NOME APPLICAZIONE].war<\/p>\n
Rinominate questo file come jasper_tutorial.war e copiatelo nella directory webapps di Tomcat; fate partire il server, e poi andate all’indirizzo http:\/\/localhost:8080\/jasper_tutorial<\/a><\/code>, dove troverete la pagina iniziale con il link, cliccando sul quale otterrete il report in PDF.<\/p>\n
Sviluppi<\/h3>\n
Ci sono molti modi per servire report tramite web application, noi abbiamo visto una caso molto semplice. Nelle applicazioni reali ci sono sicuramente molte pi\u00f9 variabili in gioco: passaggio di parametri, diversi tipi di output, e soprattutto l’utilizzo di ciclo di sviluppo\/deploy\/debug molto pi\u00f9 comodo e veloce.<\/p>\n
Linkografia<\/h3>\n