使用客户端状态为特定问题域定制图
本包中的基本图是通用构造,因此问题域(例如通信网络)所需的专门信息,必须通过在组成图的边和顶点上添加领域特定信息来提供。Prg_Graph 提供了向各种受支持对象引入状态的机制。这一概念与 OPNET Development Kit 中其他多个包所提供的机制类似:任意数据结构可以附着到包对象上,并在需要时查询或替换。这些结构在客户端与 Prg_Graph 之间以通用内存地址的形式交换,声明为 void *。
Prg_Graph 并不只是简单地允许客户端在边和顶点上附着单份状态信息结构,而是提供了一种精细的机制,支持在每个对象上并行存放多个信息“平面”。这些平面通常对应于共享同一张图、但希望独立管理各自状态的多个客户端。
为了在同一批对象上实现独立的状态存储,客户端借助一个称为“命名空间”(namespace)的概念。命名空间定义了一族客户端,并为每个客户端存储某些关键信息。命名空间本质上是一个中心注册表,多个感兴趣的客户端可以“联系”它并获得一个唯一 ID。该 ID 随后可用于在同一命名空间的所有客户端之间标识该客户端,并用于区分附着在每个对象(此处即顶点和边)上的数据结构。
每张图都有一个命名空间。该命名空间可以与其他图的命名空间相互独立;如果各图管理相同的客户端状态族,也可以共享。命名空间的唯一性由创建时赋予它的名称决定。在 Prg_Graph 中,命名空间通过显式调用 prg_graph_state_handler_register() 创建。如果命名空间的名称是新的(尚未创建过同名命名空间),则会隐式创建该命名空间。
例如,设想同一应用中的两个客户端 Visualizer 和 Routing_Engine,它们希望向同一张网络图添加状态信息,并彼此独立地保持各自的状态。它们可以执行以下操作序列:
- Visualizer 在名为“network operations”的命名空间中注册自己,并通过这一动作隐式创建该命名空间,因为它是第一个注册的客户端。这通过调用 prg_graph_state_handler_register() 并指定命名空间名称来完成。在同一次调用中,Visualizer 将自己的“状态名称”指定为“Visualizer”,以区别于“network operations”命名空间中的其他客户端。同时,Visualizer 还传入一个销毁过程和一个复制过程,图包可以在复制或销毁图时使用它们来复制和销毁 Visualizer 专有的状态。该函数返回一个状态 ID(数据类型
PrgT_Graph_State_ID),后续需要用它来选择 Visualizer 的状态而非 Routing_Engine 的状态。 - Routing Engine 以与 Visualizer 相同的方式注册自己。它指定相同的命名空间名称“network operations”,但将自己的状态名称指定为“Routing Engine”,并提供不同的复制和销毁过程,以处理其类型的状态数据结构。它收到一个不同的状态 ID,并将其保存在一个可在后续程序执行中复用的变量中。注意步骤 1 和 2 的顺序是任意的——任一客户端都可以先注册。
- 两个客户端之一通过调用 prg_graph_create() 并传入命名空间名称“network operations”来创建图对象。只需保证命名空间在此之前已创建,因此从技术上讲这一步也可以是步骤 2。类型为
PrgT_Graph*的句柄返回给客户端,并保存在变量中供后续使用。 - Visualizer 通过调用 prg_graph_client_state_set() 在图对象上设置自己的专有状态信息。它传入先前收到的状态 ID,以将自己的状态与其他潜在客户端的状态区分开。注意它不需要了解其他客户端。另请注意,本例中是在图上设置状态,但同样的概念也适用于在边和顶点上设置状态
- Routing_Engine 执行与步骤 4 中 Visualizer 相同的操作,但使用自己的状态 ID。两个状态现在在图上被分别维护。
- 当任一客户端希望从图对象取回自己的专有状态指针时,它调用 prg_graph_client_state_get() 并传入自己的状态 ID。
尽管初看似乎复杂,这一过程通常相当简单,因为大多数情况下只需要一个命名空间。首先每个客户端注册,然后创建图。利用注册时获得的状态 ID,客户端把状态信息放置在每个感兴趣的对象(例如顶点)上。此后,客户端每当需要读写与每个感兴趣对象关联的私有数据结构时,只需用状态 ID 取回自己的状态指针即可。
在只需要一个客户端的情况下(这相当常见),仍须遵循同样的过程,但命名空间的名称和客户端的名称变得无关紧要。可以使用任何名称来获得状态 ID。