EMA 概念

Ema 包是一个 API,它融合了对象化设计的若干原则,例如:

  • 数据隐藏:EMA 的用户不会接触到模型内部的、逐字节的物理结构。对各个模型组件的访问通过一组函数提供,这些函数屏蔽细节并校验模型访问的完整性。
  • 通用运算符:一组数量不多的通用运算符可以应用于 EMA 管理的任何对象。这些运算符包括创建和销毁对象、设置或获取其组件、以及复制或移动对象的能力。此外,所有对象都有一组由 EMA 维护的通用属性。

本节余下部分将给出 EMA 主要概念的定义,每个概念都配有一幅图示。注意,EMA 概念往往采用人们熟悉的名字,例如“对象”,但它们在 EMA 内部具有非常特定的语义,可能与这些词的通常用法不同。

模型

EMA 中的模型与 Riverbed 分析软件中的模型相对应,如下图所示。但 EMA 模型与 Riverbed 模型并不相同。在 EMA 内部,模型是一组描述 Riverbed 分析软件中模型的数据。换句话说,当应用程序使用 EMA 操作模型时,它实际上是在逐步构建一组数据,这些数据之后将由 EMA 用来构造 Riverbed 模型。在 EMA“会话”期间,能对模型做什么、模型在内部如何存储和操作,都由 EMA 严格规定。然而,一旦模型被 EMA“写出”,就会生成相应的 Riverbed 模型,随后便可用所有现有的处理模型的工具(如图形编辑器、op_mko 和 op_mksim)对其操作。

图 3:EMA 应用的模型文件操作

EMA 应用的模型文件操作

EMA 中的模型是对象的集合,每个对象都有一个对象类型。举几个具体例子:网络模型中可以创建的对象之一是节点,节点模型中可以创建的对象之一是处理器。为了灵活起见,一个模型中可以创建任意数量的各种类型的对象;其数量上限仅受调用 EMA 的程序可用虚拟内存的限制。

图 4:EMA 模型内的对象

EMA 模型内的对象

与对象一样,一个 EMA 应用中可以同时存在多个模型。EMA 应用中同时存在的模型数量上限受可用虚拟内存的限制。

图 5:EMA 应用内存中的模型

EMA 应用内存中的模型

模型通过两种方式相互区分:类型和实例。每个模型实例都有一个唯一标识符,使其与所有其他模型区分开来,这称为模型 ID。此外,类型相似的模型实例共享一个公共的模型类型(例如,所有网络模型都被标识为网络类型)。大多数 EMA 调用都必须传入这两个标识符之一,因为 EMA 需要知道所引用的是哪个模型或模型类型。这些标识符的 C/C++ 语言类型定义和典型函数参数名如下表所列(给出类型定义是为了代码文档和清晰起见;这些标识符实际上就是整数,可以像 C/C++ 中的普通整数一样处理)。

表 1:EMA 模型数据类型

C/C++ 类型定义 典型参数名
EmaT_Model_Type model_type
EmaT_Model_Id model_id

对象

EMA 中的对象描述 Riverbed 模型内的组件。对于每个可以用 Riverbed 分析软件创建的模型组件,都有一个对应的 EMA 对象来描述它(这类组件的例子有固定节点、处理器模块和进程模型状态)。对模型组件的描述不涉及其内部结构或过程行为,而是描述其参数化。例如,对处理器的描述可能包含控制其随时间生成数据包的属性,如所使用的 interarrival PDF。

EMA 对象本质上是一组属性,每个属性都包含一个值。模型组件的所有属性都由对应的 EMA 对象支持。对象属性的初始集合以及每个属性的默认值由对象类型决定(Ema 包内部有一个包含所有对象属性及默认值的数据库)。不过,你可以扩展属性集合,方法是使用一个对应于 Riverbed 程序中 extended attributes 按钮的 EMA 函数调用。

图 6:Ema 模型数据类型

Ema 模型数据类型

