包概述

注意: 使用 Client State 包需要拥有 OPNET Development Kit 的许可证。

Client State 包提供了一套 API,允许你的代码(client)将你的数据结构(state)与 Riverbed Modeler 对象一起存储。当网络模型对象(node、link、subnet 或 path)被复制或销毁时,Client State 包帮助你跟踪你的数据结构。该包还提供了必要的函数,供你以 Block 或 XML 格式读写(从磁盘读取/写入磁盘)你的结构的序列化形式。

要使用这个包,你必须先向 Riverbed Modeler 注册一个初始化函数。(有关如何做到这一点的信息,参见 “netbiz.ets File Structure“ 第 22 页 中关于 ets_initialization 属性的文档。)在初始化期间,你的代码必须注册一个或多个 client state 类。当你注册 client state 类时,你必须为该 state 类提供一个名称,并提供用于释放、复制、读取和写入你的 state 的回调函数。

注册你的 client state 类之后,你就可以在 node、link、subnet 和 path 上获取和设置你的 state。如果带有 client state 的对象从网络中被移除(即被剪切),或者包含该对象的模型被关闭,则会调用释放回调来释放该 state 使用的内存。如果带有 client state 的对象被复制到剪贴板,则会调用复制回调函数。

根据格式的不同,你使用不同的回调函数来保存到磁盘或从磁盘读取,如下表所示。

表 6:磁盘 I/O 回调函数

操作 格式 调用的函数
保存到磁盘 Block write 回调
保存到磁盘 XML export 回调
从磁盘读取 Block read 回调
从磁盘读取 XML import 回调

当对象从磁盘读取或写入磁盘时被调用的函数会接收 client state,以及一个称为 block 的数据结构。block 保存 state 数据的序列化形式,为写入磁盘做准备。你的读/写回调函数必须能够通过调用相应的 Ets_State_Block_ 函数,在 block 中读写整数、字符串和 double 值。