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);

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com