Xmlx Xmlx. Gregory Adam 04/07/ /

Transcription

1 Xmlx Gregry Adam 04/07/ /

2 Cntents Intrductin... 3 Caractéristiques... 3 Exemple de prgramme... 4 Créatin d un Dcument... 8 Créer un nuveau type... 9 Ajuter un élément Ajuter un attribut a un élément Prductin de l XML Appendix A Prpriétés des Types Appendix B Types inclus /

3 Intrductin Xmlx est une classe qui permet de cnstruire une arbrescence XML en mémire et de la transfrmer sus frme de chaine u fichier. Cela veut dire qu il ne faut plus s ccuper du fichier XML (encdage/fputs()/textmerge) et qu n peut se cncentrer sur la structure même. Caractéristiques XML en UTF-8 Méthdes pur Créer des éléments (nœuds) avec u sans texte Créer des attributs (attachés aux éléments) Créer des types basés sur d autres types ( 18 snt déjà inclus) Transfrmer en chaine (avec u sans TABs/CR pur la lisibilité) Transfrmer en fichier (avec u sans TABs/CR pur la lisibilité) Cntrôle des valeurs (type, valeur min/max) au mment de leur additin au dcument Encdage Du cdepage actif vers UTF-8 Traiter les caractères spécifiques a XML ( < > & ) Assez rapide. La première versin prenait 9 secndes pur ajuter 5000 éléments/nœuds et la transfrmatin en fichier La deuxième versin le fait en mins d une secnde 3 /

4 Exemple de prgramme #define true #define false.t..f. lcal success success = true lcal xmldcobj, filexml, rtndename, typeobj filexml = 'd:\tmp\1.xml' rtndename = 'hc:headcunt' && nm de la racine d case && creatin du dcument + racine case!xmlx_newobject_dcument(@m.xmldcobj, m.rtndename) && creatin d'un nuveau type 'divisintype' base: integer d case && creatin d'un nuveau type 'divisintype' base: integer case!m.xmldcobj.getnewtype(@m.typeobj, 'integer', 'divisintype') therwise && restrictins : entre 20 et 98 typeobj.minincl = 20 typeobj.maxexcl = 99 d case && ajut du type divisintype case!m.xmldcobj.addnewtype(m.typeobj) && creatin d'un deuxieme type 'peppernametype' base: 'string' d case 4 /

5 'string', 'peppernametype') therwise typeobj.minlength = 10 && lngueur minimale de 10 typeobj.maxlength = 30 && lngueur maximale de 30 && tus les nms divent cntenir 'Pepper' typeobj.pattern = '.*Pepper.*' d case && ajut du type peppernametype case!m.xmldcobj.addnewtype(m.typeobj) && ajut des namespace = attributs de la racine d case && nm, type, valeur case!m.xmldcobj.addattribute(m.xmldcobj.rt, 'xmlns:hc', 'string', 'xsdheadcunt') case!m.xmldcobj.addattribute(m.xmldcobj.rt, 'xmlns:xsi', 'string', ' lcal parentid, childid, i parentid = m.xmldcobj.rt fr i = 1 t 2 d case exit && creatin d'un element avec texte case!m.xmldcobj.addelement(@m.childid, m.parentid, 'Name', 'peppernametype', 'Wald Pepper_'+transfrm(m.i)) 5 /

6 20) && ajuter un atttribut a cet element: divisin = '20' case!m.xmldcobj.addattribute(m.childid, 'divisin', 'divisintype', && ajuter la date de naissance a cet element case!m.xmldcobj.addelement(, m.childid, 'BirthDate', 'date', date()) && creatin d'un element sans texte ( <SansTexte><divisinType>98</divisinType></SansTexte> ) case!m.xmldcobj.addelement(@m.childid, m.parentid, 'SansTexte', null, null) 98) && ajuter divisintype a cet element case!m.xmldcobj.addattribute(m.childid, 'divisin', 'divisintype', endfr d case && ecrire ce dcument case!m.xmldcobj.tfile(m.filexml, false) && ptinel pur le develppement && ecrire le dc sus fichier texte pur inspectin visuelle && avec trp de TABs et CRLF case!m.xmldcobj.tfile(frceext(m.filexml, 'txt'), true) 6 /

7 Ce prgramme prduit deux fichiers, un XML et un TXT, dnt le fichier TXT ne sert que pendant le dévelppement. 7 /

8 Tute méthde returne.t. si OK et.f. en cas de prblème (mauvais paramètres etc.) Créatin d un Dcument Lcal dcobj If(!Xmlx_NewObject_Dcument(@m. dcobj, rtelementname)) && erreur Else && k Endif Paramètres dcobj : passer par référence, c est l bjet dcument même rtelementname : le nm de la racine 8 /

9 Créer un nuveau type Se fait en tris étapes 1. Obtenir un nuveau type parenttypename, typename) typeobj : nuvel bjet type parenttypename : le type sur lequel le nuveau type est basé typename : le nm du nuveau type 2. Mdifier les prpriétés du nuveau type ( vir Appendix A) Exemple : typeobj.minlength = Ajuter ce type xmldc.addnewtype(m.typeobj) 9 /

