模型属性接口

模型属性接口这一概念在前面已被笼统地提及。严格来说,模型的属性接口并不包括那些声明为模型属性的属性,尽管这两类属性都构成模型的接口。模型属性被单独考虑,因为它们在一个地方被声明并完整定义。相比之下,模型的属性接口代表的是对其他属性定义的修改,本节将对此加以说明。

模型的属性接口由几种差别相当大的组件构成,因此“属性接口”这个名称可能令人困惑。这些组件列于下表。

表 30:模型属性接口的组件

组件 说明
属性接口描述 汇集源自模型所包含对象的被提升属性。其中可能包括由于从更低层次领域提升而归属于本地对象的属性。它允许在这些属性被提升到模型接口之前对它们执行多种操作,包括:更改属性名称;把多个属性合并为一个属性;修改某些特性,例如 range(范围)、comments(注释)等;以及隐藏属性(使其不出现在模型的接口中)。
模型关键字 在模型中保存由开发者提供的关键字,使 Modeler 的编辑器能够创建符合用户兴趣的模型“工作集”。关键字通常描述用户可能想要搜索的模型主要特征。
模型注释 用于帮助用户使用该模型的描述性文本。可以包含任意数量的一般性文本,通常描述模型的功能、主要的物理或逻辑接口、假设以及限制。
受支持的对象类型 某些类型的模型可以适用于多种类型的对象。但模型开发者可以使用这一属性接口组件来限制该模型所能支持的对象类型集合。它还允许为每种受支持的对象类型指定用于表示该模型的图标。

属性接口的统一概念在于,它们在塑造模型的外部视图方面发挥作用。也就是说,它们有助于决定把模型作为一个类来创建新对象的用户将会看到什么。

关键概念——“模型属性接口”这一术语用来把模型的若干不同定义归为一组。这些定义的共同特征在于,它们从用户的视角规定了模型的外部呈现。

属性接口描述

模型属性接口中最复杂的方面是属性接口描述的规定,它涉及被提升的对象属性。所有从模型的对象提升上来的属性都在属性接口中被重新归组。属性接口描述的作用,是允许在这些属性被提升到下一层次之前对它们作出若干更改。

属性重命名

属性接口描述最常见的用途是更改被提升属性的名称。这一操作称为属性重命名(attribute renaming),它在属性的原有名称与新名称之间建立等价关系。这是为了给模型用户提供有意义的属性名称所必需的。特别是,由于属性在被提升时会加上对象名称作为前缀,因此通常希望更改名称以去掉该前缀,从而简化呈现并隐藏底层的模型信息(也就是说,内部对象的名称对模型用户而言没有意义)。

重命名一个属性时,只有新名称通过 Modeler 的用户界面对模型用户可见。换句话说,当创建了一个作为该模型实例的对象时,该对象获得此属性并以新名称呈现它。然而在模型内部,该属性的原有名称仍然有效。因此,在对象自身的上下文中引用该对象属性的进程,在调用 op_ima_obj_attr_get() 和 op_ima_obj_attr_set() 这类内核过程时必须继续使用原有名称。在仿真期间,仿真内核不能假定所有需要访问被重命名属性的实体都知道重命名已经发生。事实上,重命名通常是在进程模型早已定义(当时只知道原始属性名称)之后,作为一种“表面”操作发生的。为了支持进程模型和管道阶段等实体继续使用原有名称,仿真内核在模型实例的上下文中同时支持两个属性名称。尽管原始名称在用户界面的任何部分都看不到,仿真本身仍可继续正确运行。重命名机制如下图所示。

图 59:属性重命名

属性重命名

关键概念——模型属性接口最常见的用途,是在属性被提升到下一层次时更改其名称。这使得该属性对模型用户来说显得更熟悉或更恰当。这一操作称为属性重命名。

除了属性的名称之外,属性接口描述还可以对属性特性施加更改。属性的每一项特性,包括默认取值、数值范围、符号映射和 comments(注释),都可以在被提升到模型接口之前加以修改。与呈现相关的特性(如 comments 和符号映射)被更改的情形非常常见,因为节点模型往往是为特定类型的用户准备的,可以选择合适的文本以匹配用户的背景。

当通过属性接口描述作出特性更改时,新的更改必须符合先前属性特性所设定的规定。这些更改可以通过限制用户可作的选择而使模型进一步“特化”,但它们不能让模型违反任何先前已存在的约束。因此,属性接口描述不得允许产生一个从先前定义的角度看无效的模型。这条规则只影响特性的某些组成部分:数值范围、符号映射和默认取值。相关约束记录在下表中:

表 31:模型属性接口中特性更改的约束

