00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016 #ifndef APR_HOOKS_H
00017 #define APR_HOOKS_H
00018
00019 #include "apu.h"
00020
00021 #include "apr_tables.h"
00022
00028 #ifdef __cplusplus
00029 extern "C" {
00030 #endif
00031
00037 #define APR_IMPLEMENT_HOOK_GET_PROTO(ns,link,name) \
00038 link##_DECLARE(apr_array_header_t *) ns##_hook_get_##name(void)
00039
00041 #define APR_DECLARE_EXTERNAL_HOOK(ns,link,ret,name,args) \
00042 typedef ret ns##_HOOK_##name##_t args; \
00043 link##_DECLARE(void) ns##_hook_##name(ns##_HOOK_##name##_t *pf, \
00044 const char * const *aszPre, \
00045 const char * const *aszSucc, int nOrder); \
00046 link##_DECLARE(ret) ns##_run_##name args; \
00047 APR_IMPLEMENT_HOOK_GET_PROTO(ns,link,name); \
00048 typedef struct ns##_LINK_##name##_t \
00049 { \
00050 ns##_HOOK_##name##_t *pFunc; \
00051 const char *szName; \
00052 const char * const *aszPredecessors; \
00053 const char * const *aszSuccessors; \
00054 int nOrder; \
00055 } ns##_LINK_##name##_t;
00056
00058 #define APR_HOOK_STRUCT(members) \
00059 static struct { members } _hooks;
00060
00062 #define APR_HOOK_LINK(name) \
00063 apr_array_header_t *link_##name;
00064
00066 #define APR_IMPLEMENT_EXTERNAL_HOOK_BASE(ns,link,name) \
00067 link##_DECLARE(void) ns##_hook_##name(ns##_HOOK_##name##_t *pf,const char * const *aszPre, \
00068 const char * const *aszSucc,int nOrder) \
00069 { \
00070 ns##_LINK_##name##_t *pHook; \
00071 if(!_hooks.link_##name) \
00072 { \
00073 _hooks.link_##name=apr_array_make(apr_hook_global_pool,1,sizeof(ns##_LINK_##name##_t)); \
00074 apr_hook_sort_register(#name,&_hooks.link_##name); \
00075 } \
00076 pHook=apr_array_push(_hooks.link_##name); \
00077 pHook->pFunc=pf; \
00078 pHook->aszPredecessors=aszPre; \
00079 pHook->aszSuccessors=aszSucc; \
00080 pHook->nOrder=nOrder; \
00081 pHook->szName=apr_hook_debug_current; \
00082 if(apr_hook_debug_enabled) \
00083 apr_hook_debug_show(#name,aszPre,aszSucc); \
00084 } \
00085 APR_IMPLEMENT_HOOK_GET_PROTO(ns,link,name) \
00086 { \
00087 return _hooks.link_##name; \
00088 }
00089
00102 #define APR_IMPLEMENT_EXTERNAL_HOOK_VOID(ns,link,name,args_decl,args_use) \
00103 APR_IMPLEMENT_EXTERNAL_HOOK_BASE(ns,link,name) \
00104 link##_DECLARE(void) ns##_run_##name args_decl \
00105 { \
00106 ns##_LINK_##name##_t *pHook; \
00107 int n; \
00108 \
00109 if(!_hooks.link_##name) \
00110 return; \
00111 \
00112 pHook=(ns##_LINK_##name##_t *)_hooks.link_##name->elts; \
00113 for(n=0 ; n < _hooks.link_##name->nelts ; ++n) \
00114 pHook[n].pFunc args_use; \
00115 }
00116
00117
00118
00119
00135 #define APR_IMPLEMENT_EXTERNAL_HOOK_RUN_ALL(ns,link,ret,name,args_decl,args_use,ok,decline) \
00136 APR_IMPLEMENT_EXTERNAL_HOOK_BASE(ns,link,name) \
00137 link##_DECLARE(ret) ns##_run_##name args_decl \
00138 { \
00139 ns##_LINK_##name##_t *pHook; \
00140 int n; \
00141 ret rv; \
00142 \
00143 if(!_hooks.link_##name) \
00144 return ok; \
00145 \
00146 pHook=(ns##_LINK_##name##_t *)_hooks.link_##name->elts; \
00147 for(n=0 ; n < _hooks.link_##name->nelts ; ++n) \
00148 { \
00149 rv=pHook[n].pFunc args_use; \
00150 \
00151 if(rv != ok && rv != decline) \
00152 return rv; \
00153 } \
00154 return ok; \
00155 }
00156
00157
00172 #define APR_IMPLEMENT_EXTERNAL_HOOK_RUN_FIRST(ns,link,ret,name,args_decl,args_use,decline) \
00173 APR_IMPLEMENT_EXTERNAL_HOOK_BASE(ns,link,name) \
00174 link##_DECLARE(ret) ns##_run_##name args_decl \
00175 { \
00176 ns##_LINK_##name##_t *pHook; \
00177 int n; \
00178 ret rv; \
00179 \
00180 if(!_hooks.link_##name) \
00181 return decline; \
00182 \
00183 pHook=(ns##_LINK_##name##_t *)_hooks.link_##name->elts; \
00184 for(n=0 ; n < _hooks.link_##name->nelts ; ++n) \
00185 { \
00186 rv=pHook[n].pFunc args_use; \
00187 \
00188 if(rv != decline) \
00189 return rv; \
00190 } \
00191 return decline; \
00192 }
00193
00194
00196 #define APR_HOOK_REALLY_FIRST (-10)
00197
00198 #define APR_HOOK_FIRST 0
00199
00200 #define APR_HOOK_MIDDLE 10
00201
00202 #define APR_HOOK_LAST 20
00203
00204 #define APR_HOOK_REALLY_LAST 30
00205
00209 APU_DECLARE_DATA extern apr_pool_t *apr_hook_global_pool;
00210
00215 APU_DECLARE_DATA extern int apr_hook_debug_enabled;
00216
00220 APU_DECLARE_DATA extern const char *apr_hook_debug_current;
00221
00227 APU_DECLARE(void) apr_hook_sort_register(const char *szHookName,
00228 apr_array_header_t **aHooks);
00232 APU_DECLARE(void) apr_hook_sort_all(void);
00233
00241 APU_DECLARE(void) apr_hook_debug_show(const char *szName,
00242 const char * const *aszPre,
00243 const char * const *aszSucc);
00244
00248 APU_DECLARE(void) apr_hook_deregister_all(void);
00249
00251 #ifdef __cplusplus
00252 }
00253 #endif
00254
00255 #endif