Guías de integración › Guía de referencia de ADL › Reglas de sintaxis que se aplican a todos los tipos de descriptores › Estructura del descriptor

Estructura del descriptor

Cada archivo del descriptor tiene la siguiente estructura general:

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

Donde:

• entity-type es un tipo de entidad de component, assembly o package e identifica el tipo de descriptor que contiene el archivo.
• entity-name es el nombre de la entidad que se describe en este archivo (SIDENT).
• attributes-and-subentities es un conjunto no ordenado que contiene cualquier número de atributos y subentidades. Cada atributo está en una sola línea y tiene el formato: name=value., donde name es un identificador (IDENT) y value es un valor de cadena (STR). Cada subentidad tiene uno de los formatos siguientes:

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

  
  type y name son el tipo y el nombre de la subentidad, respectivamente.

attributes es una lista de parejas de name=value separadas por comas. Los atributos se pueden especificar también en el bloque {} que aparece tras la línea de encabezado de entidad. Cuando los atributos se especifican en la misma línea que la definición de la entidad (después de los dos puntos), los atributos binarios se pueden especificar sin un valor (únicamente el nombre del atributo, que significa 'establecido como 1'), por ejemplo:

   volume boot: dev=/dev/hda1, ro 

es lo mismo que

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

Cada tipo de subentidad define un espacio de nombres, y dentro de ese espacio de nombres puede existir solamente una subentidad de un nombre determinado. Eso se aplica a las subentidades de ningún tipo (se puede pensar en las subentidades sin tipo como aquellas que tienen una cadena vacía en el lugar donde se indica el tipo).

Se pueden especificar atributos tanto en una línea como en el bloque {}, aunque esto se debería evitar excepto en los casos donde hay que destacar un atributo particular (por ejemplo, el atributo .class en la especificación de un componente subordinado). Si este no es el caso, se prefiere la sintaxis en línea para las subentidades más sencillas con pocos atributos y el bloque {} para entidades más complejas que tienen muchos atributos o subentidades.