与模型类似,对象也通过类型和实例来区分。模型中的每个对象实例都有一个唯一标识符,使其与模型内所有其他对象区分开来,这称为对象 ID(注意,对象 ID 在不同模型之间不唯一,因此模型 #0 和模型 #1 都可以有对象 #45)。因此,在 EMA 应用中指定一个唯一的对象实例时,还必须包含该对象所在模型的 ID。类型相似的对象实例共享一个公共的对象类型(例如,所有处理器对象都被标识为处理器类型)。这些标识符的 C/C++ 语言类型定义和典型函数调用参数名如下表所列(给出类型定义是为了代码文档和清晰起见;这些标识符实际上就是整数,可以像 C/C++ 中的普通整数一样处理)。

表 2:EMA 对象数据类型

C/C++ 类型定义 典型参数名
EmaT_Object_Type object_type
EmaT_Object_Id object_id

属性

到目前为止介绍的 EMA 概念(模型和对象)本质上是分组元素。它们并不直接包含描述模型组件的数据;它们直接包含的是属性(上一节说明了对象包含属性集合,但在需要描述模型范围的参数时,模型也包含属性集合)。属性才是真正保存用于参数化模型组件的数据。

每个属性中存储的数据称为该属性的内容(contents)。属性的内容可以通过适当的 EMA 运算符(将在后续小节介绍)写入属性或从属性读取。下图展示了一个带有若干属性的对象;每个属性的内容都是一个整数。

图 7:对象属性结构

对象属性结构

由于建模和分析实体通常使用多种数据类型进行参数化,因此属性也必须是不同的类型(例如整数、字符串)。

属性的核心类型有

  • integer
  • double
  • string
  • textlist
  • object ID
  • double vector
  • poly

integer、double(即双精度浮点)和 string 属性类型与它们所基于的 C 数据类型类似。四种特殊属性类型是 textlist、object ID、double vector 和 poly。这些数据类型为描述模型组件提供了增强的直接支持。

textlist 是构成有序列表的字符串集合。Textlist 由一种 C 数据结构实现,并通过 Program Library(Prg)包中的一组函数间接操作。textlist 属性接受 textlist 作为值;textlist 属性的一个例子是与进程模型状态关联的 enter executives 列表。

Prg 包(其函数名形如 prg_)与仿真内核的 Programming 包(其函数名形如 op_prg_)是不同的。Prg 包的函数可以由 EMA 程序、外部工具程序和进程模型代码调用。仿真内核 Programming 包的函数只能由进程模型代码调用。

object ID 类型如前所述实际上是一个整数。但它具有特殊的语义:其内容引用模型中的另一个对象。被引用的对象必须存在,该属性的内容才有效。object ID 属性只能引用与该属性所在对象处于同一模型中的对象;不能引用其他模型中的对象。object ID 属性的存在使模型成为相互引用的对象的有向图,如下图所示。

图 8:对象间引用

对象间引用

double vector 是一种属性,它包含一组实数序列,表示对象或模型的单个参数。该向量以高效的格式存储一串双精度浮点值,连续的元素被打包到连续的内存位置(这类似于 C 语言中的数组)。double vector 的每个元素都有一个用于访问它的索引(元素从 0 开始编号)。每个 double vector 属性都有一个内置于 EMA 对象与模型内部数据库中的默认大小。可以通过一个特殊的 EMA 运算符更改默认大小,以扩展或缩小向量。

poly 类型是一种可以采取多种值的属性。poly 属性的值是本章所描述的允许属性类型之一,但不包括 poly 本身。

除属性核心类型外,还有一组属性类型修饰符,叠加在核心类型之上。这些修饰符主要影响通过 EMA 访问该属性的方式。

属性类型修饰符有

  • array
  • toggle
  • set-required

array 修饰符将一个属性扩展为实际表示一系列属性,每个属性由唯一的数组索引标识。这个概念有点像 C 中的数组,其中一系列元素通过索引引用。不过,属性数组实际上是用动态分配的内存实现的,因此它们可以增长到任意大小。

toggle 修饰符将属性定义为具有两种状态:启用和禁用。但无论属性处于何种状态,属性都有确定的内容。Toggle 适用于具有可选行为的对象,这些行为在启用时需要参数。例如,处理器模块默认不会被周期性中断,因此中断速率参数无关紧要;而当启用周期性中断时,中断速率参数就有意义了。这类对象行为本可以用两个属性来描述:一个包含中断速率,另一个作为指示是否启用周期性中断的布尔值。但使用 toggle 修饰符把两部分数据合并为一个属性更为方便。

set-required 修饰符表示某个属性没有默认值,并且必须为其指定内容(即必须被“设置”)之后,模型才能写出到磁盘。该修饰符主要用于核心类型为 object ID 的属性,因为如果这类属性未被设置,就没有“智能的”或明显的默认值。

所有受支持的属性都在EMA 内置属性一节中给出。每个属性的核心类型和类型修饰符也在该节中列出。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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