10 Ajuter un élément xmldc. parentid, elementname, datatype, value) childid : id du nuvel élément créé n purra ajuter des éléments a ce nuvel élément en passant ce childid cmme deuxième paramètre a AddElement() parentid : id de l élément auquel n ajute elementname : le nm de cet élément datatype : le type de cet élément value : la valeur de cet élément Ntes Si c est un élément sans texte (valeur) il faut passer null pur datatype et value 10 /

11 Ajuter un attribut a un élément =xmldc. AddAttribute(parentId, attributename, datatype, value) parentid : id de l élément auquel n ajute cet attribut attributename : le nm de cet attribut datatype : le type de cet attribut value : la valeur de cet attribut 11 /

12 Prductin de l XML xmldc. TFile(filename [, lbeautify]) xmldc. GetString(@m.s [, lbeautify] ) TFile() prduit un fichier et GetString() prduit une chaine filename : nm du fichier s : chaine à passer par référence lbeautify si.f. u absent, prduit de l XML très cmpacte (sans TAB et CRLF) si.t. insère des TAB et CRLF pur prduire un fichier qui mntre les niveaux 12 /

13 Appendix A Prpriétés des Types Nm length minlength maxlength ttaldigits fractindigits Lngueur fixe Lngueur minimale Lngueur maximale Nmbre maximal de chiffres Nmbre maximal de chiffres après le séparateur décimal Nte : si spécifié, c est le nmbre qu n retruvera dans le fichier xml. Exemple : fractindigits= 2 Valeur = 0, dans l XML n retruvera 0.00 minincl Valeur minimale ( v >= minincl ) maxincl Valeur maximale ( v <= maxincl ) minexcl Valeur minimale ( v > minexcl ) maxexcl Valeur maximale ( v < maxexcl ) pattern Pattern regex 13 /

14 Appendix B Types inclus Nm Parent Caractéristiques decimal string blean date datetime byte decimal fractindigits = 0, minincl = -128, maxincl = 127 int decimal fractindigits = 0, minincl= -0x , maxincl = 0x7fffffff integer decimal fractindigits = 0 lng decimal fractindigits = 0, minincl = , maxincl = negativeinteger decimal fractindigits = 0, maxincl = -1 nnnegativeinteger decimal fractindigits = 0, minincl = 0 nnpsitiveinteger decimal fractindigits = 0, maxincl = 0 psitiveinteger decimal fractindigits = 0, minincl = 1 shrt decimal fractindigits = 0, minincl = -0x8000, maxincl = 0x7fff unsignedlng decimal fractindigits = 0, minincl = 0, maxincl = unsignedint decimal fractindigits = 0, minincl = 0, maxincl = unsignedshrt decimal fractindigits = 0, minincl = 0, maxincl = 0xffff unsignedbyte decimal fractindigits = 0, minincl = 0, maxincl = 0xff 14 /