EMA 运算符
EMA 中的模型和对象可以通过若干运算符来操作。运算符实现为可从 C 程序调用的函数;具体的函数调用语法将在下一节详述。本节以简化的方式介绍这些运算符。称为通用运算符的一组运算符可以同时应用于模型和对象,它们对模型和对象具有相似的语义。可以应用通用运算符的实体集合称为 M/O,即 {Model / Object}(模型 / 对象)。称为特定运算符的一组运算符只能应用于模型或对象之一,而不能两者皆可。全部通用和特定运算符列于下表。
表 3:EMA 运算符
| 通用 | 模型专用 | 对象专用 |
|---|---|---|
create |
read |
move |
destroy |
write |
nth |
copy |
code_gen |
prom_attr_set |
print |
||
attr_get |
||
attr_set |
||
attr_add |
||
attr_print |
create 运算符为新的 M/O 实例分配内存并对其进行初始化。初始化过程包括将 M/O 的所有属性设置为其默认内容。EMA 会为新的 M/O 分配一个唯一标识符,可用于后续运算符调用中引用该 M/O。一旦创建,M/O 将一直存在,直到通过 destroy 运算符将其销毁,或者基于 EMA 的应用程序终止。
destroy 运算符释放某个 M/O 实例使用的全部内存。该 M/O 实际上从 EMA 环境中移除,不能再被 EMA 运算符操作。尝试引用已销毁的 M/O 会导致错误状态。引用了该已销毁 M/O 的属性会被 EMA 查找出来,并置为“未设置”状态。
copy 运算符创建一个新实例,它是某个现有 M/O 实例的完全复制。原 M/O 的所有属性都被复制到新 M/O。原 M/O 与复制出的 M/O 之间唯一的差别是各自的唯一 ID。
print 运算符在标准输出设备上显示 M/O 的内容。显示每个属性的信息,包括其数字索引、名称、类型、默认值和当前值。同时也会打印 EMA 特有的信息,例如模型中对象的数量。
attribute get 运算符(简称 attr_get)读取 M/O 实例内某个属性的内容。该属性的内容不受此运算符影响;这是一种非破坏性的读取操作,EMA 应用程序用它来查询 M/O 的当前状态。如果将此运算符应用于此前未设置但带有 set-required 类型修饰符的属性,将会产生错误状态。除上述限制外,此运算符可以应用于任何核心类型或类型修饰符的属性。
attribute set 运算符(简称 attr_set)为 M/O 实例内某个属性指定内容。无论属性此前的内容如何,其内容都会被改为新值。此运算符可以应用于任何核心类型或类型修饰符的属性。
attribute add 运算符(简称 attr_add)在 M/O 实例内创建一个新属性。需指定该属性的名称、数据类型、单位名称和默认值。新属性最初取其默认值。此运算符用于创建用户自定义属性,相当于 extended attrs. 对象菜单项。
attribute print 运算符(简称 attr_print)显示 M/O 实例内单个属性的内容。显示的信息包括其数字索引、名称、类型、默认值和当前值。
attribute group get 运算符(简称 attr_group_get)读取 M/O 实例的属性组名。对象属性对话框使用属性组名把大量属性组织成更小、更易管理的属性集合(称为组)。所有组名相同的属性被视为同一组的一部分。属性组名仅供对象属性对话框使用,不影响任何类型的分析。属性的内容不受此运算符影响;这是一种非破坏性的读取操作,EMA 应用程序用它来查询 M/O 的当前状态。
attribute group set 运算符(简称 attr_group_set)为 M/O 实例指定组名。无论属性此前的组名如何,组名都会被改为新值。
除通用运算符外,还有一些只能应用于模型或对象之一、而不能两者皆可的特定运算符,包括:
read 运算符只能应用于模型。它打开模型目录中已存在的模型数据文件,并创建一个描述该 Riverbed 模型的 EMA 模型。此运算符是 EMA 唯一的直接数据输入机制,通常用于读入将由基于 EMA 的应用查询或操作的模型。
write 运算符只能应用于模型。它把一个已有的 EMA 模型转换为等效的 Riverbed 模型数据文件,写入主模型目录。此运算符是 EMA 唯一的直接数据导出机制,用于把 EMA 应用的结果转换为可供 Riverbed 分析软件使用的“具体”模型。
code generation 运算符(简称 code_gen)只能应用于模型。它为一个描述其所应用 EMA 模型的 EMA 应用生成源代码文件,在主模型目录中创建一个 C 代码文件(文件类型后缀 .em.c)。此运算符可用于获得一个简单的“快照”应用,用以重新生成由更复杂的 EMA 应用以算法方式构造的 EMA 模型。
move 运算符只能应用于对象。它把位于某个模型中的现有对象移动到另一个模型中。源模型将不再包含该对象,任何对该对象的新引用都会导致错误状态(从源模型的角度看,该对象如同被销毁)。另一方面,目标模型获得一个新的对象实例,具有唯一的对象 ID(该对象此前的 ID 与其在目标模型中的 ID 没有任何对应关系)。
Nth 运算符只能应用于对象。它接受一个索引号,返回按创建顺序对应该索引的对象的唯一标识符。该索引寻址每种对象类型各自独立的计数空间;例如,此运算符可以获得模型中第 5 个 A 类型的对象,但不能获得第 5 个总体对象。此运算符通常被基于 EMA 的应用用于遍历某一特定类型的全部对象。在多数模型中,都有统计模型中每种类型对象数量的属性;这些属性提供了循环计数器的最大值。
promoted attribute set 运算符(简称 prom_attr_set)只能应用于对象。此运算符与 attr_set 类似,都是为对象内某个属性指定内容。但此运算符所指定的属性在运算符被调用之前并不存在;prom_attr_set 实际上会创建该属性,预期将来会有同名属性从更低层的模型或对象提升(promote)上来。当带有提升属性的 EMA 模型被写入模型文件、并且该模型被集成到仿真中时,提升属性的值将被赋给相应的、已被提升的低层模型或对象属性。