plugin.h 代码阅读笔记

该文件中定义了lighttpd的模块插件结构体。此结构体大量使用了函数指针，对进一步深入了解函数指针很有现在。现在的工作是，解释结构体中每个字段的含义，用处，使用方法。搞清楚插件中几个函数的调用序列，插件中几个函数的返回值对lighttpd有什么影响。 [code type="c"] #ifndef _PLUGIN_H_ #define _PLUGIN_H_ #include “base.h” #include “buffer.h” //此宏定义服务器函数的通用格式，参数为 server 类型指针，一个 指向模块定义的数据结构的void 类型指针 #define SERVER_FUNC(x) \r static handler_t x(server *srv, void *p_d) #define CONNECTION_FUNC(x) \r static handler_t x(server *srv, connection *con, void *p_d) #define INIT_FUNC(x) \r static void *x() //下面四个是服务器级别的函数 #define FREE_FUNC SERVER_FUNC #define TRIGGER_FUNC SERVER_FUNC #define SETDEFAULTS_FUNC SERVER_FUNC #define SIGHUP_FUNC SERVER_FUNC //下面五个是连接级别的函数 #define SUBREQUEST_FUNC CONNECTION_FUNC #define JOBLIST_FUNC CONNECTION_FUNC #define PHYSICALPATH_FUNC CONNECTION_FUNC #define REQUESTDONE_FUNC CONNECTION_FUNC #define URIHANDLER_FUNC CONNECTION_FUNC #define PLUGIN_DATA size_t id //这个定义的是所有模块插件的内部数据都必须有一个公共字段，这个字段的值由lighttpd统一管理，类似于一个序列值，给每个模块都定义一个ID号。 //模块插件结构体,包含的信息相当的丰富。 typedef struct { size_t version; //一般写为 ： LIGHTTPD_VERSION_ID 什么时候不一样呢。 buffer *name; /* name of the plugin */ //一般写为模块的名字 , 如 mod_skeleton //下面这些函数指针指向的函数是要编写模块的开发人员实现的，当然，有些是可选的，有些是必须实现的。 void *(* init) (); //在加载当前模块的时候调用，但不是第一个要调用的函数。在此之前会调用 *_plugin_init 函数初始化当前模块。它是第一个实际调用的插件函数。此函数用于初始化模块内部数据结构，此内部数据结构被赋给*plugin_init中设定的data字段了。 handler_t (* set_defaults) (server *srv, void *p_d); //实际调用的第二个插件函数。此函数是配置文件解析入口。它应该传递一个选项参数列表给config_insert_values函数，并且还要检查参数是否有效，如果是无效参数，则需要给该选项参数设置默认值，或者返回错误。 handler_t (* cleanup) (server *srv, void *p_d); //最后一个调用的模块插件函数。用于清理当前模块使用的内存。它在当前模块被卸载的前一该被lighttpd调用。 /* is called … */ handler_t (* handle_trigger) (server *srv, void *p_d); /* once a second */ //每一秒都会调用的插件函数，模块如果不需要此定时器，可以忽略它。 handler_t (* handle_sighup) (server *srv, void *p_d); /* at a signup */ //如果lighttpd收到SIGHUP信号，则它会调用插件中的这个函数，通知插件做相应处理。lighttpd收到这个信号时并不会退出，因而对模块来说可以忽略这个信号。这个函数的调用顺序不定，在模块被加载之后，被卸载之前的任何时刻都可能调用此函数，这依赖于用户行为，用户可能手工向lighttpd发送SIGHUP信号。 handler_t (* handle_uri_raw) (server *srv, connection *con, void *p_d); /* after uri_raw is set */ //在lighttpd 设置了 uri_raw之后被调用。uri_raw是在什么时候设置的呢？ handler_t (* handle_uri_clean) (server *srv, connection *con, void *p_d); /* after uri is set */ //在lighttpd设置了uri.path 之后被调用。uri.path是在什么时候设置的呢？ handler_t (* handle_docroot) (server *srv, connection *con, void *p_d); /* getting the document-root */ //当 lighttpd 需要docroot的时候此函数被调用。 不太明白这个docroot的意思，lighttpd为什么会不定时的需要 docroot 呢？ handler_t (* handle_physical) (server *srv, connection *con, void *p_d); /* mapping url to physical path */ // 在lighttpd设置了physical.path之后被调用。 handler_t (* handle_request_done) (server *srv, connection *con, void *p_d); /* at the end of a request */ //在请求结束的时候被调用，这个时候是否已经处理了请求并将数据发送到了客户端了呢？ handler_t (* handle_connection_close)(server *srv, connection *con, void *p_d); /* at the end of a connection */ //在连接终止的时候被调用。这时候请求的响应数据肯定已经发送到了客户。 handler_t (* handle_joblist) (server *srv, connection *con, void *p_d); /* after all events are handled */ // 当此次请求的连接状态发生变化时此函数被调用。连接状态类型定义: connection_state_t handler_t (* handle_subrequest_start)(server *srv, connection *con, void *p_d); //在设置了physical.path之后被调用。这和 handle_physical函数有什么区别呢。 /* when a handler for the request * has to be found */ handler_t (* handle_subrequest) (server *srv, connection *con, void *p_d); /* */ //????? handler_t (* connection_reset) (server *srv, connection *con, void *p_d); /* */ //在每次请求的最后调用。这和 handle_request_close ，handle_request_done 有什么关系，好象是在这两 个调用中间某个时刻调用的？？？ void *data; //这个是指向模块内部数据结构的指针。 /* dlopen handle */ void *lib; //dlopen 当前模块时返回的指向此模块动态库的指针变量。用于 dlclose, dlsym , dlerror 函数调用。 } plugin; int plugins_load(server *srv); void plugins_free(server *srv); //与结构体中的函数指针对应的函数调用，一一对应。其实模块插件中的函数指针是在下面这些函数中被调用的。 handler_t plugins_call_handle_uri_raw(server *srv, connection *con); handler_t plugins_call_handle_uri_clean(server *srv, connection *con); handler_t plugins_call_handle_subrequest_start(server *srv, connection *con); handler_t plugins_call_handle_subrequest(server *srv, connection *con); handler_t plugins_call_handle_request_done(server *srv, connection *con); handler_t plugins_call_handle_docroot(server *srv, connection *con); handler_t plugins_call_handle_physical(server *srv, connection *con); handler_t plugins_call_handle_connection_close(server *srv, connection *con); handler_t plugins_call_handle_joblist(server *srv, connection *con); handler_t plugins_call_connection_reset(server *srv, connection *con); handler_t plugins_call_handle_trigger(server *srv); handler_t plugins_call_handle_sighup(server *srv); handler_t plugins_call_init(server *srv); handler_t plugins_call_set_defaults(server *srv); handler_t plugins_call_cleanup(server *srv); int config_insert_values_global(server *srv, array *ca, const config_values_t *cv); int config_insert_values_internal(server *srv, array *ca, const config_values_t *cv); int config_setup_connection(server *srv, connection *con); int config_patch_connection(server *srv, connection *con, comp_key_t comp); int config_check_cond(server *srv, connection *con, data_config *dc); int config_append_cond_match_buffer(connection *con, data_config *dc, buffer *buf, int n); #endif [/code]

转载于:https://www.cnblogs.com/qtchina/archive/2010/06/16/1759122.html