Skip to content

Latest commit

 

History

History
112 lines (88 loc) · 5.28 KB

general.md

File metadata and controls

112 lines (88 loc) · 5.28 KB
Raw

HTTP通用组件

数据结构

  • 连接参数信息

    它实际上是 url 的各个字段内容，它在 url 解析器中被使用，解析 url 产生相关信息保存在这里。

    typedef struct http_connect_params {
    char                        *http_url;
    char                        *http_scheme;
    char                        *http_host;
    char                        *http_user;
    char                        *http_password;
    char                        *http_path;
    char                        *http_query;
    char                        *http_farg;
    char                        *http_cert_pem;
    uint16_t                    http_port;
} http_connect_params_t;

相关的宏定义

  • 常用的 http、https 协议端口

    #define DEFAULT_HTTP_PORT   "80"
#define DEFAULT_HTTPS_PORT  "443"

  • 让编译器预处理，产一系列功能操作相同的函数，获取/设置 连接参数的相关信息，如 url、scheme、host、user、password、path、query 等。

    #define HTTP_GET_CONNECT_PARAMS_DEFINE(name, type, res)                                     \
    type http_get_connect_params_##name(http_connect_params_t *conn) {                      \
        HTTP_ROBUSTNESS_CHECK((conn), res);                                                 \
        return conn->http_##name;                                                           \
    }

#define HTTP_SET_CONNECT_PARAMS_DEFINE(name, type, res)                                     \
    type http_set_connect_params_##name(http_connect_params_t *conn, type t, int l) {       \
        HTTP_ROBUSTNESS_CHECK((conn && t), res);                                            \
        http_utils_assign_string(&conn->http_##name, t, l);                                 \
        return conn->http_##name;                                                           \
    }

#define HTTP_GET_CONNECT_PARAMS_STATEMENT(name, type)                       \
    type http_get_connect_params_##name(http_connect_params_t *);

#define HTTP_SET_CONNECT_PARAMS_STATEMENT(name, type)                       \
    type http_set_connect_params_##name(http_connect_params_t *, type, int);

#define HTTP_SET_AND_GET_CONNECT_PARAMS_DEFINE(name, type, res)             \
    HTTP_SET_CONNECT_PARAMS_DEFINE(name, type, res)                         \
    HTTP_GET_CONNECT_PARAMS_DEFINE(name, type, res)

#define HTTP_SET_AND_GET_CONNECT_PARAMS_STATEMENT(name, type)               \
    HTTP_SET_CONNECT_PARAMS_STATEMENT(name, type)                           \
    HTTP_GET_CONNECT_PARAMS_STATEMENT(name, type)
    HTTP_SET_AND_GET_CONNECT_PARAMS_DEFINE(url, const char*, NULL)
HTTP_SET_AND_GET_CONNECT_PARAMS_DEFINE(scheme, const char*, NULL)
HTTP_SET_AND_GET_CONNECT_PARAMS_DEFINE(host, const char*, NULL)
HTTP_SET_AND_GET_CONNECT_PARAMS_DEFINE(user, const char*, NULL)
HTTP_SET_AND_GET_CONNECT_PARAMS_DEFINE(password, const char*, NULL)
HTTP_SET_AND_GET_CONNECT_PARAMS_DEFINE(path, const char*, NULL)
HTTP_SET_AND_GET_CONNECT_PARAMS_DEFINE(query, const char*, NULL)
HTTP_SET_AND_GET_CONNECT_PARAMS_DEFINE(farg, const char*, NULL)
HTTP_SET_AND_GET_CONNECT_PARAMS_DEFINE(port, const char*, NULL)

外部函数

  • 在编译器的预处理后会产生以下函数与声明，函数看名字就知道是怎么用的了，非常简单，通过宏定义只是减少了书写的代码量而已。

    http_get_connect_params_url(http_connect_params_t *connect_params)
http_get_connect_params_scheme(http_connect_params_t *connect_params)
http_get_connect_params_host(http_connect_params_t *connect_params)
http_get_connect_params_port(http_connect_params_t *connect_params)
http_get_connect_params_user(http_connect_params_t *connect_params)
http_get_connect_params_password(http_connect_params_t *connect_params)
http_get_connect_params_path(http_connect_params_t *connect_params)
http_get_connect_params_query(http_connect_params_t *connect_params)
http_get_connect_params_farg(http_connect_params_t *connect_params)

http_set_connect_params_url(http_connect_params_t *connect_params, const char* t)
http_set_connect_params_scheme(http_connect_params_t *connect_params, const char* t)
http_set_connect_params_host(http_connect_params_t *connect_params, const char* t)
http_set_connect_params_port(http_connect_params_t *connect_params, const char* t)
http_set_connect_params_user(http_connect_params_t *connect_params, const char* t)
http_set_connect_params_password(http_connect_params_t *connect_params, const char* t)
http_set_connect_params_path(http_connect_params_t *connect_params, const char* t)
http_set_connect_params_query(http_connect_params_t *connect_params, const char* t)
http_set_connect_params_farg(http_connect_params_t *connect_params, const char* t)

  • 为连接参数结构分配内存与释放内存。

    http_connect_params_t *http_assign_connect_params(void)

void http_release_connect_params(http_connect_params_t *connect_params)

上一篇：基础组件功能

下一篇：HTTP 回调事件