用户界面定制
OPNET Development Kit 自带一个默认界面,其中包含 NetPlanner 支持的全部工具和菜单项。不过,您可以向界面添加元素或移除元素,可以修改某个工具的功能,也可以创建同一工具的多个版本,每个版本各有不同的侧重点。
上一节概述、下文详细解释的这些配置文件控制着工具、标准动作按钮和 ETS 函数的可用性。通过修改这些文件或创建您自己的替代版本,您可以定制用户界面,使其符合您的特定需求。
以下小节将介绍 editor configuration file(OPNET Development Kit 的顶层配置文件),以及在现有工具集基础上创建变体的过程。
创建编辑器变体
您可以修改标准 NetPlanner 工具:为其添加使用外部程序(通过 ETS)的操作,并移除现有操作。当您在 editor configuration file 中创建一个指向修改后定义文件的新条目时,ODK 应用程序会为新操作显示一个菜单项。当用户选择该新菜单项时,就会执行相应的专用代码。
要创建编辑器变体,您需要:
- 修改定义文件,移除您不需要的菜单操作,并添加使用外部程序的菜单操作。
- 在 editor configuration file 中为新操作创建一个条目。
下次启动时,ODK 应用程序就会包含修改后的编辑器。
您可能需要编译和链接自定义库,方法参见《构建代码库》(第 13 页)。
以下小节给出三个通过 ETS 添加新功能的示例。
示例:控制用户输入
该项目演示如何对链路的连接方式施加算法限制。所讨论的网络包含一个带 type 属性的路由器和一个带 customer 属性的流量生成节点。目标是防止用户把两个 customer 属性值相同的流量生成节点连接到同一个路由器。
该方案使用 Ets_Nt_Object_Install_Callback_Register() 注册一个回调函数,该函数在对象被安装到网络时都会被调用。Ets_Nt_Object_Install_Callback_Register() 在一个名为 <project name>_ets_init 的函数内部被调用,而该函数在应用程序启动时被调用。
Ets_Nt_Object_Install_Callback_Register() 注册的回调函数执行算法检查。该回调不返回任何内容,但与所有需要在 ODK 应用程序内部调用的其他 ETS 函数一样,它应当用 DLLEXPORT 导出。
回调原型为:
typedef void
(*EtsT_Nt_Object_Install_Callback)
(EtsT_Obj_Handle * obj_handle_array, int array_size, void *state_ptr,
EtsT_Nt_Object_Install_Src source)
该函数:
- 使用
Ets_Obj_Type_Get()检查被安装的对象是否为链路。 - 如果该对象是链路,且端点是一个流量生成节点和一个路由器,则比较新节点的 customer 属性与连接到该路由器的所有其他流量生成节点的 customer 属性。该函数使用
Ets_Topo_Assoc_Get()获取端点的句柄,并使用Ets_Obj_Attr_Get()获取它们的属性值。 - 如果任何现有节点具有相同的 customer 属性,则销毁该链路并打印错误消息。
示例:复制场景
该项目演示如何为特定任务调用函数。在本例中,用户拥有自定义文件格式,但希望使用 Duplicate Scenario 菜单项同时创建自定义格式和 Riverbed 格式的副本。
开发者有两个选择:
- 创建一个自定义函数,由它自己完成整个复制工作。
- 创建一个自定义函数,先完成自定义文件的复制,然后使用
Ets_Command_Builtin_Exec (duplicate_scenario)调用标准的场景复制函数。
要使用第二个选项实现该功能,开发者需要:
-
创建自定义函数。
-
修改
std_project_scenarios_operations.ets文件,使其调用自定义函数。Duplicate scenario 菜单项对应的操作通常为:operation: exec_builtin duplicate_scenario修改后变为:
operation: exec_function <library_name> <function_name><library_name>是不带文件扩展名的函数名称(例如只写mylibrary,而不是mylibrary.gui32.i0.ets.so),且该函数不能接受任何参数。当菜单项被点击时,该函数会被自动调用。
示例:派生外部程序
目标是添加一个按钮,以当前项目-场景名称作为参数派生一个外部程序。
需要完成的任务是:
-
通过在
std_project_icon_operations.ets中添加以下行来创建按钮:start_operation operation: exec_function <library_name> <function_name> icon: your_icon_name end_operation<function_name>应为第 3) 步中描述的函数名称。 -
使用图标编辑器创建图标,如 Modeler Editors Reference 手册的 Icon Database Editor 一章所述。
-
创建一个函数(本例中为
spawn_prog),获取项目-场景名称并派生外部程序。该函数将包含以下标准 ETS 函数:/* Get the current model handle and name of the network. */ Ets_Project_and_Scenario_Name_Get (model_handle_buffer);
spawn_prog 函数随后以项目-场景名称作为参数派生外部程序,方法是调用标准 C 函数 system:
char arg_str[255];
sprintf (arg_str, "%s %s", external_prog, project_scenario_name);
system (arg_str);