TP/TD de programmation

La société qui vous embauche, un grossiste en vêtements, reçoit régulièrement de ses clients des flux d'informations concernant leurs statistiques de ventes.

Ces flux sont constitués de lignes de texte composées ainsi :

    <public>;<code produit>;<quantité vendue>;<mois>;<année>;<commentaire> où
    
    <public> est soit 'F' (femme), 'H' (homme), 'M' (mixte) 
    <code produit> le code fournisseur du produit
    <quantité vendue> la quantité vendue pour le mois 
    <mois> mois concerné par les statistiques de vente
    <année> année concernée par les statistiques de vente
    <commentaire> un commentaire libre et optionnel
   
    

Dans le cas présent, on nous assure que le caractère séparateur ';' est présent dans le fichier uniquement comme séparateur de champs (il n'y en a pas dans la partie commentaire) et que le contenu de la partie commentaire n'est pas encadré par des guillemets, comme c'est le cas d'ordinaire avec le format CSV lorsqu'une donnée contient des espaces.

Exemple :

F;a12;21;mars;2002; Attention, léger défaut de fabrication sur la ceinture.

Cette chaîne signifie que le produit, catalogué pour "femme" et de code "a12", a fait l'objet de "21" ventes au mois de "mars" "2002". Le détaillant signale un léger défaut de fabrication.

La direction vous demande de créer un programme qui traduit un fichier de données au format CSV (Comma Separated Values) transmis par un cient (comme indiqué ci-dessus), en un fichier XML (eXtensible Markup Language). Pour cela, vous devez respecter le jeu de balises fourni par l'exemple ci-dessous.

Exemple de données source CSV :

F;a12;21;mars;2002; Attention, léger défaut de fabrication sur la ceinture.
H;d45;11;mai;2002;
F;a12;6;mars;2002;

Exemple de données résultat XML :

<?xml version="1.0" encoding="ISO-8859-1"?>

<ventes>
 <produit>
    <public>F</public> 
    <code>a12</code>
    <qte>21</qte> 
    <mois>mars</mois>
    <annee>2002</annee>
    <commentaire>Attention, léger défaut de fabrication sur la ceinture.</commentaire>
 </produit>
 <produit>
    <public>H</public> 
    <code>d45</code>
    <qte>11</qte> 
    <mois>mai</mois>
    <annee>2002</annee>
 </produit>
 <produit>
    <public>F</public> 
    <code>a12</code>
    <qte>6</qte> 
    <mois>mars</mois>
    <annee>2002</annee>
 </produit>
</ventes>

Afin de vérifier la conformité du document xml produit par votre programme, Bob, le développeur spécialisé dans la représentation des données, vous fournit la feuille de style ventes.xsl (voir annexe), qui permet de traduire un fichier xml de ventes en un fichier HTML.

On utilisera le programme xalan dans le but d'appliquer les règles de transformation de ventes.xsl sur le document résultat du traitement de votre programme. Supposons que votre programme produise le fichier ventes.xml, nous appelons le processeur xalan de la façon suivante, dans le but de produire le fichier ventes.html :

java org.apache.xalan.xslt.Process -in ventes.xml -xsl ventes.xsl -out ventes.html

Voici le résultat :

L'objectif de cette séance n'est pas l'étude de XSLT (Extensible Stylesheet Language Transformation). Toutefois une note d'introduction est disponible en annexe.

	Si vous programmez en Java
	Le jdk 1.4 inclut d'office xalan et les packages nécessaires à son exécution. Vous pouvez aussi télécharger les packages Xalan-Java 2 sur le site de la fondation Apache : http://xml.apache.org .

A faire : Concevoir un programme conforme au cas d'utilisation décrit ci-après.

Cas d'utilisation : ConvertirVentesCSVversXML

Scénario typique L'utilisateur fournit le nom d'un fichier de ventes au format CSV. Le système produit une version XML de ce fichier (même nom avec extension .xml). Cas particuliers 1. Le fichier n'existe pas ou son format n'est pas celui attendu : 1.1 Le système informe l'utilisateur. 1.2 Le cas s'arrête. 2. Un fichier portant le même nom, que celui communiqué en 1, avec l'extension .xml existe : 2.1 Le système demande confirmation d'écrasement. 2.2a L'utilisateur confirme : L'ancien fichier est remplacé par le nouveau. 2.2b L'utilisateur ne confirme pas : aucun fichier n'est créé, le cas s'arrête.

• Vous utiliserez ce fichier de données pour les tests : ventes.csv.

• Votre application devra prendre en compte les cas particuliers du cas d'utilisation.

• Conseil : Traiter les cas particuliers dans un second temps. Concentrez vous en premier sur le cas nominal (le cas typique).

Bravo, votre programme fonctionne correctement, mais doit évoluer afin de répondre au problème suivant.

Le service des statisiques a demandé à Bob de cumuler les quantités concernant un même produit pour une même période.

En effet, certaines lignes du document CSV concernent le même produit, pour un même mois. Dans l'exemple, repris ci-dessous :

1: F;a12;21;mars;2002; Attention, léger défaut de fabrication sur la ceinture.
2: H;d45;11;mai;2002;
3: F;a12;6;mars;2002;

Les lignes 1 et 3 concernent le produit a12 pour le mois de mars 2002. Bob souhaiterait que, dans ce cas, les quantités soient cumulées afin de limiter à une instance tout produit (code/mois) dans le document XML (de cette façon il n'aura rien à changer aux fichiers XSLT dont il a la charge, le malin...). Exemple :

<?xml version="1.0" encoding="ISO-8859-1"?>

<ventes>
 <produit>
    <public>F</public> 
    <code>a12</code>
    <qte>27</qte> 
    <mois>mars</mois>
    <annee>2002</annee>
    <commentaire>Attention, léger défaut de fabrication sur la ceinture.</commentaire>
 </produit>
 <produit>
    <public>H</public> 
    <code>d45</code>
    <qte>11</qte> 
    <mois>mai</mois>
    <annee>2002</annee>
    <commentaire/>
 </produit>
 
</ventes>

Nous pouvons généraliser notre travail.

Imaginons que les clients nous retournent le fichier de données sous cette forme :

public;code;qte;mois;annee;commentaire
F;a12;21;mars;2002;"Attention, ""léger"" défaut de fabrication sur la ceinture."
H;d45;11;mai;2002;
F;a12;6;mars;2002;
 

Vous remarquerez que :

Après avoir sauvegardé la dernière version de votre application et analysé le problème, vous proposerez une solution qui prenne en compte les 3 caractéristiques décrites ci-dessus.

Un document au format XML est un document texte constitué de balises. Mais contrairement au langage HTML, il est possible de définir librement les balises utilisées. En se focalisant essentiellement sur la structure du document (par un jeu de balises) et le contenu (à l'intérieur des balises), XML se présente comme un modèle d'architecture dans lequel les données sont séparées de la logique de présentation.

Structure minimale d'un document XML

Exemple d'un document XML (source : sujet d'examen BTS IG 2002) :

<?xml version="1.0"?> 
  <!-- ceci est un commentaire -->
  <article> 
    <auteur> Boby Lapointe </auteur>
    <copyright/> 
    <titre>Une introduction à XML</titre>
    <section> 
        <titre>Présentation de XML</titre> 
        <paragraphe>Ce document est bien formé</paragraphe>
    </section>
  </article>

Lors de traitements, un document XML est chargé en mémoire sous la forme d'un arbre. Exemple.

Ce document XML est bien formé car

De plus, une balise peut contenir des attributs. Un attribut est constitué d'une paire nom=valeur, le nom étant en minuscule et sa valeur entre guillemets (double quote). Le document peut faire référence à des entités internes et externes, contenir des instructions de traitement, définir des espaces de nom. Exemple.

<?xml version="1.0" encoding="ISO-8859-1"?>

<?xml-stylesheet type="text/xsl" href="ventes.xsl"?>

<ventes mois="mars">
 <produit>
    <public>F</public> 
    <code>a12</code>
    <qte>21</qte> 
    <annee>2002</annee>
    <commentaire>Attention, léger défaut de fabrication sur la ceinture.</commentaire>
 </produit>
 <produit>
    <public>F</public> 
    <code>a12</code>
    <qte>6</qte> 
    <annee>2002</annee>
    <commentaire></commentaire>
 </produit>
 
</ventes>

Certains navigateurs, équipés d'un processeur XSLT, peuvent interpréter le document XML par le biais d'un document XSLT mentionné dans une instruction de traitement, comme c'est le cas dans cet exemple.

Les documents XML peuvent être classés en deux catégories :

Enfin, lorsque plusieurs documents partagent le même jeu de balises, celui-ci est généralement décrit par une DTD (Document Type Definition) ou, plus récemment, par un XMLSchema (avec définition des types de données).

Voici le contenu du fichier ventes.xsl transmis par Bob.

<?xml version="1.0" encoding="ISO-8859-1"?>

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
        
 <xsl:output  method="html"  omit-xml-declaration="no"  indent="yes"/> 
        
<!-- ****************************************************************************
** root template
*****************************************************************************-->

 <xsl:template match="/"> 
   <html><head></head><body><center><br/>
       <h1>VENTES</h1>
       <xsl:apply-templates select="ventes" />
   </center></body></html> 
 </xsl:template>
 
         
<!-- ****************************************************************************
** "ventes" template
*****************************************************************************-->

<xsl:template match="ventes">
  <table border="1">
    <th>code</th><th>public</th><th>mois</th>
    <th>annee</th><th>qte</th><th>commentaire</th>

    <xsl:for-each select="produit">
      <tr>
        <td><xsl:apply-templates select="code"/></td>
        <td><xsl:apply-templates select="public"/></td>
        <td><xsl:apply-templates select="mois"/></td>
        <td><xsl:apply-templates select="annee"/></td>
        <td><xsl:apply-templates select="qte"/></td>
        <td><xsl:apply-templates select="commentaire"/></td>
      </tr>
    </xsl:for-each>
    
  </table> 
</xsl:template>

<xsl:template match="commentaire">
  <xsl:value-of select = "."/>
  <xsl:text disable-output-escaping="yes">&amp;nbsp;</xsl:text>
</xsl:template>

</xsl:stylesheet>

Remarque

En absence d'instructions de transformation d'un élément, comme c'est le cas dans ventes.xsl pour les éléments code, public, mois, annee, qte, son contenu est simplement copié dans le document résultat. Ceci nous convient bien, sauf pour l'élément commentaire pouvant parfois être vide. Or, comme celui-ci est placé dans une cellule de tableau, nous devons insérer au moins un espace (&nbps; pour non breaking space) afin d'obtenir un résultat HTML satisfaisant. C'est pourquoi l'instruction de ce noeud est explicitement défini par : 1: <xsl:template match="commentaire"> 2: <xsl:value-of select = "."/> 3: <xsl:text disable-output-escaping="yes">&amp;nbsp;</xsl:text> 4: </xsl:template> Ligne 2 : Récupère le texte du noeud (comportement par défaut). Ligne 3 : <xsl:text> permet d'ajouter du texte additionnel. Malheureusement l'instruction <xsl:text>&nbsp;</xsl:text> ne passe pas, car &nbsp; n'est pas une des cinq entités prédéfinies par XML (&lt; &gt; &amp; &quot &apos;). De plus, on ne veut pas que le processeur XSLT tente de convertir &nbsp;, destiné aux navigateurs web. D'où le changement de la valeur par défaut de l'attribut disable-output-escaping.