5.1   Les sources

L'implémentation C++ de notre module CORBA HELLO (interface idl HELLO_Gen) est faite dans le répertoire /src/HELLO:

HELLO.hxx
HELLO.cxx

Au début du header de notre module (HELLO.hxx), les inclusions suivantes sont nécessaires:

#include <SALOMEconfig.h>
#include CORBA_SERVER_HEADER(HELLO_Gen)
#include "SALOME_Component_i.hxx"

Le fichier SALOMEconfig.h contient un certain nombre de définitions utiles pour assurer l'indépendance du code par rapport à la version de CORBA utilisée. SALOME_Component_i.hxx contient l'interface de la classe d'implémentation C++ du composant de base Salome (idl Engines::Component). Enfin, la macro CORBA_SERVER_HEADER assure l'indépendance des noms de fichiers d'inclusion par rapport à l'implémentation de l'ORB CORBA.

Après cela, nous définissons une classe d'implémentation, nommée HELLO, dérivant de POA_HELLO_ORB::HELLO_Gen (classe abstraite générée automatiquement par CORBA lors de la compilation de l'idl) et de Engines_Component_i (car l'interface idl HELLO_Gen dérive de Engines::Component comme tout composant Salome2). Cette classe contient un constructeur dont les arguments sont imposés par CORBA, un destructeur virtuel, et une méthode makeBanner fournissant le service souhaité:

class HELLO:
  public POA_HELLO_ORB::HELLO_Gen,
  public Engines_Component_i
{
public:
    HELLO(CORBA::ORB_ptr orb,
            PortableServer::POA_ptr poa,
            PortableServer::ObjectId * contId,
            const char *instanceName,
            const char *interfaceName);
    virtual ~HELLO();
    char* makeBanner(const char* name);
};

La fonction makeBanner prend comme argument et renvoit un char*, projection C++ du type CORBA/IDL string. La documentation complète du mapping c++ de l'IDL est fournie par l'OMG sur son site internet : http://www.omg.org/cgi-bin/doc?ptc/00-01-02.

Enfin, nous fournissons l'interface (normalisé) de la fonction HELLOEngine_factory, qui sera appelée par le "FactoryServer C++" pour charger le composant HELLO:

extern "C"
    PortableServer::ObjectId * HELLOEngine_factory(
            CORBA::ORB_ptr orb,
            PortableServer::POA_ptr poa,
            PortableServer::ObjectId * contId,
            const char *instanceName,
            const char *interfaceName);

Dans le fichier source (HELLO.cxx) se trouvent les définitions du constructeur et de la fonction d'instanciation HELLOEngine_factory (toutes deux normalisées!), et de makeBanner:

char* HELLO::makeBanner(const char* name)
{
    string banner="Hello, ";
    banner+=name;
    return CORBA::string_dup(banner.c_str());
}

Dans cette fonction, l'emploi de string_dup (fonction déclarée dans le namespace CORBA) n'est pas obligatoire (on aurait pu utiliser l'opérateur new), mais conseillé car ces fonctions permettent aux ORB d'utiliser des mécanismes spéciaux de gestion de la mémoire sans avoir à redéfinir les opérateurs new globaux.

5.2   Makefile

Dans le makefile, il faut définir certaines cibles:

VPATH=.:@srcdir@:@top_srcdir@/idl
LIB = libHELLOEngine.la
LIB_SRC = HELLO.cxx
LIB_SERVER_IDL = HELLO_Gen.idl
LIB_CLIENT_IDL = SALOME_Component.idl SALOME_Exception.idl Logger.idl
CPPFLAGS += -I${KERNEL_ROOT_DIR}/include/salome
LDFLAGS+= -lSalomeContainer -lOpUtil -L${KERNEL_ROOT_DIR}/lib/salome

Passons en revue chacune de ces cibles. - LIB contient le nom normalisé (lib<Nom_Module>Engine.la) le nom de la librairie, LIB_SRC définit le nom des fichiers sources, et VPATH les repertoire où l'on peut les trouver. - LIB_SERVER_IDL contient le nom des fichiers idl implémentés par le module. - LIB_CLIENT_IDL contient le nom des idl où sont définis les services CORBA utilisés par le module. HELLO utilise Logger.idl via les macros "MESSAGE", SALOME_Component.idl et SALOME_Exception.idl via l'héritage de HELLO_ORB:: - Il faut ajouter à CPPFLAGS le chemin pour les fichiers includes utilisés (SALOMEconfig.h, SALOME_Component_i.hxx et utilities.h se trouvent dans ${KERNEL_ROOT_DIR}/include/salome):: - La classe HELLO utilise les librairies lib (pour Engines_Component_i) et libOptUtil (pour PortableServer et Salome_Exception). On indique donc le nom de ces librairies et leur chemin dans LDFLAGS. D'autres librairies sont souvent utiles, par exemple libsalomeDS si on implémente la persistence, ou libSalomeNS si on utilise le naming service.

7.1   Introduction

Pour aller plus loin dans l'intégration de notre module, nous allons ajouter une interface graphique (développée en Qt), s'intégrant dans l'interface applicative de Salome (IAPP). On ne détaillera pas ici le fonctionnement de l'IAPP de Salome, mais pour résumer, l'IAPP gère une boucle d'évènements (clics souris, clavier, etc), et redirige après traitement ces évènements vers le module actif (le principe est qu'à un instant donné, un module est actif. Lorsqu'un module est activé, son IHM est chargée dynamiquement). Le programmeur de la GUI d'un module a donc à charge de définir les méthodes permettant de traiter correctement les évènements transmis. Parmi ces méthodes, citons les principales : OnGUIEvent(), OnMousePress(), OnMouseMove(), OnKeyPress(), DefinePopup(), CustomPopup().

7.2   Choix des widgets

7.3   Implémentation de l'IHM

L'implémentation C++ de l'IHM est faite dans le répertoire /src/HELLOGUI. Le header HELLOGUI.h déclare de la classe HELLOGUI, et contient des directives Qt (Q_OBJECT). De ce fait, il doit être processé par le compilateur moc (Qt Meta Model Compiler). Pour cette raison, l'extension du fichier est .h et dans le Makefile nous ajoutons la cible:

LIB_MOC = HELLOGUI.h

Le fichier source HELLO.cxx contient la définition des fonctions membres, et le Makefile permet de construire une librairie libHELLOGUI (le nom est normalisé poour permettre le chargement dynamique : lib<NomModule>GUI.

switch (theCommandID)
  {
  case 901:
    // Traitement de "Get banner"
    ...
  case 190:
    // Traitement de "MyNewItem"
    ...
  }

myName = QInputDialog::getText( tr("QUE_HELLO_LABEL"), tr("QUE_HELLO_NAME"),
                                QLineEdit::Normal, QString::null, &ok);

- MEN_ : label menu
- BUT_ : label bouton
- TOT_ : aide tooltip
- ERR_ : message d'erreur
- WRN_ : message d'alerte
- INF_ : message d'information
- QUE_ : question
- PRP_ : prompt dans la barre des status

msgid "HELLOGUI::INF_HELLO_BANNER"
msgstr "HELLO Information"

findtr HELLOGUI.cxx > HELLO_msg_en.po

PO_FILES =  HELLO_msg_en.po HELLO_msg_fr.po

langage=<langage>