doubango(1)：类

doubango是基于c语言的，所以采用一套特殊机制来模拟了类。

类的声明

typedef struct trtp_rtcp_header_s {
    TSK_DECLARE_OBJECT;

    //类自己的变量
}
trtp_rtcp_header_t;

如上图，用struct来模拟类，而在每个struct的开始，添加TSK_DECLARE_OBJECT;，然后是类自己的变量。
TSK_DECLARE_OBJECT的作用是在每个类的开始添加了3个变量。
__def__是一个tsk_object_def_t结构的指针，后面再讲，
refCount是一个引用计数。
lock也是为了引用计数的一个锁相关变量。

#define TSK_DECLARE_OBJECT \
    const void* __def__;  /**< Opaque data holding a pointer to the actual meta-data(size, constructor, destructor and comparator) */ \
    volatile long   refCount; /**< Reference counter. */ \
    volatile long lock

类的创建

如何模拟类的构造和析构函数呢，这就要借助刚才提到的tsk_object_def_t。定义如下：

typedef struct tsk_object_def_s
{
    //! The size of the object.
    tsk_size_t size;
    //! Pointer to the constructor.
    tsk_object_t*   (* constructor) (tsk_object_t *, va_list *);
    //! Pointer to the destructor.
    tsk_object_t*   (* destructor) (tsk_object_t *);
    //! Pointer to the comparator.
    int     (* comparator) (const tsk_object_t *, const tsk_object_t *);
}
tsk_object_def_t;

tsk_object_def_t是一个类的描述，它包含了类的大小，构造函数，析构函数函数和比较函数。每个类都会有一个tsk_object_def_t的全局变量。如：

static const tsk_object_def_t trtp_rtcp_header_def_s = {
    sizeof(trtp_rtcp_header_t),
    trtp_rtcp_header_ctor,
    trtp_rtcp_header_dtor,
    tsk_null,
};
const tsk_object_def_t *trtp_rtcp_header_def_t = &trtp_rtcp_header_def_s;

有了它，就可以通过tsk_object_t* tsk_object_new(const tsk_object_def_t *objdef, ...)构造一个类了。
tsk_object_new 先通过def的size分配内存，初始化TSK_DECLARE_OBJECT增加的3个变量（对def赋值为传入的objdef，设置引用计数为1），再通过def的构造函数，对分配的内存进行初始化。

通常还会提供一个xxx_create或xxx_create_null的函数，来提供构建的操作。 create函数里调用tsk_object_new来完成构建。

引用计数和销毁

doubango里对象是通过引用计数来控制的，tsk_object_new设置引用计数为1，如果对对象进行了拷贝，并且要留下来做他用，需要调用tsk_object_t* tsk_object_ref(tsk_object_t *self)来增加引用计数。
不再需要时也通过tsk_object_t* tsk_object_unref(tsk_object_t *self)减少引用计数。tsk_object_unref会检查引用计数，如果为0，会自动销毁。因为对象开头有ref指针，所以能找到析构函数，调用析构函数，并释放内存。

类的继承

类的继承在doubango里，是通过在子类struct的一开始包含基类struct的变量来实现的。基本语法如下：

//基类声明
typedef struct tmedia_consumer_s
{
    TSK_DECLARE_OBJECT;
        //其他变量
} tmedia_consumer_t;
//为继承积累定义一个宏，内容为声明一个基类的变量
#define TMEDIA_DECLARE_CONSUMER tmedia_consumer_t __consumer__
//子类继承声明
typedef struct tdav_consumer_audio_s
{
    TMEDIA_DECLARE_CONSUMER;
    //其他变量
}
tdav_consumer_audio_t;

由于基类变量是子类的第一个变量，他们的地址是相同的，所以在使用时，直接对指针进行强转就可以了。（虚函数是没有的）

虚类

以tdav_producer_audiounit_t的继承关系为例，如下：
tdav_producer_audiounit_t继承tdav_producer_audio_t,tdav_producer_audio_t又继承tmedia_producer_t。
你会发现，tmedia_producer_t并没有提供_def_t的类，也没有构造和析构函数。而是提供一个xxx_init 和一个xxx_uninit函数。由于没有构造析构函数和def，所以无法实例化，模拟了虚类。
子类的构造函数里调用基类的xxx_init和xxx_uninit对基类部分进行初始化和反初始化。

到此，对doubango的类结构就基本了解了。

最后编辑于：2020.06.12 09:50:12