对象

NRAC 网络中的每种对象都维护着某些信息,以支持 NRAC 服务。表 2 汇总了各对象及其相关信息。

表 2:NRAC 网络对象

对象 说明 维护的信息
Network(网络) 所有其他类型对象的容器,提供一个独立于其他网络的上下文 名称:自由格式文本
资源度量单位名称(如 "Mbps")
客户端状态指针:指向与本对象关联的用户自定义内存的指针
该网络内创建的所有资源、消费者和事件
Resource(资源) 基础设施构件,可被一个或多个消费者使用 名称:自由格式文本
容量:资源的大小
客户端状态指针(见上)
Consumer(消费者) 基础设施使用者,即消耗资源的对象 名称:自由格式文本
负载:消耗的资源量
客户端状态指针(见上)
Event(事件) 影响资源消耗方式的条件或情形 描述:自由格式文本
客户端状态指针(见上)
Conditional Consumer(条件消费者) NRAC 针对某些查询返回的对象,表示消费者与事件的配对 Consumer:所关注的消费者
Event:消费者实际使用该资源所必需的事件

NRAC 对象由 API 客户端通过"句柄"(handle)来管理。简而言之,句柄就是对所关注对象的引用。要通过 API 操作某个对象,就需要使用句柄。句柄与指针很像,但让程序员能够保持对对象更抽象的视图,而不必把它看作一块内存。NRAC 包各对象的句柄列于表 3。每个句柄都有各自的数据类型,用于函数参数和变量。

表 3:NRAC 对象句柄

NRAC 对象 句柄数据类型
Network Nrac_Net_Handle
Resource Nrac_Resource_Handle
Consumer Nrac_Consumer_Handle
Event Nrac_Event_Handle
Conditional Consumer Nrac_Conditional_Consumer_Handle

以下重要说明及函数引用将澄清这些对象的用法:

  • 资源与消费者之间的关系是"多对多"的。换言之,单个资源可被多个消费者使用。这在资源"超售"的情形下是合理的,尤其是因为这种关系可能依赖于某个事件。因此,多个消费者可以共享一个资源而永不冲突——只要它们对资源的使用依赖于互斥的事件。这与网络容量规划中共享保护的概念非常契合。
  • 资源与消费者的关系通过调用 nrac_resource_consumer_add() 建立。"撤销"这种关系有几种方式,各自的作用范围不同:
  • 可以从资源或消费者的角度执行查询,以检查系统的状态。NRAC 包提供汇总你所建立的全部关系的服务,免除了你自己统计的负担。使用 nrac_resource_consumers_get() 查找使用某个特定资源的消费者。使用 nrac_consumer_resources_get() 查找某个给定消费者所使用的全部资源(例如端到端连接所经过的全部链路)。使用 nrac_resource_load_get() 获取网络中各消费者施加在某个给定资源上的负载。
  • 条件消费者是由 nrac_resource_consumers_get() 返回的对象。更准确地说,返回的是一个列表(Prg 包的 List *),其中包含零个或多个条件消费者对象。每个条件消费者对象表示:所关注的资源会被该消费者使用,但仅在特定事件的条件下才会如此。每个此类对象对应的消费者和事件可分别通过调用 nrac_conditional_consumer_consumer_get() 和 nrac_conditional_consumer_event_get() 获取。
  • 许多允许你指定特定事件或消费者的函数,也允许你用特殊常量来代替这些信息,表示"任意事件"(NRAC_ANY_EVENT)或"任意消费者"(NRAC_ANY_CONSUMER)。这种通配特性使你可以例如请求在任意条件下使用某个特定资源的消费者列表,而不限于某个特定事件发生时。类似地,在调用 nrac_consumer_remove_from_resource() 时,将待移除的消费者指定为 NRAC_ANY_CONSUMER,即可从资源上移除所有消费者。
  • 上表中提到的每种对象都允许你通过调用相应的 "get" 函数来访问其维护的基本信息。例如,nrac_event_desc_get() 允许你获取事件对象的描述。关于同类 "get" 函数的完整说明,请参阅本章的函数详细列表。
  • "客户端状态指针"的概念得到每种主要对象类型的支持。这些指针的目的是让你能够高效地将 NRAC 对象与应用程序中的对象或结构关联起来。举例来说,当你调用 nrac_consumer_resources_get() 时,会得到一个资源句柄列表。如果你在创建资源对象时为其设置了名称,这些资源对象就会有名称。然而,用名称去查找网络中对应的对象可能效率不高。为解决这个问题,你可以在 NRAC 网络模型中的每个资源里嵌入一个指向你网络中某个链路对象(例如)的指针。客户端状态指针是可选的——如果某些或全部对象不想使用它们,只需在创建对象时传入 NIL 指针。