Los macros de sustitución pueden ser utilizados en una de dos maneras:
• |
Sustitución Directa o |
• |
Sustitución Condicional
|
Sustitución Directa
Esta forma sustituye directamente el valor correspondiente del elemento en alcance hacia la salida.
Estructura: %<macroName>%
Donde <macroName> puede ser cualquiera de los macros listados en las tablas de Macros de Sustitución de Campo.
Ejemplos
• |
%className% |
• |
%opName% |
• |
%attName%
|
Sustitución Condicional
Esta forma del macro permite que se hagan sustituciones alternativas dependiendo del valor del macro.
Estructura: %<macroName> ( == "<text>" ) ? <subTrue> ( : <subFalse> ) %
Donde:
• |
( ) denota que los valores entre los paréntesis son opcionales |
• |
<text> es una cadena representando un valor posible para el macro |
• |
<subTrue> y <subFalse> puede ser una combinación de cadenas entre comillas y el valor de la palabra clave; donde el valor es utilizado, se reemplaza con el valor del macro en la salida. |
Ejemplos
• |
%classAbstract=="T" ? "pure" : ""% |
• |
%opStereotype=="operator" ? "operator" : ""% |
• |
%paramDefault != "" ? " = " value : ""%
|
Los tres ejemplos de arriba no producen ninguna salida si la condición falla. En este caso la condición falsa puede ser omitida, resultando en el siguiente uso:
• |
%classAbstract=="T" ? "pure"% |
• |
%opStereotype=="operator" ? "operator"% |
• |
%paramDefault != "" ? " = " value%
|
El tercer ejemplo muestra en ambos bloques la comparación buscando un valor no vacío o existencia. La prueba también puede ser omitida.
• |
%paramDefault ? " = " value : ""% |
• |
%paramDefault ? " = " value% |
Todos los ejemplos de arriba que contienen paramDefault son equivalentes. Si el parámetro al alcance tenía un valor predeterminado de 10, la salida de cada uno de ellos normalmente sería:
= 10
Notas
• |
En un macro de sustitución condicional, cualquier espacio en blanco seguido de <macroName> es ignorado; si se requiere un espacio en blanco en la salida, debería ser incluido dentro de las cadenas de sustitución entre comillas |
Aprender más