Panoramica

Guide di integrazione › Guida di riferimento di ADL › Sintassi del descrittore dell'assemblato › Panoramica

Panoramica

Il descrittore dell'assemblato contiene una entità di assemblato, che definisce un componente nuovo che consiste di vari componenti, i quali possono essere componenti semplici o altri assemblati. Un assemblato formato interamente da componenti istanziabili (tutti compresi in un catalogo) è considerato istanziabile. Se in un assemblato appare un componente del singleton, l'assemblato stesso è un singleton e non può essere spostato in un catalogo.

Il descrittore dell'assemblato ha la struttura seguente:

assembly sname
   { 
   .category = text
   .description = " text " 
   .console = " subord-name " 

   input  sname
   output  sname
   ... 

   property  sname &nbsp[ : dflt = value ] 
   property  sname &nbsp[ : mandatory ] 
   ... 
   volume sname

   subordinate  sname
      { 
       .class = clsname
        attr = val
       ... 
      } 

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

Gli attributi seguenti vengono definiti solo per assemblati, non hanno significato in componenti semplici:

.console

Il nome di un componente subordinato, che servirà come destinazione di accesso predefinita per questo assemblato. Esso consente di stabilire che un assemblato si comporti come un componente semplice, ovvero permette all'assemblato di accettare una richiesta di accesso nello stesso modo di un componente semplice che offra supporto per una console di accesso. Dato che non è obbligatorio che ogni componente disponga di una console di accesso (dipende dal sistema operativo e dal software installato), un assemblato non necessariamente deve disporne. Se l'assemblato non ha bisogno di una console di accesso o non ha nessun componente che possa fungere da console di accesso, è possibile omettere questo attributo o impostarlo su stringa vuota. Eccezione speciale: se l'attributo viene omesso (piuttosto che impostato esplicitamente su stringa vuota) e l'assemblato ha solamente un'entità subordinata, si presuppone che questa entità subordinata sia la destinazione di accesso predefinita. L'entità subordinata specificata dall'attributo .console (o supposta per impostazione predefinita, per assemblati singoli subordinati) può essere essa stessa un assemblato.
Non rappresenta un errore specificare un'entità subordinata che non supporti l'accesso alla console (o perché è un componente che non ha nessuna console, o perché è un assemblato che ha insiemi .console da svuotare): l'unico esito di una tale impostazione sarà che l'assemblato risultante non supporterà l'accesso alla console.

Vengono definiti gli attributi seguenti per un assemblato e hanno lo stesso significato delle loro controparti per un componente semplice:

.category	Una stringa arbitraria che definisce la categoria generale a cui il componente appartiene. È consentita dalla sintassi ADL, ma non viene interpretata in alcun modo. Viene destinata all'uso dagli strumenti di immagine di CA AppLogic per organizzare componenti in librerie di componenti (cataloghi).
.description	Una breve descrizione del componente. Analogamente a .category , il valore di questo attributo è arbitrario e considerato solo per scopi di documentazione.

L'ordine di entità nell'assemblato non è importante e tutte le entità secondarie sono facoltative, tranne per il fatto che un assemblato deve avere almeno una entità subordinata.

Ecco qui un riepilogo delle entità secondarie dell'entità assemblato, seguita da sottosezioni che definiscono in dettaglio:

input, output	Queste entità secondarie definiscono i terminali dell'assemblato.
property	Definisce una proprietà dell'assemblato. È necessario connettere ciascuna proprietà ad almeno una proprietà di un componente subordinato - vedere l'entità subordinata.
volume	Definisce una proprietà dell'assemblato, simile all'entità di proprietà.
subordinate	Definisce un componente subordinato nell'assemblato.
connections	Definisce la tabella di connessioni dell'assemblato. Questa è un'entità di matrice, ciascun elemento corrisponde a una connessione.
visual	Dati di presentazione visivi. ADL non definisce i contenuti di questa entità. Si suppone che, per un'interfaccia utente grafica, l'editor per archiviare informazioni relative alla visualizzazione dell'assemblato sia visualizzato nella finestra dell'editor (colore, forma dell'icona, layout di terminali, layout di componenti subordinati, routing di connessioni eccetera). I contenuti di questa entità devono essere conformi alle regole di sintassi generali di UDL, che sono state presentate prima in questo documento, nelle Regole di sintassi che si applicano alla sezione Tutti i tipi di descrittore. Consultare anche la specificazione di UDL per ulteriori informazioni.