用户界面定制

OPNET Development Kit 自带一个默认界面,其中包含 NetPlanner 支持的全部工具和菜单项。不过,您可以向界面添加元素或移除元素,可以修改某个工具的功能,也可以创建同一工具的多个版本,每个版本各有不同的侧重点。

上一节概述、下文详细解释的这些配置文件控制着工具、标准动作按钮和 ETS 函数的可用性。通过修改这些文件或创建您自己的替代版本,您可以定制用户界面,使其符合您的特定需求。

以下小节将介绍 editor configuration file(OPNET Development Kit 的顶层配置文件),以及在现有工具集基础上创建变体的过程。

创建编辑器变体

您可以修改标准 NetPlanner 工具:为其添加使用外部程序(通过 ETS)的操作,并移除现有操作。当您在 editor configuration file 中创建一个指向修改后定义文件的新条目时,ODK 应用程序会为新操作显示一个菜单项。当用户选择该新菜单项时,就会执行相应的专用代码。

要创建编辑器变体,您需要:

  1. 修改定义文件,移除您不需要的菜单操作,并添加使用外部程序的菜单操作。
  2. 在 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)

该函数:

  1. 使用 Ets_Obj_Type_Get() 检查被安装的对象是否为链路。
  2. 如果该对象是链路,且端点是一个流量生成节点和一个路由器,则比较新节点的 customer 属性与连接到该路由器的所有其他流量生成节点的 customer 属性。该函数使用 Ets_Topo_Assoc_Get() 获取端点的句柄,并使用 Ets_Obj_Attr_Get() 获取它们的属性值。
  3. 如果任何现有节点具有相同的 customer 属性,则销毁该链路并打印错误消息。

示例:复制场景

该项目演示如何为特定任务调用函数。在本例中,用户拥有自定义文件格式,但希望使用 Duplicate Scenario 菜单项同时创建自定义格式和 Riverbed 格式的副本。

开发者有两个选择:

  • 创建一个自定义函数,由它自己完成整个复制工作。
  • 创建一个自定义函数,先完成自定义文件的复制,然后使用 Ets_Command_Builtin_Exec (duplicate_scenario) 调用标准的场景复制函数。

要使用第二个选项实现该功能,开发者需要:

  1. 创建自定义函数。

  2. 修改 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),且该函数不能接受任何参数。

    当菜单项被点击时,该函数会被自动调用。

示例:派生外部程序

目标是添加一个按钮,以当前项目-场景名称作为参数派生一个外部程序。

需要完成的任务是:

  1. 通过在 std_project_icon_operations.ets 中添加以下行来创建按钮:

    start_operation
       operation: exec_function <library_name> <function_name>
       icon:      your_icon_name
    end_operation
    

    <function_name> 应为第 3) 步中描述的函数名称。

  2. 使用图标编辑器创建图标,如 Modeler Editors Reference 手册的 Icon Database Editor 一章所述。

  3. 创建一个函数(本例中为 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);

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