router.h

Go to the documentation of this file.

#ifndef KEEL_ROUTER_H
#define KEEL_ROUTER_H
 
#include <keel/allocator.h>
#include <keel/request.h>
#include <keel/response.h>
#include <keel/body_reader.h>
#include <stddef.h>
 
typedef void (*KlHandler)(KlRequest *req, KlResponse *res, void *user_data);
 
typedef int (*KlMiddleware)(KlRequest *req, KlResponse *res, void *user_data);
 
typedef struct KlWsServerConfig KlWsServerConfig;
 
typedef struct {
    const char *method;                
    const char *pattern;               
    size_t method_len;                 
    size_t pattern_len;                
    KlHandler handler;                 
    void *user_data;                   
    KlBodyReaderFactory body_reader;   
    KlWsServerConfig *ws_config;       
} KlRoute;
 
typedef struct {
    const char *method;    
    const char *pattern;   
    size_t method_len;     
    size_t pattern_len;    
    KlMiddleware fn;       
    void *user_data;       
} KlMiddlewareEntry;
 
typedef struct KlRouter {
    KlRoute *routes;                   
    int count;                         
    int capacity;                      
    KlMiddlewareEntry *middleware;     
    int mw_count;                      
    int mw_capacity;                   
    KlMiddlewareEntry *post_middleware; 
    int post_mw_count;                 
    int post_mw_capacity;              
    KlAllocator *alloc;                
} KlRouter;
 
int  kl_router_init(KlRouter *r, KlAllocator *alloc);
 
int  kl_router_add(KlRouter *r, const char *method, const char *pattern,
                   KlHandler handler, void *user_data,
                   KlBodyReaderFactory body_reader);
 
int  kl_router_match(KlRouter *r, const char *method, size_t method_len,
                     const char *path, size_t path_len,
                     KlRoute **matched, KlParam *params, int *num_params);
 
int  kl_router_use(KlRouter *r, const char *method, const char *pattern,
                   KlMiddleware fn, void *user_data);
 
int  kl_router_use_post(KlRouter *r, const char *method, const char *pattern,
                        KlMiddleware fn, void *user_data);
 
int  kl_router_run_middleware(KlRouter *r, KlRequest *req, KlResponse *res);
 
int  kl_router_run_post_middleware(KlRouter *r, KlRequest *req, KlResponse *res);
 
void kl_router_free(KlRouter *r);
 
#endif