EMA 基础对象
Ema 包中定义了一组基础对象,用于支持更复杂的对象。这些基础对象在下文中说明,后续的 Riverbed 分析软件对象(在后续主题中描述)都会用到它们。
符号对象(Symbol Object)
符号对象表示一个值到符号名称的映射。符号对象 ID 被 properties 对象的 symbol map list 属性使用。
表 6:符号对象属性
| 名称 | 类型 | 默认值 |
|---|---|---|
symbol |
string |
(空) |
value |
poly¹ |
注 1:value 的类型在运行时确定
Properties 对象
当向模型或对象添加用户定义的属性时,properties 对象的对象标识符是必需的参数。properties 对象(属性列于下表)包含所添加属性的名称、类型、符号映射及其他属性的信息。
表 7:Properties 对象属性
| 名称 | 类型 | 默认值 |
|---|---|---|
public name |
string |
(空) |
units |
string |
(空) |
default value |
poly¹ |
|
comments |
textlist |
|
high limit |
double |
|
low limit |
double |
|
symbol map list |
array of object IDs² |
|
flags |
integer³ |
|
data type |
integer⁴ |
|
count properties |
object ID⁵ |
|
handler library |
string⁶ |
(空) |
click handler |
string⁶ |
(空) |
confirm handler |
string⁶ |
(空) |
new value handler |
string⁶ |
(空) |
display handler |
string⁶ |
(空) |
list attribute definitions |
array of object IDs⁷ |
注 1:value 的类型在运行时确定,并且必须与 data type 属性指定的类型一致
注 2:符号对象的对象 ID
注 3:有效类型见表 152 Properties Object Flags Symbolic Constants
注 4:有效类型为 EMAC_INTEGER、EMAC_DOUBLE、EMAC_STRING、EMAC_TOGGLE、EMAC_TOGGLE_DOUBLE、EMAC_COMPOUND 或 EMAC_DATAFILE
注 5:properties 对象的对象 ID(仅当 data type 为 EMAC_COMPOUND 时),用于定义复合对象的 count 属性的属性
注 6:这些属性指定自定义的事件处理例程,用于覆盖设置对象属性的标准接口;详见"Active Attributes"(第 51 页)。
注 7:子对象的属性定义对象的对象 ID(仅当 data type 为 EMAC_COMPOUND 时),用于定义复合对象的子对象的每个属性的属性
属性定义对象
属性定义将属性名称映射到其属性。属性定义在 properties 对象中用于定义复合属性的子对象属性的属性。在这种语境下,复合属性的每个子对象的属性都包含一个属性定义对象列表。每个属性定义对象提供一个属性名称、分组及其对应的属性。
表 8:属性定义对象属性
| 名称 | 类型 | 默认值 |
|---|---|---|
name |
string |
(空) |
group |
string |
(空) |
properties |
object ID¹ |
注 1:properties 对象的对象 ID
复合值对象
当一个属性的类型为 EMAC_COMPOUND 时,其值是一个复合值对象的对象 ID。复合值对象包含两个属性。list 属性是一个对象 ID 数组,其中每个 ID 标识一个复合对象(见下文描述),它是该复合值的一个子对象。count 属性明确指定该复合值包含多少个复合对象。
表 9:复合值对象属性
| 名称 | 类型 | 默认值 |
|---|---|---|
count |
integer |
|
list |
array of object IDs¹ |
(空) |
注 1:复合对象的对象 ID
复合对象
复合对象是不含初始属性的对象。复合对象中的所有属性都是通过调用 Ema_Object_Prom_Attr_Set() 函数显式添加的。复合对象表示复合属性值对象的子对象。
复合值对象使用示例
本节通过 C 代码片段给出一个示例,说明如何使用 EMA 函数构造 EMA 复合值对象。下图所示的复合属性结构将通过 EMA 构造。
图 9:复合值对象

