ShareThis

Structure d’un programme

La structure d’un bloc PL SQL est très simple :

DECLARE
-- Déclaration des variables et curseurs
BEGIN
-- Code PL SQL
END;


Pour ce qui est de MySql, il existe les procédures (exécutent un traitement) et les fonctions (renvoient une valeur).
Il faut créer la procédure ou fonction :


CREATE PROCEDURE exemple_proc(OUT param1 INT)
BEGIN
SELECT * FROM employes
END


Et ensuite l’appeler avec l’instruction CALL :


CALL exemple_proc(@a)


Et ensuite faire un SELECT :

SELECT @a

Les déclencheurs (triggers)

Exécutent une action lors d’un évènement spécifique sur une table, une vue ou sur la base de donnée en elle même.

Un déclencheur ne peut pas contenir de COMMIT ou ROLLBACK vu qu’il s’exécute dans une transaction.

Si un ordre DML (select, insert, delete, update) est lancé sur la table concernée par le trigger, une exception ORA-04091 TABLE IS MUTATING peut être lancée.

2 variables peuvent être utilisées : OLD et NEW (juste avec les insert et update). Elles ne peuvent être utilisées que dans la clause WHEN.

Mettre un exemple de trigger

La clause INSTEAD OF est la seule clause utilisable en plus uniquement pour les vues.

Les déclencheurs concernant la base de données sont des déclencheurs sur les évènements système ou utilisateur.

Mettre la liste

Il est possible de désactiver (ou activer) les déclencheurs d’une table :

ALTER TABLE nomTable DISABL / ENABLE ALL TRIGGERS

Un trigger en particulier :

ALTER TRIGGER nomTrigger [enable/disable]

Les vues système à propos des triggers :

USER_TRIGGERS
DBA_TRIGGERS
ALL_TRIGGERS

Les curseurs :

En PL SQL :

Il existe 2 sortes de curseurs :

les curseurs explicites (gérés par l’utilisateur – ouverture, fermeture du curseur…) et implicites (gérés par Oracle).

Exemple de curseur explicite :
DECLARE
-- déclaration du curseur
CURSOR C_EMPLOYE IS
SELECT num_emp, nom_emp, prenom_emp FROM employes;

Open C_EMPLOYE ; -- ouverture du curseur
Loop -- boucle sur les lignes
Fetch C_EMPLOYE Into num_emp, nom_emp, prenom_emp;
dbms_output.put_line( 'Employé ' || To_char(num) || ' ' || nom || ' ' || prenom) ;
End loop ;
CLOSE C_EMPLOYE
END;

Exemple de curseur implicite

DECLARE
-- Déclaration des variables
BEGIN

END;

ShareThis

