NS by Example

目录

OTcl Linkage联接

---

OTcl Linkage 联接

添加新的基础网络对象去扩展NS，通常需要从C++代码中得到OTcl linkage（联接）， 对象的类用C++来编写由于它的高效性。 本节介绍了NS中C++/OTcl联接， 并给出新建一个简单的名叫"MyAgent"代理的示例，"MyAgent"代理没有任何行为(i.e. no packet creation and transmission). Figures 18 到 21 列出了C++ source file for "MyAgent"。 本节最后是一个OTcl脚本用来测试"MyAgent"是否被实现.

导出C++类到OTcl Export C++ class to OTcl

假设用C++新建了一个网络对象的类"MyAgent"，它是从"Agent"类衍生出来， 然后他能够建立一个OTcl对象的实例。为了实现这个功能我们必须定义一个联接对象"MyAgentClass"， 它从"TclClass"衍生得来。 这个联接对象创建了一个有指定命名的OTcl对象(这个例子名为是"Agent/MyAgentOtcl")， 并建立一个联接在OTcl对象和C++对象("MyAgent")之间， 它的实例运行"create"成员函数中指定的程序。Figure 18 表示"MyAgent类"和联接类的定义

 

Figure 18. Example C++ Network Component and The Linkage Object

当NS开始运行， 它运行静态变量(static variable) "class_my_agent"的构造函数, 这样一来"MyAgentClass"的实例被建立了。 在这个处理过程中， "Agent/MyAgentOtcl"类和他的方法method(成员函数)也在OTcl的空间内被建立。 无论何时用户在OTcl空间内建立一个对象的实例就会使用命令"new Agent/MyAgentOtcl"， 它调用"MyAgentClass::create"去建立"MyAgent"对象并返回它的地址。 这里要当心， 从OTcl中建立一个C++对象的实例并不意味着能够从OTcl调用C++对象实例的成员函数或访问它的成员变量。

导出C++类的变量到OTcl Export C++ class variables to OTcl 

假设C++对象"MyAgent"有两个参数变量"my_var1"和"my_var2"， 并且我们想轻松的在OTcl中使用模拟脚本来配置（改变）它们 。这需要使用对每个想要输出的C++类的变量的绑定函数（binding function）。 一个绑定函数建立一个给出名字的新成员变量(绑定函数的第一个变量)在对应的OTcl对象类("Agent/MyAgentOtcl")中， 并建立一个双向绑定在OTcl类的变量和C++变量（第二个变量指定的地址）之间。 Figure 19表明如何给Figure 18中"my_var1" 和"my_var2" 建立绑定。

 
Figure 19. Variable Binding Creation Example

绑定函数位于"MyAgent"的构造函数中，这样在建立对象的实例时就建立了绑定。NS 支持4种不同的绑定函数对应5种变量类型： 

- bind(): real or integer variables - bind_time(): time variable - bind_bw(): bandwidth variable - bind_bool(): boolean variable

以这种方式就可以设计和运行一个模拟并且能使用OTcl脚本去改变或访问C++实现的网络组件的配置参数(或变量的值) 。 无论何时导出一个C++变量， 建议还要去设置这个变量的默认值在"ns-2/tcl/lib/ns-lib.tcl"文件中。 否则在建立新对象的实例时将收到警告信息。

导出C++对象的控制命令到OTcl Export C++ Object Control Commands to OTcl 

给C++对象("MyAgent")定义一个"command"成员函数作为OTcl命令的解释器。 事实上对于用户来说， 在一个C++对象的"command"成员函数中定义的OTcl命令， 和对应的OTcl对象中的成员函数看起来是一样的。Figure 20给出Figure 18中"MyAgent"对象定义的一个"command"成员函数的例子。