WikiAdmin : 1 version importée : dfg

2026-07-24T17:08:24Z

1 version importée : dfg

← Version précédente	Version du 24 juillet 2026 à 17:08
(Aucune différence)

toross>WikiAdmin : /* Explication des sources */

2024-02-16T22:00:55Z

Explication des sources

Nouvelle page

{{IntroductionDFG}}
== Tuto_002 : Développement en c++ sous LINUX ==
=== L'objectif ===
{{parW|1=
L'objectif est de montrer comment créer rapidement un driver en c++ pour écrire/lire dans/depuis un fichier au format {{mb|xml}} dont les données sont modélisées par le diagramme suivant :
{{c|
<uml>
class CDessin {
}
CDessin *--> "1" CBase : base
CPoint --|> CBase
CPoint : float x
CPoint : float y
CSegment --|> CBase
CSegment *--> "1" CPoint : A
CSegment *--> "1" CPoint : B
CCercle --|> CBase
CCercle *--> "1" CPoint : C
CCercle : float R
CCompound --|> CBase
CCompound *--> "*" CBase : elements
hide empty methods
hide empty fields
</uml>
}}
}}
=== Pour commencer ===
{{parW|1=

Pour commencer créer les répertoires {{m|tuto_002/}} {{m|myXercesTools}} et {{m|utilities}} dans un répertoire commun dans lesquels nous allons travailler. Pour ceci tapez :

<source lang="bash">
mkdir tuto_002
mkdir myXercesTools
mkdir utilities
mkdir tuto_002/generated
mkdir tuto_002/generated_out
</source>
Vous aurez alors :
<source lang="bash">
├── myXercesTools
├── tuto_002
│ ├── generated
│ └── generated_out
└── utilities
</source>

}}

=== Le modèle ===
{{parW|1=

Le modèle utilisé par DataFlowGenerator correspondant au modèle uml précédent est le suivant :

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<grammar type="xml" version="1.0.0" FileFormatVersion="1.0.0">
<el name="dessin" type="CDessin">
<el name="base" type="CBase" OnlyDefinition="1">
</el>
<el name="point" type="CPoint" heritances="CBase" OnlyDefinition="1">
<el name="x" type="float"/>
<el name="y" type="float"/>
</el>
<el name="segment" type="CSegment" heritances="CBase" OnlyDefinition="1">
<el name="A" type="@CPoint"/>
<el name="B" type="@CPoint"/>
</el>
<el name="cercle" type="CCercle" heritances="CBase" OnlyDefinition="1">
<el name="C" type="@CPoint"/>
<el name="R" type="float"/>
</el>
<el name="compound" type="CCompound" cardinality="*" heritances="CBase">
<el name="elements" type="@CBase" cardinality="*"
accept="CPoint:CSegment:CCercle:CCompound"/>
</el>
</el>
</grammar>
</source>

}}{{parW|1=

Sur le site http://dfg.bht.fr, copiez ce modèle dans le champ de texte nommé {{mb|grammar_file_name}} et dans le champ de texte nommé {{mb|data_name}} écrivez "tuto_002_".

Sélectionnez {{mb|Générer du c++ avec Xerces}} et puis cliquez sur le bouton {{mb|Générer}} pour créer les fichiers suivants :
* Les variables :
** tuto_002_XMLDriver_pkg_version.h
** tuto_002_XMLDriver.h
** tuto_002_XMLDriver.cxx
* Les fixes
** my_xerces_impl.h
** my_xerces_impl.cxx
** utilities.h
** utilities.cxx

}}{{parW|1=

Copier ces fichiers dans les répertoires {{m|myXercesTools}}, {{m|utilities}} et {{m|tuto_002/generated}} :

<source lang="bash">
.
├── myXercesTools
│ ├── my_xerces_impl.cxx
│ └── my_xerces_impl.h
├── tuto_002
│ ├── generated
│ │ ├── tuto_002_XMLDriver.cxx
│ │ ├── tuto_002_XMLDriver.h
│ │ └── tuto_002_XMLDriver_pkg_version.h
└── utilities
├── utilities.cxx
└── utilities.h
</source>
}}

