Guide di integrazione › Guida di riferimento di ADL › Regole di sintassi che si applicano a Tutti i tipi di descrittore. › Struttura del descrittore

Struttura del descrittore

Ciascun file di descrittore ha la seguente struttura complessiva:

entity-type entity-name
   {
    attributes-and-subentities
   } 

In cui:

• il tipo di entità (entity-type) appartiene al componente, all'assemblato o al pacchetto e identifica il tipo di descrittore che viene contenuto nel file.
• il nome di entità (entity-name) è il nome dell'entità che viene descritta in questo file (SIDENT).
• attributi ed entità secondarie (attributes-and-subentities) è un insieme non ordinato che contiene un numero qualsiasi di attributi ed entità secondarie. Ciascun attributo è su una riga singola e dispone del modulo: name=value., dove name è un ID (IDENT) e value è un valore di stringa (STR). Ciascuna entità secondaria ha uno dei moduli seguenti:

  name : attributes
  
  type name :attributes 
  name
     {
      attributes-and-subentities
     } 
  type name
     {
      attributes-and-subentities
     } 
  

il tipo (type) e il nome (name) sono rispettivamente il tipo e il nome dell'entità secondaria.

Attributi (attributes) è un elenco separato da virgole di coppie nome=valore. È possibile specificare anche gli attributi nel blocco { } dopo la riga di intestazione dell'entità. Quando gli attributi vengono specificati sulla stessa riga come la definizione di entità (dopo i due punti), è possibile specificare gli attributi binari senza un valore (giusto il nome dell'attributo, che significa "impostato su 1"), ad esempio,

   volume boot: dev=/dev/hda1, ro 

è identico a

   volume boot: dev=/dev/hda1, ro=1 

Ciascun tipo di entità secondaria definisce uno spazio dei nomi e dentro tale spazio dei nomi può esistere solamente un'entità secondaria di un determinato nome. Ciò si applica alle entità secondarie senza tipo (uno può pensare alle entità secondarie senza tipo come se avessero una stringa vuota in qualità di tipo).

È possibile specificare attributi in-line e nel blocco { }, ma dovrebbe essere evitato tranne nei casi in cui un attributo particolare debba distinguersi (ad esempio, l'attributo .class nella specificazione di un componente subordinato); altrimenti, in entità secondarie più semplici con pochi attributi, la sintassi in-line viene preferita. Per entità più complesse con molti attributi o entità secondarie, utilizzare il blocco { }.