doubango(3)--协议栈的启动过程

协议栈启动的上层接口

         对于Doubango中得sip协议栈，是通过SipStack类粘合上层代码与底层代码的，该类定义在SipStack.h中，实现在SipStack.cxx中。当构造好一个SipStack实例之后，对于底层而言，实际上是创建了一个tsip_stack_t 的实例，这个实例在SipStack类中通过tsip_stack_handle_t *handle字段指向。此时，handle对于上层而言是不透明的，从tsip_stack_handle_t的定义也可以看出：

         typedefvoid tsip_stack_handle_t

因此，handle实际上是一个void指针。指向具体的tsip_stack_t实例。实际上，stack的底层实例已经创建好，并且已经设置好了很多字段信息。但是stack仍旧是没有启动的，若要启动协议栈，对于上层代码而言，可以通过SipStack->start()达到此目的。

         SipStack->start(),正是提供给上层启动底层协议栈的粘合接口。而该接口仅仅是对底层协议栈启动的真正函数tsip_stack_start(tsip_stack_t *stack)函数的一个封装而已。

 

底层协议栈的启动--tsip_stack_start(…)

tsip_stack_start(tsip_stack_t *stack)函数主要完成三件事情：

1.     对协议栈运行模式的处理

判断工作模式为服务器模式或者是客户端模式，在默认情况下，Doubango是作为一个客户端软电话的底层运作机制配置的，因此在这种情况下，我们得到的是客户端运行模式。

另外，还要判断网络层协议族和传输层(tcp,udp)类型，默认情况下为IPV4以及UDP。选择一个最合适的本地ip地址(根据目前的网口选择)网口的IP地址最终由getaddrinfo(…)获得。

 

2.     启动协议栈的sipevent 事件处理线程run(…)

在stack的结构中，有一个TSK_DECLARE_RUNNABLE的宏声明，这个宏实际上在stack的顶端嵌入了一个tsk_runnable_t__runnable__的结构实例，因此，stack可以被安全的强制转化为一个tsk_runnable_t的类型实例，而这就是TSK_RUNNABLE宏的作用。

TSK_RUNNABLE(stack)->objects是一个队列头，传入其中的元素是通用的tsk_list_item_t,而tsk_list_item_t的作用就是将一个需要记录的实例(任何结构的实例)挂接在tsk_list_item_t的void *data 字段。

因此，TSK_RUNNABLE(stack)->objects实际上是一个队列，该队列中挂载的结构实例便是tsip_event_t结构的实例。

 

Stack的run(…)线程在stack的生存周期内一直在运行，它的作用是从TSK_RUNNABLE(stack)->objects中取出一个tsip_event_t实例，然后通过注册到stack的回调函数，将该sip事件传递到高层的用户代码中。实际上，这里的传递需要穿越粘合层，因为stack中回调函数即stack->callback(…)，便是由SipStack类注册的stack_callback(…)函数，该函数的原型如下：

           int stack_callback(tsip_event_t*sipevent);

 

3.     启动协议栈的传输层——tsip_transport_layer

首先，生成一个默认的tsip_transport_t实例，链接如stack的tsip_transport_layer的transports队列。

其次，启动tsip_transport_layer，这里便完成了套接字的生成，端口绑定，若是tcp协议还要完成connect的相关事宜。

 

到了这里，粘合层的任务便已经完成了，底层的套接口已经启动，可以接受来自对端的sip消息和处理该sip消息了。