Présentation

Manuels d'intégration › Manuel de référence du langage ADL › Syntaxe de descripteur d'assemblage › Présentation

Présentation

Le descripteur d'assemblage contient une entité d'assemblage, définissant un nouveau composant qui en comprend plusieurs, qui peuvent être de simples composants ou d'autres assemblages. Un assemblage constitué entièrement de composants instantiables (résidant tous dans un catalogue) est lui-même considéré comme un instantiable. Si un composant de singleton s'affiche dans un assemblage, l'assemblage proprement dit est un singleton et ne peut pas être déplacé dans un catalogue.

Le descripteur d'assemblage a la structure suivante :

nom s d'assemblage
   { 
   .category = texte
   .description = " texte " 
   .console = " nom-subord " 

   input  nom s
   output  nom s
   ... 

   property  nom s &nbsp[ : dflt = valeur ] 
   property  nom s &nbsp[ : mandatory ] 
   ... 
   volume nom s

   subordinate  nom s
      { 
       .class = nom cls
        attr = val
       ... 
      } 

   connections 
      [ 
       nom-sub. nom-trm => nom-sub . nom-trm
      ....  
      ] 
   visual 
      { 
      ... 
      } 
   }

Les attributs suivants sont définis pour des assemblages uniquement. Ils n'ont aucune signification dans des composants simples :

.console

Nom d'un composant subordonné qui servira de cible de connexion par défaut pour cet assemblage. Il permet de définir un assemblage qui se comporte comme un simple composant dans le sens où il autorise l'assemblage à accepter une demande de connexion de la même façon qu'un composant simple prenant en charge une console de connexion. Comme tous les composants ne sont pas requis pour disposer d'une console de connexion (en fonction du système d'exploitation et du logiciel installé), aucun assemblage n'est requis pour disposer de cette console. Si l'assemblage ne nécessite aucune console de connexion ou ne dispose d'aucun composant pouvant faire office de console, vous pouvez ignorer cet attribut ou le définir sur la chaîne vide. En tant qu'exception spéciale, lorsque l'attribut est ignoré (plutôt qu'explicitement défini sur la chaîne vide) et que l'assemblage ne compte qu'un seul subordonné, ce subordonné est implicitement considéré comme cible de connexion par défaut. Le subordonné spécifié par l'attribut .console (ou utilisé implicitement par défaut pour des assemblages ne comptant qu'un seul subordonné) peut lui-même être un assemblage.
Spécifier un subordonné ne prenant pas en charge de connexion à la console n'est pas une erreur (soit parce qu'il s'agit d'un composant qui n'a aucune console, soit parce qu'il s'agit d'un assemblage pour lequel .console est vide). Ce paramétrage a pour unique résultat que l'assemblage qui en découle ne prend pas en charge la connexion à la console.

Les attributs suivants sont définis pour un assemblage ; ils ont la même signification que leurs équivalents pour un composant simple :

.category	Chaîne arbitraire qui définit la catégorie générale à laquelle le composant appartient. Elle est autorisée par la syntaxe ADL, mais n'est interprétée d'aucune façon. Elle est utilisée par les outils visuels CA AppLogic pour organiser les composants dans les bibliothèques de composants (catalogues).
.description	Brève description du composant. Comme pour l'attribut .category, la valeur de cet attribut est arbitraire et sert uniquement à titre informatif.

L'ordre des entités dans l'assemblage n'a aucune importance et toutes les sous-entités sont facultatives, si ce n'est qu'un assemblage au moins doit avoir une entité subordonnée.

Voici un récapitulatif des sous-entités de l'entité "'assemblage", suivi par des sous-sections définissant chacune d'elles en détail :

input, output	Ces sous-entités définissent les terminaux de l'assemblage.
property	Définit une propriété de l'assemblage. Chaque propriété doit être reliée à au moins une propriété d'un composant subordonné. Voir Entité subordonnée.
volume	Définit une propriété de l'assemblage similaire à l'entité de propriété.
subordinate	Définit un composant subordonné dans l'assemblage.
connections	Définit la table de connexion de l'assemblage. Il s'agit d'une entité de tableau dans laquelle chaque élément correspond à une connexion.
visual	Données de présentation visuelle. ADL ne définit pas le contenu de cette entité. Elle est destinée à l'éditeur de l'interface utilisateur graphique pour stocker des informations relatives à l'affichage de l'assemblage dans la fenêtre de l'éditeur (couleur, forme d'icône, présentation des terminaux, présentation des composants subordonnés, routage des connexions, etc.). Le contenu de cette entité doit être conforme aux règles de syntaxe générales du langage UDL présentées plus haut dans ce document à la section Règles de syntaxe s'appliquant à tous les types de descripteur. Consultez la spécification UDL pour plus d'informations.