1. Introduction

JasperReports est un outil (librairie) Open Source puissant utilisé pour la génération d'états. Il permet de créer des rapports à partir de fichiers XML. Le résultat peut être affiché à l'écran, imprimé ou stocké dans des fichiers au format PDF, HTML, XLS, CSV ou XML.

JasperReports est entièrement développé en Java et peut être intégré dans une gamme très variée d'applications Java (y compris les applications J2EE). Son objectif principal est de fournir un moyen simple et flexible pour la génération de documents

2. Génération de rapport avec Jasper Report

Les applications d’entreprises nécessitent souvent l’édition écran, papier de données provenant de sources diverses ( base de données, fichiers XML, etc.)

Les solutions d’implémentation sont diverses :

1. Framework d’entreprise propriétaire ;

2. Outils payants ( Actuate, Business Objects, etc.)

Cependant des outils issus du libre existent et très puissant en terme de fonctionnalités :

2. XSL et XSLFO pour la mise en forme de données XML

3. Le framework Jasper Report ;

Nous étudierons dans ce tutorial l’utilisation de la librairie Jasper Report au travers de la construction d’un rapport simple via un GUI nommé iReport et de sa génération au format PDF dans une classe JAVA.

La base de données choisie est MySQL.

2.1. Création de la base de données

La source de données choisie pour cet article est MySQL. Il est évidemment possible d'en choisir une autre comme Oracle, pourvu que vous disposiez des drivers JDBC adaptés.

Nous supposons que MySQL est installé et que vous disposez des droits nécessaires pour la création des objets pour ce tutorial ( base, table )

2.2. Création de la base

Vous devez vous connecter à votre serveur MySQL et exécuter le script de création de base suivant :

CREATE DATABASE `jasper_database`;

2.3. Création de la table

Créer la table suivante dans la base jasper_database :

CREATE TABLE `jasper_database`.`EMPLOYEE` (
`NOM` VARCHAR(50) NOT NULL,
`PRENOM` VARCHAR(50) NOT NULL,
`AGE` NUMERIC NOT NULL,
`VILLE` VARCHAR(50) NOT NULL,
PRIMARY KEY(`NOM`)
) ;

Nous allons maintenant peupler la table employee

insert into employee (NOM,PRENOM,AGE,VILLE) values ('DUPONT','Paul',25,'PARIS');
insert into employee (NOM,PRENOM,AGE,VILLE) values ('MARTIN','Fred',34,'PARIS');
insert into employee (NOM,PRENOM,AGE,VILLE) values ('WAGNER','Anne',45,'PARIS');
insert into employee (NOM,PRENOM,AGE,VILLE) values ('POLUX','Elea',64,'TOULOUSE');

3. Installations des outils

3.1. Installation de iReport

Télécharger iReport sur le site http://ireport.sourceforge.net

L’installation de iReport est triviale puisque qu’il suffit d’extraire l’archive téléchargée ( ici sur D : ) et d’exécuter l’application en lançant D:\iReport-0.5.1\bin\startup.bat

3.2. Utilisation de iReport

Nous allons maintenant créer un rapport simple sur la table précédemment créée en utilisant l’assistant fournit dans iReport

Ouvrir iReport en exécutant D:\iReport-0.5.1\bin\startup.bat

3.3 Création d’une connexion

Dans le menu ouvrir Datasource > Connections / Datasources

Cliquer sur New et paramétrer la connexion à la base de données comme suit :

Cliquer sur le bouton Test pour vérifier la connexion

Une fois la connexion valide cliquer sur le bouton Save, la connexion est maintenant créée. Vous pouvez fermer alors la fenêtre suivante :

3.4 Création du rapport

Dans le menu ouvrir Fichier > Report Wizard et saisir la requête SQL suivante :

select * from employee

Cliquer Next et sélectionner tous les champs en cliquant >>

Cliquer Next

Cliquer Next ( dans ce rapport simple nous ne feront pas de groupement )

Laisser ces valeurs par défaut et cliquer Next

