使用 acl 较为底层的 HTTP 协议库写 HTTP 下载客户端举例

　　在" 使用 acl 库开发一个 HTTP 下载客户端 " 文章中介绍利用ACL库中的 HTTP 高级API函数编写HTTP下载客户端的简单的例子，本文介绍一下如何使用稍微底层的API来编写同样功能的例子。在这个例子中，可以看到那些高级API是如何封装底层API的。

　　请先看一个例子如下：

#include "lib_acl.h"
#include "lib_protocol.h"

static void get_url(const char *method, const char *url,
    const char *proxy, const char *dump)
{
    /* 创建 HTTP 请求头 */
    HTTP_HDR_REQ *hdr_req = http_hdr_req_create(url, method, "HTTP/1.1");
    ACL_VSTREAM *stream;  /* 网络连接流 */
    ACL_VSTRING *buf = acl_vstring_alloc(256);  /* 分配内存缓冲区 */
    HTTP_HDR_RES *hdr_res;  /* HTTP 响应头 */
    HTTP_RES *res;  /* HTTP响应体 */
    ACL_FILE *fp = NULL;  /* 转储文件句柄 */
    const char *ptr;
    int   ret;

    /* 输出 HTTP 请求头内容 */

    http_hdr_print(&hdr_req->hdr, "---request hdr---");

    /* 如果设定代理服务器，则连接代理服务器地址，
     * 否则使用 HTTP 请求头里指定的地址
     */

    if (*proxy)
        acl_vstring_strcpy(buf, proxy);
    else
        acl_vstring_strcpy(buf, http_hdr_req_host(hdr_req));

    /* 获得远程 HTTP 服务器的连接地址 */

    ptr = acl_vstring_memchr(buf, ':');
    if (ptr == NULL)
        acl_vstring_strcat(buf, ":80");
    else {
        int   port;
        ptr++;
        port = atoi(ptr);
        if (port <= 0 || port >= 65535) {
            printf("http server's addr(%s) invalid/n", acl_vstring_str(buf));
            acl_vstring_free(buf);
            http_hdr_req_free(hdr_req);
            return;
        }
    }

    /* 连接远程 http 服务器 */

    stream = acl_vstream_connect(acl_vstring_str(buf) /* 服务器地址 */,
            ACL_BLOCKING /* 采用阻塞方式 */,
            10 /* 连接超时时间为 10 秒 */,
            10 /* 网络 IO 操作超时时间为 10 秒 */,
            4096 /* stream 流缓冲区大小为 4096 字节 */);
    if (stream == NULL) {
        /* 连接服务器失败 */

        printf("connect addr(%s) error(%s)/n",
            acl_vstring_str(buf), acl_last_serror());
        acl_vstring_free(buf);
        http_hdr_req_free(hdr_req);
        return;
    }

    /* 构建 HTTP 请求头数据 */

    http_hdr_build_request(hdr_req, buf);

    /* 向 HTTP 服务器发送请求 */

    ret = acl_vstream_writen(stream, acl_vstring_str(buf), ACL_VSTRING_LEN(buf));
    if (ret == ACL_VSTREAM_EOF) {
        printf("write to server error(%s)/n", acl_last_serror());
        acl_vstream_close(stream);
        acl_vstring_free(buf);
        http_hdr_req_free(hdr_req);
        return;
    }

    /* 创建一个 HTTP 响应头对象 */

    hdr_res = http_hdr_res_new();

    /* 读取 HTTP 服务器响应头*/

    ret = http_hdr_res_get_sync(hdr_res, stream, 10 /* IO 超时时间为 10 秒 */);
    if (ret < 0) {
        printf("get http reply header error(%s)/n", acl_last_serror());
        http_hdr_res_free(hdr_res);
        acl_vstream_close(stream);
        acl_vstring_free(buf);
        http_hdr_req_free(hdr_req);
        return;
    }

    /* 分析HTTP服务器响应头 */

    if (http_hdr_res_parse(hdr_res) < 0) {
        printf("parse http reply header error/n");
        http_hdr_print(&hdr_res->hdr, "--- reply http header ---");
        http_hdr_res_free(hdr_res);
        acl_vstream_close(stream);
        acl_vstring_free(buf);
        http_hdr_req_free(hdr_req);
        return;
    }

    /* 如果需要转储至磁盘则需要先打开文件 */

    if (dump != NULL) {
        fp = acl_fopen(dump, "w+");
        if (fp == NULL)
            printf("open file(%s) error(%s)/n",
                dump, acl_last_serror());
    }

    /* 如果 HTTP 响应没有数据体则仅输出 HTTP 响应头即可 */

    if (hdr_res->hdr.content_length == 0
        || (hdr_res->hdr.content_length == -1
            && !hdr_res->hdr.chunked
            && hdr_res->reply_status > 300
            && hdr_res->reply_status < 400))
    {
        if (fp)
            http_hdr_fprint(ACL_FSTREAM(fp), &hdr_res->hdr,
                "--- reply http header ---");
        else
            http_hdr_fprint(ACL_VSTREAM_OUT, &hdr_res->hdr,
                "--- reply http header ---");
        http_hdr_res_free(hdr_res);
        acl_vstream_close(stream);
        acl_vstring_free(buf);
        http_hdr_req_free(hdr_req);
        return;
    }

    /* 输出 HTTP 响应头 */

    http_hdr_print(&hdr_res->hdr, "--- reply http header ---");

    /* 创建 HTTP 响应体对象 */

    res = http_res_new(hdr_res);

    /* 如果有数据体则开始读取 HTTP 响应数据体部分 */

    while (1) {
        http_off_t  n;
        char  buf2[4096];
       
        /* 以同步方式读取HTTP响应数据 */

        n = http_res_body_get_sync(res, stream, buf2, sizeof(buf2) - 1);
        if (n <= 0)
            break;

        if (fp) {
            /* 转储至文件中 */

            if (acl_fwrite(buf2, (size_t) n, 1, fp) == (size_t) EOF) {
                printf("write to dump file(%s) error(%s)/n",
                    dump, acl_last_serror());
                break;
            }
        } else {
            buf2[n] = 0;
            printf("%s", buf2);
        }
    }

    if (fp)
        acl_fclose(fp); &nbsp;/* 关闭转储文件句柄 */
    http_res_free(res);  /* 释放 HTTP 响应对象, hdr_res 会在此函数内部自动被释放 */
    acl_vstream_close(stream);  /* 关闭网络流 */
    acl_vstring_free(buf);  /* 释放内存区 */
    http_hdr_req_free(hdr_req);  /* 释放 HTTP 请求头对象 */
}

