XPAND模板语言语法1.0
Xpand模板语言一般写在以.xpt为结尾的文本文件中 ,以“« »” 作为开头和结尾 。Xpand语言主要包括以下几个标签:
«IMPORT», «DEFINE», «EXPAND», «FILE», «FOREACH», «EXTENSION», «IF», «PROTECT», «LET», «ERROR», 和«REM»。
«IMPORT»
使用在Xpand模板的顶部,用于元数据模型导入使用 。导入元模型后,就可以在整个模板中使用他的任意属性值
例:
«IMPORT ecore»
«DEFINE»
虽然.xpt文件被称为模板文件,但在Xpand中,写在«DEFINE»
标签内的内容块才会被程序认为是模板,将对其进行转换。用«ENDDEFINE»标签终止«DEFINE»块。
语法:
«DEFINE templateName (parameterList) FOR MetaClass»
. . .
«ENDDEFINE»
«EXPAND»
«EXPAND»标签用来引用另一个«DEFINE»模板块或者扩展它,类似于子类继承extend父类。
语法:
«EXPAND definitionName [(parameterList)] [FOR expression |
FOREACH expression [SEPARATOR expression] ]»
definitionName必须是完全限定的名称空间,包括文件名和路径,除非它是同一个文件中的«DEFINE»。当引用文件外的«DEFINE»块时,向模板中添加适当的IMPORT语句后再引用可能更方便文件。
例:
直接引入
«IMPORT mindmap»
«DEFINE Main FOR Map»
«EXPAND topic::topic::Main FOR this»
«EXPAND relationship::relationship::Main FOR this»
«ENDDEFINE»
先import再引入
«IMPORT mindmap»
«IMPORT topic»
«IMPORT relationship»
«DEFINE Main FOR Map»
«EXPAND topic::csv FOR this»
«EXPAND relationship::csvFile FOR this»
«ENDDEFINE»
注意上面两个例子,每个«EXPAND»语句显式地包含FOR this,这意味着包含«DEFINE»的上下文全部被传递。另一种方法是只传递一个你想要的元素,比如上面例子中的Topic或Relationship元素的列表。在下面的例子中,Relationship元素被过滤出来并传递给当前«DEFINE»
«DEFINE Main FOR Map»
«EXPAND topic::csv»
«FILE title + "-relations.csv"-»
«EXPAND relationship::csv FOR elements.typeSelect(Relationship)-»
«ENDFILE»
«ENDDEFINE»
«DEFINE csv FOR List[mindmap::Relationship]»
«FOREACH this AS relation-»
«relation.name»,«relation.type.toString()»,«relation.source.name»,
«relation.target.name»
«ENDFOREACH»
«ENDDEFINE»
你也可以在DEFINE块外面使用EXPAND 来引入单个元素,然后在所有的DEFINE块中使用。(类似于全局变量的引用):
«EXPAND relationship::csv FOREACH elements.typeSelect(Relationship)»
«DEFINE csv FOR Relationship»
«relation.name»,«relation.type.toString()»,«relation.source.name»,
«relation.target.name»
«ENDDEFINE»
«FILE»
用FILE标签来创建文件。语法:
«FILE expression [OUTLET_NAME]»
. . .
«ENDFILE»
«FOREACH»
和大多数程序语言一致,foreach用来遍历集合元素。
语法:
«FOREACH expression AS varName [ITERATOR iterName]
[SEPARATOR expression]»
. . .
«ENDFOREACH»
expression 需要遍历的集合元素
varName 集合中每个元素名
[ITERATOR iterName] 集合访问计数器
«EXTENSION»
除了xpand 语言自带的一些函数外,你可以自定义函数,然后通过«EXTENSION»标签将其引入并使用。
例:
定义函数
使用函数
«IF»
Xpand支持使用«IF»条件语句。«ELSE»和«ELSEIF»语句补充«IF»块,以«ENDIF»。这是«IF»语句的一般语法:
«IF expression»
. . .
[ «ELSEIF expression» ]
. . .
[ «ELSE»
. . . ]
«ENDIF»
«PROTECT»
要标记指定用于用户修改的生成代码段,Xpand提供了一个«PROTECT»语句。在生成代码时,«PROTECT»内代码将不被覆盖(生成的代码类似于注释)。以下是«PROTECT»语句的通用语法:
«PROTECT CSTART expression CEND expression ID expression (DISABLE)?»
. . .
«ENDPROTECT»
CSTART和CEND表达式应该是目标语言的有效注释标记—例如Java注释的/*和*/。ID应该是唯一的。默认情况下,PROTECT区域处于启用状态,可通过添加关键字“DISABLED”将其禁用。
«LET»
«LET»语句用于创建一个局部变量。
语法:
«LET expression AS varName»
. . .
«ENDLET»
«ERROR»
您可以通过插入一个«ERROR»语句来终止模板的执行。
该表达式将被用作XpandException的消息,如果«ERROR»被处理,则会抛出该消息。
注意,最好在执行模板之前对输入模型元素进行校验,因此很少需要使用«ERROR»语句。
语法:
«ERROR expression»
例:
«DEFINE Main FOR Map»
«IF title == null || title == ''-»
«ERROR 'No title'»
«ELSE»
...
«ENDIF»
«ENDDEFINE»
«REM»
可以使用«REM»标签将注释添加到模板中。«REM»标签不能嵌套。
语法:
«REM»Text comment here...«ENDREM»
«AROUND»
在Xpand模板中使用的一个更强大的特性是«AROUND»标签,该标签提供aspectoriented的功能(类似于Spring的面向切面编程AOP)。
AROUND标签用来匹配你想要的模板文件, 并对其进行操作 。
语法:
«AROUND fullyQualifiedDefinitionName(parameterList)? FOR Type»
. . .
«ENDAROUND»
fullyQualifiedDefinitionName 为文件名称,可以包含通配符(*)。
例如,mindmap::topic2csv:: csvFile可以提供一个全路径的文件名称,亦可以使用mindmap::topic*来匹配以mindmap::topic开头的模板。
类似地,参数类型可以在我们的切点中指定。指定的类型与它们的定义形参类型或超类型匹配。通配符(*)也可以用于参数列表中。
例如,您可以使用mindmap::topic2csv::csv(字符串名称)或mindmap::topic2csv::csv(字符串名称,*)如果可能有额外的
匹配所有模板:
«AROUND *(*) FOR Object»
匹配以topic为结尾并带有任意数量参数的所有模板:
«AROUND *topic(*) FOR Object»
To match all templates in the mindmap namespace that have no parameters
for MapElement types (including subclasses):
匹配mindmap中MapElement类型参数的所有模板(包括子类)
«AROUND mindmap::* FOR MapElement»
匹配所有使用一个String参数得模板:
«AROUND *(String s) FOR Object»
匹配使用至少一个String参数的所有模板:
«AROUND *(String s,*) FOR Object»
标签:1.0,XPAND,mindmap,语法,模板,expression,EXPAND,DEFINE From: https://www.cnblogs.com/cnblogs-ade/p/16614964.html