Model to Text工具Acceleo使用教程（六）——模板服务
本讲开始详细介绍acceleo提供的剩余七种服务。
一、对象服务
1、eAllContents
eAllContents()：返回当前对象的所有孩子对象
接受类型：EMF对象
返回：家族对象列表
详细描述：此服务返回了所有直接或间接的孩子对象，不区分类型，即返回所有类型的对象。
应用举例：假设a,b,c,d,e是对象，a包含b,c，b包含d，d包含e，则
<%a.eAllContents()%>: 返回 {b, c, d, e}
<%b.eAllContents()%>: 返回 {d, e}
<%e.eAllContents()%>: 返回空对象
2、eAllContents
eAllContents(String)：返回指定类型的对象
接受类型：EMF对象
参数：stirng类型，值为需要返回对象的类型
返回：家族对象列表
应用举例：假设p是包，a是其中的class，此类包含三个属性：int b, int c, 和 boolean d。包p中还有另一个类e，它有三个属性：int f，string g，和对象h，则
<%p.eAllContents()%>: 返回 {a,b, c, d,e, f,g,h}
<%p.eAllContents(“ Class ”)%>: 返回 {a, e}
<%p.eAllContents(“ String ”)%>: 返回 {g}
<%a.eAllContents(“ int ”)%>: 返回 {b, c, f}
<%a.eAllContents(“ String ”)%>: 返回空列表
3、eClass
eClass()：返回类型的类
接受类型：EMF对象
返回：类型的类
详细描述：此服务返回与当前类型对应的元模型中的类，类似于java语言中提供的class属性。
应用举例：
<%if (a.eClass().name == “ Class ”) {%> 中间指令<%}%>，只有当a是一个类时才执行中间指令。
4、eContainer
eContainer()：返回父亲对象
接受类型：EMF对象
返回：父亲对象
详细描述：此服务将返回父亲对象，而不管父亲是什么类型，如果父亲是空，返回空
应用举例：假设a是类，包含了b属性，则
<%b.eContainer()%>: 返回 a
<%a.eContainer()%>: 返回空对象
5、eContainer
eContainer(String)：返回指定类型的父亲对象
接受类型：EMF对象
参数：string类型，值为需要返回的父亲对象的类型
返回：指定类型的父亲对象
应用举例：假设p是包，包含了类a，a中有字符串属性b，则
<%a.eContainer(“ Package ”)%>: 返回 “p”
<%b.eContainer(“ Package ”)%>: 返回 “p”
<%p.eContainer(“ Package ”)%>: 返回空对象
<%a.eContainer(“ String ”)%>: 返回空对象
6、eContainingFeature
eContainingFeature()：返回父亲包含的特征
接受类型：EMF对象
返回：父亲包含的特征
应用举例：<%eContainingFeature()%>
7、eContainmentFeature
eContainmentFeature()，类似于eContainingFeature()
8、eContents
eContents()：返回类型的直接孩子对象（区别于eAllContents）
接受类型：EMF对象
返回：直接孩子对象列表
应用举例：假设p是包，包含类a，a中有属性b,c，则
<%a.eContents()%>: 返回 {b, c,}
<%p.eContents()%>: 返回 {a}
<%b.eContents()%>: 返回空
9、eCrossReferences
eCrossReferences()：返回所有引用类型对象
接受类型：EMF对象
返回：引用对象列表
应用举例：类a继承b, b实现了掊接口c。a中包含属性d,e，则
<%a.eCrossReferences()%>返回{b,c}
10、eResource
eResource()：返回包含模型的文件的路径
接受类型：EMF对象
返回：模型文件路径
11、eResourceName
eResourceName()：返回模型文件名字（包含扩展名）
接受类型：EMF对象
返回：模型文件名字
应用举例：如果此服务应用于“C:/Obeo/models/MyModel.xmi” 中的某个对象上，则返回 “MyModel.xmi”。
12、getRootContainer
getRootContainer()：返回包含当前对象的顶层对象
接受类型：EMF对象
返回：顶层对象
应用举例：如果a包含b, b包含c，则
<%c.getRootContainer()%>返回a
13、load
load(String)：加载模型并返回其根对象
接受类型：EMF对象
参数：模型文件路径
返回：模型文件的顶层对象
应用举例：
<%load(“ //UML2_LIBRARIES/UML2PrimitiveTypes.library.uml2 ”)%>返回UML2模型的根元素。
二、属性服务
属性是以key=value的形式保存在文件中的，文件扩展名为.properties，属性首先寻找当前目录下的key，如找不到，再在模板中寻找，如果仍找不到，返回Empty feature evaluation异常。如果发现多个key，则只使用第一次找到的那个value。为了使用reflective的预览特性，属性文件必须和模板文件在同一个目录下。
1、getBestProperty
getBestProperty(String)：返回与参数最接近的key的值
接受类型：ENode（也就是所有对象类型：int, double, boolean, String, ENodeList, EObject）
参数：string类型，值为key（属性的标识符）
返回：最接近的属性值
详细描述：此服务首先在属性文件中寻找key，如找不到，用一个更小的key寻找，直到找到为此，先在属性文件中找，后在模板中找，如最终扔找不到，返回Empty feature evaluation异常。
应用举例：给定一个key “aa.bb.cc.dd”, 如果getProperty(“aa.bb.cc.dd”)返回空，则用getProperty(“aa.bb.cc”)继续，如仍找不到，则用getProperty(“aa.bb”)……如此反复
可以利用此性质，为一系列相同前缀的属性设置默认属性值，这样这些属性就至少有一个属性值。
2、getProperty
getProperty(String)：返回key的value
接受类型：ENode（也就是所有对象类型：int, double, boolean, String, ENodeList, EObject）
参数：string类型，值为key（属性的标识符）
返回：key的属性值
3、getProperty
getProperty(String,String)：在指定文件中，寻找key的关联属性值
接受类型：ENode（也就是所有对象类型：int, double, boolean, String, ENodeList, EObject）
参数：string类型，值为文件的名字（不包含扩展名）
string类型，值为key（属性的标识符）
返回：key的属性值
三、需求服务
1、delete
delete(String)：删除条件指定的列表元素
接受类型：ENode（也就是所有对象类型：int, double, boolean, String, ENodeList, EObject）
参数：条件表达式
返回：满足条件表达式的元素列表
应用举例：<%eAllContents(“ Class ”).delete(“ attributes.nSize() == 0 ”))%去掉了没有属性的class。
不建议使用delete服务，建议使用[]，[]是xpath语法，用于过滤元素。
2、delete
delete(String,String)：删除两个参数相等时对应的元素
接受类型：ENode（也就是所有对象类型：int, double, boolean, String, ENodeList, EObject）
参数：string类型，条件表达式的左边
string类型，条件表达式的右边
返回：满足条件表达式的元素列表
应用举例：<%eAllContents(“ Class ”).delete(“ attributes.nSize() ”, “ 0 ”)%>去年了没有属性的class。同上，也不建议使用。
3、evaluate
evaluate(String)：表达式求值
接受类型：ENode（也就是所有对象类型：int, double, boolean, String, ENodeList, EObject）
参数：string类型，值为表达式
返回：表达式的计算结果
应用举例：<%evaluate(eAllContents(“ Class ”).attributes.nSize().sep(“ + ”).toString())%>返回了所有类的属性的个数。
4、select
select(String)：根据指定条件选择对象
接受类型：ENode（也就是所有对象类型：int, double, boolean, String, ENodeList, EObject）
参数：string类型，值为表达式
返回：满足条件的对象列表
应用举例：<%eAllContents(“ Class ”).select(“ attributes.nSize() == 0 ”)%>返回所有没有属性的类。
不建议使用selete服务，建议使用[]。
5、select
select(String,String)：删除两个参数相等时对应的元素
接受类型：ENode（也就是所有对象类型：int, double, boolean, String, ENodeList, EObject）
参数：string类型，条件表达式的左边
string类型，条件表达式的右边
返回：满足条件表达式的元素列表
应用举例：<%eAllContents(“ Class ”).selete(“ attributes.nSize() ”, “ 0 ”)%>过滤所有没有属性的class。同上，也不建议使用。
四、资源服务
1、getFileContent
getFileContent(String)：以string的形式返回文件的内容
接受类型：ENode（也就是所有对象类型：int, double, boolean, String, ENodeList, EObject）
参数：string类型，值文件的路径
返回：文件的内容
详细描述：如果文件为空或无法访问，返回空的buffer。
应用举例：<%getFileContent(“ C:/Obeo/models/MyModel.xmi ”)%>返回了MyModel.xmi的内容。
2、getChainPath
getChainPath()：返回根链(chain)路径
接受类型：ENode（也就是所有对象类型：int, double, boolean, String, ENodeList, EObject）
返回：根链路径
应用举例：<%getChainPath()%>
五、专用服务
专用服务是acceleo专用的语法服务。
1、i
i()：返回当前迭代索引
接受类型：ENode（也就是所有对象类型：int, double, boolean, String, ENodeList, EObject）
返回：当前迭代索引
应用举例：public void method(<%for (parameters) {%><%if (i() != 0) {%>, <%}%><%type%> <%name%><%}%>) {..
2、args
args(int)：脚本调用传递参数时，获取参数值
接受类型：ENode（也就是所有对象类型：int, double, boolean, String, ENodeList, EObject）
参数：参数索引
返回：指定索引的参数值
应用举例：假如通过<%myScript (“ test ”, “ otherTest ”)%>调用myScript脚本，则在脚本myScript中<%script type=“ Property ” name=“ myScript ”%>，<%args(0)%>表示参数“test”，<%args(1)%>表示参数“otherTest ”，而<%args(6)%>是空参数“”。
六、总结
本讲又介绍九种服务中的五种服务，后文将介绍最后的两种服务，并将为该教程画上圆满的句号。