特性 约束
range(范围) 如果更改 range 特性,则新的 range 必须包含在先前的 range 之内。换句话说,新 range 中的任何取值都不得落在先前 range 之外。关于更改 range 可能对其他特性造成的约束违反,见下文。
符号映射(Symbol Map) 如果先前的符号映射不允许其他取值,则不得添加带新取值的符号。符号映射中的取值必须包含在先前指定的 range 之内(但不必包含在新的 range 之内)。在属性合并这一特殊情形下(见下文),这些符号必须包含在新的 range 之内。
默认取值(Default Value) 默认取值必须包含在指定的 range 之内。

关键概念——属性接口所施加的更改通常与被提升属性的特性修改有关。常见的更改涉及属性的 range、符号映射和 comments。新的特性配置不得导致违反先前特性所设定的约束。

属性特性的继承

在把属性的特性配置为模型属性接口的一部分时,可以为每项特性指定一个继承状态(inheritance status)。继承状态决定该特性是否应当与其来源定义中的同一特性保持绑定,或者是否可以被更改。由于每项特性各自维护自己的继承状态,因此可以让某些特性从原始属性定义继承其配置,而另一些特性则被更改。表 35 展示了用于为某些属性特性选择继承状态的 Node Editor 控件。

在定义的继承方面,符号映射的行为比其他特性略为复杂。Modeler 并不要求符号映射必须完全继承或完全重新定义,而是允许按符号逐个控制继承。符号映射中的 Allow other values 部分也可以继承或更改。如果允许其他取值,就可以创建额外的符号并定义它们对应的取值。这些符号的状态描述为“add”,表示它们将被追加到符号映射中。对于已包含在该属性先前定义中的符号,可以使用“suppress”状态把它从符号映射中移除。如果要保留该符号,可以给它“inherit”状态,表示它将继续跟随其原始定义。最后,同一个符号也可以重复使用但赋予不同的取值,这通过“replace”状态实现。下面的图示展示了一个包含上述各种状态符号的符号映射。

图 60:符号的状态取值

符号的状态取值

属性合并

属性接口支持另一种有用的机制,用于在提升之前对属性进行转换。这一机制称为属性合并(attribute merging),它允许把多个被提升的属性组合为一个属性。虽然各个属性在模型的上下文中仍然独立存在,但从模型用户的视角看,只出现一个属性。除了文档中可能给出的说明之外,Modeler 的用户界面中没有任何迹象表明该属性代表多个底层的对象属性。

图 61:属性合并

属性合并

属性合并通常用于模型中包含许多相似对象、且每个对象都提升自身属性的情形。对于某些真实应用,可能只有让所有这些属性在任何情况下都表现完全一致才有意义。为此,可以使用属性合并把“这些属性绑定在一起”。例如,考虑一个交换机的节点模型,其中包含 16 个发射器和接收器对象,每个都有自己的传输速率。再假设该节点模型所代表的真实设备,制造商提供了多种传输速率,但在所有配置中,16 个端口总是使用相同的传输速率。为了防止用户使这些传输速率出现分歧,可取的做法是把这些属性合并为一个属性,可以称之为“交换机的传输速率”。这样,属性合并还带来一项重要的额外好处,即减少模型用户所需的规定工作量,因为只需规定一个属性取值,而不是 16 个。

作为一组属性,被合并属性的行为取决于访问它们的层次。在模型的作用域内部,每个属性都可以单独修改和查看,因此它们可以被赋予不同的取值。而在模型实例的上下文中,这些属性是统一的,对被合并属性的更改会传播到所有各个底层属性。不过,与仿真内核在属性重命名发生时仍支持旧属性名称的原因相同,重命名机制也支持按原始名称访问各个属性。因此,尽管这些属性不会在用户界面中的模型实例上出现,它们仍然可以通过仿真内核 Ima 包的 API 来访问。请注意,被合并属性的底层取值可能出现分歧,这带来一个特殊情形:当使用“op_ima_obj_attr_get()”或仿真内核的调试器等查询被合并属性的取值时,应当返回哪个取值。如果出现这种情形,Modeler 会选择不返回取值,因为被合并属性的取值是有歧义的;取而代之,它会返回一个特殊码,表明存在分歧的取值。更多信息参见“op_ima_obj_attr_get()”。

关键概念——模型的属性接口可以在本地层次上把一组属性归并为模型用户所看到的一个属性。这些属性被称为被合并。当许多对象提升同一个属性、并且已知它们逻辑上“绑定在一起”(即必须始终具有相同取值)时,这一机制非常有用。

当属性通过模型的接口提升并被模型实例继承时,该属性可以被置于若干状态之一。这种状态称为属性的状态(status),它为模型开发者提供了一种重要的控制机制。各状态取值及其效果列于下表。

表 32:属性的状态取值

