Skip to content

Latest commit

 

History

History
134 lines (87 loc) · 4.27 KB

File metadata and controls

134 lines (87 loc) · 4.27 KB

httpclient

这应该是用户最容易接触到的上层应用了,虽然用户可以接触它,但是我并不打算将client对外公开操作,除非很熟悉(至少我目前是这样子打算的),因此我将它设置成内部管理。

使用池化技术,将所有的client都放在一个client pool中,需要的时候从池中租借(lease),在使用完毕归还到client pool中(release)。

数据结构

typedef struct http_client {
    http_list_t                         list;
    http_interceptor_t                  *interceptor;
    http_connect_params_t               *connect_params;
    http_request_method_t               method;
    uint32_t                            interest_event;
    http_event_t                        *event;
    size_t                              process;
    size_t                              total;
    void                                *data;
} http_client_t;
  • list : http-client内部维护了两条链表,分别是已使用空闲链表,而list则是用于挂载到这两个列表中的,以及一个用于包含client池的**_client_pool_lock**互斥锁:
static http_list_t _http_client_free_list;
static http_list_t _http_client_used_list;

static platform_mutex_t _client_pool_lock;
  • interceptor :拥有的拦截器。

  • connect_params :指向连接参数结构。

  • method :请求的模式,如GET/POST等。

  • interest_event :感兴趣的事件,在拦截器收到数据的时候触发回调函数,而通过感兴趣的事件选择是否上报到用户空间。

  • event :事件回调处理。

  • process:已经处理的数据长度。

  • total:总数据长度。

  • data:用户要发送给服务器的数据(POST的数据)。

外部函数

  • http-client的初始化,应该称之为系统初始化更合适,它会初始化内部管理的client pool,用链表的形式去管理所有的空闲 client,数量由用户指定HTTP_CLIENT_POOL_SIZE,默认为5
int http_client_init(const char *ca);
  • 等待处理完毕并退出,如果任务还处于工作队列中,本函数将持续等待工作队列的工作完成,当然,如果不关心工作队列中的任务处理结果,可以调用工作队列的销毁函数,直接销毁工作队列并退出。
void http_client_wait_exit(void);
  • 直接退出处理,本函数会销毁工作队列。
void http_client_exit(void);
  • 租借client,其实就是从空闲链表**_http_client_free_list中取出一个client**,返回给用户。
http_client_t *http_client_lease(void);
  • http-client释放操作,这应该叫将client放回空闲链表**_http_client_free_list**中。
void http_client_release(http_client_t *c);
  • 用户接口,http get数据,通过回调函数上报数据,它只需url参数与对应的回调函数即可,在内部会从空闲链表**_http_client_free_list中分配一个client用于处理url,处理完了会释放client**。
int http_client_get(const char *url, http_event_cb_t cb);
  • 用户接口,http post数据,指定要posturl与数据内容
int http_client_post(const char *url, void *data ,http_event_cb_t cb);
  • 注册感兴趣的事件,在产生该事件的时候将会告知应用层
void http_client_set_interest_event(http_client_t *c, http_event_type_t event);
  • 设置http的请求方法。
void http_client_set_method(http_client_t *c, http_request_method_t method);
  • 设置http要发送给服务器的数据。
void http_client_set_data(http_client_t *c, void *data);

内部函数

  • client pool的初始化,其实就是根据指定的 client 数量去初始化 client 池,并挂载到空闲链表**_http_client_free_list**中,在需要的时候从该链表取下。
void *_http_client_pool_init(void)
  • client的初始化,主要就是分配相关的内存空间。
int _http_client_internal_init(void)
  • 根据用户指定的感兴趣的事件进行回调处理。
static int _http_client_internal_event_handle(void *e)

上一篇工作队列

下一篇