Map<String, Object> parameters = new HashMap<String, Object>();
JasperReport jasperReport = JasperCompileManager.compileReport(jrxml);
JasperPrint jasperPrint = JasperFillManager.fillReport(jasperReport, parameters, new JRXmlDataSource(new BufferedInputStream(new FileInputStream(“C:\\data.xml”)),"/donnees"));
JasperExportManager.exportReportToHtmlFile(“data.html");

ShareThis

Map parameters = new HashMap();
JasperReport jasperReport = JasperCompileManager.compileReport(jrxml);
JasperPrint jasperPrint = JasperFillManager.fillReport(jasperReport, parameters, new JRXmlDataSource(new BufferedInputStream(new FileInputStream(“C://data.xml”)),"/donnees"));
File destFile = new File(« C://", "data.docx");
JRDocxExporter exporter = new JRDocxExporter();
exporter.setParameter(JRExporterParameter.JASPER_PRINT, jasperPrint);
exporter.setParameter(JRExporterParameter.OUTPUT_FILE_NAME, destFile.toString());
exporter.exportReport();
 
if(Desktop.isDesktopSupported()){
if(Desktop.getDesktop().isSupported(Desktop.Action.OPEN)){
Desktop.getDesktop().open(new File("C:\\data.docx"));
}

La map parameters peut permettre de passer des paramètres (ici on n’en passe pas), il faut ensuite comme à chaque fois avec jasper report utiliser la classe JasperCompileManager et la méthode compileReport pour compiler le jrxml ainsi que la classe JasperFillManager et la méthode fillReport pour indiquer la datasource et la requête associée au report (ici la datasource est le fichier data.xml et on va lire tous les nœuds de la balise « donnees »).

Pour ce qui est de l’export Word en lui-même, il faut utiliser la classe JRDocxExporter et lui passer en paramètre le report compilé ainsi que le fichier de destination. Ici nous avons choisi d’enregistrer le fichier et le stocker sur le disque mais il aurait été possible de passer en paramètre un outputStream de la façon suivante : exporter.setParameter(JRExporterParameter.OUTPUT_STREAM, outputStream); Il suffit ensuite d’appeler la méthode exportReport qui va permettre de générer le rapport au format docx.

Les dernières lignes de programme utilisent la classe Desktop (introduite depuis Java 6) pour lancer le document word généré à l’écran.

ShareThis

Jasper Soft est une société proposant une suite complète de business intelligence : Jasper ETL pour la récupération, la transformation et le chargement des données, iReport pour la conception de modèles de reports, Jasper Analysis et Jasper Report pour l’exécution et la lecture des données, Jasper Server pour la distribution des rapports. Cet article présente la suite décisionnelle de Jasper Soft ainsi que l’ensemble de ses outils.

Une nouvelle preuve de l’efficacité du modèle de l’Open Source

Créée par Teodor Danciu en 2001, la suite de BI de JasperSoft se développe rapidement sur le modèle de l’Open Source. Grâce à la participation active de la communauté (plus de 200 projets en cours) et à l’intégration d’autres outils open source dans sa suite (tels que Talend et Liferay), Jasper Soft a su créer rapidement une solution d’analyse et de reporting performante et ne cesse encore d’innover. Aujourd’hui, Jasper Report distribue une partie de ses applications sous forme de logiciels libre et propose d’autres outils sous licence mais à un coût moindre que ses principaux concurrents (http://www.01net.com/article/280435.html). Jasper soft fourni également du support, des formations et des activités de service autour de ses logiciels.

Présentation générale

Jasper Soft propose des outils pour :

- l’aide à la prise de décision
- l’intégration de données
- la génération et l’analyse de rapports
- la distribution de ces rapports

Concrètement, l’outil d’ETL va permettre de charger des données provenant de différentes sources dans un datawarehouse. iReport est le logiciel qui va ensuite permettre de créer en « glisser / déposer » des modèles de rapport (un fichier .jrxml est alors généré). Jasper report va permettre de se connecter à n’importe quelle source de données et d’exécuter le modèle de rapport créé précédemment en lui passant des paramètres. Jasper server va, lui, permettre de diffuser les reports selon différents modes de distribution (portail web, envoi par mail planifié des rapports à certains utilisateurs…).

Les données des rapports peuvent provenir de nombreuses sources (Jasper Report supporte presque toutes les bases de données, les fichiers XML, CSV, texte et même des EJB et des POJO Hibernate).

En sortie, les formats de génération de rapports possible sont : PDF, HTML, XLS, CSV, XML, RTF, TXT, impression directe (lance l’impression pour imprimer le rapport).

Les différents outils de la suite décisionnelle de Jasper Soft

1) Jasper ETL
Jasper ETL va permettre de réaliser la phase d’ETL (extraction, transformation et chargement des données) et de créer le datawarehouse. Jasper ETL n’est autre que le logiciel d’ETL talend, qui permet de modéliser et d’exécuter des flux d’import de données, que Jasper Soft distribue dans sa suite d’outils de BI.

2) iReport

iReport est une interface graphique qui permet de créer des modèles de rapport en « glisser / déposer ». iReport génère un fichier « .jrxml » qui décrit le design du rapport (la mise en page). Ce fichier jrxml est ensuite exécutable par l’intermédiaire de l’API Jasper Report (voir ci-dessous), en lui passant des paramètres (source de données, requête, variables…).

3) Jasper Report

Jasper Report est une API écrite en Java permettant d’exécuter et de lancer un report Jasper Report. Il est donc possible d’écrire un programme Java qui va, en utilisant les classes de l’API Jasper Report, prendre le modèle de rapport conçu avec iReport et lui associer une source de données.

4) Jasper Server

Jasper server va principalement permettre de :
- Distribuer les rapports à une date donnée à certains utilisateurs (possibilité de créer des comptes utilisateur, d’envoyer des rapports par email tous les mois à une date donnée à certains utilisateurs par exemple).
- Créer très simplement des rapports en fonction de données disponibles sur le serveur (un utilisateur final pourra créer ses propres rapports en drag en drop).
D’autres fonctionnalités sont disponibles (historisation des rapports, croisement de données avec des applications web – mashups – ). Pour une liste exhaustive des fonctionnalités, suivez ce lien vers le site de jasper report : http://www.jaspersoft.com/jasperserver

5) Jasper Analysis

Jasper Analysis va permettre d’étendre les possibilités de reporting de Jasper Server. Jasper Analysis est capable d’analyser des données selon plusieurs axes et de réaliser des tableaux croisés.

Conclusion

Jasper Soft a donc su tirer partie du modèle de l’Open Source, pour bâtir une solution de BI complète et performante. Cette suite est généraliste et permettra de construire tout type de report.

ShareThis

Il faut tout d’abord télécharger les .jar de Quercus (disponibles ici) .

Une fois téléchargés, il faut les inclure dans le dossier lib du domaine du serveur glassfish (par exemple dans le dossier [glassfish_home]/domains/domain1/lib/).

Il suffit ensuite d’implémenter la servlet de Quercus dans le fichier web.xml de l’application et d’en définir le mapping. Par exemple pour mapper toutes les pages en .php :

 
<servlet-name>Quercus Servlet</servlet-name>
  <servlet-class>com.caucho.quercus.servlet.QuercusServlet</servlet-class>
 
<servlet-mapping>
  <servlet-name>Quercus Servlet</servlet-name>
<url-pattern>*.php</url-pattern> 
 
</servlet-mapping>

On peut maintenant créer une page PHP et l’inclure dans le répertoire contenant les pages web de l’application. Une fois le .war de l’appli déployé, la page PHP sera disponible sur le serveur Glassfish !

ShareThis

Il faut tout d’abord télécharger les deux archives .jar de Soft EU URL rewriter et les inclure dans le projet.

Il faut aussi déclarer la servlet de Soft EU URL Rewriter dans le web.xml de l’application ainsi que les urls pour lesquelles il faut appliquer ce filtre :

<!-- url rewriter -->
<filter>
    <filter-name>RewriterFilter</filter-name>
    <filter-class>cz.softeu.rewriter.RewriterFilter</filter-class>
</filter>
 
<filter-mapping>
    <filter-name>RewriterFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

Ici URL Rewriter testera toutes les urls de notre application.
Pour ne filtrer que les pages JSF, il faut préciser l’url pattern suivant :

<url-pattern>*.jsf</url-pattern>

Cette librairie permet ensuite par l’intermédiaire d’un fichier de configuration (rewriter-config.xml) d’associer une adresse à afficher et une adresse réelle. On peut, par exemple, définir dans notre fichier rewriter-config.xml :

<rewriter-config xmlns:b="http://rewriter.softeu.cz/basic/">
 
    <b:regex>
        <from>^/news/(.*)$</from>
        <to>/news.jsf?id=$1</to>
    </b:regex>
 
    <b:regex type="redirect">
        <from>^/categorie/([^\?]*)/(.*)$</from>
        <to>/displayCategories.jsf?id=$1</to>
    </b:regex>
 
</rewriter-config>

Dans cet exemple, on redirige toutes les urls du type http://www.site.com/news/123/ vers http://www.site.com/news.jsf?id=123 et les urls du type http://www.site.com/categorie/nom-de-la-categorie(ou tout type de texte)/123/ vers http://www.site.com/displayCategories.jsf?id=123

La propriété type offre trois options pour la gestion des url :

- par défaut : la librairie va chercher la page dans le répertoire de l’application
- redirect : une redirection est faîte sur la page
- permanent-redirect : redirection de type HttpServletResponse.SC_MOVED_PERMANENTLY
- temporary-redirect : redirection de type HttpServletResponse.SC_MOVED_TEMPORARILY

Il est donc maintenant possible de tester : en appelant l’url http://www.site.com/news/123/
la page http://www.site.com/news.jsf?id=123 s’affichera ce qui est beaucoup mieux pour le
référencement naturel !

ShareThis

FacesContext.getCurrentInstance()
.getExternalContext()
.redirect("http://www.monSite.com");

Il suffit de récupérer l’instance en cours et d’utiliser la méthode redirect.

ShareThis

Pour augmenter (ou diminuer) le timeout par défaut d’une session (qui est par défaut de 20 minutes), il suffit de préciser dans
le web.xml :

1
2
3

 <session-config>
     <session-timeout>60</session-timeout>
</session-config>

Le timeout à préciser étant un temps en minutes.

ShareThis

Un site dispose d’une section d’upload de photos. Ces photos sont enregistrées dans un répertoire /uploads de l’application.
Un gros problème se pose alors : une fois que l’on redéploie l’application, le contenu du répertoire /uploads est vidé puisque les photos ne seront plus présentes dans le .war de l’application.
La solution à ce problème est donc les alternate docroot.

On va pouvoir, dans le fichier sun-web.xml, définir un répertoire externe à l’application où l’on stockera les photos et y mapper une url. Ainsi, si on déclare dans notre sun-web.xml :

<property name="alternatedocroot_1" 
  value="from=/uploads/*
  dir=/home/">
</property>

Glassfish ira chercher toutes les photos qui auront l’url http://www.monSite.com/uploads/maPhoto.png dans le dossier /home/uploads/ du serveur.

A noter qu’il est possible de définir plusieurs alternate docroot, il faudra alors les déclarer sous la forme :

<property name="alternatedocroot_1" value="..."></property>
<property name="alternatedocroot_2" value="..."></property>
<property name="alternatedocroot_3" value="..."></property>

ShareThis