状态 说明
promoted 被提升属性出现在下一建模层次,并在该层次上初始地继续被提升。
set 被提升属性以指定的初始取值出现在下一建模层次。除非显式采取措施把它继续提升,否则它不会越过下一层次。
hidden 被提升属性存在于下一建模层次,但不出现。系统为该属性指定初始取值,并且该取值在下一建模层次上无法更改(在用户界面中无法访问)。由于该属性存在于下一层次,因此可以在仿真期间访问它。当许多属性的取值可以预先知道,或者它们的取值并不相关时,这一机制有助于缩短冗长的属性列表。

关键概念——当属性通过模型的接口提升到模型的实例时,接口会在三种可能的状态设置中选择一种,决定:1) 该属性以被提升的形式出现在对象上;2) 该属性出现并具有某个初始赋值;3) 该属性获得赋值但不出现。

属性特性的更改不仅适用于被提升的对象属性,也适用于模型实例的某些选定内置属性。例如,节点对象的“altitude”属性可以通过节点模型的属性接口来控制。用户可能希望把节点的海拔限制在某个高度以上,此时就需要编辑该属性的 range 特性。

与被提升的属性一样,内置的实例属性也可以被赋予状态。这一能力常用于隐藏实例中不重要的属性,以简化对象的属性列表。通常这是一种良好的做法,因为属性列表可能变得不必要地冗长,令模型用户困惑。当然,那些相关但为保证模型正确运行必须具有特定取值的属性,可以被赋值并隐藏,以确保模型用户不会更改它们。

关键概念——模型属性接口还为依赖该模型的对象的某些内置属性提供控制。与被提升的属性一样,受支持的内置对象属性可以被提升、预先赋值或隐藏。如果模型的正确运行依赖于这些属性的特定设置,这是一个重要的机制。

受支持的对象类型

若干类型的模型(包括节点模型、链路模型和路径模型)可用于实例化多种类型的对象。例如,如果使用 Wireless 模块,一个节点模型可以应用于固定节点、移动节点或卫星节点。类似地,单工点对点、双工点对点、总线以及抽头链路对象都使用链路模型。由于某些模型只对特定类型的对象才有意义,Modeler 允许某些类型的模型区分受支持与不受支持的对象类型。这使得 Modeler 只允许对该模型进行正确的实例化。根据模型类型的不同,还可以通过同一机制规定与受支持对象相关的额外信息。就节点模型、链路模型和路径模型这一具体情形而言,会为每种受支持的对象类型指定在图形化网络模型中表示该对象的图标。这些图标出现在编辑器的对象调色板中,也出现在网络图里。

下图展示了一个对话框区段,用于为某个节点模型规定受支持的节点对象类型。

图 62:受支持节点类型的规定

受支持节点类型的规定

模型关键字

在实例化模型时,Modeler 的编辑器必须让用户选择要使用的模型。特别是,Project Editor 使用*对象调色板(object palette)*来呈现可用的节点模型和链路模型。每个模型都由一个图标表示,如受支持的对象类型一节所述。用户把图标从调色板“拖”到图中,以创建作为相应模型实例的新对象。

对象调色板中所表示的模型保存在宿主计算机的文件系统中,Modeler 可以被配置为在特定目录中搜索模型。然而,这些目录中存在的链路和节点模型列表可能极其冗长,并且很可能包含许多与当前工作无关的模型。不幸的是,这会使对象调色板变得庞大而杂乱,用户可能难以找到感兴趣的模型。为解决这一问题,并总体上便于查找模型,Modeler 为某些类型的模型提供了模型关键字机制。

目前只对节点模型、链路模型和路径模型,Modeler 允许指定一个关键字列表。关键字数量不限,每个关键字各自独立起作用。在 Project Editor 中,可以让对象调色板按照期望关键字列表对模型集合进行“筛选”。这样,调色板就只呈现与当前项目相关的节点和链路模型。

保留关键字“hidden”用于向 Modeler 表明不应显示该模型,即使其他关键字符合用户指定的筛选条件。只有当显式指定“hidden”关键字时,该模型才会被呈现。当事先决定某个模型由于用户感兴趣的可能性很低而应很少显示时,这一机制很有用。它与称为“Model Derivation”(模型派生)的功能配合使用时尤其有用,该功能在派生模型一节中说明。

模型注释

模型的属性接口中包含 comments(注释),可用于向用户提供关于模型的一般性文档。模型注释由一般性的非结构化文本构成,允许模型开发者以任意格式规定信息。这些注释没有任何功能作用,必要时可以留空,但完整地记录模型的接口是一种非常好的做法。这使得用户能够正确使用模型,并在不查看模型内部的情况下理解模型的功能。如果预期的用户使用其他 Riverbed 分析软件产品,他们通常无法访问模型内部,模型注释或其他随附文档便是他们理解模型及其用法的唯一资源。

关键概念——模型可以包含关键字,用以标识自身的特征或它所适用的应用类型。Modeler 可以利用关键字有选择地只呈现用户感兴趣的那些模型。模型注释让开发者能够向用户提供关于模型功能的一般性文档。

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