指定复合值对象的第一步是分配该对象本身:
comp_val_objid = Ema_Object_Create (model_id, OBJ_ATTR_COMP_VALUE);
接下来,需要分配并设置各个复合对象(即子对象):
subobject0_objid = Ema_Object_Create (model_id, OBJ_ATTR_COMP_OBJ);
subobject1_objid = Ema_Object_Create (model_id, OBJ_ATTR_COMP_OBJ);
随后,每个子对象需要添加它所需的属性。但这是一个两步过程,因为向对象添加新属性需要一个 properties 对象。因此先创建 properties 对象:
attr0_props_objid = Ema_Object_Create (model_id, OBJ_ATTR_PROPS);
attr1_props_objid = Ema_Object_Create (model_id, OBJ_ATTR_PROPS);
properties 对象需要为其各属性指定值:
prg_lptr = prg_list_create ();
Ema_Object_Attr_Set (model_id, attr0_props_objid,
"units", COMP_CONTENTS, "",
"default value", COMP_CONTENTS_TYPE, EMAC_DOUBLE,
"default value", COMP_CONTENTS, (double) 0,
"comments", COMP_CONTENTS, prg_lptr,
"high limit", COMP_CONTENTS, 0.0,
"low limit", COMP_CONTENTS, 0.0,
"symbol map list", COMP_INTENDED, EMAC_DISABLED,
"flags", COMP_CONTENTS, EMAC_DEFC_AUTOASSIGN,
"data type", COMP_CONTENTS, 1,
"count properties", COMP_INTENDED, EMAC_DISABLED,
"list attribute definitions", COMP_INTENDED, EMAC_DISABLED,
EMAC_EOL);
(对 attr1_props_objid 的类似调用此处未列出。)
接下来,子对象属性的属性准备就绪后,将属性添加到每个子对象:
Ema_Object_Prom_Attr_Set (model_id, subobject0_objid, "attr0", attr0_props_objid);
Ema_Object_Prom_Attr_Set (model_id, subobject0_objid, "attr1", attr1_props_objid);
Ema_Object_Prom_Attr_Set (model_id, subobject1_objid, "attr0", attr0_props_objid);
Ema_Object_Prom_Attr_Set (model_id, subobject1_objid, "attr1", attr1_props_objid);
现在可以为子对象上的属性提供值:
Ema_Object_Attr_Set (model_id, subobject0_objid,
"attr0", COMP_CONTENTS, 1.0,
"attr1", COMP_CONTENTS, 2.2,
EMAC_EOL);
Ema_Object_Attr_Set (model_id, subobject1_objid,
"attr0", COMP_CONTENTS, 11.0,
"attr1", COMP_CONTENTS, 12.2,
EMAC_EOL);
最后,设置复合值对象的 list 和 count 属性,以包含已创建并定义的子对象:
Ema_Object_Attr_Set (model_id, comp_val_objid,
"count", COMP_CONTENTS, 2,
"list", COMP_ARRAY_CONTENTS(0), subobject0_objid,
"list", COMP_ARRAY_CONTENTS(1), subobject1_objid,
EMAC_EOL);
使用符号映射
在前例的基础上,这里引入符号对象并将其用于设置子对象的属性值。在下面的示例中,将创建一个把字符串 “One” 映射到值 1.0 的符号对象。然后修改与 attr0 对应的 properties 对象,在其符号映射中包含该符号对象。最后,把该符号设置为 subobject1 中的一个值。
首先,创建符号对象:
symbol_objid = Ema_Object_Create (model_id, OBJ_ATTR_SYMMAP);
“One” 到 1.0 的映射在符号对象的属性中指定:
Ema_Object_Attr_Set (model_id, symbol_objid,
"symbol", COMP_CONTENTS, "One",
"value", COMP_CONTENTS_TYPE, EMAC_DOUBLE,
"value", COMP_CONTENTS, 1.0,
EMAC_EOL);
注意在上述代码中,由于符号对象的 value 属性的类型为 poly,因此使用 COMP_CONTENTS_TYPE 来显式指明实际设置到该属性上的值的类型。
修改 attr0 的 properties 对象以包含该符号对象:
Ema_Object_Attr_Set (model_id, attr0_props_objid,
"symbol map list", COMP_ARRAY_CONTENTS(0), symbol_objid,
EMAC_EOL);
最后,将 subobject1 的 attr0 的值设置为一个符号值。与创建复合值对象相关的代码无需修改:
Ema_Object_Attr_Set (model_id, subobject1_objid,
"attr0", COMP_CONTENTS_SYMBOL, "One",
EMAC_EOL);