Guías de integración › Guía de referencia de ADL › Sintaxis del marcado de propiedades › Estilos de marcado

Estilos de marcado

Marcado en línea

$$prop: val1 : name1 , val2 : name2 , ...

La presencia de una cadena $$prop: en una línea de texto del archivo de configuración quiere decir que esta línea contiene uno o varios valores de propiedad. Normalmente, la cadena $$prop: y el resto de la línea de texto son invisibles a la aplicación que utiliza este archivo de configuración, pues aparecen como un comentario; por ejemplo, si el archivo de configuración es un script de Perl sería:

$port = 3306 # $$prop: 3306:ip_port

Las parejas val:name que siguen a la cadena del identificador de marcado se interpretan así:

val1:name1 indica que la primera aparición de la cadena val1 de esta línea se debe tratar como el valor de la propiedad name1 y se debe sustituir siempre que esa propiedad tenga que cambiarse.

val2:name2 indica que la primera aparición de la cadena val2 tras la primera aparición de val1 es el valor de la propiedad name2.

etc.
Si el valor name en una pareja val:name es '-', la cadena val se ignora. Esto se utiliza para omitir las partes de los datos de la configuración que podrían coincidir con un valor de propiedad, por ejemplo, un marcado como este:

x1 = 1 # $$prop: 1:val 

En este caso, se hace que el valor 1 de x1 se considere el valor de la propiedad val. Para hacer que la cadena 1 que sigue al signo = sea el valor de la propiedad, el marcado debe ser:

x1 = 1 # $$prop: 1:-, 1:val 

El nombre de propiedad especial '-' también se utiliza en caso de que el valor de la propiedad sea una cadena vacía, por ejemplo, en el marcado siguiente la propiedad es la cadena vacía que sigue a la cadena "x1 =":

x1 = #$$prop: "x1 = ":- , "":val 

Si un valor contiene caracteres de puntuación que forman parte de la sintaxis de marcado (dos puntos, coma, espacio), el valor se deberá entrecomillar mediante la sintaxis de comillas dobles definida para los archivos del descriptor de ADL.

Marcado de línea siguiente

$$propN: val1 : name1 , val2 : name2 , ... [$$] 

Este marcado se utiliza para los archivos de configuración que no permiten que el texto de comentario aparezca en la misma línea que el valor que tiene que exponerse como propiedad modificable. Se parece a la sintaxis en línea, pero indica que hay que buscar las cadenas coincidentes en el texto de la línea siguiente al texto en el que aparece el marcado, y no en la línea actual.

Marcado para archivos que no se basan en líneas

$$propF: val1 : name1 , val2 : name2 , ... $$ 

Este marcado se utiliza para los archivos de configuración en los que el carácter de nueva línea no se considera diferente de otro espacio en blanco y las actualizaciones del archivo pueden hacer que se añadan o eliminen nuevas líneas donde haya un espacio en blanco sin entrecomillar. Para este tipo de marcado, se necesita una secuencia $$ de cierre para indicar el final de la lista de parejas val:name. Se permiten nuevas líneas entre las parejas val:name. Se buscan cadenas que coincidan con los valores en todo el texto que sigue la marca $$ de cierre, independientemente de las nuevas líneas. La búsqueda se realiza hasta que todos los valores se encuentren o hasta que se lea 1 K de texto para cada pareja val:name (si se produce esto último sin que se hayan encontrado todos los valores, se comunica un error). Se sigue esperando que cada valor de propiedad resida en una sola línea.