在需要对某个功能做拓展时,使用工厂模式能给代码带来尽量少的修改量。本文将通过遵循SOLID设计原则中的开闭原则和依赖倒置原则在C语言上实现工厂模式。
下面将使用解码器功能作为例子进行讲解,下图为使用工厂模式设计的类关系图和程序运行流程图。
本文的结构如下:
工厂设计
以下为工厂类中的成员与成员函数。
/**
* @enum ret_t
* @annotation ["scriptable"]
* 函数返回值常量定义。
*/
typedef enum _ret_t {
/**
* @const RET_OK
* 成功。
*/
RET_OK = 0,
/**
* @const RET_OOM
* Out of memory。
*/
RET_OOM,
/**
* @const RET_FAIL
* 失败。
*/
RET_FAIL,
// ...
/**
* @const RET_BAD_PARAMS
* 无效参数。
*/
RET_BAD_PARAMS = 16,
} ret_t;
/* decoder_factory.h */
#ifndef DECODER_FACTORY_H
#define DECODER_FACTORY_H
#include "tkc/darray.h"
#include "audio_decoder.h"
typedef decoder_t* (*decoder_create_t)(void);
/**
* @class decoder_factory_t
* decoder工厂。
*/
typedef struct _audio_decoder_factory_t {
/*private*/
darray_t creators;
} audio_decoder_factory_t;
/**
* @method decoder_factory_instance
* 获取decoder工厂实例。
* @annotation ["constructor"]
* @return {decoder_factory_t*} 返回decoder工厂实例。
*/
decoder_factory_t* decoder_factory_instance(void);
/**
* @method decoder_factory_register
* 注册decoder创建函数。
* @param {decoder_factory_t*} factory decoder工厂对象。
* @param {const char*} type 类型(如mp3)。
* @param {decoder_create_t} create decoder创建函数。
*
* @return {ret_t} 返回RET_OK表示成功,否则表示失败。
*/
ret_t decoder_factory_register(decoder_factory_t* factory, const char* type,
decoder_create_t create);
/**
* @method decoder_factory_create_decod