Cliquer Finish, le rapport apparaît alors dans le designer

3.4. Compilation du rapport

Nous allons maintenant générer sous la forme d’un fichier XML dont l’extension est en fait jrxml ( le format utilisé par la librairie Jasper Report )

Dans le menu ouvrir Build > Compiler

Nous allons là encore laisser par défaut la sauvegarde du fichier classic.jrxml dans le répertoire D:\iReport-0.5.1

Cliquer sur Enregistrer, la compilation se lance et une fois terminée vous devriez avoir dans le volet inférieur :

Compiling to file... .\classic.jasper -> D:\iReport-0.5.1\classic.java it.businesslogic.ireport.ReportClassLoader@a50549 Compilation running time : 1722

Génération du rapport PDF via JAVA

Nous allons maintenant créer un projet sous Eclipse, et une classe java qui s’occupera de compiler le fichier classic.jrxml pour en générer un rapport PDF.

Téléchargez et installez J2SE 1.4 SDK.

Si vous ne disposez pas d'Eclipse, téléchargez-le et installez le.

Si ces deux premiers points vous pose problème, consultez la page suivante : http://www.eclipsetotale.com/articles/installation.html

3.5. Création du projet ECLIPSE

Nous devons créer et configurer un projet Eclipse. Cette partie est essentielle au bon fonctionnement de la suite.

Faites "Fichier>New>Project"

Choisissez "Java Project" puis donnez au projet les caractéristiques suivantes :

Veillez à bien cocher "Create separate source and output folders".

Si Eclipse vous demande de passer en Java Perspective, répondez "Yes".

Créez à partir de l'explorateur windows un répertoire "lib" dans la racine de votre projet : /eclipse/workspace/jasperTest/lib

Téléchargez l'archive libs.zip : ici. Décompressez son contenu dans le répertoire "lib". jasperreports-1.0.1.jar contient les principaux packages nécessaires au bon fonctionnement de jasper. mysql-connector-java-3.0.8-stable-bin.jar est un driver JDBC opensource pour se connecter à MySQL. Les autres packages sont indispensables pour la compilation du rapport.

Revenez à Eclipse et faites sur le nom du projet "jasperTest" : "Bouton droit > Refresh". Le répertoire "lib" a dû apparaître.

Nous allons maintenant ajouter au classpath du projet les librairies :

Faites sur le projet "jasperTest" : "Bouton Droit > Properties"

Cliquez sur "Java Build Path" puis sur l'onglet "Librairies".

Cliquez sur "Add jars". Une fenêtre apparaît. Déroulez l'arborescence qui soit être "jasperTest > lib" et sélectionnez tous les jar présents. Puis cliquez sur "OK".

3.6. Création de la classe JAVA

Faites sur le nom du projet "jasperTest" : "Bouton droit > New > Class" puis donner à la classe les caractéristiques suivantes :

Code de la classe GeneratePDF.java

public static void main(String[] args) {

// - Paramètres de connexion à la base de données
String url = "jdbc:mysql://localhost/jasper_database";
String login = "root";
String password = "root";

try {
// - Connexion à la base
Driver monDriver = new com.mysql.jdbc.Driver();
DriverManager.registerDriver(monDriver);
Connection connection = DriverManager.getConnection(url, login, password);

// - Chargement et compilation du rapport
JasperDesign jasperDesign = JRXmlLoader.load("D:\\iReport-0.5.1\\classic.jrxml");
JasperReport jasperReport = JasperCompileManager.compileReport(jasperDesign);

// - Paramètres à envoyer au rapport
Map parameters = new HashMap();
parameters.put("Titre", "Titre");

// - Execution du rapport
JasperPrint jasperPrint = JasperFillManager.fillReport(jasperReport, parameters, connection);

// - Création du rapport au format PDF
JasperExportManager.exportReportToPdfFile(jasperPrint, "D:\\iReport-0.5.1\\classic.pdf");
} catch (JRException e) {

e.printStackTrace();
} catch (SQLException e) {

e.printStackTrace();
}

}
}