static void usage(const char *procname)
{
    printf("usage: %s -h[help] -t method -r url -f dump_file -X proxy_addr/n"
        "example: %s -t GET -r http://www.sina.com.cn/ -f url_dump.txt/n",
        procname, procname);
}

int main(int argc, char *argv[])
{
    int   ch;
    char  url[256], dump[256], proxy[256], method[32];

    acl_init();  /* 初始化 acl 库 */

    ACL_SAFE_STRNCPY(method, "GET", sizeof(method));
    url[0] = 0;
    dump[0] = 0;
    proxy[0] = 0;
    while ((ch = getopt(argc, argv, "hr:t:f:X:")) > 0) {
        switch (ch) {
        case 'h':
            usage(argv[0]);
            return (0);
        case 'r':
            ACL_SAFE_STRNCPY(url, optarg, sizeof(url));
            break;
        case 't':
            ACL_SAFE_STRNCPY(method, optarg, sizeof(method));
            break;
        case 'f':
            ACL_SAFE_STRNCPY(dump, optarg, sizeof(dump));
            break;
        case 'X':
            ACL_SAFE_STRNCPY(proxy, optarg, sizeof(proxy));
            break;
        default:
            break;
        }
    }

    if (url[0] == 0) {
        usage(argv[0]);
        return (0);
    }

    get_url(method, url, proxy, dump);
    return (0);
}

 

 　　可以明显地看出，该例子的实现代码量要比 使用 acl 库开发一个 HTTP 下载客户端 麻烦许多，但它却比较清晰地展示了 HTTP 协议的请求与响应过程。该例子可以在 acl_project/samples/http/get_url1/ 目录下找到。

      acl 库下载： http://acl.sourceforge.net/