Reverse engineering de fichiers IDL

Vous pouvez procéder au reverse engineering de fichiers IDL afin de créer des classes et des interfaces avec leurs attributs et opérations dans un diagramme de classes.

Les reverse engineering de fichiers IDL est soumis aux restrictions suivantes :

Pré-traitement - Lorsqu'un symbole # est placé au début d'une ligne, la fonctionnalité de reverse engineering traite à la fois les valeurs "if" et "else".

Les balises suivantes ne sont pas prises en compte par le reverse engineering :

fixed <8, 4>
fixed <8, 2>
sequence <short, 4>
sequence
[wire_marshal( wireVARIANT )]

Exemple :

struct bar {
  fixed <8, 4> high_scale;
  fixed <8, 2> low_scale;
};

struct bar {
  long val;
  sequence <short, 4> my_shorts;
};

typedef sequence<LinkKind>LinkKinds;
typedef [wire_marshal( wireVARIANT )]  struct tagVARIANT  VARIANT;

Remarque : Si vous pointez sur les fichiers devant subir le reverse engineering, cliquez le bouton droit de la souris et sélectionnez la commande Editer, vous pouvez afficher le contenu de ces fichiers. Pour pouvoir utiliser cette commande, vous devez associer le suffixe de nom de fichier à un éditeur dans la boîte de dialogue Options générales\Editeur.

Sélectionnez Langage > Reverse engineering IDL pour afficher la boîte de dialogue Reverse engineering de IDL.
Sélectionnez Fichiers IDL ou Répertoires IDL dans la liste Reverse engineering.
Cliquez sur le bouton Ajouter dans l'onglet Sélection.

Une boîte de dialogue standard de sélection de fichiers s'affiche.
Sélectionnez les éléments ou répertoires sur lesquels vous souhaitez faire porter le reverse engineering, puis cliquez sur le bouton Ouvrir.

Remarque :
Vous pouvez sélectionner plusieurs fichiers à la fois pour le reverse engineering, en utilisant les touches Ctrl et Maj. Vous ne pouvez pas sélectionner plusieurs répertoires à la fois.

La boîte de dialogue Reverse engineering de IDL répertorie les éléments sélectionnés.

Sélectionnez les options de reverse engineering dans l'onglet Options.

Option	Résultat
Créer des symboles	Crée un symbole dans le diagramme pour chaque objet IDL récupéré. Si vous décochez cette case, les objets récupérés ne sont visibles que dans l'Explorateur d'objets.
Marquer les classificateurs comme n’étant pas à générer	Les classificateurs récupérés par reverse engineering (classes et interfaces) ne seront ensuite plus générés à partir du modèle. Pour pouvoir les générer, vous devez cochez la case Générer dans leur feuille de propriétés respective.
Bibliothèques	Spécifie une liste de modèles de bibliothèque à utiliser comme référence lors du reverse engineering. Le modèle de destination du reverse engineering peut contenir des raccourcis vers des objets définis dans une bibliothèque. Si vous spécifiez la bibliothèque ici, le lien entre le raccourci et son objet cible (contenu dans la bibliothèque) sera préservé et la bibliothèque sera ajoutée à la liste des modèles cibles dans le modèle de destination du reverse engineering. Vous pouvez faire glisser les bibliothèques dans la liste afin de spécifier une hiérarchie de bibliothèques. PowerAMC tentera de résoudre les raccourcis trouvés dans le modèle de destination du reverse engineering en utilisant tour à tour chacune des bibliothèques spécifiées. Ainsi, si la bibliothèque v1.1 apparaît dans la liste avant la bibliothèque v1.0, PowerAMC tentera d'abord de résoudre les raccourcis vers la bibliothèque v1.1 et analysera uniquement la bibliothèque v1.0 s'il reste des raccourcis non résolus. Vous devez utiliser la liste des modèles cibles pour gérer les bibliothèques liées au modèle de destination du reverse engineering, par exemple, vous pouvez changer la version de bibliothèque (voir Guide des fonctionnalités générales > Liaison et synchronisation de modèles > Raccourcis et répliques > Utilisation des modèles cible).

Option

Résultat

Créer des symboles

Crée un symbole dans le diagramme pour chaque objet IDL récupéré. Si vous décochez cette case, les objets récupérés ne sont visibles que dans l'Explorateur d'objets.

Marquer les classificateurs comme n’étant pas à générer

Les classificateurs récupérés par reverse engineering (classes et interfaces) ne seront ensuite plus générés à partir du modèle. Pour pouvoir les générer, vous devez cochez la case Générer dans leur feuille de propriétés respective.

Bibliothèques

Spécifie une liste de modèles de bibliothèque à utiliser comme référence lors du reverse engineering.

Le modèle de destination du reverse engineering peut contenir des raccourcis vers des objets définis dans une bibliothèque. Si vous spécifiez la bibliothèque ici, le lien entre le raccourci et son objet cible (contenu dans la bibliothèque) sera préservé et la bibliothèque sera ajoutée à la liste des modèles cibles dans le modèle de destination du reverse engineering.

Vous pouvez faire glisser les bibliothèques dans la liste afin de spécifier une hiérarchie de bibliothèques. PowerAMC tentera de résoudre les raccourcis trouvés dans le modèle de destination du reverse engineering en utilisant tour à tour chacune des bibliothèques spécifiées. Ainsi, si la bibliothèque v1.1 apparaît dans la liste avant la bibliothèque v1.0, PowerAMC tentera d'abord de résoudre les raccourcis vers la bibliothèque v1.1 et analysera uniquement la bibliothèque v1.0 s'il reste des raccourcis non résolus.

Vous devez utiliser la liste des modèles cibles pour gérer les bibliothèques liées au modèle de destination du reverse engineering, par exemple, vous pouvez changer la version de bibliothèque (voir Guide des fonctionnalités générales > Liaison et synchronisation de modèles > Raccourcis et répliques > Utilisation des modèles cible).

Cliquez sur OK.

Une boîte de progression s'affiche. Si le modèle dans lequel vous effectuez un reverse engineering contient déjà des données, une boîte de dialogue de fusion s'affiche.

Pour plus d'informations sur la fusion de modèles, voir Guide des fonctionnalités générale > L'interface de PowerAMC > Comparaison et fusion de modèles.

Les classes et interfaces sont ajoutées dans votre modèle et sont visibles dans le diagramme et l'Explorateur d'objets. Elles figurent également dans l'onglet Reverse de la fenêtre Résultats, située en bas de la fenêtre principale.