=== Compilation ===
==== Si XERCES 2.7 n'est pas installé sur votre système ====
{{parW|1=
Les sources de XERCES peuvent être téléchargées sous la forme de fichier nommé xerces-c-src_2_7_0.tar.gz depuis le site de [http://archive.apache.org/dist/xml/xerces-c/Xerces-C_2_7_0/source/ archive.apache.org/dist/xml/xerces-c/Xerces-C_2_7_0/source/].

}}{{parW|1=

En notant {{m|<install_bin_dir>}} le répertoire dans lequel sera installée XERCES et {{m|<install_src_dir>}} le
répertoire à partir duquel l'installation est réalisée, les opérations suivantes permettent l'installation :
{{code|lang=bash|line|code=
1 mkdir {{m|<install_bin_dir>}}/xerces-c-lib_2_7_0
2 export {{m|XERCESCROOT}}=<install_src_dir>
3 cd {{m|<install_src_dir>}}/src/xercesc
4 autoconf
5 ./runConfigure -plinux -P {{m|<install_bin_dir>}}
6 make
7 make install
}}
}}
==== Le programme tuto_002 ====
{{parW|1=

Maintenant la variable XERCESCROOT doit être positionné sur le librairie XERCES installé donc cette fois-ci :
<source lang="bash">
export XERCESCROOT=<install_bin_dir>
</source>
par exemple :
<source lang="bash">
export XERCESCROOT=/local01/atoross/exe/xerces-c-lib_2_7_0
</source>
Afin de pouvoir exécuter le programme compilé il faut aussi modifier LD_LIBRARY_PATH comme suit :
<source lang="bash">
export LD_LIBRARY_PATH=$XERCESCROOT/lib:$LD_LIBRARY_PATH
</source>
Le répertoire XERCESCROOT doit contenir les répertoires :
<source lang="text">
.
├── include
└── lib
</source>

Créer un fichier nommé "{{m|Makefile}}" dans le répertoire tuto_002 et copier le texte suivant dans ce fichier :
<source lang="bash">
proj=tuto_002
all : test

test : ${proj}

${proj} : util.o myxerces.o xmldriver.o main.cpp
g++ -I${XERCESCROOT}/include -I../utilities -Igenerated -I../myXercesTools -L${XERCESCROOT}/lib -lxerces-c main.cpp util.o myxerces.o xmldriver.o -o ${proj}

util.o : ../utilities/utilities.cxx ../utilities/utilities.h
g++ -I../utilities ../utilities/utilities.cxx -c -o util.o

xmldriver.o :generated/$(proj)_XMLDriver.cxx generated/$(proj)_XMLDriver.h generated/$(proj)_XMLDriver_pkg_version.h
echo "g++ -I${XERCESCROOT}/include -I../utilities -I../myXercesTools -Igenerated -L${XERCESCROOT}/lib generated/${proj}_XMLDriver.cxx -c -o xmldriver.o"
g++ -I${XERCESCROOT}/include -I../utilities -I../myXercesTools -Igenerated -L${XERCESCROOT}/lib generated/${proj}_XMLDriver.cxx -c -o xmldriver.o

myxerces.o: ../myXercesTools/my_xerces_impl.cxx ../myXercesTools/my_xerces_impl.h
echo "g++ -I../utilities -I../myXercesTools -I${XERCESCROOT}/include -L${XERCESCROOT}/lib ../myXercesTools/my_xerces_impl.cxx -c -o myxerces.o"
g++ -I../utilities -I../myXercesTools -I${XERCESCROOT}/include -L${XERCESCROOT}/lib ../myXercesTools/my_xerces_impl.cxx -c -o myxerces.o
clean :
-rm *.o *~ ${proj} ./generated_out/*
</source>
Les sources du programme doivent être écrite dans le fichier nommé "{{m|main.cpp}}" et créé dans tuto_002, copier ces sources depuis le paragraphe "[[#Le_programme_complet|le programme complet]]" dans ce fichier.
Nous avons maintenant les fichiers suivants :
<source lang="text">
.
├── myXercesTools
│ ├── my_xerces_impl.cxx
│ └── my_xerces_impl.h
├── tuto_002
│ ├── generated
│ │ ├── tuto_002_XMLDriver.cxx
│ │ ├── tuto_002_XMLDriver.h
│ │ └── tuto_002_XMLDriver_pkg_version.h
│ ├── generated_out
│ ├── main.cpp
│ ├── Makefile
└── utilities
├── utilities.cxx
└── utilities.h
</source>
Pour compiler entrer dans le répertoire tuto_002 et tapez :
<source lang="bash">
make
</source>
Pour exécuter le programme entrer dans le répertoire tuto_002 et tapez :
<source lang="bash">
./tuto_002
</source>
Vous verrez alors aparaître le fichiers :
<source lang="text">
generated_out/
├── dessin1.xml
└── dessin2.xml
</source>

}}

=== Explication des sources ===

==== Extension, utilisation de la fabrique ====
{{parW|1=

Avoir des données sans pouvoir ajouter des traitements ou extensions ce n'est pas très intéressant. Pour étendre les classes générées on utilise l' héritage et le polymorphisme des classes. Afin de pouvoir utiliser les nouveaux types de classe on utilise un {{m|fabrique}} qui est un {{m|singleton}}.

Par exemple si nous voulions ajouter un traitement aux cercle, une translation, on peut écrire le code suivant :
<source lang="cpp">
class myCCercle : public CCercle
{
public :
int my_attr ;
myCCercle() : CCercle(), my_attr(0)
{
} ;
void move( double dx, double dy )
{
C->x = C->x+dx ;
C->y = C->y+dy ;
}
};
CDessinBase * myCCercle_factory()
{
return new myCCercle() ;
};
</source>

Mais il ne faut pas oublier d'enregistrer cette classe dans la fabrique, voici comment le faire :
<source lang="cpp">
CDessinBase_factory::instance()->register_creator( "CCercle", myCCercle_factory ) ;
</source>

Pour créer la classe il suffit d'appeler la fabrique :
<source lang="cpp">
CCercle * cercle = (CCercle *) factory->create( "CCercle" ) ;
</source>

Voici l'exemple qui montre comment appliquer le translation :
<source lang="cpp">
myCCercle* mycercle = (myCCercle*) cercle ;
mycercle->move( 10.0, 10.0 ) ;
</source>

}}
==== Construction des données ====
{{parW|1=

La construction se fait en appelant la fabrique. Pour les structures ayant une cardinal diffèrent de 1 nous utilisons les {{m|vecteur}} de la librairie {{m|STL}}.
Exemple :
<source lang="cpp">
CDessinBase_factory * factory =CDessinBase_factory::instance();

...

CDessin * Med = (CDessin *) factory->create( "CDessin" ) ;
CCompound * comp = (CCompound *) factory->create( "CCompound" ) ;
Med->compound.push_back( comp ) ;
</source>

{{Remarque|texte=La mémoire allouée est libérée par le code généré}}
}}
==== Charger et décharger ====
{{parW|1=
En utilisant une instance de {{m|CFileFormatInfo}} nous pouvons sauvegarder ou charger tout fichier contenant les données conforme au modèle.
<source lang="cpp">
CFileFormatInfo Info ;
Info.Save2XMLFile( Med , "generated_out/dessin1.xml" ) ;

CDessin * Med2 = Info.LoadFromXMLFile( "generated_out/dessin1.xml" ) ;
Info.Save2XMLFile( Med2 , "generated_out/dessin2.xml" ) ;
</source>

{{Remarque|texte=La classe {{m|CFileFormatInfo}} cache bon nombre d'initialisations XERCES.}}
}}
==== Le programme complet ====
{{parW|1=
<source lang="cpp">
#include "generated/tuto_002_XMLDriver.h"
#include <iostream>
#include <typeinfo>
using namespace tuto_002_XMLDriver_ns ;

class myCCercle : public CCercle
{
public :
int my_attr ;
myCCercle() : CCercle(), my_attr(0)
{
} ;
void move( double dx, double dy )
{
C->x = C->x+dx ;
C->y = C->y+dy ;
}
};

CDessinBase * myCCercle_factory()
{
return new myCCercle() ;
};

int main(int argc, char * argv[ ])
{
std::cout << "start" << std::endl ;

//enregistrement du créateur
CDessinBase_factory::instance()->register_creator( "CCercle", myCCercle_factory ) ;

// Instance sur la fabrique de classe
CDessinBase_factory * factory =CDessinBase_factory::instance();

// Créaton dans la mémoire
CDessin * Med = (CDessin *) factory->create( "CDessin" ) ;
CCompound * comp = (CCompound *) factory->create( "CCompound" ) ;
Med->compound.push_back( comp ) ;

CCercle * cercle = (CCercle *) factory->create( "CCercle" ) ;
cercle->C->x = 12.0 ;
cercle->C->x = 3.0 ;
cercle->R = 40.0 ;
comp->elements.push_back( (CBase *) cercle ) ;

CSegment * segment = (CSegment *) factory->create( "CSegment" ) ;
segment->A->x = 5.0 ;
segment->A->y = 6.0 ;
segment->B->x = 1.0 ;
segment->B->y = -2.0 ;
comp->elements.push_back( (CBase *) segment ) ;

CCompound * comp2 = (CCompound *) factory->create( "CCompound" ) ;
comp->elements.push_back( (CBase *) comp2 ) ;
cercle = (CCercle *) factory->create( "CCercle" ) ;
cercle->C->x = 16.0 ;
cercle->C->x = 7.0 ;
cercle->R = 30.0 ;
comp2->elements.push_back( (CBase *) cercle ) ;

comp = comp2 ;

comp2 = (CCompound *) factory->create( "CCompound" ) ;
comp->elements.push_back( (CBase *) comp2 ) ;
cercle = (CCercle *) factory->create( "CCercle" ) ;
cercle->C->x = 13.0 ;
cercle->C->x = 4.0 ;
cercle->R = 20.0 ;
comp2->elements.push_back( (CBase *) cercle ) ;

comp = (CCompound *) factory->create( "CCompound" ) ;
Med->compound.push_back( comp ) ;
comp->copy( comp2 ) ;

myCCercle* mycercle = (myCCercle*) cercle ;
mycercle->move( 10.0, 10.0 ) ;

try
{
CFileFormatInfo Info ;
Info.Save2XMLFile( Med , "generated_out/dessin1.xml" ) ;

CDessin * Med2 = Info.LoadFromXMLFile( "generated_out/dessin1.xml" ) ;
Info.Save2XMLFile( Med2 , "generated_out/dessin2.xml" ) ;
}
catch (const my_xerces::myXercesError& toCatch)
{
std::cerr << toCatch.what() << std::endl ;
}
Med->clear() ;
delete Med ;

std::cout << "end" << std::endl ;
return 0 ;
}
</source>
}}
{{:DataFlowGenerator:see_too}}

Tutoriel de Data Flow Generator V0 - Historique des versions

WikiAdmin : 1 version importée : dfg

toross>WikiAdmin : /* Explication des sources */