libcurl使用easy模式阻塞卡死等問題的完美解決

引言:

    由於要在android手機測進行DM開發, 其中最重要的就是FUMO和SCOMO下載, 下載使用的是linux開源庫libcurl. 於是就把libcurl的使用研究了一遍, 有些心得, 並解決了一些網友的阻塞卡死問題, 於是jwisp將經驗和方案分享給大家.

 

一共四篇:

使用libcurl進行文件下載類項目開發(一) libcurl簡單使用介紹

(二)使用libcurl實現獲取目標文件大小, 下載進度顯示, 斷點續傳等功能

(三)Libcurl中使用curl_easy_perform阻塞, 遇到無信號卡死的完美解決方案

(四)使用Libcurl下載文件,解決無信號中斷,下載中掉電恢復后斷點續傳問題的源代碼

 

Libcurl使用介紹:

       四個關鍵函數:

1.      curl_easy_init() 初始化curl環境,新建curl對象,返回對象句柄,使用舉例:    CURL *handler = curl_easy_init();

2.      curl_easy_setopt() 各種設置, 包括URL設置等,使用舉例:

  curl_easy_setopt(handler, CURLOPT_URL, “www.baidu.com”),其中中間的參數是設置的類別,比較重要,后面會列舉說明.

3.      curl_easy_perform() 開始執行下載操作, 若下載失敗會返回錯誤碼.例如: CURLcode code = curl_easy_perform(handler)

4.      curl_easy_getinfo() 得到各種下載信息, 包括下載文件名,文件大小等,此操作必須放在curl_easy_perform()之后執行才能得到正確的值.使用舉例: long resultCode;

   curl_easy_getinfo(handler, CURLINFO_RESPONSE_CODE, &resultCode);

中間的參數也在后面列舉

必要的參數說明

   curl_easy_setopt()參數:

     CURLOPT_URL  設置目標URL地址

     CURLOPT_HEADER 是否包含http頭,包含則設置為一個非0值

     CURLOPT_NOBODY 如果你不需要http的body部分(除header頭以外其他部分),設置此項為一個非0值

     CURLOPT_TIMETOU 設置一個超時時間,若超過此時間perform會立即返回,返回碼為下載失敗對應錯誤碼,單位秒.注意此時間為從調用perform開始后的總的下載時間,舉例curl_easy_setopt(handler, CURLOPT_TIMEOUT, 30)

設置超時時間為30秒,即下載必須在30秒內完成,否則返回下載失敗

     CURLOPT_CONNECTIONTIMEOUT 連接超時時間,單位秒.這個參數在easy curl下載中基本沒什么實用價值.

     CURLOPT_RESUME_FROM_LARGE 從什么位置開始下載,斷點續傳主要使用此參數進行配置,使用非常簡單,只需要傳遞一個字節偏移量即可,例如

 curl_easy_setopt(handler, CURLOPT_ RESUME_FROM, 0),表示從第0個字節開始下載, curl_easy_setopt(handler, CURLOPT_ RESUME_FROM, 500),從第500個字節開始下載

     CURLOPT_RANGE 下載指定字節的文件塊,參數對應的值格式為X-Y,例如curl_easy_setopt(handler, CURLOPT_ RESUME_FROM, “500-999”),下載從500個字節開始到999字節結束的文件塊

     CURLOPT_NOPROGRESS 如果不需要下載進度設置此項為一個非0值

     CURLOPT_PROGRESSFUNCTION 設置回調的進度函數,設置后,會不斷的調用進度函數,並傳遞參數總大小和已下載大小給該函數

     CURLOPT_PROGRESSDATA 設置傳遞給回調的進度函數的一個參數,類型為字符串類型,后面jwisp會舉例說明

curl_easy_getinfo() 部分參數說明

     CURLINFO_RESPONSE_CODE 得到perform的執行結果碼

     CURLINFO_CONTENT_LENGTH_DOWNLOAD 得到下載文件大小

本節jwisp為大家舉例說明如果使用上節介紹的函數和參數,在使用libcurl的過程中,如何獲取下載目標文件的大小, 下載進度條,斷點續傳等,這些基本的函數,將為jwisp在最后處理下載過程異常中斷等問題提供支持.

1.      編寫得到下載目標文件的大小的函數

long getDownloadFileLenth(const char *url){
    long downloadFileLenth = 0;
    CURL *handle = curl_easy_init();
    curl_easy_setopt(handle, CURLOPT_URL, url);
    curl_easy_setopt(handle, CURLOPT_HEADER, 1);    //只需要header頭
    curl_easy_setopt(handle, CURLOPT_NOBODY, 1);    //不需要body
    if (curl_easy_perform(handle) == CURLE_OK) {
        curl_easy_getinfo(handle, CURLINFO_CONTENT_LENGTH_DOWNLOAD, &downloadFileLenth);
    } else {
        downloadFileLenth = -1;
    }
    return downloadFileLenth;
}

2.      下載中回調自己寫的得到下載進度值的函數

下載回調函數的原型應該為:

int progressFunc(const char* flag, double dtotal, double dnow, double ultotal, double ulnow);

a.      應該在外部聲明一個遠程下載文件大小的全局變量

double downloadFileLenth = 0;

為了斷點續傳, 還應該聲明一個本地文件大小的全局變量

double localFileLenth = 0;

b.      編寫一個得到進度值的函數getProgressValue()

int getProgressValue(const char* flag, double dt, double dn, double ult, double uln){
    double showTotal, showNow;
    if (downloadFileLenth == 0){
        downloadFileLenth = getDownloadFileLenth(url);
    }
    showTotal = downloadFileLenth;
    if (localFileLenth == 0){
        localFileLenth = getLocalFileLenth(filePath);
    }
    showNow = localFileLenth + dn;
    //然后就可以調用你自己的進度顯示函數了, 這里假設已經有一個進度函數, 那么只需要傳遞當前下載值和總下載值即可.
    showProgressValue(showNow, showTotal);
}

c.       在下載中進行三個下載參數的設置

curl_easy_setopt(handle, CURLOPT_NOPROGRESS, 0);

curl_easy_setopt(handle, CURLOPT_PROGRESSFUNCTION, getProgressValue);  //設置回調的進度函數

curl_easy_setopt(handle, CURLOPT_PROGRESSDATA, “flag”);   //此設置對應上面的const char *flag

3.      斷點續傳

用libcurl實現斷點續傳很簡單,只用兩步即可實現,一是要得到本地文件已下載的大小,通過函數getLocalFileLenth()方法來得到,二是設置CURLOPT_RESUME_FROM_LARGE參數的值為已下載本地文件大小.

得到本地文件大小的函數:

long getLocalFileLenth(const char* localPath);

設置下載點如下即可:

                    

curl_easy_setopt(handle, CURLOPT_RESUME_FROM_LARGE, getLocalFileLenth(localFile));