转自 http://blog.csdn.net/xkarl/article/details/6340180
Log4C,Log4CPlus/Log4cpp,Log4j,Log4Net,Log4Perl,Log4PHP,Log4PLSQL,Log4LS,Log4py,Log4r,qmmslog,JDK1.4's util.logging framework是常用的LOG调试库,log4**的架构都类似
虽然C不是面向对象语言,但是log4c的实现完全是面向对象思想,和log4j的实现方式几乎雷同
Log4c需要设置的,也就是面向用户的,接口有
category:log的日志模块
Appender:log输出方式stream,mem,syslog等
Layout:log打印方式,基本的,详细的(比如详细时间等)
1、 Factory Method工厂方法的管理
这里的SD(Service Design)就相当于一个N个工厂集合(log4c_category_factory和log4c_appender_factory和log4c_layout_factory是单态的工厂,通过sd_factory_xx来做管理)
不要理解为polymorphism,只不过提供一个Service Design的统一API而已,根据实际需要是可以分离开的,
factory.h :
struct __sd_factory {
char* fac_name;
const sd_factory_ops_t* fac_ops;
sd_hash_t* fac_hash;
};
typedef struct __sd_factory sd_factory_t;
extern sd_factory_t* sd_factory_new(const char* a_name, const sd_factory_ops_t* a_ops);
extern voidsd_factory_delete(sd_factory_t* a_this);
extern void*sd_factory_get(sd_factory_t* a_this, const char* a_name);
extern voidsd_factory_destroy(sd_factory_t* a_this, void* a_pr);
extern voidsd_factory_print(const sd_factory_t* a_this, FILE* a_stream);
extern intsd_factory_list(const sd_factory_t* a_this, void** a_items,
int a_nitems);
2、 Factory Method工厂方法
因为面向用户配置选项,appender和layout在用户看来接口都一样,创建和删除以及打印,拥有共同的操作,fac_new/fac_delete/fac_print
factory.h :
struct __sd_factory {
char* fac_name;
const sd_factory_ops_t* fac_ops;
sd_hash_t* fac_hash;
};
typedef struct __sd_factory sd_factory_t;
struct __sd_factory_ops
{
void* (*fac_new) (const char*);
void (*fac_delete) (void*);
void (*fac_print) (void*, FILE*);
};
typedef struct __sd_factory_opssd_factory_ops_t;
fac_name用来区分appender/layout,fac_hash用来储存,方便查 找,如果更多的接口的话都无妨(个人喜好用链表代替hash),当不同模块Appender.c/ Layout.c都预先添加到hash中,如果还有ABC模块/XYZ模块,照样预先添加到HASH,模块非常的独立
Appender.c :
static const sd_factory_ops_tlog4c_appender_factory_ops = {
(void*) log4c_appender_new,
(void*) log4c_appender_delete,
(void*) log4c_appender_print,
};
Layout.c :
static const sd_factory_ops_tlog4c_layout_factory_ops = {
(void*)log4c_layout_new,
(void*)log4c_layout_delete,
(void*)log4c_layout_print,
};
添加子fac到HASH后,在用户接口层,根据fac_name,通过 sd_hash_lookup查找HASH,找到fac_ops,有了fac_ops,就有了fac_new/fac_delete /fac_print,这个时候的地址是相应的函数指针----或者appender或者layout或者ABC或者XYZ
3、 Descriptor多态
在log4c_appender_new具体函数中,又面临一个问题是,appender有不同的输出方式:stream,mem,syslog等,
appender.h :
typedef struct log4c_appender_type {
const char* name;
int (*open) (log4c_appender_t*);
int (*append) (log4c_appender_t*, const log4c_logging_event_t*);
int (*close) (log4c_appender_t*);
} log4c_appender_type_t;
Appender.c :
static const log4c_appender_type_t * constappender_types[] = {
&log4c_appender_type_stream,
&log4c_appender_type_stream2,
&log4c_appender_type_mmap,
&log4c_appender_type_syslog,
&log4c_appender_type_rollingfile
};
static size_t nappender_types =sizeof(appender_types) / sizeof(appender_types[0]);
这里用一个指针数组,毕竟输出类型是有限的
Appender_type_stream.c :
const log4c_appender_type_tlog4c_appender_type_stream = {
"stream",
stream_open,
stream_append,
stream_close,
};
Appender_type_mmap.c :
const log4c_appender_type_tlog4c_appender_type_mmap = {
"mmap",
mmap_open,
mmap_append,
mmap_close,
};
Appender_type_syslog.c :
const log4c_appender_type_tlog4c_appender_type_syslog = {
"syslog",
syslog_open,
syslog_append,
syslog_close,
};
同样操作,将上面不同类型添加到HASH,上面是指针数组的成员,在 log4c_appender_type_get运行时候,根据appender_name,通过通过sd_hash_lookup查找HASH,找到 open/ append/ close的指针,也就是具体的函数指针,或者stream_open/ mmap_open/ syslog_open等
在log4c_layout_new具体函数中,有不同的输出方式:data,time等,同样是一个多态的实现
4、 实际应用例子
int main()
{
...
root = log4c_category_get("root");
sub1 = log4c_category_get("sub1");
layout1 = log4c_layout_get("layout1");
log4c_appender_t* appender1 = log4c_appender_get("appender1");
log4c_layout_set_type(layout1, &log4c_layout_type_basic_r);
log4c_appender_set_layout(appender1, layout1);
log4c_appender_set_udata(appender1, stdout);
log4c_category_set_appender(sub1, appender1);
log4c_category_set_priority(sub1, LOG4C_PRIORITY_ERROR);
...
}
factory打印结果,udata是stderr、stdout等:
factory[log4c_category_factory]:
{ name:'root' priority:NOTSET additive:1 appender:'(nil)' parent:'(nil)' }
{ name:'sub1' priority:ERROR additive:1 appender:'appender1' parent:'root' }
factory[log4c_appender_factory]:
{ name:'stderr' type:'stream' layout:'basic' isopen:0 udata:10311428}
{ name:'stdout' type:'stream' layout:'basic' isopen:0 udata:10311408}
{ name:'appender1' type:'stream' layout:'layout1' isopen:0 udata:10311428}
factory[log4c_layout_factory]:
{ name:'layout1' type:'basic_r' udata:00000000 }
{ name:'basic' type:'basic' udata:00000000 }
{ name:'dated' type:'dated' udata:00000000 }
(1)可以看到有几个默认设置的,这是因为代码中默认配置了几项:
/* build default appenders */
log4c_appender_set_udata(log4c_appender_get("stderr"), stderr);
log4c_appender_set_udata(log4c_appender_get("stdout"), stdout);
/* build default layouts */
log4c_layout_set_type(log4c_layout_get("dated"), &log4c_layout_type_dated);
log4c_layout_set_type(log4c_layout_get("basic"), &log4c_layout_type_basic);
(2)3次fac_ops
log4c_category_factory = sd_factory_new("log4c_category_factory",&log4c_category_factory_ops);
log4c_appender_factory = sd_factory_new("log4c_appender_factory",&log4c_appender_factory_ops);
log4c_layout_factory = sd_factory_new("log4c_layout_factory",&log4c_layout_factory_ops);
(后两个new的时候是默认的类型log4c_appender_type_stream log4c_layout_type_basic)
(log4c_appender_factory->fac_hash,log4c_layout_factory->fac_hash类似LIST_HEAD的概念)
(a_name对应就是log4c_***_type_t中的name)
(3)如果配置在log4crc:
<category name="mycat" priority="debug" appender="stdout" />
<appender name="stdout" type="stream" layout="basic"/>
<layout name="basic" type="basic"/>
3次fac_ops、3次sd_factory_get,不同的是,会增加
log4c_category_set_priority
log4c_appender_set_type
log4c_layout_set_type
来配置类型
5、 小结
其实Factory_ops和Discriptor都没有必要HASH或者链表,毕竟这里分类有限,特别是对于log4c的代码而言,Discriptor直接数组中循环判断即可,HASH完全是多余
反倒是Factory_ops在分类很多的情况下,采用HASH或者链表,因为 Factory_ops面向的层次更高,实际项目中分工是每个人几个子fac,采用数组耦合性太强,采用HASH或者链表,只要新加一个fac_ops, 只需添加到HASH或者链表,到时候查找即可
在fac_ops具体实现中,name不同,就必须新开一块内存,所以必须采用HASH或者链表,比如log4c_appender_factory->fac_hash,log4c_layout_factory->fac_has就是HASH的HEAD